libs/web/htdocs/luci-static/resources/cbi.js

   1 /*
   2         LuCI - Lua Configuration Interface
   3
   4         Copyright 2008 Steven Barth <steven@midlink.org>
   5         Copyright 2008-2010 Jo-Philipp Wich <xm@subsignal.org>
   6
   7         Licensed under the Apache License, Version 2.0 (the "License");
   8         you may not use this file except in compliance with the License.
   9         You may obtain a copy of the License at
  10
  11         http://www.apache.org/licenses/LICENSE-2.0
  12 */
  13
  14 var cbi_d = [];
  15 var cbi_t = [];
  16 var cbi_c = [];
  17
  18 var cbi_validators = {
  19
  20         'integer': function(v)
  21         {
  22                 return (v.match(/^-?[0-9]+$/) != null);
  23         },
  24
  25         'uinteger': function(v)
  26         {
  27                 return (cbi_validators.integer(v) && (v >= 0));
  28         },
  29
  30         'float': function(v)
  31         {
  32                 return !isNaN(parseFloat(v));
  33         },
  34
  35         'ufloat': function(v)
  36         {
  37                 return (cbi_validators['float'](v) && (v >= 0));
  38         },
  39
  40         'ipaddr': function(v)
  41         {
  42                 return cbi_validators.ip4addr(v) || cbi_validators.ip6addr(v);
  43         },
  44
  45         'ip4addr': function(v)
  46         {
  47                 if( v.match(/^(\d+)\.(\d+)\.(\d+)\.(\d+)(\/(\d+))?$/) )
  48                 {
  49                         return (RegExp.$1 >= 0) && (RegExp.$1 <= 255) &&
  50                                (RegExp.$2 >= 0) && (RegExp.$2 <= 255) &&
  51                                (RegExp.$3 >= 0) && (RegExp.$3 <= 255) &&
  52                                (RegExp.$4 >= 0) && (RegExp.$4 <= 255) &&
  53                                (!RegExp.$5 || ((RegExp.$6 >= 0) && (RegExp.$6 <= 32)))
  54                         ;
  55                 }
  56
  57                 return false;
  58         },
  59
  60         'ip6addr': function(v)
  61         {
  62                 if( v.match(/^([a-fA-F0-9:.]+)(\/(\d+))?$/) )
  63                 {
  64                         if( !RegExp.$2 || ((RegExp.$3 >= 0) && (RegExp.$3 <= 128)) )
  65                         {
  66                                 var addr = RegExp.$1;
  67
  68                                 if( addr == '::' )
  69                                 {
  70                                         return true;
  71                                 }
  72
  73                                 if( addr.indexOf('.') > 0 )
  74                                 {
  75                                         var off = addr.lastIndexOf(':');
  76
  77                                         if( !(off && cbi_validators.ip4addr(addr.substr(off+1))) )
  78                                                 return false;
  79
  80                                         addr = addr.substr(0, off) + ':0:0';
  81                                 }
  82
  83                                 if( addr.indexOf('::') >= 0 )
  84                                 {
  85                                         var colons = 0;
  86                                         var fill = '0';
  87
  88                                         for( var i = 1; i < (addr.length-1); i++ )
  89                                                 if( addr.charAt(i) == ':' )
  90                                                         colons++;
  91
  92                                         if( colons > 7 )
  93                                                 return false;
  94
  95                                         for( var i = 0; i < (7 - colons); i++ )
  96                                                 fill += ':0';
  97
  98                                         if (addr.match(/^(.*?)::(.*?)$/))
  99                                                 addr = (RegExp.$1 ? RegExp.$1 + ':' : '') + fill +
 100                                                        (RegExp.$2 ? ':' + RegExp.$2 : '');
 101                                 }
 102
 103                                 return (addr.match(/^(?:[a-fA-F0-9]{1,4}:){7}[a-fA-F0-9]{1,4}$/) != null);
 104                         }
 105                 }
 106
 107                 return false;
 108         },
 109
 110         'port': function(v)
 111         {
 112                 return cbi_validators.integer(v) && (v >= 0) && (v <= 65535);
 113         },
 114
 115         'portrange': function(v)
 116         {
 117                 if( v.match(/^(\d+)-(\d+)$/) )
 118                 {
 119                         var p1 = RegExp.$1;
 120                         var p2 = RegExp.$2;
 121
 122                         return cbi_validators.port(p1) &&
 123                                cbi_validators.port(p2) &&
 124                                (parseInt(p1) <= parseInt(p2))
 125                         ;
 126                 }
 127                 else
 128                 {
 129                         return cbi_validators.port(v);
 130                 }
 131         },
 132
 133         'macaddr': function(v)
 134         {
 135                 return (v.match(/^([a-fA-F0-9]{2}:){5}[a-fA-F0-9]{2}$/) != null);
 136         },
 137
 138         'host': function(v)
 139         {
 140                 return cbi_validators.hostname(v) || cbi_validators.ipaddr(v);
 141         },
 142
 143         'hostname': function(v)
 144         {
 145                 return (v.match(/^[a-zA-Z_][a-zA-Z0-9_\-.]*$/) != null);
 146         },
 147
 148         'wpakey': function(v)
 149         {
 150                 if( v.length == 64 )
 151                         return (v.match(/^[a-fA-F0-9]{64}$/) != null);
 152                 else
 153                         return (v.length >= 8) && (v.length <= 63);
 154         },
 155
 156         'wepkey': function(v)
 157         {
 158                 if( v.substr(0,2) == 's:' )
 159                         v = v.substr(2);
 160
 161                 if( (v.length == 10) || (v.length == 26) )
 162                         return (v.match(/^[a-fA-F0-9]{10,26}$/) != null);
 163                 else
 164                         return (v.length == 5) || (v.length == 13);
 165         },
 166
 167         'uciname': function(v)
 168         {
 169                 return (v.match(/^[a-zA-Z0-9_]+$/) != null);
 170         },
 171
 172         'range': function(v, args)
 173         {
 174                 var min = parseInt(args[0]);
 175                 var max = parseInt(args[1]);
 176                 var val = parseInt(v);
 177
 178                 if (!isNaN(min) && !isNaN(max) && !isNaN(val))
 179                         return ((val >= min) && (val <= max));
 180
 181                 return false;
 182         }
 183 };
 184
 185
 186 function cbi_d_add(field, dep, next) {
 187         var obj = document.getElementById(field);
 188         if (obj) {
 189                 var entry
 190                 for (var i=0; i<cbi_d.length; i++) {
 191                         if (cbi_d[i].id == field) {
 192                                 entry = cbi_d[i];
 193                                 break;
 194                         }
 195                 }
 196                 if (!entry) {
 197                         entry = {
 198                                 "node": obj,
 199                                 "id": field,
 200                                 "parent": obj.parentNode.id,
 201                                 "next": next,
 202                                 "deps": []
 203                         };
 204                         cbi_d.unshift(entry);
 205                 }
 206                 entry.deps.push(dep)
 207         }
 208 }
 209
 210 function cbi_d_checkvalue(target, ref) {
 211         var t = document.getElementById(target);
 212         var value;
 213
 214         if (!t) {
 215                 var tl = document.getElementsByName(target);
 216
 217                 if( tl.length > 0 && tl[0].type == 'radio' )
 218                         for( var i = 0; i < tl.length; i++ )
 219                                 if( tl[i].checked ) {
 220                                         value = tl[i].value;
 221                                         break;
 222                                 }
 223
 224                 value = value ? value : "";
 225         } else if (!t.value) {
 226                 value = "";
 227         } else {
 228                 value = t.value;
 229
 230                 if (t.type == "checkbox") {
 231                         value = t.checked ? value : "";
 232                 }
 233         }
 234
 235         return (value == ref)
 236 }
 237
 238 function cbi_d_check(deps) {
 239         var reverse;
 240         var def = false;
 241         for (var i=0; i<deps.length; i++) {
 242                 var istat = true;
 243                 reverse = false;
 244                 for (var j in deps[i]) {
 245                         if (j == "!reverse") {
 246                                 reverse = true;
 247                         } else if (j == "!default") {
 248                                 def = true;
 249                                 istat = false;
 250                         } else {
 251                                 istat = (istat && cbi_d_checkvalue(j, deps[i][j]))
 252                         }
 253                 }
 254                 if (istat) {
 255                         return !reverse;
 256                 }
 257         }
 258         return def;
 259 }
 260
 261 function cbi_d_update() {
 262         var state = false;
 263         for (var i=0; i<cbi_d.length; i++) {
 264                 var entry = cbi_d[i];
 265                 var next  = document.getElementById(entry.next)
 266                 var node  = document.getElementById(entry.id)
 267                 var parent = document.getElementById(entry.parent)
 268
 269                 if (node && node.parentNode && !cbi_d_check(entry.deps)) {
 270                         node.parentNode.removeChild(node);
 271                         state = true;
 272                         if( entry.parent )
 273                                 cbi_c[entry.parent]--;
 274                 } else if ((!node || !node.parentNode) && cbi_d_check(entry.deps)) {
 275                         if (!next) {
 276                                 parent.appendChild(entry.node);
 277                         } else {
 278                                 next.parentNode.insertBefore(entry.node, next);
 279                         }
 280                         state = true;
 281                         if( entry.parent )
 282                                 cbi_c[entry.parent]++;
 283                 }
 284         }
 285
 286         if (entry && entry.parent) {
 287                 cbi_t_update();
 288         }
 289
 290         if (state) {
 291                 cbi_d_update();
 292         }
 293 }
 294
 295 function cbi_bind(obj, type, callback, mode) {
 296         if (!obj.addEventListener) {
 297                 obj.attachEvent('on' + type,
 298                         function(){
 299                                 var e = window.event;
 300
 301                                 if (!e.target && e.srcElement)
 302                                         e.target = e.srcElement;
 303
 304                                 return !!callback(e);
 305                         }
 306                 );
 307         } else {
 308                 obj.addEventListener(type, callback, !!mode);
 309         }
 310         return obj;
 311 }
 312
 313 function cbi_combobox(id, values, def, man) {
 314         var selid = "cbi.combobox." + id;
 315         if (document.getElementById(selid)) {
 316                 return
 317         }
 318
 319         var obj = document.getElementById(id)
 320         var sel = document.createElement("select");
 321                 sel.id = selid;
 322                 sel.className = 'cbi-input-select';
 323
 324         if (obj.nextSibling) {
 325                 obj.parentNode.insertBefore(sel, obj.nextSibling);
 326         } else {
 327                 obj.parentNode.appendChild(sel);
 328         }
 329
 330         var dt = obj.getAttribute('cbi_datatype');
 331         var op = obj.getAttribute('cbi_optional');
 332
 333         if (dt)
 334                 cbi_validate_field(sel, op == 'true', dt);
 335
 336         if (!values[obj.value]) {
 337                 if (obj.value == "") {
 338                         var optdef = document.createElement("option");
 339                         optdef.value = "";
 340                         optdef.appendChild(document.createTextNode(def));
 341                         sel.appendChild(optdef);
 342                 } else {
 343                         var opt = document.createElement("option");
 344                         opt.value = obj.value;
 345                         opt.selected = "selected";
 346                         opt.appendChild(document.createTextNode(obj.value));
 347                         sel.appendChild(opt);
 348                 }
 349         }
 350
 351         for (var i in values) {
 352                 var opt = document.createElement("option");
 353                 opt.value = i;
 354
 355                 if (obj.value == i) {
 356                         opt.selected = "selected";
 357                 }
 358
 359                 opt.appendChild(document.createTextNode(values[i]));
 360                 sel.appendChild(opt);
 361         }
 362
 363         var optman = document.createElement("option");
 364         optman.value = "";
 365         optman.appendChild(document.createTextNode(man));
 366         sel.appendChild(optman);
 367
 368         obj.style.display = "none";
 369
 370         cbi_bind(sel, "change", function() {
 371                 if (sel.selectedIndex == sel.options.length - 1) {
 372                         obj.style.display = "inline";
 373                         sel.parentNode.removeChild(sel);
 374                         obj.focus();
 375                 } else {
 376                         obj.value = sel.options[sel.selectedIndex].value;
 377                 }
 378
 379                 try {
 380                         cbi_d_update();
 381                 } catch (e) {
 382                         //Do nothing
 383                 }
 384         })
 385 }
 386
 387 function cbi_combobox_init(id, values, def, man) {
 388         var obj = document.getElementById(id);
 389         cbi_bind(obj, "blur", function() {
 390                 cbi_combobox(id, values, def, man)
 391         });
 392         cbi_combobox(id, values, def, man);
 393 }
 394
 395 function cbi_filebrowser(id, url, defpath) {
 396         var field   = document.getElementById(id);
 397         var browser = window.open(
 398                 url + ( field.value || defpath || '' ) + '?field=' + id,
 399                 "luci_filebrowser", "width=300,height=400,left=100,top=200,scrollbars=yes"
 400         );
 401
 402         browser.focus();
 403 }
 404
 405 function cbi_dynlist_init(name)
 406 {
 407         function cbi_dynlist_renumber(e)
 408         {
 409                 var count = 1;
 410                 var childs = e.parentNode.childNodes;
 411
 412                 for( var i = 0; i < childs.length; i++ )
 413                         if( childs[i].name == name )
 414                                 childs[i].id = name + '.' + (count++);
 415
 416                 e.focus();
 417         }
 418
 419         function cbi_dynlist_keypress(ev)
 420         {
 421                 ev = ev ? ev : window.event;
 422
 423                 var se = ev.target ? ev.target : ev.srcElement;
 424
 425                 if (se.nodeType == 3)
 426                         se = se.parentNode;
 427
 428                 switch (ev.keyCode)
 429                 {
 430                         /* backspace, delete */
 431                         case 8:
 432                         case 46:
 433                                 if (se.value.length == 0)
 434                                 {
 435                                         if (ev.preventDefault)
 436                                                 ev.preventDefault();
 437
 438                                         return false;
 439                                 }
 440
 441                                 return true;
 442
 443                         /* enter, arrow up, arrow down */
 444                         case 13:
 445                         case 38:
 446                         case 40:
 447                                 if (ev.preventDefault)
 448                                         ev.preventDefault();
 449
 450                                 return false;
 451                 }
 452
 453                 return true;
 454         }
 455
 456         function cbi_dynlist_keydown(ev)
 457         {
 458                 ev = ev ? ev : window.event;
 459
 460                 var se = ev.target ? ev.target : ev.srcElement;
 461
 462                 if (se.nodeType == 3)
 463                         se = se.parentNode;
 464
 465                 var prev = se.previousSibling;
 466                 while (prev && prev.name != name)
 467                         prev = prev.previousSibling;
 468
 469                 var next = se.nextSibling;
 470                 while (next && next.name != name)
 471                         next = next.nextSibling;
 472
 473                 switch (ev.keyCode)
 474                 {
 475                         /* backspace, delete */
 476                         case 8:
 477                         case 46:
 478                                 var jump = (ev.keyCode == 8)
 479                                         ? (prev || next) : (next || prev);
 480
 481                                 if (se.value.length == 0 && jump)
 482                                 {
 483                                         se.parentNode.removeChild(se.nextSibling);
 484                                         se.parentNode.removeChild(se);
 485
 486                                         cbi_dynlist_renumber(jump);
 487
 488                                         if (ev.preventDefault)
 489                                                 ev.preventDefault();
 490
 491                                         return false;
 492                                 }
 493
 494                                 break;
 495
 496                         /* enter */
 497                         case 13:
 498                                 var n = document.createElement('input');
 499                                         n.name       = se.name;
 500                                         n.type       = se.type;
 501
 502                                 cbi_bind(n, 'keydown',  cbi_dynlist_keydown);
 503                                 cbi_bind(n, 'keypress', cbi_dynlist_keypress);
 504
 505                                 if (next)
 506                                 {
 507                                         se.parentNode.insertBefore(n, next);
 508                                         se.parentNode.insertBefore(document.createElement('br'), next);
 509                                 }
 510                                 else
 511                                 {
 512                                         se.parentNode.appendChild(n);
 513                                         se.parentNode.appendChild(document.createElement('br'));
 514                                 }
 515
 516                                 var dt = se.getAttribute('cbi_datatype');
 517                                 var op = se.getAttribute('cbi_optional') == 'true';
 518
 519                                 if (dt)
 520                                         cbi_validate_field(n, op, dt);
 521
 522                                 cbi_dynlist_renumber(n);
 523                                 break;
 524
 525                         /* arrow up */
 526                         case 38:
 527                                 if (prev)
 528                                         prev.focus();
 529
 530                                 break;
 531
 532                         /* arrow down */
 533                         case 40:
 534                                 if (next)
 535                                         next.focus();
 536
 537                                 break;
 538                 }
 539
 540                 return true;
 541         }
 542
 543         var inputs = document.getElementsByName(name);
 544         for( var i = 0; i < inputs.length; i++ )
 545         {
 546                 cbi_bind(inputs[i], 'keydown',  cbi_dynlist_keydown);
 547                 cbi_bind(inputs[i], 'keypress', cbi_dynlist_keypress);
 548         }
 549 }
 550
 551 //Hijacks the CBI form to send via XHR (requires Prototype)
 552 function cbi_hijack_forms(layer, win, fail, load) {
 553         var forms = layer.getElementsByTagName('form');
 554         for (var i=0; i<forms.length; i++) {
 555                 $(forms[i]).observe('submit', function(event) {
 556                         // Prevent the form from also submitting the regular way
 557                         event.stop();
 558
 559                         // Submit via XHR
 560                         event.element().request({
 561                                 onSuccess: win,
 562                                 onFailure: fail
 563                         });
 564
 565                         if (load) {
 566                                 load();
 567                         }
 568                 });
 569         }
 570 }
 571
 572
 573 function cbi_t_add(section, tab) {
 574         var t = document.getElementById('tab.' + section + '.' + tab);
 575         var c = document.getElementById('container.' + section + '.' + tab);
 576
 577         if( t && c ) {
 578                 cbi_t[section] = (cbi_t[section] || [ ]);
 579                 cbi_t[section][tab] = { 'tab': t, 'container': c, 'cid': c.id };
 580         }
 581 }
 582
 583 function cbi_t_switch(section, tab) {
 584         if( cbi_t[section] && cbi_t[section][tab] ) {
 585                 var o = cbi_t[section][tab];
 586                 var h = document.getElementById('tab.' + section);
 587                 for( var tid in cbi_t[section] ) {
 588                         var o2 = cbi_t[section][tid];
 589                         if( o.tab.id != o2.tab.id ) {
 590                                 o2.tab.className = o2.tab.className.replace(/(^| )cbi-tab( |$)/, " cbi-tab-disabled ");
 591                                 o2.container.style.display = 'none';
 592                         }
 593                         else {
 594                                 if(h) h.value = tab;
 595                                 o2.tab.className = o2.tab.className.replace(/(^| )cbi-tab-disabled( |$)/, " cbi-tab ");
 596                                 o2.container.style.display = 'block';
 597                         }
 598                 }
 599         }
 600         return false
 601 }
 602
 603 function cbi_t_update() {
 604         var hl_tabs = [ ];
 605
 606         for( var sid in cbi_t )
 607                 for( var tid in cbi_t[sid] )
 608                         if( cbi_c[cbi_t[sid][tid].cid] == 0 ) {
 609                                 cbi_t[sid][tid].tab.style.display = 'none';
 610                         }
 611                         else if( cbi_t[sid][tid].tab && cbi_t[sid][tid].tab.style.display == 'none' ) {
 612                                 cbi_t[sid][tid].tab.style.display = '';
 613
 614                                 var t = cbi_t[sid][tid].tab;
 615                                 t.className += ' cbi-tab-highlighted';
 616                                 hl_tabs.push(t);
 617                         }
 618
 619         if( hl_tabs.length > 0 )
 620                 window.setTimeout(function() {
 621                         for( var i = 0; i < hl_tabs.length; i++ )
 622                                 hl_tabs[i].className = hl_tabs[i].className.replace(/ cbi-tab-highlighted/g, '');
 623                 }, 750);
 624 }
 625
 626
 627 function cbi_validate_form(form, errmsg)
 628 {
 629         /* if triggered by a section removal or addition, don't validate */
 630         if( form.cbi_state == 'add-section' || form.cbi_state == 'del-section' )
 631                 return true;
 632
 633         if( form.cbi_validators )
 634         {
 635                 for( var i = 0; i < form.cbi_validators.length; i++ )
 636                 {
 637                         var validator = form.cbi_validators[i];
 638                         if( !validator() && errmsg )
 639                         {
 640                                 alert(errmsg);
 641                                 return false;
 642                         }
 643                 }
 644         }
 645
 646         return true;
 647 }
 648
 649 function cbi_validate_reset(form)
 650 {
 651         window.setTimeout(
 652                 function() { cbi_validate_form(form, null) }, 100
 653         );
 654
 655         return true;
 656 }
 657
 658 function cbi_validate_field(cbid, optional, type)
 659 {
 660         var field = (typeof cbid == "string") ? document.getElementById(cbid) : cbid;
 661         var vargs;
 662
 663         if( type.match(/^(\w+)\(([^\(\)]+)\)/) )
 664         {
 665                 type  = RegExp.$1;
 666                 vargs = RegExp.$2.split(/\s*,\s*/);
 667         }
 668
 669         var vldcb = cbi_validators[type];
 670
 671         if( field && vldcb )
 672         {
 673                 var validator = function()
 674                 {
 675                         // is not detached
 676                         if( field.form )
 677                         {
 678                                 field.className = field.className.replace(/ cbi-input-invalid/g, '');
 679
 680                                 // validate value
 681                                 var value = (field.options && field.options.selectedIndex > -1)
 682                                         ? field.options[field.options.selectedIndex].value : field.value;
 683
 684                                 if( !(((value.length == 0) && optional) || vldcb(value, vargs)) )
 685                                 {
 686                                         // invalid
 687                                         field.className += ' cbi-input-invalid';
 688                                         return false;
 689                                 }
 690                         }
 691
 692                         return true;
 693                 };
 694
 695                 if( ! field.form.cbi_validators )
 696                         field.form.cbi_validators = [ ];
 697
 698                 field.form.cbi_validators.push(validator);
 699
 700                 cbi_bind(field, "blur",  validator);
 701                 cbi_bind(field, "keyup", validator);
 702
 703                 if (field.nodeName == 'SELECT')
 704                 {
 705                         cbi_bind(field, "change", validator);
 706                         cbi_bind(field, "click",  validator);
 707                 }
 708
 709                 field.setAttribute("cbi_validate", validator);
 710                 field.setAttribute("cbi_datatype", type);
 711                 field.setAttribute("cbi_optional", (!!optional).toString());
 712
 713                 validator();
 714
 715                 var fcbox = document.getElementById('cbi.combobox.' + field.id);
 716                 if (fcbox)
 717                         cbi_validate_field(fcbox, optional, type);
 718         }
 719 }
 720
 721 function cbi_row_swap(elem, up, store)
 722 {
 723         var tr = elem.parentNode;
 724         while (tr && tr.nodeName != 'tr')
 725                 tr = tr.parentNode;
 726
 727         var table = tr.parentNode;
 728         while (table && table.nodeName != 'table')
 729                 table = table.parentNode;
 730
 731         var s = up ? 3 : 2;
 732         var e = up ? table.rows.length : table.rows.length - 1;
 733
 734         for (var idx = s; idx < e; idx++)
 735         {
 736                 if (table.rows[idx] == tr)
 737                 {
 738                         if (up)
 739                                 tr.parentNode.insertBefore(table.rows[idx], table.rows[idx-1]);
 740                         else
 741                                 tr.parentNode.insertBefore(table.rows[idx+1], table.rows[idx]);
 742
 743                         break;
 744                 }
 745         }
 746
 747         var ids = [ ];
 748         for (idx = 2; idx < table.rows.length; idx++)
 749         {
 750                 table.rows[idx].className = table.rows[idx].className.replace(
 751                         /cbi-rowstyle-[12]/, 'cbi-rowstyle-' + (1 + (idx % 2))
 752                 );
 753
 754                 if (table.rows[idx].id && table.rows[idx].id.match(/-([^\-]+)$/) )
 755                         ids.push(RegExp.$1);
 756         }
 757
 758         var input = document.getElementById(store);
 759         if (input)
 760                 input.value = ids.join(' ');
 761
 762         return false;
 763 }
 764
 765 if( ! String.serialize )
 766         String.serialize = function(o)
 767         {
 768                 switch(typeof(o))
 769                 {
 770                         case 'object':
 771                                 // null
 772                                 if( o == null )
 773                                 {
 774                                         return 'null';
 775                                 }
 776
 777                                 // array
 778                                 else if( o.length )
 779                                 {
 780                                         var i, s = '';
 781
 782                                         for( var i = 0; i < o.length; i++ )
 783                                                 s += (s ? ', ' : '') + String.serialize(o[i]);
 784
 785                                         return '[ ' + s + ' ]';
 786                                 }
 787
 788                                 // object
 789                                 else
 790                                 {
 791                                         var k, s = '';
 792
 793                                         for( k in o )
 794                                                 s += (s ? ', ' : '') + k + ': ' + String.serialize(o[k]);
 795
 796                                         return '{ ' + s + ' }';
 797                                 }
 798
 799                                 break;
 800
 801                         case 'string':
 802                                 // complex string
 803                                 if( o.match(/[^a-zA-Z0-9_,.: -]/) )
 804                                         return 'decodeURIComponent("' + encodeURIComponent(o) + '")';
 805
 806                                 // simple string
 807                                 else
 808                                         return '"' + o + '"';
 809
 810                                 break;
 811
 812                         default:
 813                                 return o.toString();
 814                 }
 815         }
 816
 817
 818 if( ! String.format )
 819         String.format = function()
 820         {
 821                 if (!arguments || arguments.length < 1 || !RegExp)
 822                         return;
 823
 824                 var html_esc = [/&/g, '&#38;', /"/g, '&#34;', /'/g, '&#39;', /</g, '&#60;', />/g, '&#62;'];
 825                 var quot_esc = [/"/g, '&#34;', /'/g, '&#39;'];
 826
 827                 function esc(s, r) {
 828                         for( var i = 0; i < r.length; i += 2 )
 829                                 s = s.replace(r[i], r[i+1]);
 830                         return s;
 831                 }
 832
 833                 var str = arguments[0];
 834                 var out = '';
 835                 var re = /^(([^%]*)%('.|0|\x20)?(-)?(\d+)?(\.\d+)?(%|b|c|d|u|f|o|s|x|X|q|h|j|t))/;
 836                 var a = b = [], numSubstitutions = 0, numMatches = 0;
 837
 838                 while( a = re.exec(str) )
 839                 {
 840                         var m = a[1];
 841                         var leftpart = a[2], pPad = a[3], pJustify = a[4], pMinLength = a[5];
 842                         var pPrecision = a[6], pType = a[7];
 843
 844                         numMatches++;
 845
 846                         if (pType == '%')
 847                         {
 848                                 subst = '%';
 849                         }
 850                         else
 851                         {
 852                                 if (numSubstitutions++ < arguments.length)
 853                                 {
 854                                         var param = arguments[numSubstitutions];
 855
 856                                         var pad = '';
 857                                         if (pPad && pPad.substr(0,1) == "'")
 858                                                 pad = leftpart.substr(1,1);
 859                                         else if (pPad)
 860                                                 pad = pPad;
 861
 862                                         var justifyRight = true;
 863                                         if (pJustify && pJustify === "-")
 864                                                 justifyRight = false;
 865
 866                                         var minLength = -1;
 867                                         if (pMinLength)
 868                                                 minLength = parseInt(pMinLength);
 869
 870                                         var precision = -1;
 871                                         if (pPrecision && pType == 'f')
 872                                                 precision = parseInt(pPrecision.substring(1));
 873
 874                                         var subst = param;
 875
 876                                         switch(pType)
 877                                         {
 878                                                 case 'b':
 879                                                         subst = (parseInt(param) || 0).toString(2);
 880                                                         break;
 881
 882                                                 case 'c':
 883                                                         subst = String.fromCharCode(parseInt(param) || 0);
 884                                                         break;
 885
 886                                                 case 'd':
 887                                                         subst = (parseInt(param) || 0);
 888                                                         break;
 889
 890                                                 case 'u':
 891                                                         subst = Math.abs(parseInt(param) || 0);
 892                                                         break;
 893
 894                                                 case 'f':
 895                                                         subst = (precision > -1)
 896                                                                 ? ((parseFloat(param) || 0.0)).toFixed(precision)
 897                                                                 : (parseFloat(param) || 0.0);
 898                                                         break;
 899
 900                                                 case 'o':
 901                                                         subst = (parseInt(param) || 0).toString(8);
 902                                                         break;
 903
 904                                                 case 's':
 905                                                         subst = param;
 906                                                         break;
 907
 908                                                 case 'x':
 909                                                         subst = ('' + (parseInt(param) || 0).toString(16)).toLowerCase();
 910                                                         break;
 911
 912                                                 case 'X':
 913                                                         subst = ('' + (parseInt(param) || 0).toString(16)).toUpperCase();
 914                                                         break;
 915
 916                                                 case 'h':
 917                                                         subst = esc(param, html_esc);
 918                                                         break;
 919
 920                                                 case 'q':
 921                                                         subst = esc(param, quot_esc);
 922                                                         break;
 923
 924                                                 case 'j':
 925                                                         subst = String.serialize(param);
 926                                                         break;
 927
 928                                                 case 't':
 929                                                         var td = 0;
 930                                                         var th = 0;
 931                                                         var tm = 0;
 932                                                         var ts = (param || 0);
 933
 934                                                         if (ts > 60) {
 935                                                                 tm = Math.floor(ts / 60);
 936                                                                 ts = (ts % 60);
 937                                                         }
 938
 939                                                         if (tm > 60) {
 940                                                                 th = Math.floor(tm / 60);
 941                                                                 tm = (tm % 60);
 942                                                         }
 943
 944                                                         if (th > 24) {
 945                                                                 td = Math.floor(th / 24);
 946                                                                 th = (th % 24);
 947                                                         }
 948
 949                                                         subst = (td > 0)
 950                                                                 ? String.format('%dd %dh %dm %ds', td, th, tm, ts)
 951                                                                 : String.format('%dh %dm %ds', th, tm, ts);
 952
 953                                                         break;
 954                                         }
 955                                 }
 956                         }
 957
 958                         out += leftpart + subst;
 959                         str = str.substr(m.length);
 960                 }
 961
 962                 return out + str;
 963         }