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", urlencode_path(href));
88
82
link.setAttribute("title", title);
89
83
if (onclick != null)
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);
379
341
/** Given an argument map, as output in the args parameter of the return of
380
342
* parseurl, gets the first occurence of an argument in the URL string.
381
343
* If the argument was not found, returns null.
538
492
return str.substr(str.length - substring.length) == substring;
541
/** Removes all occurences of a value from an array.
543
Array.prototype.removeall = function(val)
548
for (i=0; i<arr.length; i++)
551
if (arr[i] != val) j++;
556
/** Shallow-clones an object */
557
function shallow_clone_object(obj)
565
/** Returns a new XMLHttpRequest object, in a somewhat browser-agnostic
568
function new_xmlhttprequest()
573
return new XMLHttpRequest();
577
/* Internet Explorer */
580
return new ActiveXObject("Msxml2.XMLHTTP");
586
return new ActiveXObject("Microsoft.XMLHTTP");
590
throw("Your browser does not support AJAX. "
591
+ "IVLE requires a modern browser.");
597
/** Creates a random string of length length,
598
* consisting of alphanumeric characters.
600
var rand_chars = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXTZ"
601
+ "abcdefghiklmnopqrstuvwxyz";
602
function random_string(length)
604
var str = Array(length);
606
for (var i=0; i<length; i++)
608
v = Math.floor(Math.random() * rand_chars.length);
609
str[i] = rand_chars.charAt(v);
614
/** Makes an XMLHttpRequest call to the server.
615
* Sends the XMLHttpRequest object containing the completed response to a
616
* specified callback function.
495
/** Equivalent to Python's repr.
496
* Gets the JavaScript string representation.
497
* Actually just calls JSON.stringify.
501
return JSON.stringify(str);
504
/** Makes an XMLHttpRequest call to the server. Waits (synchronously) for a
505
* response, and returns an XMLHttpRequest object containing the completed
618
* \param callback A callback function. Will be called when the response is
619
* complete. Passed 1 parameter, an XMLHttpRequest object containing the
620
* completed response. If callback is null this is a syncronous request
621
* otherwise this is an asynchronous request.
622
508
* \param app IVLE app to call (such as "fileservice").
623
509
* \param path URL path to make the request to, within the application.
624
510
* \param args Argument object, as described in parse_url and friends.
625
* \param method String; "GET", "POST", "PUT", or "PATCH"
626
* \param content_type String, optional.
511
* \param method String; "GET" or "POST"
512
* \param content_type String, optional. Only applies if method is "POST".
513
* May be "application/x-www-form-urlencoded" or "multipart/form-data".
627
514
* Defaults to "application/x-www-form-urlencoded".
515
* \return An XMLHttpRequest object containing the completed response.
629
function ajax_call(callback, app, path, args, method, content_type)
517
function ajax_call(app, path, args, method, content_type)
519
if (content_type != "multipart/form-data")
632
520
content_type = "application/x-www-form-urlencoded";
633
521
path = app_path(app, path);
635
523
/* A random string, for multipart/form-data
636
524
* (This is not checked against anywhere else, it is solely defined and
637
525
* used within this function) */
638
var boundary = random_string(20);
639
var xhr = new_xmlhttprequest();
640
var asyncronous = callback != null;
643
xhr.onreadystatechange = function()
645
if (xhr.readyState == 4)
526
var boundary = "48234n334nu7n4n2ynonjn234t683jyh80j";
527
var xhr = new XMLHttpRequest();
651
528
if (method == "GET")
653
530
/* GET sends the args in the URL */
654
531
url = build_url({"path": path, "args": args});
655
/* open's 3rd argument = true -> asynchronous */
656
xhr.open(method, url, asyncronous);
532
/* open's 3rd argument = false -> SYNCHRONOUS (wait for response)
533
* (No need for a callback function) */
534
xhr.open(method, url, false);
661
/* POST & PUT & PATCH sends the args in the request body */
539
/* POST sends the args in application/x-www-form-urlencoded */
662
540
url = encodeURI(path);
663
xhr.open(method, url, asyncronous);
541
xhr.open(method, url, false);
665
543
if (content_type == "multipart/form-data")
667
545
xhr.setRequestHeader("Content-Type",
668
"multipart/form-data; boundary=" + boundary);
546
"multipart/form-data, boundary=" + boundary);
669
547
message = make_multipart_formdata(args, boundary);
671
else if (content_type == "application/x-www-form-urlencoded")
673
551
xhr.setRequestHeader("Content-Type", content_type);
674
552
message = make_query_string(args);
676
else if (content_type == "application/json")
678
xhr.setRequestHeader("Content-Type", content_type);
679
message = JSON.stringify(args);
683
xhr.setRequestHeader("Content-Type", content_type);
686
554
xhr.send(message);
688
/* Only return the XHR for syncronous requests */
695
/** Attempts to JSON decodes a response object
696
* If a non-200 response or the JSON decode fails then returns null
698
function decode_response(response)
700
if (response.status == 200)
704
var responseText = response.responseText;
705
return JSON.parse(responseText);