Open-ILS/web/js/dojo/openils/Util.js

   1 /* ---------------------------------------------------------------------------
   2  * Copyright (C) 2008  Georgia Public Library Service
   3  * Bill Erickson <erickson@esilibrary.com>
   4  *
   5  * This program is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU General Public License
   7  * as published by the Free Software Foundation; either version 2
   8  * of the License, or (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  * GNU General Public License for more details.
  14  * ---------------------------------------------------------------------------
  15  */
  16
  17
  18 /**
  19  * General purpose, static utility functions
  20  */
  21
  22 if(!dojo._hasResource["openils.Util"]) {
  23     dojo._hasResource["openils.Util"] = true;
  24     dojo.provide("openils.Util");
  25     dojo.require('openils.Event');
  26     dojo.declare('openils.Util', null, {});
  27
  28
  29     /**
  30      * Wrapper for dojo.addOnLoad that verifies a valid login session is active
  31      * before adding the function to the onload set
  32      */
  33     openils.Util.addOnLoad = function(func, noSes) {
  34         if(func) {
  35             if(!noSes) {
  36                 dojo.require('openils.User');
  37                 if(!openils.User.authtoken)
  38                     return;
  39             }
  40             console.log("adding onload " + func.name);
  41             dojo.addOnLoad(func);
  42         }
  43     };
  44
  45     /**
  46      * Returns true if the provided array contains the specified value
  47      */
  48     openils.Util.arrayContains = function(arr, val) {
  49         for(var i = 0; arr && i < arr.length; i++) {
  50             if(arr[i] == val)
  51                 return true;
  52         }
  53         return false;
  54     };
  55
  56     /**
  57      * Given a HTML select object, returns the currently selected value
  58      */
  59     openils.Util.selectorValue = function(sel) {
  60         if(!sel) return null;
  61         var idx = sel.selectedIndex;
  62         if(idx < 0) return null;
  63         var o = sel.options[idx];
  64         var v = o.value;
  65         if(v == null) v = o.innerHTML;
  66         return v;
  67     }
  68
  69     /**
  70      * Returns the character code of the provided (or current window) event
  71      */
  72     openils.Util.getCharCode = function(evt) {
  73         evt = (evt) ? evt : ((window.event) ? event : null);
  74         if(evt) {
  75             return (evt.charCode ? evt.charCode :
  76                 ((evt.which) ? evt.which : evt.keyCode ));
  77         } else { return -1; }
  78     }
  79
  80
  81     /**
  82      * Registers a handler for when the Enter key is pressed while
  83      * the provided DOM node has focus.
  84      */
  85     openils.Util.registerEnterHandler = function(domNode, func) {
  86             if(!(domNode && func)) return;
  87             domNode.onkeydown = function(evt) {
  88             var code = openils.Util.getCharCode(evt);
  89             if(code == 13 || code == 3)
  90                 func();
  91         }
  92         }
  93
  94
  95     /**
  96      * Parses opensrf response objects to see if they contain
  97      * data and/or an ILS event.  This only calls request.recv()
  98      * once, so in a streaming context, it's necessary to loop on
  99      * this method.
 100      * @param r The OpenSRF Request object
 101      * @param eventOK If true, any found events will be returned as responses.
 102      * If false, they will be treated as error conditions and their content will
 103      * be alerted if openils.Util.alertEvent is set to true.  Also, if eventOk is
 104      * false, the response content will be null when an event is encountered.
 105      */
 106     openils.Util.alertEvent = true;
 107     openils.Util.readResponse = function(r, eventOk) {
 108         var msg = r.recv();
 109         if(msg == null) return msg;
 110         var val = msg.content();
 111         if(e = openils.Event.parse(val)) {
 112             if(eventOk) return e;
 113             console.log(e.toString());
 114             if(openils.Util.alertEvent)
 115                 alert(e);
 116             return null;
 117         }
 118         return val;
 119     };
 120
 121
 122     /**
 123      * Given a DOM node, adds the provided class to the node
 124      */
 125     openils.Util.addCSSClass = function(node, cls) {
 126         if(!(node && cls)) return;
 127         var className = node.className;
 128
 129         if(!className) {
 130             node.className = cls;
 131             return;
 132         }
 133
 134         var classList = className.split(/\s+/);
 135         var newName = '';
 136
 137         for (var i = 0; i < classList.length; i++) {
 138             if(classList[i] == cls) return;
 139             if(classList[i] != null)
 140                 newName += classList[i] + " ";
 141         }
 142
 143         newName += cls;
 144         node.className = newName;
 145     },
 146
 147     /**
 148      * Given a DOM node, removes the provided class from the CSS class
 149      * name list.
 150      */
 151     openils.Util.removeCSSClass = function(node, cls) {
 152         if(!(node && cls && node.className)) return;
 153         var classList = node.className.split(/\s+/);
 154         var className = '';
 155         for(var i = 0; i < classList.length; i++) {
 156             if (classList[i] != cls) {
 157                 if(i == 0)
 158                     className = classList[i];
 159                 else
 160                     className += ' ' + classList[i];
 161             }
 162         }
 163         node.className = className;
 164     }
 165
 166 }