freshlybakedca.ke
Git fork
jsoref.tngl.sh
1// Copyright (C) 2007, Fredrik Kuivinen <frekui@gmail.com>
2// 2007, Petr Baudis <pasky@suse.cz>
3// 2008-2011, Jakub Narebski <jnareb@gmail.com>
4
5/**
6 * @fileOverview Generic JavaScript code (helper functions)
7 * @license GPLv2 or later
8 */
9
10
11/* ============================================================ */
12/* ............................................................ */
13/* Padding */
14
15/**
16 * pad INPUT on the left with STR that is assumed to have visible
17 * width of single character (for example nonbreakable spaces),
18 * to WIDTH characters
19 *
20 * example: padLeftStr(12, 3, '\u00A0') == '\u00A012'
21 * ('\u00A0' is nonbreakable space)
22 *
23 * @param {Number|String} input: number to pad
24 * @param {Number} width: visible width of output
25 * @param {String} str: string to prefix to string, defaults to '\u00A0'
26 * @returns {String} INPUT prefixed with STR x (WIDTH - INPUT.length)
27 */
28function padLeftStr(input, width, str) {
29 var prefix = '';
30 if (typeof str === 'undefined') {
31 ch = '\u00A0'; // using ' ' doesn't work in all browsers
32 }
33
34 width -= input.toString().length;
35 while (width > 0) {
36 prefix += str;
37 width--;
38 }
39 return prefix + input;
40}
41
42/**
43 * Pad INPUT on the left to WIDTH, using given padding character CH,
44 * for example padLeft('a', 3, '_') is '__a'
45 * padLeft(4, 2) is '04' (same as padLeft(4, 2, '0'))
46 *
47 * @param {String} input: input value converted to string.
48 * @param {Number} width: desired length of output.
49 * @param {String} ch: single character to prefix to string, defaults to '0'.
50 *
51 * @returns {String} Modified string, at least SIZE length.
52 */
53function padLeft(input, width, ch) {
54 var s = input + "";
55 if (typeof ch === 'undefined') {
56 ch = '0';
57 }
58
59 while (s.length < width) {
60 s = ch + s;
61 }
62 return s;
63}
64
65
66/* ............................................................ */
67/* Handling browser incompatibilities */
68
69/**
70 * Create XMLHttpRequest object in cross-browser way
71 * @returns XMLHttpRequest object, or null
72 */
73function createRequestObject() {
74 try {
75 return new XMLHttpRequest();
76 } catch (e) {}
77 try {
78 return window.createRequest();
79 } catch (e) {}
80 try {
81 return new ActiveXObject("Msxml2.XMLHTTP");
82 } catch (e) {}
83 try {
84 return new ActiveXObject("Microsoft.XMLHTTP");
85 } catch (e) {}
86
87 return null;
88}
89
90
91/**
92 * Insert rule giving specified STYLE to given SELECTOR at the end of
93 * first CSS stylesheet.
94 *
95 * @param {String} selector: CSS selector, e.g. '.class'
96 * @param {String} style: rule contents, e.g. 'background-color: red;'
97 */
98function addCssRule(selector, style) {
99 var stylesheet = document.styleSheets[0];
100
101 var theRules = [];
102 if (stylesheet.cssRules) { // W3C way
103 theRules = stylesheet.cssRules;
104 } else if (stylesheet.rules) { // IE way
105 theRules = stylesheet.rules;
106 }
107
108 if (stylesheet.insertRule) { // W3C way
109 stylesheet.insertRule(selector + ' { ' + style + ' }', theRules.length);
110 } else if (stylesheet.addRule) { // IE way
111 stylesheet.addRule(selector, style);
112 }
113}
114
115
116/* ............................................................ */
117/* Support for legacy browsers */
118
119/**
120 * Provides getElementsByClassName method, if there is no native
121 * implementation of this method.
122 *
123 * NOTE that there are limits and differences compared to native
124 * getElementsByClassName as defined by e.g.:
125 * https://developer.mozilla.org/en/DOM/document.getElementsByClassName
126 * https://www.whatwg.org/specs/web-apps/current-work/multipage/dom.html#dom-getelementsbyclassname
127 * https://www.whatwg.org/specs/web-apps/current-work/multipage/dom.html#dom-document-getelementsbyclassname
128 *
129 * Namely, this implementation supports only single class name as
130 * argument and not set of space-separated tokens representing classes,
131 * it returns Array of nodes rather than live NodeList, and has
132 * additional optional argument where you can limit search to given tags
133 * (via getElementsByTagName).
134 *
135 * Based on
136 * https://code.google.com/p/getelementsbyclassname/
137 * http://www.dustindiaz.com/getelementsbyclass/
138 * https://stackoverflow.com/questions/1818865/do-we-have-getelementsbyclassname-in-javascript
139 *
140 * See also https://johnresig.com/blog/getelementsbyclassname-speed-comparison/
141 *
142 * @param {String} class: name of _single_ class to find
143 * @param {String} [taghint] limit search to given tags
144 * @returns {Node[]} array of matching elements
145 */
146if (!('getElementsByClassName' in document)) {
147 document.getElementsByClassName = function (classname, taghint) {
148 taghint = taghint || "*";
149 var elements = (taghint === "*" && document.all) ?
150 document.all :
151 document.getElementsByTagName(taghint);
152 var pattern = new RegExp("(^|\\s)" + classname + "(\\s|$)");
153 var matches= [];
154 for (var i = 0, j = 0, n = elements.length; i < n; i++) {
155 var el= elements[i];
156 if (el.className && pattern.test(el.className)) {
157 // matches.push(el);
158 matches[j] = el;
159 j++;
160 }
161 }
162 return matches;
163 };
164} // end if
165
166
167/* ............................................................ */
168/* unquoting/unescaping filenames */
169
170/**#@+
171 * @constant
172 */
173var escCodeRe = /\\([^0-7]|[0-7]{1,3})/g;
174var octEscRe = /^[0-7]{1,3}$/;
175var maybeQuotedRe = /^\"(.*)\"$/;
176/**#@-*/
177
178/**
179 * unquote maybe C-quoted filename (as used by git, i.e. it is
180 * in double quotes '"' if there is any escape character used)
181 * e.g. 'aa' -> 'aa', '"a\ta"' -> 'a a'
182 *
183 * @param {String} str: git-quoted string
184 * @returns {String} Unquoted and unescaped string
185 *
186 * @globals escCodeRe, octEscRe, maybeQuotedRe
187 */
188function unquote(str) {
189 function unq(seq) {
190 var es = {
191 // character escape codes, aka escape sequences (from C)
192 // replacements are to some extent JavaScript specific
193 t: "\t", // tab (HT, TAB)
194 n: "\n", // newline (NL)
195 r: "\r", // return (CR)
196 f: "\f", // form feed (FF)
197 b: "\b", // backspace (BS)
198 a: "\x07", // alarm (bell) (BEL)
199 e: "\x1B", // escape (ESC)
200 v: "\v" // vertical tab (VT)
201 };
202
203 if (seq.search(octEscRe) !== -1) {
204 // octal char sequence
205 return String.fromCharCode(parseInt(seq, 8));
206 } else if (seq in es) {
207 // C escape sequence, aka character escape code
208 return es[seq];
209 }
210 // quoted ordinary character
211 return seq;
212 }
213
214 var match = str.match(maybeQuotedRe);
215 if (match) {
216 str = match[1];
217 // perhaps str = eval('"'+str+'"'); would be enough?
218 str = str.replace(escCodeRe,
219 function (substr, p1, offset, s) { return unq(p1); });
220 }
221 return str;
222}
223
224/* end of common-lib.js */