Move all state variable declarations together.
[mkws-moved-to-github.git] / tools / htdocs / mkws.js
index 12f3f71..4579c8e 100644 (file)
@@ -2,10 +2,74 @@
 
 "use strict"; // HTML5: disable for debug_level >= 2
 
+
+// Handlebars helpers
+Handlebars.registerHelper('json', function(obj) {
+    return $.toJSON(obj);
+});
+
+
+Handlebars.registerHelper('translate', function(s) {
+    debug("translating '" + s + "'");
+    return mkws.M(s);
+});
+
+
+// We need {{attr '@name'}} because Handlebars can't parse {{@name}}
+Handlebars.registerHelper('attr', function(attrName) {
+    return this[attrName];
+});
+
+
+/*
+ * Use as follows: {{#if-any NAME1 having="NAME2"}}
+ * Applicable when NAME1 is the name of an array
+ * The guarded code runs only if at least one element of the NAME1
+ * array has a subelement called NAME2.
+ */
+Handlebars.registerHelper('if-any', function(items, options) {
+    var having = options.hash.having;
+    for (var i in items) {
+       var item = items[i]
+       if (!having || item[having]) {
+           return options.fn(this);
+       }
+    }
+    return "";
+});
+
+
+Handlebars.registerHelper('first', function(items, options) {
+    var having = options.hash.having;
+    for (var i in items) {
+       var item = items[i]
+       if (!having || item[having]) {
+           return options.fn(item);
+       }
+    }
+    return "";
+});
+
+
+Handlebars.registerHelper('commaList', function(items, options) {
+    var out = "";
+
+    for (var i in items) {
+       if (i > 0) out += ", ";
+       out += options.fn(items[i])
+    }
+
+    return out;
+});
+
+
+
 // Some functions are visible to be called from outside code, namely
 // generated HTML: mkws.switchView(), showDetails(), limitTarget(),
 // limitQuery(), delimitTarget(), delimitQuery(), pagerPrev(),
-// pagerNext(), showPage()
+// pagerNext(), showPage(). Also mkws.M() is made available for the
+// Handlebars helper 'translate'
+
 
 // Set up global mkws object. Contains a hash of session objects,
 // indexed by windowid.
@@ -70,11 +134,13 @@ var mkws = {
     }
 };
 
+
 // Define empty mkws_config for simple applications that don't define it.
 if (mkws_config == null || typeof mkws_config != 'object') {
     var mkws_config = {};
 }
 
