4 * General purpose functions for manipulation of page content.
9 * Written by Keith Marshall <keith@users.osdn.me>
10 * Copyright (C) 2020, MinGW.org Project
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:
20 * The above copyright notice, this permission notice, and the following
21 * disclaimer shall be included in all copies or substantial portions of
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.
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".
38 var element = document.getElementById( item );
39 if( element ) element.innerHTML = value;
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).
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 );
53 request_handler.open( "GET", src, true );
54 request_handler.send();
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.
62 set_content( "page-title", document.title );
63 set_content( "page-subtitle", subtitle );
64 load_content( "page-content", src );
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
72 if( title ) document.title = title;
73 load_page_content( src, subtitle );
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.
82 load_content( "header", "header.html" );
83 load_page_content( src, subtitle );
86 /* $RCSfile$: end of file */