70
69
* it will automatically be URL-encoded.
71
70
* \param onclick Optional string. Will be set as the "onclick" attribute
72
71
* of the "a" element.
73
* \param dontencode Optional boolean. If true, will not encode the href.
74
* if including query strings, you must set this to true and use build_url
75
* to escape the URI correctly.
76
72
* \return DOM Element object.
78
function dom_make_link_elem(tagname, text, title, href, onclick, dontencode)
74
function dom_make_link_elem(tagname, text, title, href, onclick)
80
76
if (text == null) text = "";
81
77
if (href == null) href = "";
82
78
var elem = document.createElement(tagname);
83
79
var link = document.createElement("a");
84
if (dontencode != true)
85
href = urlencode_path(href);
86
link.setAttribute("href", href);
80
link.setAttribute("href", encodeURI(href));
88
82
link.setAttribute("title", title);
89
83
if (onclick != null)
99
93
function dom_make_img(src, width, height, title, alt)
101
95
var img = document.createElement("img");
102
img.setAttribute("src", urlencode_path(src));
96
img.setAttribute("src", src);
103
97
if (width != null)
104
98
img.setAttribute("width", width);
105
99
if (height != null)
155
149
* args is never null, though it may be empty.
157
151
* All strings are decoded/unescaped. Reserved characters
158
* (; , / ? : @ & = + * $) are not decoded except in args and path.
152
* (; , / ? : @ & = + * $) are not decoded except in args.
160
154
* \param url String. A URL. To read from the current browser window, use
161
155
* window.location.href.
310
307
url += ":" + obj.server_port.toString();
311
308
if (("path" in obj) && obj.path != null)
313
var path = urlencode_path(obj.path.toString());
314
if (url.length > 0 && path.length > 0 && path.charAt(0) != "/")
310
var path = obj.path.toString();
311
if (url.length > 0 && path.length > 0 && path[0] != "/")
315
312
path = "/" + path;
318
315
if (("query_string" in obj) && obj.query_string != null)
319
query_string = encodeURI(obj.query_string.toString());
316
query_string = obj.query_string.toString();
320
317
else if (("args" in obj) && obj.args != null)
321
318
query_string = make_query_string(obj.args);
323
if (query_string != "" && query_string != null)
320
if (query_string != null)
324
321
url += "?" + query_string;
329
/** URL-encodes a path. This is a special case of URL encoding as all
330
* characters *except* the slash must be encoded.
332
function urlencode_path(path)
334
/* Split up the path, URLEncode each segment with encodeURIComponent,
337
var split = path.split('/');
338
for (var i=0; i<split.length; i++)
339
split[i] = encodeURIComponent(split[i]);
340
path = path_join.apply(null, split);
341
if (split[0] == "" && split.length > 1) path = "/" + path;
345
/** Writes a JSONable object to the cookie under a particular key
346
* (JSON encoded and URL encoded).
348
function write_cookie(key, value)
350
var sendstr = encodeURIComponent(key) + "="
351
+ encodeURIComponent(JSON.stringify(value))
352
+ "; path=" + urlencode_path(root_dir);
353
/* This actually just assigns to the key, not replacing the whole cookie
354
* as it appears to. */
355
document.cookie = sendstr;
357
/** Reads a cookie which has a JSONable object encoded as its value.
358
* Returns the object, parsed from JSON.
360
function read_cookie(key)
362
var cookies = document.cookie.split(";");
363
var checkstart = encodeURIComponent(key) + "=";
364
var checklen = checkstart.length;
365
for (var i=0; i<cookies.length; i++)
367
var cookie = cookies[i];
368
while (cookie[0] == ' ')
369
cookie = cookie.substr(1);
370
if (cookie.substr(0, checklen) == checkstart)
372
var valstr = cookie.substr(checklen);
373
valstr = decodeURIComponent(valstr);
374
return JSON.parse(valstr);
323
return encodeURI(url);
379
326
/** Given an argument map, as output in the args parameter of the return of
504
451
return path_join(root_dir, path);
507
/** Shorthand for make_path(path_join(app, ...))
508
* Creates an absolute path for a given path within a given app.
510
function app_path(app /*,...*/)
512
return make_path(path_join.apply(null, arguments));
515
/** Generates an absolute URL to a public application
517
function public_app_path(app /*,...*/)
519
return location.protocol + "//" + public_host
520
+ make_path(path_join.apply(null, arguments));
523
454
/** Given a path, gets the "basename" (the last path segment).
525
456
function path_basename(path)
547
478
return JSON.stringify(str);
550
/** Removes all occurences of a value from an array.
552
Array.prototype.removeall = function(val)
557
for (i=0; i<arr.length; i++)
560
if (arr[i] != val) j++;
565
/** Shallow-clones an object */
566
function shallow_clone_object(obj)
574
/** Returns a new XMLHttpRequest object, in a somewhat browser-agnostic
577
function new_xmlhttprequest()
582
return new XMLHttpRequest();
586
/* Internet Explorer */
589
return new ActiveXObject("Msxml2.XMLHTTP");
595
return new ActiveXObject("Microsoft.XMLHTTP");
599
throw("Your browser does not support AJAX. "
600
+ "IVLE requires a modern browser.");
606
/** Makes an asynchronous XMLHttpRequest call to the server.
607
* Sends the XMLHttpRequest object containing the completed response to a
608
* specified callback function.
481
/** Makes an XMLHttpRequest call to the server. Waits (synchronously) for a
482
* response, and returns an XMLHttpRequest object containing the completed
610
* \param callback A callback function. Will be called when the response is
611
* complete. Passed 1 parameter, an XMLHttpRequest object containing the
612
* completed response.
613
485
* \param app IVLE app to call (such as "fileservice").
614
486
* \param path URL path to make the request to, within the application.
615
487
* \param args Argument object, as described in parse_url and friends.
617
489
* \param content_type String, optional. Only applies if method is "POST".
618
490
* May be "application/x-www-form-urlencoded" or "multipart/form-data".
619
491
* Defaults to "application/x-www-form-urlencoded".
492
* \return An XMLHttpRequest object containing the completed response.
621
function ajax_call(callback, app, path, args, method, content_type)
494
function ajax_call(app, path, args, method, content_type)
623
496
if (content_type != "multipart/form-data")
624
497
content_type = "application/x-www-form-urlencoded";
625
path = app_path(app, path);
498
path = make_path(path_join(app, path));
627
500
/* A random string, for multipart/form-data
628
501
* (This is not checked against anywhere else, it is solely defined and
629
502
* used within this function) */
630
503
var boundary = "48234n334nu7n4n2ynonjn234t683jyh80j";
631
var xhr = new_xmlhttprequest();
632
xhr.onreadystatechange = function()
634
if (xhr.readyState == 4)
504
var xhr = new XMLHttpRequest();
639
505
if (method == "GET")
641
507
/* GET sends the args in the URL */
642
508
url = build_url({"path": path, "args": args});
643
/* open's 3rd argument = true -> asynchronous */
644
xhr.open(method, url, true);
509
/* open's 3rd argument = false -> SYNCHRONOUS (wait for response)
510
* (No need for a callback function) */
511
xhr.open(method, url, false);
649
516
/* POST sends the args in application/x-www-form-urlencoded */
650
517
url = encodeURI(path);
651
xhr.open(method, url, true);
518
xhr.open(method, url, false);
653
520
if (content_type == "multipart/form-data")