+
 // wrapper for jQuery lib
 function _make_mkws_team($, teamName) {
     // if (console && console.log) // disabled, will fail in IE8
@@ -88,6 +154,17 @@ function _make_mkws_team($, teamName) {
 
     var m_sort = 'relevance';
     var m_filters = [];
+    var curPage = 1;
+    var recPerPage = 20;
+    var totalRec = 0;
+    var curDetRecId = '';
+    var curDetRecData = null;
+    var submitted = false;
+    var SourceMax = 16;
+    var SubjectMax = 10;
+    var AuthorMax = 10;
+    var m_query; // initially undefined
+
 
     // keep time state for debugging
     var m_debug_time = {
@@ -95,6 +172,8 @@ function _make_mkws_team($, teamName) {
        "last": $.now()
     };
 
+
+    // Needs to be defined inside _make_mkws_team() so it can see m_debug_time
     mkws.debug_function = function (string) {
        if (!mkws.debug_level)
            return;
@@ -119,65 +198,6 @@ function _make_mkws_team($, teamName) {
     debug("start running MKWS");
 
 
-    Handlebars.registerHelper('json', function(obj) {
-       return $.toJSON(obj);
-    });
-
-
-    Handlebars.registerHelper('translate', function(s) {
-       debug("translating '" + s + "'");
-       return M(s);
-    });
-
-
-    // We need {{attr '@name'}} because Handlebars can't parse {{@name}}
-    Handlebars.registerHelper('attr', function(attrName) {
-       return this[attrName];
-    });
-
-
-    /*
-     * Use as follows: {{#if-any NAME1 having="NAME2"}}
-     * Applicable when NAME1 is the name of an array
-     * The guarded code runs only if at least one element of the NAME1
-     * array has a subelement called NAME2.
-     */
-    Handlebars.registerHelper('if-any', function(items, options) {
-       var having = options.hash.having;
-       for (var i in items) {
-           var item = items[i]
-           if (!having || item[having]) {
-               return options.fn(this);
-           }
-       }
-       return "";
-    });
-
-
-    Handlebars.registerHelper('first', function(items, options) {
-       var having = options.hash.having;
-       for (var i in items) {
-           var item = items[i]
-           if (!having || item[having]) {
-               return options.fn(item);
-           }
-       }
-       return "";
-    });
-
-
-    Handlebars.registerHelper('commaList', function(items, options) {
-       var out = "";
-
-       for (var i in items) {
-           if (i > 0) out += ", ";
-           out += options.fn(items[i])
-       }
-
-       return out;
-    });
-
-
     {
 
        /* default mkws config */
@@ -265,22 +285,11 @@ function _make_mkws_team($, teamName) {
                           "showResponseType": '', // or "json" (for debugging?)
                           "onrecord": my_onrecord } );
 
-    // some state vars
-    var curPage = 1;
-    var recPerPage = 20;
-    var totalRec = 0;
-    var curDetRecId = '';
-    var curDetRecData = null;
-    var submitted = false;
-    var SourceMax = 16;
-    var SubjectMax = 10;
-    var AuthorMax = 10;
-    var m_query; // initially undefined
-
     if (!isNaN(parseInt(mkws_config.perpage_default))) {
        recPerPage = parseInt(mkws_config.perpage_default);
     }
 
+
     //
     // pz2.js event handlers:
     //
@@ -289,6 +298,7 @@ function _make_mkws_team($, teamName) {
        m_paz.bytarget();
     }
 
+
     function my_onshow(data) {
        totalRec = data.merged;
        // move it out
@@ -340,6 +350,7 @@ function _make_mkws_team($, teamName) {
             '<span class="records">' + M('Retrieved records') + ': ' + data.records + '/' + data.hits + '</span>';
     }
 
+
     function my_onterm(data) {
        // no facets
        if (!mkws_config.facets || mkws_config.facets.length == 0) {
@@ -371,6 +382,7 @@ function _make_mkws_team($, teamName) {
            replaceHtml(termlist, acc.join(''));
     }
 
+
     function add_single_facet(acc, caption, data, max, pzIndex) {
        acc.push('<div class="facet" id="mkwsFacet' + caption + '">');
        acc.push('<div class="termtitle">' + M(caption) + '</div>');
@@ -392,6 +404,7 @@ function _make_mkws_team($, teamName) {
        acc.push('</div>');
     }
 
+
     function my_onrecord(data) {
        // FIXME: record is async!!
        clearTimeout(m_paz.recordTimer);
@@ -404,6 +417,7 @@ function _make_mkws_team($, teamName) {
        recordDiv.innerHTML += html;
     }
 
+
     function my_onbytarget(data) {
        var targetDiv = document.getElementById("mkwsBytarget");
        if (!targetDiv) {
@@ -434,6 +448,7 @@ function _make_mkws_team($, teamName) {
     ////////////////////////////////////////////////////////////////////////////////
     ////////////////////////////////////////////////////////////////////////////////
 
+
     // wait until the DOM is ready
     function domReady ()
     {
@@ -447,6 +462,7 @@ function _make_mkws_team($, teamName) {
        }
     }
 
+
     // when search button pressed
     function onFormSubmitEventHandler()
     {
@@ -454,6 +470,7 @@ function _make_mkws_team($, teamName) {
        return false;
     }
 
+
     function newSearch(query, sort, targets, windowid)
     {
        debug("newSearch: " + query);
@@ -472,6 +489,7 @@ function _make_mkws_team($, teamName) {
        submitted = true;
     }
 
+
     function onSelectDdChange()
     {
        if (!submitted) return false;
@@ -481,12 +499,14 @@ function _make_mkws_team($, teamName) {
        return false;
     }
 
+
     function resetPage()
     {
        curPage = 1;
        totalRec = 0;
     }
 
+
     function triggerSearch (query, sort, targets, windowid)
     {
        var pp2filter = "";
@@ -534,6 +554,7 @@ function _make_mkws_team($, teamName) {
        m_paz.search(m_query, recPerPage, m_sort, pp2filter, undefined, params);
     }
 
+
     function loadSelect ()
     {
        if (document.mkwsSelect) {
@@ -544,6 +565,7 @@ function _make_mkws_team($, teamName) {
        }
     }
 
+
     // limit the query after clicking the facet
     mkws.limitQuery = function (field, value)
     {
@@ -556,6 +578,7 @@ function _make_mkws_team($, teamName) {
        return false;
     }
 
+
     // limit by target functions
     mkws.limitTarget  = function (id, name)
     {
@@ -568,6 +591,7 @@ function _make_mkws_team($, teamName) {
        return false;
     }
 
+
     mkws.delimitQuery = function (field, value)
     {
        debug("delimitQuery(field=" + field + ", value=" + value + ")");
@@ -687,14 +711,15 @@ function _make_mkws_team($, teamName) {
             + prev + predots + middle + postdots + next + '</div>';
     }
 
+
     mkws.showPage = function (pageNum)
     {
        curPage = pageNum;
        m_paz.showPage( curPage - 1 );
     }
 
-    // simple paging functions
 
+    // simple paging functions
     mkws.pagerNext = function () {
        if ( totalRec - recPerPage*curPage > 0) {
             m_paz.showNext();
@@ -702,13 +727,14 @@ function _make_mkws_team($, teamName) {
        }
     }
 
+
     mkws.pagerPrev = function () {
        if ( m_paz.showPrev() != false )
             curPage--;
     }
 
-    // switching view between targets and records
 
+    // switching view between targets and records
     mkws.switchView = function(view) {
        debug("switchView: " + view);
 
@@ -742,6 +768,7 @@ function _make_mkws_team($, teamName) {
        }
     }
 
+
     // detailed record drawing
     mkws.showDetails = function (prefixRecId) {
        var recId = prefixRecId.replace('mkwsRec_', '');
@@ -764,6 +791,7 @@ function _make_mkws_team($, teamName) {
        m_paz.record(recId);
     }
 
+
     function replaceHtml(el, html) {
        var oldEl = typeof el === "string" ? document.getElementById(el) : el;
        /*@cc_on // Pure innerHTML is slightly faster in IE
@@ -778,6 +806,7 @@ function _make_mkws_team($, teamName) {
        return newEl;
     };
 
+
     function renderDetails(data, marker)
     {
        var template = loadTemplate("Record");
@@ -1020,6 +1049,7 @@ function _make_mkws_team($, teamName) {
        return nvpair;
     }
 
+
     function mkws_set_lang()  {
        var lang = parseQuerystring().lang || mkws_config.lang;
        if (!lang || !mkws.locale_lang[lang]) {
@@ -1032,6 +1062,7 @@ function _make_mkws_team($, teamName) {
        return mkws_config.lang;
     }
 
+
     function mkws_html_switch() {
        debug("HTML switch");
 
@@ -1047,6 +1078,7 @@ function _make_mkws_team($, teamName) {
        $("#mkwsTargets").css("display", "none");
     }
 
+
     function mkws_html_sort() {
        debug("HTML sort, m_sort = '" + m_sort + "'");
        var sort_html = '<select name="mkwsSort" id="mkwsSort">';
@@ -1067,6 +1099,7 @@ function _make_mkws_team($, teamName) {
        return sort_html;
     }
 
+
     function mkws_html_perpage() {
        debug("HTML perpage");
        var perpage_html = '<select name="mkwsPerpage" id="mkwsPerpage">';
@@ -1085,6 +1118,7 @@ function _make_mkws_team($, teamName) {
        return perpage_html;
     }
 
+
     /*
      * Run service-proxy authentication in background (after page load).
      * The username/password is configured in the apache config file
@@ -1120,6 +1154,7 @@ function _make_mkws_team($, teamName) {
        });
     }
 
+
     /* create locale language menu */
     function mkws_html_lang() {
        var lang_default = "en";
@@ -1162,6 +1197,7 @@ function _make_mkws_team($, teamName) {
        $("#mkwsLang").html(data);
     }
 
+
     function mkws_resize_page () {
        var list = ["mkwsSwitch"];
 
@@ -1189,6 +1225,7 @@ function _make_mkws_team($, teamName) {
        }
     };
 
+
     /* locale */
     function M(word) {
        var lang = mkws_config.lang;
@@ -1198,6 +1235,8 @@ function _make_mkws_team($, teamName) {
 
        return mkws.locale_lang[lang][word] || word;
     }
+    mkws.M = M; // so the Handlebars helper can use it
+
 
     // main
     (function() {