41
34
/** Creates a DOM element with simple text inside it.
42
35
* \param tagname String. Name of the element's tag (eg. "p").
43
36
* \param text String. Text to be placed inside the element.
44
* \param title String, optional. Tooltip for the text.
45
* (Note, title creates a span element around the text).
46
37
* \return DOM Element object.
48
function dom_make_text_elem(tagname, text, title)
39
function dom_make_text_elem(tagname, text)
50
41
if (text == null) text = "";
51
42
var elem = document.createElement(tagname);
54
textnode = document.createTextNode(text);
57
textnode = document.createElement("span");
58
textnode.setAttribute("title", title);
59
textnode.appendChild(document.createTextNode(text));
61
elem.appendChild(textnode);
43
elem.appendChild(document.createTextNode(text));
65
47
/** Creates a DOM element with hyperlinked text inside it.
66
48
* \param tagname String. Name of the element's tag (eg. "p").
67
49
* \param text String. Text to be placed inside the element.
68
* \param title String, optional. Sets a tooltip for the link.
69
50
* \param href String. URL the text will link to. This is a raw string,
70
51
* it will automatically be URL-encoded.
71
52
* \param onclick Optional string. Will be set as the "onclick" attribute
72
53
* 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
54
* \return DOM Element object.
78
function dom_make_link_elem(tagname, text, title, href, onclick, dontencode)
56
function dom_make_link_elem(tagname, text, href, onclick)
80
58
if (text == null) text = "";
81
59
if (href == null) href = "";
82
60
var elem = document.createElement(tagname);
83
61
var link = document.createElement("a");
84
if (dontencode != true)
85
href = urlencode_path(href);
86
link.setAttribute("href", href);
88
link.setAttribute("title", title);
62
link.setAttribute("href", encodeURI(href));
89
63
if (onclick != null)
90
64
link.setAttribute("onclick", onclick);
91
65
link.appendChild(document.createTextNode(text));
310
287
url += ":" + obj.server_port.toString();
311
288
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) != "/")
290
var path = obj.path.toString();
291
if (url.length > 0 && path.length > 0 && path[0] != "/")
315
292
path = "/" + path;
318
295
if (("query_string" in obj) && obj.query_string != null)
319
query_string = encodeURI(obj.query_string.toString());
296
query_string = obj.query_string.toString();
320
297
else if (("args" in obj) && obj.args != null)
321
298
query_string = make_query_string(obj.args);
323
if (query_string != "" && query_string != null)
300
if (query_string != null)
324
301
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);
303
return encodeURI(url);
379
306
/** Given an argument map, as output in the args parameter of the return of
504
431
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
/** Same as app_path but creates a properly-escaped site-relative URL.
517
function app_url(app /*,...*/)
519
return urlencode_path(app_path.apply(null, arguments));
522
/** Generates an absolute URL to a public application
524
function public_app_url(app /*,...*/)
526
return "http://" + public_host + app_url.apply(null, arguments);
529
/** Given a path, gets the "basename" (the last path segment).
531
function path_basename(path)
533
segments = path.split("/");
534
if (segments[segments.length-1].length == 0)
535
return segments[segments.length-2];
537
return segments[segments.length-1];
540
/** Given a string str, determines whether it ends with substr */
541
function endswith(str, substring)
543
if (str.length < substring.length) return false;
544
return str.substr(str.length - substring.length) == substring;
547
/** Removes all occurences of a value from an array.
549
Array.prototype.removeall = function(val)
554
for (i=0; i<arr.length; i++)
557
if (arr[i] != val) j++;
562
/** Shallow-clones an object */
563
function shallow_clone_object(obj)
571
/** Returns a new XMLHttpRequest object, in a somewhat browser-agnostic
574
function new_xmlhttprequest()
579
return new XMLHttpRequest();
583
/* Internet Explorer */
586
return new ActiveXObject("Msxml2.XMLHTTP");
592
return new ActiveXObject("Microsoft.XMLHTTP");
596
throw("Your browser does not support AJAX. "
597
+ "IVLE requires a modern browser.");
603
/** Creates a random string of length length,
604
* consisting of alphanumeric characters.
606
var rand_chars = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXTZ"
607
+ "abcdefghiklmnopqrstuvwxyz";
608
function random_string(length)
610
var str = Array(length);
612
for (var i=0; i<length; i++)
614
v = Math.floor(Math.random() * rand_chars.length);
615
str[i] = rand_chars.charAt(v);
620
/** Makes an XMLHttpRequest call to the server.
621
* Sends the XMLHttpRequest object containing the completed response to a
622
* specified callback function.
434
/** Makes an XMLHttpRequest call to the server. Waits (synchronously) for a
435
* response, and returns an XMLHttpRequest object containing the completed
624
* \param callback A callback function. Will be called when the response is
625
* complete. Passed 1 parameter, an XMLHttpRequest object containing the
626
* completed response. If callback is null this is a syncronous request
627
* otherwise this is an asynchronous request.
628
438
* \param app IVLE app to call (such as "fileservice").
629
439
* \param path URL path to make the request to, within the application.
630
440
* \param args Argument object, as described in parse_url and friends.
631
* \param method String; "GET", "POST", "PUT", or "PATCH"
632
* \param content_type String, optional.
441
* \param method String; "GET" or "POST"
442
* \param content_type String, optional. Only applies if method is "POST".
443
* May be "application/x-www-form-urlencoded" or "multipart/form-data".
633
444
* Defaults to "application/x-www-form-urlencoded".
445
* \return An XMLHttpRequest object containing the completed response.
635
function ajax_call(callback, app, path, args, method, content_type)
447
function ajax_call(app, path, args, method, content_type)
449
if (content_type != "multipart/form-data")
638
450
content_type = "application/x-www-form-urlencoded";
639
path = app_path(app, path);
451
path = make_path(path_join(app, path));
641
453
/* A random string, for multipart/form-data
642
454
* (This is not checked against anywhere else, it is solely defined and
643
455
* used within this function) */
644
var boundary = random_string(20);
645
var xhr = new_xmlhttprequest();
646
var asyncronous = callback != null;
649
xhr.onreadystatechange = function()
651
if (xhr.readyState == 4)
456
var boundary = "48234n334nu7n4n2ynonjn234t683jyh80j";
457
var xhr = new XMLHttpRequest();
657
458
if (method == "GET")
659
460
/* GET sends the args in the URL */
660
461
url = build_url({"path": path, "args": args});
661
/* open's 3rd argument = true -> asynchronous */
662
xhr.open(method, url, asyncronous);
462
/* open's 3rd argument = false -> SYNCHRONOUS (wait for response)
463
* (No need for a callback function) */
464
xhr.open(method, url, false);
667
/* POST & PUT & PATCH sends the args in the request body */
668
url = urlencode_path(path);
669
xhr.open(method, url, asyncronous);
469
/* POST sends the args in application/x-www-form-urlencoded */
470
url = encodeURI(path);
471
xhr.open(method, url, false);
671
473
if (content_type == "multipart/form-data")
673
475
xhr.setRequestHeader("Content-Type",
674
"multipart/form-data; boundary=" + boundary);
476
"multipart/form-data, boundary=" + boundary);
675
477
message = make_multipart_formdata(args, boundary);
677
else if (content_type == "application/x-www-form-urlencoded")
679
481
xhr.setRequestHeader("Content-Type", content_type);
680
482
message = make_query_string(args);
682
else if (content_type == "application/json")
684
xhr.setRequestHeader("Content-Type", content_type);
685
message = JSON.stringify(args);
689
xhr.setRequestHeader("Content-Type", content_type);
692
484
xhr.send(message);
694
/* Only return the XHR for syncronous requests */
701
/** Attempts to JSON decodes a response object
702
* If a non-200 response or the JSON decode fails then returns null
704
function decode_response(response)
706
if (response.status == 200)
710
var responseText = response.responseText;
711
return JSON.parse(responseText);
added
removed
www/media/common/util.js
