site.js

   1 /*
   2  * site.js
   3  *
   4  * General purpose functions for manipulation of page content.
   5  *
   6  *
   7  * $Id$
   8  *
   9  * Written by Keith Marshall <keith@users.osdn.me>
  10  * Copyright (C) 2020, MinGW.org Project
  11  *
  12  *
  13  * Permission is hereby granted, free of charge, to any person obtaining a
  14  * copy of this software and associated documentation files (the "Software"),
  15  * to deal in the Software without restriction, including without limitation
  16  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  17  * and/or sell copies of the Software, and to permit persons to whom the
  18  * Software is furnished to do so, subject to the following conditions:
  19  *
  20  * The above copyright notice, this permission notice, and the following
  21  * disclaimer shall be included in all copies or substantial portions of
  22  * the Software.
  23  *
  24  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  25  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  26  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  27  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  28  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  29  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OF OR OTHER
  30  * DEALINGS IN THE SOFTWARE.
  31  *
  32  */
  33 function set_content( item, value )
  34 { /* Replace the existing content, if any, of the HTML element with
  35    * id attribute named "item", (if such an element exists), with new
  36    * content as specified by "value".
  37    */
  38   var element = document.getElementById( item );
  39   if( element ) element.innerHTML = value;
  40 }
  41
  42 function load_content( container, src )
  43 { /* Set the content of the specified HTML "container" element, by
  44    * injection of the entire contents of an external file which is
  45    * fetched by http server request; (either an http, or an https,
  46    * server connection is required; does not work for local files).
  47    */
  48   var request_handler = new XMLHttpRequest();
  49   request_handler.onreadystatechange = function()
  50   { if( (this.readyState == this.DONE) && (this.status == 200) )
  51       set_content( container, this.responseText );
  52   }
  53   request_handler.open( "GET", src, true );
  54   request_handler.send();
  55 }
  56
  57 function load_page_content( src, subtitle )
  58 { /* Propagate the HTML document title to the "masthead" display,
  59    * update the displayed page subtitle, (which may be null), and
  60    * load the page content from the specified "src" file.
  61    */
  62   set_content( "page-title", document.title );
  63   set_content( "page-subtitle", subtitle );
  64   load_content( "page-content", src );
  65 }
  66
  67 function load_page_overlay( src, title, subtitle )
  68 { /* Replace the existing page content from the specified overlay
  69    * "src" file, updating the page title, and subtitle, as may be
  70    * appropriate.
  71    */
  72   if( title ) document.title = title;
  73   load_page_content( src, subtitle );
  74 }
  75
  76 function new_page( src, subtitle )
  77 { /* Create a new page display, starting from scratch; assign the
  78    * displayed title from the HTML document title attribute, adding
  79    * the specified subtitle, lay out the standard page header block,
  80    * and load the page content from the "src" file.
  81    */
  82   load_content( "header", "header.html" );
  83   load_page_content( src, subtitle );
  84 }
  85
  86 /* $RCSfile$: end of file */