12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335 |
- /*
- json2.js
- 2012-10-08
- Public Domain.
- NO WARRANTY EXPRESSED OR IMPLIED. USE AT YOUR OWN RISK.
- See http://www.JSON.org/js.html
- This code should be minified before deployment.
- See http://javascript.crockford.com/jsmin.html
- USE YOUR OWN COPY. IT IS EXTREMELY UNWISE TO LOAD CODE FROM SERVERS YOU DO
- NOT CONTROL.
- This file creates a global JSON object containing two methods: stringify
- and parse.
- JSON.stringify(value, replacer, space)
- value any JavaScript value, usually an object or array.
- replacer an optional parameter that determines how object
- values are stringified for objects. It can be a
- function or an array of strings.
- space an optional parameter that specifies the indentation
- of nested structures. If it is omitted, the text will
- be packed without extra whitespace. If it is a number,
- it will specify the number of spaces to indent at each
- level. If it is a string (such as '\t' or ' '),
- it contains the characters used to indent at each level.
- This method produces a JSON text from a JavaScript value.
- When an object value is found, if the object contains a toJSON
- method, its toJSON method will be called and the result will be
- stringified. A toJSON method does not serialize: it returns the
- value represented by the name/value pair that should be serialized,
- or undefined if nothing should be serialized. The toJSON method
- will be passed the key associated with the value, and this will be
- bound to the value
- For example, this would serialize Dates as ISO strings.
- Date.prototype.toJSON = function (key) {
- function f(n) {
- // Format integers to have at least two digits.
- return n < 10 ? '0' + n : n;
- }
- return this.getUTCFullYear() + '-' +
- f(this.getUTCMonth() + 1) + '-' +
- f(this.getUTCDate()) + 'T' +
- f(this.getUTCHours()) + ':' +
- f(this.getUTCMinutes()) + ':' +
- f(this.getUTCSeconds()) + 'Z';
- };
- You can provide an optional replacer method. It will be passed the
- key and value of each member, with this bound to the containing
- object. The value that is returned from your method will be
- serialized. If your method returns undefined, then the member will
- be excluded from the serialization.
- If the replacer parameter is an array of strings, then it will be
- used to select the members to be serialized. It filters the results
- such that only members with keys listed in the replacer array are
- stringified.
- Values that do not have JSON representations, such as undefined or
- functions, will not be serialized. Such values in objects will be
- dropped; in arrays they will be replaced with null. You can use
- a replacer function to replace those with JSON values.
- JSON.stringify(undefined) returns undefined.
- The optional space parameter produces a stringification of the
- value that is filled with line breaks and indentation to make it
- easier to read.
- If the space parameter is a non-empty string, then that string will
- be used for indentation. If the space parameter is a number, then
- the indentation will be that many spaces.
- Example:
- text = JSON.stringify(['e', {pluribus: 'unum'}]);
- // text is '["e",{"pluribus":"unum"}]'
- text = JSON.stringify(['e', {pluribus: 'unum'}], null, '\t');
- // text is '[\n\t"e",\n\t{\n\t\t"pluribus": "unum"\n\t}\n]'
- text = JSON.stringify([new Date()], function (key, value) {
- return this[key] instanceof Date ?
- 'Date(' + this[key] + ')' : value;
- });
- // text is '["Date(---current time---)"]'
- JSON.parse(text, reviver)
- This method parses a JSON text to produce an object or array.
- It can throw a SyntaxError exception.
- The optional reviver parameter is a function that can filter and
- transform the results. It receives each of the keys and values,
- and its return value is used instead of the original value.
- If it returns what it received, then the structure is not modified.
- If it returns undefined then the member is deleted.
- Example:
- // Parse the text. Values that look like ISO date strings will
- // be converted to Date objects.
- myData = JSON.parse(text, function (key, value) {
- var a;
- if (typeof value === 'string') {
- a =
- /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2}(?:\.\d*)?)Z$/.exec(value);
- if (a) {
- return new Date(Date.UTC(+a[1], +a[2] - 1, +a[3], +a[4],
- +a[5], +a[6]));
- }
- }
- return value;
- });
- myData = JSON.parse('["Date(09/09/2001)"]', function (key, value) {
- var d;
- if (typeof value === 'string' &&
- value.slice(0, 5) === 'Date(' &&
- value.slice(-1) === ')') {
- d = new Date(value.slice(5, -1));
- if (d) {
- return d;
- }
- }
- return value;
- });
- This is a reference implementation. You are free to copy, modify, or
- redistribute.
- */
- /*jslint evil: true, regexp: true */
- /*members "", "\b", "\t", "\n", "\f", "\r", "\"", JSON, "\\", apply,
- call, charCodeAt, getUTCDate, getUTCFullYear, getUTCHours,
- getUTCMinutes, getUTCMonth, getUTCSeconds, hasOwnProperty, join,
- lastIndex, length, parse, prototype, push, replace, slice, stringify,
- test, toJSON, toString, valueOf
- */
- // Create a JSON object only if one does not already exist. We create the
- // methods in a closure to avoid creating global variables.
- if (typeof JSON !== 'object') {
- JSON = {};
- }
- (function () {
- 'use strict';
- function f(n) {
- // Format integers to have at least two digits.
- return n < 10 ? '0' + n : n;
- }
- if (typeof Date.prototype.toJSON !== 'function') {
- Date.prototype.toJSON = function (key) {
- return isFinite(this.valueOf())
- ? this.getUTCFullYear() + '-' +
- f(this.getUTCMonth() + 1) + '-' +
- f(this.getUTCDate()) + 'T' +
- f(this.getUTCHours()) + ':' +
- f(this.getUTCMinutes()) + ':' +
- f(this.getUTCSeconds()) + 'Z'
- : null;
- };
- String.prototype.toJSON =
- Number.prototype.toJSON =
- Boolean.prototype.toJSON = function (key) {
- return this.valueOf();
- };
- }
- var cx = /[\u0000\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,
- escapable = /[\\\"\x00-\x1f\x7f-\x9f\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]/g,
- gap,
- indent,
- meta = { // table of character substitutions
- '\b': '\\b',
- '\t': '\\t',
- '\n': '\\n',
- '\f': '\\f',
- '\r': '\\r',
- '"' : '\\"',
- '\\': '\\\\'
- },
- rep;
- function quote(string) {
- // If the string contains no control characters, no quote characters, and no
- // backslash characters, then we can safely slap some quotes around it.
- // Otherwise we must also replace the offending characters with safe escape
- // sequences.
- escapable.lastIndex = 0;
- return escapable.test(string) ? '"' + string.replace(escapable, function (a) {
- var c = meta[a];
- return typeof c === 'string'
- ? c
- : '\\u' + ('0000' + a.charCodeAt(0).toString(16)).slice(-4);
- }) + '"' : '"' + string + '"';
- }
- function str(key, holder) {
- // Produce a string from holder[key].
- var i, // The loop counter.
- k, // The member key.
- v, // The member value.
- length,
- mind = gap,
- partial,
- value = holder[key];
- // If the value has a toJSON method, call it to obtain a replacement value.
- if (value && typeof value === 'object' &&
- typeof value.toJSON === 'function') {
- value = value.toJSON(key);
- }
- // If we were called with a replacer function, then call the replacer to
- // obtain a replacement value.
- if (typeof rep === 'function') {
- value = rep.call(holder, key, value);
- }
- // What happens next depends on the value's type.
- switch (typeof value) {
- case 'string':
- return quote(value);
- case 'number':
- // JSON numbers must be finite. Encode non-finite numbers as null.
- return isFinite(value) ? String(value) : 'null';
- case 'boolean':
- case 'null':
- // If the value is a boolean or null, convert it to a string. Note:
- // typeof null does not produce 'null'. The case is included here in
- // the remote chance that this gets fixed someday.
- return String(value);
- // If the type is 'object', we might be dealing with an object or an array or
- // null.
- case 'object':
- // Due to a specification blunder in ECMAScript, typeof null is 'object',
- // so watch out for that case.
- if (!value) {
- return 'null';
- }
- // Make an array to hold the partial results of stringifying this object value.
- gap += indent;
- partial = [];
- // Is the value an array?
- if (Object.prototype.toString.apply(value) === '[object Array]') {
- // The value is an array. Stringify every element. Use null as a placeholder
- // for non-JSON values.
- length = value.length;
- for (i = 0; i < length; i += 1) {
- partial[i] = str(i, value) || 'null';
- }
- // Join all of the elements together, separated with commas, and wrap them in
- // brackets.
- v = partial.length === 0
- ? '[]'
- : gap
- ? '[\n' + gap + partial.join(',\n' + gap) + '\n' + mind + ']'
- : '[' + partial.join(',') + ']';
- gap = mind;
- return v;
- }
- // If the replacer is an array, use it to select the members to be stringified.
- if (rep && typeof rep === 'object') {
- length = rep.length;
- for (i = 0; i < length; i += 1) {
- if (typeof rep[i] === 'string') {
- k = rep[i];
- v = str(k, value);
- if (v) {
- partial.push(quote(k) + (gap ? ': ' : ':') + v);
- }
- }
- }
- } else {
- // Otherwise, iterate through all of the keys in the object.
- for (k in value) {
- if (Object.prototype.hasOwnProperty.call(value, k)) {
- v = str(k, value);
- if (v) {
- partial.push(quote(k) + (gap ? ': ' : ':') + v);
- }
- }
- }
- }
- // Join all of the member texts together, separated with commas,
- // and wrap them in braces.
- v = partial.length === 0
- ? '{}'
- : gap
- ? '{\n' + gap + partial.join(',\n' + gap) + '\n' + mind + '}'
- : '{' + partial.join(',') + '}';
- gap = mind;
- return v;
- }
- }
- // If the JSON object does not yet have a stringify method, give it one.
- if (typeof JSON.stringify !== 'function') {
- JSON.stringify = function (value, replacer, space) {
- // The stringify method takes a value and an optional replacer, and an optional
- // space parameter, and returns a JSON text. The replacer can be a function
- // that can replace values, or an array of strings that will select the keys.
- // A default replacer method can be provided. Use of the space parameter can
- // produce text that is more easily readable.
- var i;
- gap = '';
- indent = '';
- // If the space parameter is a number, make an indent string containing that
- // many spaces.
- if (typeof space === 'number') {
- for (i = 0; i < space; i += 1) {
- indent += ' ';
- }
- // If the space parameter is a string, it will be used as the indent string.
- } else if (typeof space === 'string') {
- indent = space;
- }
- // If there is a replacer, it must be a function or an array.
- // Otherwise, throw an error.
- rep = replacer;
- if (replacer && typeof replacer !== 'function' &&
- (typeof replacer !== 'object' ||
- typeof replacer.length !== 'number')) {
- throw new Error('JSON.stringify');
- }
- // Make a fake root object containing our value under the key of ''.
- // Return the result of stringifying the value.
- return str('', {'': value});
- };
- }
- // If the JSON object does not yet have a parse method, give it one.
- if (typeof JSON.parse !== 'function') {
- JSON.parse = function (text, reviver) {
- // The parse method takes a text and an optional reviver function, and returns
- // a JavaScript value if the text is a valid JSON text.
- var j;
- function walk(holder, key) {
- // The walk method is used to recursively walk the resulting structure so
- // that modifications can be made.
- var k, v, value = holder[key];
- if (value && typeof value === 'object') {
- for (k in value) {
- if (Object.prototype.hasOwnProperty.call(value, k)) {
- v = walk(value, k);
- if (v !== undefined) {
- value[k] = v;
- } else {
- delete value[k];
- }
- }
- }
- }
- return reviver.call(holder, key, value);
- }
- // Parsing happens in four stages. In the first stage, we replace certain
- // Unicode characters with escape sequences. JavaScript handles many characters
- // incorrectly, either silently deleting them, or treating them as line endings.
- text = String(text);
- cx.lastIndex = 0;
- if (cx.test(text)) {
- text = text.replace(cx, function (a) {
- return '\\u' +
- ('0000' + a.charCodeAt(0).toString(16)).slice(-4);
- });
- }
- // In the second stage, we run the text against regular expressions that look
- // for non-JSON patterns. We are especially concerned with '()' and 'new'
- // because they can cause invocation, and '=' because it can cause mutation.
- // But just to be safe, we want to reject all unexpected forms.
- // We split the second stage into 4 regexp operations in order to work around
- // crippling inefficiencies in IE's and Safari's regexp engines. First we
- // replace the JSON backslash pairs with '@' (a non-JSON character). Second, we
- // replace all simple value tokens with ']' characters. Third, we delete all
- // open brackets that follow a colon or comma or that begin the text. Finally,
- // we look to see that the remaining characters are only whitespace or ']' or
- // ',' or ':' or '{' or '}'. If that is so, then the text is safe for eval.
- if (/^[\],:{}\s]*$/
- .test(text.replace(/\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g, '@')
- .replace(/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g, ']')
- .replace(/(?:^|:|,)(?:\s*\[)+/g, ''))) {
- // In the third stage we use the eval function to compile the text into a
- // JavaScript structure. The '{' operator is subject to a syntactic ambiguity
- // in JavaScript: it can begin a block or an object literal. We wrap the text
- // in parens to eliminate the ambiguity.
- j = eval('(' + text + ')');
- // In the optional fourth stage, we recursively walk the new structure, passing
- // each name/value pair to a reviver function for possible transformation.
- return typeof reviver === 'function'
- ? walk({'': j}, '')
- : j;
- }
- // If the text is not JSON parseable, then a SyntaxError is thrown.
- throw new SyntaxError('JSON.parse');
- };
- }
- }());/**
- * History.js Native Adapter
- * @author Benjamin Arthur Lupton <contact@balupton.com>
- * @copyright 2010-2011 Benjamin Arthur Lupton <contact@balupton.com>
- * @license New BSD License <http://creativecommons.org/licenses/BSD/>
- */
- // Closure
- (function(window,undefined){
- "use strict";
- // Localise Globals
- var History = window.History = window.History||{};
- // Check Existence
- if ( typeof History.Adapter !== 'undefined' ) {
- throw new Error('History.js Adapter has already been loaded...');
- }
- // Add the Adapter
- History.Adapter = {
- /**
- * History.Adapter.handlers[uid][eventName] = Array
- */
- handlers: {},
- /**
- * History.Adapter._uid
- * The current element unique identifier
- */
- _uid: 1,
- /**
- * History.Adapter.uid(element)
- * @param {Element} element
- * @return {String} uid
- */
- uid: function(element){
- return element._uid || (element._uid = History.Adapter._uid++);
- },
- /**
- * History.Adapter.bind(el,event,callback)
- * @param {Element} element
- * @param {String} eventName - custom and standard events
- * @param {Function} callback
- * @return
- */
- bind: function(element,eventName,callback){
- // Prepare
- var uid = History.Adapter.uid(element);
- // Apply Listener
- History.Adapter.handlers[uid] = History.Adapter.handlers[uid] || {};
- History.Adapter.handlers[uid][eventName] = History.Adapter.handlers[uid][eventName] || [];
- History.Adapter.handlers[uid][eventName].push(callback);
- // Bind Global Listener
- element['on'+eventName] = (function(element,eventName){
- return function(event){
- History.Adapter.trigger(element,eventName,event);
- };
- })(element,eventName);
- },
- /**
- * History.Adapter.trigger(el,event)
- * @param {Element} element
- * @param {String} eventName - custom and standard events
- * @param {Object} event - a object of event data
- * @return
- */
- trigger: function(element,eventName,event){
- // Prepare
- event = event || {};
- var uid = History.Adapter.uid(element),
- i,n;
- // Apply Listener
- History.Adapter.handlers[uid] = History.Adapter.handlers[uid] || {};
- History.Adapter.handlers[uid][eventName] = History.Adapter.handlers[uid][eventName] || [];
- // Fire Listeners
- for ( i=0,n=History.Adapter.handlers[uid][eventName].length; i<n; ++i ) {
- History.Adapter.handlers[uid][eventName][i].apply(this,[event]);
- }
- },
- /**
- * History.Adapter.extractEventData(key,event,extra)
- * @param {String} key - key for the event data to extract
- * @param {String} event - custom and standard events
- * @return {mixed}
- */
- extractEventData: function(key,event){
- var result = (event && event[key]) || undefined;
- return result;
- },
- /**
- * History.Adapter.onDomLoad(callback)
- * @param {Function} callback
- * @return
- */
- onDomLoad: function(callback) {
- var timeout = window.setTimeout(function(){
- callback();
- },2000);
- window.onload = function(){
- clearTimeout(timeout);
- callback();
- };
- }
- };
- // Try to Initialise History
- if ( typeof History.init !== 'undefined' ) {
- History.init();
- }
- })(window);
- /**
- * History.js HTML4 Support
- * Depends on the HTML5 Support
- * @author Benjamin Arthur Lupton <contact@balupton.com>
- * @copyright 2010-2011 Benjamin Arthur Lupton <contact@balupton.com>
- * @license New BSD License <http://creativecommons.org/licenses/BSD/>
- */
- (function(window,undefined){
- "use strict";
- // ========================================================================
- // Initialise
- // Localise Globals
- var
- document = window.document, // Make sure we are using the correct document
- setTimeout = window.setTimeout||setTimeout,
- clearTimeout = window.clearTimeout||clearTimeout,
- setInterval = window.setInterval||setInterval,
- History = window.History = window.History||{}; // Public History Object
- // Check Existence
- if ( typeof History.initHtml4 !== 'undefined' ) {
- throw new Error('History.js HTML4 Support has already been loaded...');
- }
- // ========================================================================
- // Initialise HTML4 Support
- // Initialise HTML4 Support
- History.initHtml4 = function(){
- // Initialise
- if ( typeof History.initHtml4.initialized !== 'undefined' ) {
- // Already Loaded
- return false;
- }
- else {
- History.initHtml4.initialized = true;
- }
- // ====================================================================
- // Properties
- /**
- * History.enabled
- * Is History enabled?
- */
- History.enabled = true;
- // ====================================================================
- // Hash Storage
- /**
- * History.savedHashes
- * Store the hashes in an array
- */
- History.savedHashes = [];
- /**
- * History.isLastHash(newHash)
- * Checks if the hash is the last hash
- * @param {string} newHash
- * @return {boolean} true
- */
- History.isLastHash = function(newHash){
- // Prepare
- var oldHash = History.getHashByIndex(),
- isLast;
- // Check
- isLast = newHash === oldHash;
- // Return isLast
- return isLast;
- };
- /**
- * History.isHashEqual(newHash, oldHash)
- * Checks to see if two hashes are functionally equal
- * @param {string} newHash
- * @param {string} oldHash
- * @return {boolean} true
- */
- History.isHashEqual = function(newHash, oldHash){
- newHash = encodeURIComponent(newHash).replace(/%25/g, "%");
- oldHash = encodeURIComponent(oldHash).replace(/%25/g, "%");
- return newHash === oldHash;
- };
- /**
- * History.saveHash(newHash)
- * Push a Hash
- * @param {string} newHash
- * @return {boolean} true
- */
- History.saveHash = function(newHash){
- // Check Hash
- if ( History.isLastHash(newHash) ) {
- return false;
- }
- // Push the Hash
- History.savedHashes.push(newHash);
- // Return true
- return true;
- };
- /**
- * History.getHashByIndex()
- * Gets a hash by the index
- * @param {integer} index
- * @return {string}
- */
- History.getHashByIndex = function(index){
- // Prepare
- var hash = null;
- // Handle
- if ( typeof index === 'undefined' ) {
- // Get the last inserted
- hash = History.savedHashes[History.savedHashes.length-1];
- }
- else if ( index < 0 ) {
- // Get from the end
- hash = History.savedHashes[History.savedHashes.length+index];
- }
- else {
- // Get from the beginning
- hash = History.savedHashes[index];
- }
- // Return hash
- return hash;
- };
- // ====================================================================
- // Discarded States
- /**
- * History.discardedHashes
- * A hashed array of discarded hashes
- */
- History.discardedHashes = {};
- /**
- * History.discardedStates
- * A hashed array of discarded states
- */
- History.discardedStates = {};
- /**
- * History.discardState(State)
- * Discards the state by ignoring it through History
- * @param {object} State
- * @return {true}
- */
- History.discardState = function(discardedState,forwardState,backState){
- //History.debug('History.discardState', arguments);
- // Prepare
- var discardedStateHash = History.getHashByState(discardedState),
- discardObject;
- // Create Discard Object
- discardObject = {
- 'discardedState': discardedState,
- 'backState': backState,
- 'forwardState': forwardState
- };
- // Add to DiscardedStates
- History.discardedStates[discardedStateHash] = discardObject;
- // Return true
- return true;
- };
- /**
- * History.discardHash(hash)
- * Discards the hash by ignoring it through History
- * @param {string} hash
- * @return {true}
- */
- History.discardHash = function(discardedHash,forwardState,backState){
- //History.debug('History.discardState', arguments);
- // Create Discard Object
- var discardObject = {
- 'discardedHash': discardedHash,
- 'backState': backState,
- 'forwardState': forwardState
- };
- // Add to discardedHash
- History.discardedHashes[discardedHash] = discardObject;
- // Return true
- return true;
- };
- /**
- * History.discardedState(State)
- * Checks to see if the state is discarded
- * @param {object} State
- * @return {bool}
- */
- History.discardedState = function(State){
- // Prepare
- var StateHash = History.getHashByState(State),
- discarded;
- // Check
- discarded = History.discardedStates[StateHash]||false;
- // Return true
- return discarded;
- };
- /**
- * History.discardedHash(hash)
- * Checks to see if the state is discarded
- * @param {string} State
- * @return {bool}
- */
- History.discardedHash = function(hash){
- // Check
- var discarded = History.discardedHashes[hash]||false;
- // Return true
- return discarded;
- };
- /**
- * History.recycleState(State)
- * Allows a discarded state to be used again
- * @param {object} data
- * @param {string} title
- * @param {string} url
- * @return {true}
- */
- History.recycleState = function(State){
- //History.debug('History.recycleState', arguments);
- // Prepare
- var StateHash = History.getHashByState(State);
- // Remove from DiscardedStates
- if ( History.discardedState(State) ) {
- delete History.discardedStates[StateHash];
- }
- // Return true
- return true;
- };
- // ====================================================================
- // HTML4 HashChange Support
- if ( History.emulated.hashChange ) {
- /*
- * We must emulate the HTML4 HashChange Support by manually checking for hash changes
- */
- /**
- * History.hashChangeInit()
- * Init the HashChange Emulation
- */
- History.hashChangeInit = function(){
- // Define our Checker Function
- History.checkerFunction = null;
- // Define some variables that will help in our checker function
- var lastDocumentHash = '',
- iframeId, iframe,
- lastIframeHash, checkerRunning,
- startedWithHash = Boolean(History.getHash());
- // Handle depending on the browser
- if ( History.isInternetExplorer() ) {
- // IE6 and IE7
- // We need to use an iframe to emulate the back and forward buttons
- // Create iFrame
- iframeId = 'historyjs-iframe';
- iframe = document.createElement('iframe');
- // Adjust iFarme
- // IE 6 requires iframe to have a src on HTTPS pages, otherwise it will throw a
- // "This page contains both secure and nonsecure items" warning.
- iframe.setAttribute('id', iframeId);
- iframe.setAttribute('src', '#');
- iframe.style.display = 'none';
- // Append iFrame
- document.body.appendChild(iframe);
- // Create initial history entry
- iframe.contentWindow.document.open();
- iframe.contentWindow.document.close();
- // Define some variables that will help in our checker function
- lastIframeHash = '';
- checkerRunning = false;
- // Define the checker function
- History.checkerFunction = function(){
- // Check Running
- if ( checkerRunning ) {
- return false;
- }
- // Update Running
- checkerRunning = true;
- // Fetch
- var
- documentHash = History.getHash(),
- iframeHash = History.getHash(iframe.contentWindow.document);
- // The Document Hash has changed (application caused)
- if ( documentHash !== lastDocumentHash ) {
- // Equalise
- lastDocumentHash = documentHash;
- // Create a history entry in the iframe
- if ( iframeHash !== documentHash ) {
- //History.debug('hashchange.checker: iframe hash change', 'documentHash (new):', documentHash, 'iframeHash (old):', iframeHash);
- // Equalise
- lastIframeHash = iframeHash = documentHash;
- // Create History Entry
- iframe.contentWindow.document.open();
- iframe.contentWindow.document.close();
- // Update the iframe's hash
- iframe.contentWindow.document.location.hash = History.escapeHash(documentHash);
- }
- // Trigger Hashchange Event
- History.Adapter.trigger(window,'hashchange');
- }
- // The iFrame Hash has changed (back button caused)
- else if ( iframeHash !== lastIframeHash ) {
- //History.debug('hashchange.checker: iframe hash out of sync', 'iframeHash (new):', iframeHash, 'documentHash (old):', documentHash);
- // Equalise
- lastIframeHash = iframeHash;
-
- // If there is no iframe hash that means we're at the original
- // iframe state.
- // And if there was a hash on the original request, the original
- // iframe state was replaced instantly, so skip this state and take
- // the user back to where they came from.
- if (startedWithHash && iframeHash === '') {
- History.back();
- }
- else {
- // Update the Hash
- History.setHash(iframeHash,false);
- }
- }
- // Reset Running
- checkerRunning = false;
- // Return true
- return true;
- };
- }
- else {
- // We are not IE
- // Firefox 1 or 2, Opera
- // Define the checker function
- History.checkerFunction = function(){
- // Prepare
- var documentHash = History.getHash()||'';
- // The Document Hash has changed (application caused)
- if ( documentHash !== lastDocumentHash ) {
- // Equalise
- lastDocumentHash = documentHash;
- // Trigger Hashchange Event
- History.Adapter.trigger(window,'hashchange');
- }
- // Return true
- return true;
- };
- }
- // Apply the checker function
- History.intervalList.push(setInterval(History.checkerFunction, History.options.hashChangeInterval));
- // Done
- return true;
- }; // History.hashChangeInit
- // Bind hashChangeInit
- History.Adapter.onDomLoad(History.hashChangeInit);
- } // History.emulated.hashChange
- // ====================================================================
- // HTML5 State Support
- // Non-Native pushState Implementation
- if ( History.emulated.pushState ) {
- /*
- * We must emulate the HTML5 State Management by using HTML4 HashChange
- */
- /**
- * History.onHashChange(event)
- * Trigger HTML5's window.onpopstate via HTML4 HashChange Support
- */
- History.onHashChange = function(event){
- //History.debug('History.onHashChange', arguments);
- // Prepare
- var currentUrl = ((event && event.newURL) || History.getLocationHref()),
- currentHash = History.getHashByUrl(currentUrl),
- currentState = null,
- currentStateHash = null,
- currentStateHashExits = null,
- discardObject;
- // Check if we are the same state
- if ( History.isLastHash(currentHash) ) {
- // There has been no change (just the page's hash has finally propagated)
- //History.debug('History.onHashChange: no change');
- History.busy(false);
- return false;
- }
- // Reset the double check
- History.doubleCheckComplete();
- // Store our location for use in detecting back/forward direction
- History.saveHash(currentHash);
- // Expand Hash
- if ( currentHash && History.isTraditionalAnchor(currentHash) ) {
- //History.debug('History.onHashChange: traditional anchor', currentHash);
- // Traditional Anchor Hash
- History.Adapter.trigger(window,'anchorchange');
- History.busy(false);
- return false;
- }
- // Create State
- currentState = History.extractState(History.getFullUrl(currentHash||History.getLocationHref()),true);
- // Check if we are the same state
- if ( History.isLastSavedState(currentState) ) {
- //History.debug('History.onHashChange: no change');
- // There has been no change (just the page's hash has finally propagated)
- History.busy(false);
- return false;
- }
- // Create the state Hash
- currentStateHash = History.getHashByState(currentState);
- // Check if we are DiscardedState
- discardObject = History.discardedState(currentState);
- if ( discardObject ) {
- // Ignore this state as it has been discarded and go back to the state before it
- if ( History.getHashByIndex(-2) === History.getHashByState(discardObject.forwardState) ) {
- // We are going backwards
- //History.debug('History.onHashChange: go backwards');
- History.back(false);
- } else {
- // We are going forwards
- //History.debug('History.onHashChange: go forwards');
- History.forward(false);
- }
- return false;
- }
- // Push the new HTML5 State
- //History.debug('History.onHashChange: success hashchange');
- History.pushState(currentState.data,currentState.title,encodeURI(currentState.url),false);
- // End onHashChange closure
- return true;
- };
- History.Adapter.bind(window,'hashchange',History.onHashChange);
- /**
- * History.pushState(data,title,url)
- * Add a new State to the history object, become it, and trigger onpopstate
- * We have to trigger for HTML4 compatibility
- * @param {object} data
- * @param {string} title
- * @param {string} url
- * @return {true}
- */
- History.pushState = function(data,title,url,queue){
- //History.debug('History.pushState: called', arguments);
- // We assume that the URL passed in is URI-encoded, but this makes
- // sure that it's fully URI encoded; any '%'s that are encoded are
- // converted back into '%'s
- url = encodeURI(url).replace(/%25/g, "%");
- // Check the State
- if ( History.getHashByUrl(url) ) {
- throw new Error('History.js does not support states with fragment-identifiers (hashes/anchors).');
- }
- // Handle Queueing
- if ( queue !== false && History.busy() ) {
- // Wait + Push to Queue
- //History.debug('History.pushState: we must wait', arguments);
- History.pushQueue({
- scope: History,
- callback: History.pushState,
- args: arguments,
- queue: queue
- });
- return false;
- }
- // Make Busy
- History.busy(true);
- // Fetch the State Object
- var newState = History.createStateObject(data,title,url),
- newStateHash = History.getHashByState(newState),
- oldState = History.getState(false),
- oldStateHash = History.getHashByState(oldState),
- html4Hash = History.getHash(),
- wasExpected = History.expectedStateId == newState.id;
- // Store the newState
- History.storeState(newState);
- History.expectedStateId = newState.id;
- // Recycle the State
- History.recycleState(newState);
- // Force update of the title
- History.setTitle(newState);
- // Check if we are the same State
- if ( newStateHash === oldStateHash ) {
- //History.debug('History.pushState: no change', newStateHash);
- History.busy(false);
- return false;
- }
- // Update HTML5 State
- History.saveState(newState);
- // Fire HTML5 Event
- if(!wasExpected)
- History.Adapter.trigger(window,'statechange');
- // Update HTML4 Hash
- if ( !History.isHashEqual(newStateHash, html4Hash) && !History.isHashEqual(newStateHash, History.getShortUrl(History.getLocationHref())) ) {
- History.setHash(newStateHash,false);
- }
-
- History.busy(false);
- // End pushState closure
- return true;
- };
- /**
- * History.replaceState(data,title,url)
- * Replace the State and trigger onpopstate
- * We have to trigger for HTML4 compatibility
- * @param {object} data
- * @param {string} title
- * @param {string} url
- * @return {true}
- */
- History.replaceState = function(data,title,url,queue){
- //History.debug('History.replaceState: called', arguments);
- // We assume that the URL passed in is URI-encoded, but this makes
- // sure that it's fully URI encoded; any '%'s that are encoded are
- // converted back into '%'s
- url = encodeURI(url).replace(/%25/g, "%");
- // Check the State
- if ( History.getHashByUrl(url) ) {
- throw new Error('History.js does not support states with fragment-identifiers (hashes/anchors).');
- }
- // Handle Queueing
- if ( queue !== false && History.busy() ) {
- // Wait + Push to Queue
- //History.debug('History.replaceState: we must wait', arguments);
- History.pushQueue({
- scope: History,
- callback: History.replaceState,
- args: arguments,
- queue: queue
- });
- return false;
- }
- // Make Busy
- History.busy(true);
- // Fetch the State Objects
- var newState = History.createStateObject(data,title,url),
- newStateHash = History.getHashByState(newState),
- oldState = History.getState(false),
- oldStateHash = History.getHashByState(oldState),
- previousState = History.getStateByIndex(-2);
- // Discard Old State
- History.discardState(oldState,newState,previousState);
- // If the url hasn't changed, just store and save the state
- // and fire a statechange event to be consistent with the
- // html 5 api
- if ( newStateHash === oldStateHash ) {
- // Store the newState
- History.storeState(newState);
- History.expectedStateId = newState.id;
-
- // Recycle the State
- History.recycleState(newState);
-
- // Force update of the title
- History.setTitle(newState);
-
- // Update HTML5 State
- History.saveState(newState);
- // Fire HTML5 Event
- //History.debug('History.pushState: trigger popstate');
- History.Adapter.trigger(window,'statechange');
- History.busy(false);
- }
- else {
- // Alias to PushState
- History.pushState(newState.data,newState.title,newState.url,false);
- }
- // End replaceState closure
- return true;
- };
- } // History.emulated.pushState
- // ====================================================================
- // Initialise
- // Non-Native pushState Implementation
- if ( History.emulated.pushState ) {
- /**
- * Ensure initial state is handled correctly
- */
- if ( History.getHash() && !History.emulated.hashChange ) {
- History.Adapter.onDomLoad(function(){
- History.Adapter.trigger(window,'hashchange');
- });
- }
- } // History.emulated.pushState
- }; // History.initHtml4
- // Try to Initialise History
- if ( typeof History.init !== 'undefined' ) {
- History.init();
- }
- })(window);
- /**
- * History.js Core
- * @author Benjamin Arthur Lupton <contact@balupton.com>
- * @copyright 2010-2011 Benjamin Arthur Lupton <contact@balupton.com>
- * @license New BSD License <http://creativecommons.org/licenses/BSD/>
- */
- (function(window,undefined){
- "use strict";
- // ========================================================================
- // Initialise
- // Localise Globals
- var
- console = window.console||undefined, // Prevent a JSLint complain
- document = window.document, // Make sure we are using the correct document
- navigator = window.navigator, // Make sure we are using the correct navigator
- sessionStorage = window.sessionStorage||false, // sessionStorage
- setTimeout = window.setTimeout,
- clearTimeout = window.clearTimeout,
- setInterval = window.setInterval,
- clearInterval = window.clearInterval,
- JSON = window.JSON,
- alert = window.alert,
- History = window.History = window.History||{}, // Public History Object
- history = window.history; // Old History Object
- try {
- sessionStorage.setItem('TEST', '1');
- sessionStorage.removeItem('TEST');
- } catch(e) {
- sessionStorage = false;
- }
- // MooTools Compatibility
- JSON.stringify = JSON.stringify||JSON.encode;
- JSON.parse = JSON.parse||JSON.decode;
- // Check Existence
- if ( typeof History.init !== 'undefined' ) {
- throw new Error('History.js Core has already been loaded...');
- }
- // Initialise History
- History.init = function(options){
- // Check Load Status of Adapter
- if ( typeof History.Adapter === 'undefined' ) {
- return false;
- }
- // Check Load Status of Core
- if ( typeof History.initCore !== 'undefined' ) {
- History.initCore();
- }
- // Check Load Status of HTML4 Support
- if ( typeof History.initHtml4 !== 'undefined' ) {
- History.initHtml4();
- }
- // Return true
- return true;
- };
- // ========================================================================
- // Initialise Core
- // Initialise Core
- History.initCore = function(options){
- // Initialise
- if ( typeof History.initCore.initialized !== 'undefined' ) {
- // Already Loaded
- return false;
- }
- else {
- History.initCore.initialized = true;
- }
- // ====================================================================
- // Options
- /**
- * History.options
- * Configurable options
- */
- History.options = History.options||{};
- /**
- * History.options.hashChangeInterval
- * How long should the interval be before hashchange checks
- */
- History.options.hashChangeInterval = History.options.hashChangeInterval || 100;
- /**
- * History.options.safariPollInterval
- * How long should the interval be before safari poll checks
- */
- History.options.safariPollInterval = History.options.safariPollInterval || 500;
- /**
- * History.options.doubleCheckInterval
- * How long should the interval be before we perform a double check
- */
- History.options.doubleCheckInterval = History.options.doubleCheckInterval || 500;
- /**
- * History.options.disableSuid
- * Force History not to append suid
- */
- History.options.disableSuid = History.options.disableSuid || false;
- /**
- * History.options.storeInterval
- * How long should we wait between store calls
- */
- History.options.storeInterval = History.options.storeInterval || 1000;
- /**
- * History.options.busyDelay
- * How long should we wait between busy events
- */
- History.options.busyDelay = History.options.busyDelay || 250;
- /**
- * History.options.debug
- * If true will enable debug messages to be logged
- */
- History.options.debug = History.options.debug || false;
- /**
- * History.options.initialTitle
- * What is the title of the initial state
- */
- History.options.initialTitle = History.options.initialTitle || document.title;
- /**
- * History.options.html4Mode
- * If true, will force HTMl4 mode (hashtags)
- */
- History.options.html4Mode = History.options.html4Mode || false;
- /**
- * History.options.delayInit
- * Want to override default options and call init manually.
- */
- History.options.delayInit = History.options.delayInit || false;
- // ====================================================================
- // Interval record
- /**
- * History.intervalList
- * List of intervals set, to be cleared when document is unloaded.
- */
- History.intervalList = [];
- /**
- * History.clearAllIntervals
- * Clears all setInterval instances.
- */
- History.clearAllIntervals = function(){
- var i, il = History.intervalList;
- if (typeof il !== "undefined" && il !== null) {
- for (i = 0; i < il.length; i++) {
- clearInterval(il[i]);
- }
- History.intervalList = null;
- }
- };
- // ====================================================================
- // Debug
- /**
- * History.debug(message,...)
- * Logs the passed arguments if debug enabled
- */
- History.debug = function(){
- if ( (History.options.debug||false) ) {
- History.log.apply(History,arguments);
- }
- };
- /**
- * History.log(message,...)
- * Logs the passed arguments
- */
- History.log = function(){
- // Prepare
- var
- consoleExists = !(typeof console === 'undefined' || typeof console.log === 'undefined' || typeof console.log.apply === 'undefined'),
- textarea = document.getElementById('log'),
- message,
- i,n,
- args,arg
- ;
- // Write to Console
- if ( consoleExists ) {
- args = Array.prototype.slice.call(arguments);
- message = args.shift();
- if ( typeof console.debug !== 'undefined' ) {
- console.debug.apply(console,[message,args]);
- }
- else {
- console.log.apply(console,[message,args]);
- }
- }
- else {
- message = ("\n"+arguments[0]+"\n");
- }
- // Write to log
- for ( i=1,n=arguments.length; i<n; ++i ) {
- arg = arguments[i];
- if ( typeof arg === 'object' && typeof JSON !== 'undefined' ) {
- try {
- arg = JSON.stringify(arg);
- }
- catch ( Exception ) {
- // Recursive Object
- }
- }
- message += "\n"+arg+"\n";
- }
- // Textarea
- if ( textarea ) {
- textarea.value += message+"\n-----\n";
- textarea.scrollTop = textarea.scrollHeight - textarea.clientHeight;
- }
- // No Textarea, No Console
- else if ( !consoleExists ) {
- alert(message);
- }
- // Return true
- return true;
- };
- // ====================================================================
- // Emulated Status
- /**
- * History.getInternetExplorerMajorVersion()
- * Get's the major version of Internet Explorer
- * @return {integer}
- * @license Public Domain
- * @author Benjamin Arthur Lupton <contact@balupton.com>
- * @author James Padolsey <https://gist.github.com/527683>
- */
- History.getInternetExplorerMajorVersion = function(){
- var result = History.getInternetExplorerMajorVersion.cached =
- (typeof History.getInternetExplorerMajorVersion.cached !== 'undefined')
- ? History.getInternetExplorerMajorVersion.cached
- : (function(){
- var v = 3,
- div = document.createElement('div'),
- all = div.getElementsByTagName('i');
- while ( (div.innerHTML = '<!--[if gt IE ' + (++v) + ']><i></i><![endif]-->') && all[0] ) {}
- return (v > 4) ? v : false;
- })()
- ;
- return result;
- };
- /**
- * History.isInternetExplorer()
- * Are we using Internet Explorer?
- * @return {boolean}
- * @license Public Domain
- * @author Benjamin Arthur Lupton <contact@balupton.com>
- */
- History.isInternetExplorer = function(){
- var result =
- History.isInternetExplorer.cached =
- (typeof History.isInternetExplorer.cached !== 'undefined')
- ? History.isInternetExplorer.cached
- : Boolean(History.getInternetExplorerMajorVersion())
- ;
- return result;
- };
- /**
- * History.emulated
- * Which features require emulating?
- */
- if (History.options.html4Mode) {
- History.emulated = {
- pushState : true,
- hashChange: true
- };
- }
- else {
- History.emulated = {
- pushState: !Boolean(
- window.history && window.history.pushState && window.history.replaceState
- && !(
- (/ Mobile\/([1-7][a-z]|(8([abcde]|f(1[0-8]))))/i).test(navigator.userAgent) /* disable for versions of iOS before version 4.3 (8F190) */
- || (/AppleWebKit\/5([0-2]|3[0-2])/i).test(navigator.userAgent) /* disable for the mercury iOS browser, or at least older versions of the webkit engine */
- )
- ),
- hashChange: Boolean(
- !(('onhashchange' in window) || ('onhashchange' in document))
- ||
- (History.isInternetExplorer() && History.getInternetExplorerMajorVersion() < 8)
- )
- };
- }
- /**
- * History.enabled
- * Is History enabled?
- */
- History.enabled = !History.emulated.pushState;
- /**
- * History.bugs
- * Which bugs are present
- */
- History.bugs = {
- /**
- * Safari 5 and Safari iOS 4 fail to return to the correct state once a hash is replaced by a `replaceState` call
- * https://bugs.webkit.org/show_bug.cgi?id=56249
- */
- setHash: Boolean(!History.emulated.pushState && navigator.vendor === 'Apple Computer, Inc.' && /AppleWebKit\/5([0-2]|3[0-3])/.test(navigator.userAgent)),
- /**
- * Safari 5 and Safari iOS 4 sometimes fail to apply the state change under busy conditions
- * https://bugs.webkit.org/show_bug.cgi?id=42940
- */
- safariPoll: Boolean(!History.emulated.pushState && navigator.vendor === 'Apple Computer, Inc.' && /AppleWebKit\/5([0-2]|3[0-3])/.test(navigator.userAgent)),
- /**
- * MSIE 6 and 7 sometimes do not apply a hash even it was told to (requiring a second call to the apply function)
- */
- ieDoubleCheck: Boolean(History.isInternetExplorer() && History.getInternetExplorerMajorVersion() < 8),
- /**
- * MSIE 6 requires the entire hash to be encoded for the hashes to trigger the onHashChange event
- */
- hashEscape: Boolean(History.isInternetExplorer() && History.getInternetExplorerMajorVersion() < 7)
- };
- /**
- * History.isEmptyObject(obj)
- * Checks to see if the Object is Empty
- * @param {Object} obj
- * @return {boolean}
- */
- History.isEmptyObject = function(obj) {
- for ( var name in obj ) {
- if ( obj.hasOwnProperty(name) ) {
- return false;
- }
- }
- return true;
- };
- /**
- * History.cloneObject(obj)
- * Clones a object and eliminate all references to the original contexts
- * @param {Object} obj
- * @return {Object}
- */
- History.cloneObject = function(obj) {
- var hash,newObj;
- if ( obj ) {
- hash = JSON.stringify(obj);
- newObj = JSON.parse(hash);
- }
- else {
- newObj = {};
- }
- return newObj;
- };
- // ====================================================================
- // URL Helpers
- /**
- * History.getRootUrl()
- * Turns "http://mysite.com/dir/page.html?asd" into "http://mysite.com"
- * @return {String} rootUrl
- */
- History.getRootUrl = function(){
- // Create
- var rootUrl = document.location.protocol+'//'+(document.location.hostname||document.location.host);
- if ( document.location.port||false ) {
- rootUrl += ':'+document.location.port;
- }
- rootUrl += '/';
- // Return
- return rootUrl;
- };
- /**
- * History.getBaseHref()
- * Fetches the `href` attribute of the `<base href="...">` element if it exists
- * @return {String} baseHref
- */
- History.getBaseHref = function(){
- // Create
- var
- baseElements = document.getElementsByTagName('base'),
- baseElement = null,
- baseHref = '';
- // Test for Base Element
- if ( baseElements.length === 1 ) {
- // Prepare for Base Element
- baseElement = baseElements[0];
- baseHref = baseElement.href.replace(/[^\/]+$/,'');
- }
- // Adjust trailing slash
- baseHref = baseHref.replace(/\/+$/,'');
- if ( baseHref ) baseHref += '/';
- // Return
- return baseHref;
- };
- /**
- * History.getBaseUrl()
- * Fetches the baseHref or basePageUrl or rootUrl (whichever one exists first)
- * @return {String} baseUrl
- */
- History.getBaseUrl = function(){
- // Create
- var baseUrl = History.getBaseHref()||History.getBasePageUrl()||History.getRootUrl();
- // Return
- return baseUrl;
- };
- /**
- * History.getPageUrl()
- * Fetches the URL of the current page
- * @return {String} pageUrl
- */
- History.getPageUrl = function(){
- // Fetch
- var
- State = History.getState(false,false),
- stateUrl = (State||{}).url||History.getLocationHref(),
- pageUrl;
- // Create
- pageUrl = stateUrl.replace(/\/+$/,'').replace(/[^\/]+$/,function(part,index,string){
- return (/\./).test(part) ? part : part+'/';
- });
- // Return
- return pageUrl;
- };
- /**
- * History.getBasePageUrl()
- * Fetches the Url of the directory of the current page
- * @return {String} basePageUrl
- */
- History.getBasePageUrl = function(){
- // Create
- var basePageUrl = (History.getLocationHref()).replace(/[#\?].*/,'').replace(/[^\/]+$/,function(part,index,string){
- return (/[^\/]$/).test(part) ? '' : part;
- }).replace(/\/+$/,'')+'/';
- // Return
- return basePageUrl;
- };
- /**
- * History.getFullUrl(url)
- * Ensures that we have an absolute URL and not a relative URL
- * @param {string} url
- * @param {Boolean} allowBaseHref
- * @return {string} fullUrl
- */
- History.getFullUrl = function(url,allowBaseHref){
- // Prepare
- var fullUrl = url, firstChar = url.substring(0,1);
- allowBaseHref = (typeof allowBaseHref === 'undefined') ? true : allowBaseHref;
- // Check
- if ( /[a-z]+\:\/\//.test(url) ) {
- // Full URL
- }
- else if ( firstChar === '/' ) {
- // Root URL
- fullUrl = History.getRootUrl()+url.replace(/^\/+/,'');
- }
- else if ( firstChar === '#' ) {
- // Anchor URL
- fullUrl = History.getPageUrl().replace(/#.*/,'')+url;
- }
- else if ( firstChar === '?' ) {
- // Query URL
- fullUrl = History.getPageUrl().replace(/[\?#].*/,'')+url;
- }
- else {
- // Relative URL
- if ( allowBaseHref ) {
- fullUrl = History.getBaseUrl()+url.replace(/^(\.\/)+/,'');
- } else {
- fullUrl = History.getBasePageUrl()+url.replace(/^(\.\/)+/,'');
- }
- // We have an if condition above as we do not want hashes
- // which are relative to the baseHref in our URLs
- // as if the baseHref changes, then all our bookmarks
- // would now point to different locations
- // whereas the basePageUrl will always stay the same
- }
- // Return
- return fullUrl.replace(/\#$/,'');
- };
- /**
- * History.getShortUrl(url)
- * Ensures that we have a relative URL and not a absolute URL
- * @param {string} url
- * @return {string} url
- */
- History.getShortUrl = function(url){
- // Prepare
- var shortUrl = url, baseUrl = History.getBaseUrl(), rootUrl = History.getRootUrl();
- // Trim baseUrl
- if ( History.emulated.pushState ) {
- // We are in a if statement as when pushState is not emulated
- // The actual url these short urls are relative to can change
- // So within the same session, we the url may end up somewhere different
- shortUrl = shortUrl.replace(baseUrl,'');
- }
- // Trim rootUrl
- shortUrl = shortUrl.replace(rootUrl,'/');
- // Ensure we can still detect it as a state
- if ( History.isTraditionalAnchor(shortUrl) ) {
- shortUrl = './'+shortUrl;
- }
- // Clean It
- shortUrl = shortUrl.replace(/^(\.\/)+/g,'./').replace(/\#$/,'');
- // Return
- return shortUrl;
- };
- /**
- * History.getLocationHref(document)
- * Returns a normalized version of document.location.href
- * accounting for browser inconsistencies, etc.
- *
- * This URL will be URI-encoded and will include the hash
- *
- * @param {object} document
- * @return {string} url
- */
- History.getLocationHref = function(doc) {
- doc = doc || document;
- // most of the time, this will be true
- if (doc.URL === doc.location.href)
- return doc.location.href;
- // some versions of webkit URI-decode document.location.href
- // but they leave document.URL in an encoded state
- if (doc.location.href === decodeURIComponent(doc.URL))
- return doc.URL;
- // FF 3.6 only updates document.URL when a page is reloaded
- // document.location.href is updated correctly
- if (doc.location.hash && decodeURIComponent(doc.location.href.replace(/^[^#]+/, "")) === doc.location.hash)
- return doc.location.href;
- if (doc.URL.indexOf('#') == -1 && doc.location.href.indexOf('#') != -1)
- return doc.location.href;
-
- return doc.URL || doc.location.href;
- };
- // ====================================================================
- // State Storage
- /**
- * History.store
- * The store for all session specific data
- */
- History.store = {};
- /**
- * History.idToState
- * 1-1: State ID to State Object
- */
- History.idToState = History.idToState||{};
- /**
- * History.stateToId
- * 1-1: State String to State ID
- */
- History.stateToId = History.stateToId||{};
- /**
- * History.urlToId
- * 1-1: State URL to State ID
- */
- History.urlToId = History.urlToId||{};
- /**
- * History.storedStates
- * Store the states in an array
- */
- History.storedStates = History.storedStates||[];
- /**
- * History.savedStates
- * Saved the states in an array
- */
- History.savedStates = History.savedStates||[];
- /**
- * History.noramlizeStore()
- * Noramlize the store by adding necessary values
- */
- History.normalizeStore = function(){
- History.store.idToState = History.store.idToState||{};
- History.store.urlToId = History.store.urlToId||{};
- History.store.stateToId = History.store.stateToId||{};
- };
- /**
- * History.getState()
- * Get an object containing the data, title and url of the current state
- * @param {Boolean} friendly
- * @param {Boolean} create
- * @return {Object} State
- */
- History.getState = function(friendly,create){
- // Prepare
- if ( typeof friendly === 'undefined' ) { friendly = true; }
- if ( typeof create === 'undefined' ) { create = true; }
- // Fetch
- var State = History.getLastSavedState();
- // Create
- if ( !State && create ) {
- State = History.createStateObject();
- }
- // Adjust
- if ( friendly ) {
- State = History.cloneObject(State);
- State.url = State.cleanUrl||State.url;
- }
- // Return
- return State;
- };
- /**
- * History.getIdByState(State)
- * Gets a ID for a State
- * @param {State} newState
- * @return {String} id
- */
- History.getIdByState = function(newState){
- // Fetch ID
- var id = History.extractId(newState.url),
- str;
- if ( !id ) {
- // Find ID via State String
- str = History.getStateString(newState);
- if ( typeof History.stateToId[str] !== 'undefined' ) {
- id = History.stateToId[str];
- }
- else if ( typeof History.store.stateToId[str] !== 'undefined' ) {
- id = History.store.stateToId[str];
- }
- else {
- // Generate a new ID
- while ( true ) {
- id = (new Date()).getTime() + String(Math.random()).replace(/\D/g,'');
- if ( typeof History.idToState[id] === 'undefined' && typeof History.store.idToState[id] === 'undefined' ) {
- break;
- }
- }
- // Apply the new State to the ID
- History.stateToId[str] = id;
- History.idToState[id] = newState;
- }
- }
- // Return ID
- return id;
- };
- /**
- * History.normalizeState(State)
- * Expands a State Object
- * @param {object} State
- * @return {object}
- */
- History.normalizeState = function(oldState){
- // Variables
- var newState, dataNotEmpty;
- // Prepare
- if ( !oldState || (typeof oldState !== 'object') ) {
- oldState = {};
- }
- // Check
- if ( typeof oldState.normalized !== 'undefined' ) {
- return oldState;
- }
- // Adjust
- if ( !oldState.data || (typeof oldState.data !== 'object') ) {
- oldState.data = {};
- }
- // ----------------------------------------------------------------
- // Create
- newState = {};
- newState.normalized = true;
- newState.title = oldState.title||'';
- newState.url = History.getFullUrl(oldState.url?oldState.url:(History.getLocationHref()));
- newState.hash = History.getShortUrl(newState.url);
- newState.data = History.cloneObject(oldState.data);
- // Fetch ID
- newState.id = History.getIdByState(newState);
- // ----------------------------------------------------------------
- // Clean the URL
- newState.cleanUrl = newState.url.replace(/\??\&_suid.*/,'');
- newState.url = newState.cleanUrl;
- // Check to see if we have more than just a url
- dataNotEmpty = !History.isEmptyObject(newState.data);
- // Apply
- if ( (newState.title || dataNotEmpty) && History.options.disableSuid !== true ) {
- // Add ID to Hash
- newState.hash = History.getShortUrl(newState.url).replace(/\??\&_suid.*/,'');
- if ( !/\?/.test(newState.hash) ) {
- newState.hash += '?';
- }
- newState.hash += '&_suid='+newState.id;
- }
- // Create the Hashed URL
- newState.hashedUrl = History.getFullUrl(newState.hash);
- // ----------------------------------------------------------------
- // Update the URL if we have a duplicate
- if ( (History.emulated.pushState || History.bugs.safariPoll) && History.hasUrlDuplicate(newState) ) {
- newState.url = newState.hashedUrl;
- }
- // ----------------------------------------------------------------
- // Return
- return newState;
- };
- /**
- * History.createStateObject(data,title,url)
- * Creates a object based on the data, title and url state params
- * @param {object} data
- * @param {string} title
- * @param {string} url
- * @return {object}
- */
- History.createStateObject = function(data,title,url){
- // Hashify
- var State = {
- 'data': data,
- 'title': title,
- 'url': url
- };
- // Expand the State
- State = History.normalizeState(State);
- // Return object
- return State;
- };
- /**
- * History.getStateById(id)
- * Get a state by it's UID
- * @param {String} id
- */
- History.getStateById = function(id){
- // Prepare
- id = String(id);
- // Retrieve
- var State = History.idToState[id] || History.store.idToState[id] || undefined;
- // Return State
- return State;
- };
- /**
- * Get a State's String
- * @param {State} passedState
- */
- History.getStateString = function(passedState){
- // Prepare
- var State, cleanedState, str;
- // Fetch
- State = History.normalizeState(passedState);
- // Clean
- cleanedState = {
- data: State.data,
- title: passedState.title,
- url: passedState.url
- };
- // Fetch
- str = JSON.stringify(cleanedState);
- // Return
- return str;
- };
- /**
- * Get a State's ID
- * @param {State} passedState
- * @return {String} id
- */
- History.getStateId = function(passedState){
- // Prepare
- var State, id;
- // Fetch
- State = History.normalizeState(passedState);
- // Fetch
- id = State.id;
- // Return
- return id;
- };
- /**
- * History.getHashByState(State)
- * Creates a Hash for the State Object
- * @param {State} passedState
- * @return {String} hash
- */
- History.getHashByState = function(passedState){
- // Prepare
- var State, hash;
- // Fetch
- State = History.normalizeState(passedState);
- // Hash
- hash = State.hash;
- // Return
- return hash;
- };
- /**
- * History.extractId(url_or_hash)
- * Get a State ID by it's URL or Hash
- * @param {string} url_or_hash
- * @return {string} id
- */
- History.extractId = function ( url_or_hash ) {
- // Prepare
- var id,parts,url, tmp;
- // Extract
-
- // If the URL has a #, use the id from before the #
- if (url_or_hash.indexOf('#') != -1)
- {
- tmp = url_or_hash.split("#")[0];
- }
- else
- {
- tmp = url_or_hash;
- }
-
- parts = /(.*)\&_suid=([0-9]+)$/.exec(tmp);
- url = parts ? (parts[1]||url_or_hash) : url_or_hash;
- id = parts ? String(parts[2]||'') : '';
- // Return
- return id||false;
- };
- /**
- * History.isTraditionalAnchor
- * Checks to see if the url is a traditional anchor or not
- * @param {String} url_or_hash
- * @return {Boolean}
- */
- History.isTraditionalAnchor = function(url_or_hash){
- // Check
- var isTraditional = !(/[\/\?\.]/.test(url_or_hash));
- // Return
- return isTraditional;
- };
- /**
- * History.extractState
- * Get a State by it's URL or Hash
- * @param {String} url_or_hash
- * @return {State|null}
- */
- History.extractState = function(url_or_hash,create){
- // Prepare
- var State = null, id, url;
- create = create||false;
- // Fetch SUID
- id = History.extractId(url_or_hash);
- if ( id ) {
- State = History.getStateById(id);
- }
- // Fetch SUID returned no State
- if ( !State ) {
- // Fetch URL
- url = History.getFullUrl(url_or_hash);
- // Check URL
- id = History.getIdByUrl(url)||false;
- if ( id ) {
- State = History.getStateById(id);
- }
- // Create State
- if ( !State && create && !History.isTraditionalAnchor(url_or_hash) ) {
- State = History.createStateObject(null,null,url);
- }
- }
- // Return
- return State;
- };
- /**
- * History.getIdByUrl()
- * Get a State ID by a State URL
- */
- History.getIdByUrl = function(url){
- // Fetch
- var id = History.urlToId[url] || History.store.urlToId[url] || undefined;
- // Return
- return id;
- };
- /**
- * History.getLastSavedState()
- * Get an object containing the data, title and url of the current state
- * @return {Object} State
- */
- History.getLastSavedState = function(){
- return History.savedStates[History.savedStates.length-1]||undefined;
- };
- /**
- * History.getLastStoredState()
- * Get an object containing the data, title and url of the current state
- * @return {Object} State
- */
- History.getLastStoredState = function(){
- return History.storedStates[History.storedStates.length-1]||undefined;
- };
- /**
- * History.hasUrlDuplicate
- * Checks if a Url will have a url conflict
- * @param {Object} newState
- * @return {Boolean} hasDuplicate
- */
- History.hasUrlDuplicate = function(newState) {
- // Prepare
- var hasDuplicate = false,
- oldState;
- // Fetch
- oldState = History.extractState(newState.url);
- // Check
- hasDuplicate = oldState && oldState.id !== newState.id;
- // Return
- return hasDuplicate;
- };
- /**
- * History.storeState
- * Store a State
- * @param {Object} newState
- * @return {Object} newState
- */
- History.storeState = function(newState){
- // Store the State
- History.urlToId[newState.url] = newState.id;
- // Push the State
- History.storedStates.push(History.cloneObject(newState));
- // Return newState
- return newState;
- };
- /**
- * History.isLastSavedState(newState)
- * Tests to see if the state is the last state
- * @param {Object} newState
- * @return {boolean} isLast
- */
- History.isLastSavedState = function(newState){
- // Prepare
- var isLast = false,
- newId, oldState, oldId;
- // Check
- if ( History.savedStates.length ) {
- newId = newState.id;
- oldState = History.getLastSavedState();
- oldId = oldState.id;
- // Check
- isLast = (newId === oldId);
- }
- // Return
- return isLast;
- };
- /**
- * History.saveState
- * Push a State
- * @param {Object} newState
- * @return {boolean} changed
- */
- History.saveState = function(newState){
- // Check Hash
- if ( History.isLastSavedState(newState) ) {
- return false;
- }
- // Push the State
- History.savedStates.push(History.cloneObject(newState));
- // Return true
- return true;
- };
- /**
- * History.getStateByIndex()
- * Gets a state by the index
- * @param {integer} index
- * @return {Object}
- */
- History.getStateByIndex = function(index){
- // Prepare
- var State = null;
- // Handle
- if ( typeof index === 'undefined' ) {
- // Get the last inserted
- State = History.savedStates[History.savedStates.length-1];
- }
- else if ( index < 0 ) {
- // Get from the end
- State = History.savedStates[History.savedStates.length+index];
- }
- else {
- // Get from the beginning
- State = History.savedStates[index];
- }
- // Return State
- return State;
- };
-
- /**
- * History.getCurrentIndex()
- * Gets the current index
- * @return (integer)
- */
- History.getCurrentIndex = function(){
- // Prepare
- var index = null;
-
- // No states saved
- if(History.savedStates.length < 1) {
- index = 0;
- }
- else {
- index = History.savedStates.length-1;
- }
- return index;
- };
- // ====================================================================
- // Hash Helpers
- /**
- * History.getHash()
- * @param {Location=} location
- * Gets the current document hash
- * Note: unlike location.hash, this is guaranteed to return the escaped hash in all browsers
- * @return {string}
- */
- History.getHash = function(doc){
- var url = History.getLocationHref(doc),
- hash;
- hash = History.getHashByUrl(url);
- return hash;
- };
- /**
- * History.unescapeHash()
- * normalize and Unescape a Hash
- * @param {String} hash
- * @return {string}
- */
- History.unescapeHash = function(hash){
- // Prepare
- var result = History.normalizeHash(hash);
- // Unescape hash
- result = decodeURIComponent(result);
- // Return result
- return result;
- };
- /**
- * History.normalizeHash()
- * normalize a hash across browsers
- * @return {string}
- */
- History.normalizeHash = function(hash){
- // Prepare
- var result = hash.replace(/[^#]*#/,'').replace(/#.*/, '');
- // Return result
- return result;
- };
- /**
- * History.setHash(hash)
- * Sets the document hash
- * @param {string} hash
- * @return {History}
- */
- History.setHash = function(hash,queue){
- // Prepare
- var State, pageUrl;
- // Handle Queueing
- if ( queue !== false && History.busy() ) {
- // Wait + Push to Queue
- //History.debug('History.setHash: we must wait', arguments);
- History.pushQueue({
- scope: History,
- callback: History.setHash,
- args: arguments,
- queue: queue
- });
- return false;
- }
- // Log
- //History.debug('History.setHash: called',hash);
- // Make Busy + Continue
- History.busy(true);
- // Check if hash is a state
- State = History.extractState(hash,true);
- if ( State && !History.emulated.pushState ) {
- // Hash is a state so skip the setHash
- //History.debug('History.setHash: Hash is a state so skipping the hash set with a direct pushState call',arguments);
- // PushState
- History.pushState(State.data,State.title,State.url,false);
- }
- else if ( History.getHash() !== hash ) {
- // Hash is a proper hash, so apply it
- // Handle browser bugs
- if ( History.bugs.setHash ) {
- // Fix Safari Bug https://bugs.webkit.org/show_bug.cgi?id=56249
- // Fetch the base page
- pageUrl = History.getPageUrl();
- // Safari hash apply
- History.pushState(null,null,pageUrl+'#'+hash,false);
- }
- else {
- // Normal hash apply
- document.location.hash = hash;
- }
- }
- // Chain
- return History;
- };
- /**
- * History.escape()
- * normalize and Escape a Hash
- * @return {string}
- */
- History.escapeHash = function(hash){
- // Prepare
- var result = History.normalizeHash(hash);
- // Escape hash
- result = window.encodeURIComponent(result);
- // IE6 Escape Bug
- if ( !History.bugs.hashEscape ) {
- // Restore common parts
- result = result
- .replace(/\%21/g,'!')
- .replace(/\%26/g,'&')
- .replace(/\%3D/g,'=')
- .replace(/\%3F/g,'?');
- }
- // Return result
- return result;
- };
- /**
- * History.getHashByUrl(url)
- * Extracts the Hash from a URL
- * @param {string} url
- * @return {string} url
- */
- History.getHashByUrl = function(url){
- // Extract the hash
- var hash = String(url)
- .replace(/([^#]*)#?([^#]*)#?(.*)/, '$2')
- ;
- // Unescape hash
- hash = History.unescapeHash(hash);
- // Return hash
- return hash;
- };
- /**
- * History.setTitle(title)
- * Applies the title to the document
- * @param {State} newState
- * @return {Boolean}
- */
- History.setTitle = function(newState){
- // Prepare
- var title = newState.title,
- firstState;
- // Initial
- if ( !title ) {
- firstState = History.getStateByIndex(0);
- if ( firstState && firstState.url === newState.url ) {
- title = firstState.title||History.options.initialTitle;
- }
- }
- // Apply
- try {
- document.getElementsByTagName('title')[0].innerHTML = title.replace('<','<').replace('>','>').replace(' & ',' & ');
- }
- catch ( Exception ) { }
- document.title = title;
- // Chain
- return History;
- };
- // ====================================================================
- // Queueing
- /**
- * History.queues
- * The list of queues to use
- * First In, First Out
- */
- History.queues = [];
- /**
- * History.busy(value)
- * @param {boolean} value [optional]
- * @return {boolean} busy
- */
- History.busy = function(value){
- // Apply
- if ( typeof value !== 'undefined' ) {
- //History.debug('History.busy: changing ['+(History.busy.flag||false)+'] to ['+(value||false)+']', History.queues.length);
- History.busy.flag = value;
- }
- // Default
- else if ( typeof History.busy.flag === 'undefined' ) {
- History.busy.flag = false;
- }
- // Queue
- if ( !History.busy.flag ) {
- // Execute the next item in the queue
- clearTimeout(History.busy.timeout);
- var fireNext = function(){
- var i, queue, item;
- if ( History.busy.flag ) return;
- for ( i=History.queues.length-1; i >= 0; --i ) {
- queue = History.queues[i];
- if ( queue.length === 0 ) continue;
- item = queue.shift();
- History.fireQueueItem(item);
- History.busy.timeout = setTimeout(fireNext,History.options.busyDelay);
- }
- };
- History.busy.timeout = setTimeout(fireNext,History.options.busyDelay);
- }
- // Return
- return History.busy.flag;
- };
- /**
- * History.busy.flag
- */
- History.busy.flag = false;
- /**
- * History.fireQueueItem(item)
- * Fire a Queue Item
- * @param {Object} item
- * @return {Mixed} result
- */
- History.fireQueueItem = function(item){
- return item.callback.apply(item.scope||History,item.args||[]);
- };
- /**
- * History.pushQueue(callback,args)
- * Add an item to the queue
- * @param {Object} item [scope,callback,args,queue]
- */
- History.pushQueue = function(item){
- // Prepare the queue
- History.queues[item.queue||0] = History.queues[item.queue||0]||[];
- // Add to the queue
- History.queues[item.queue||0].push(item);
- // Chain
- return History;
- };
- /**
- * History.queue (item,queue), (func,queue), (func), (item)
- * Either firs the item now if not busy, or adds it to the queue
- */
- History.queue = function(item,queue){
- // Prepare
- if ( typeof item === 'function' ) {
- item = {
- callback: item
- };
- }
- if ( typeof queue !== 'undefined' ) {
- item.queue = queue;
- }
- // Handle
- if ( History.busy() ) {
- History.pushQueue(item);
- } else {
- History.fireQueueItem(item);
- }
- // Chain
- return History;
- };
- /**
- * History.clearQueue()
- * Clears the Queue
- */
- History.clearQueue = function(){
- History.busy.flag = false;
- History.queues = [];
- return History;
- };
- // ====================================================================
- // IE Bug Fix
- /**
- * History.stateChanged
- * States whether or not the state has changed since the last double check was initialised
- */
- History.stateChanged = false;
- /**
- * History.doubleChecker
- * Contains the timeout used for the double checks
- */
- History.doubleChecker = false;
- /**
- * History.doubleCheckComplete()
- * Complete a double check
- * @return {History}
- */
- History.doubleCheckComplete = function(){
- // Update
- History.stateChanged = true;
- // Clear
- History.doubleCheckClear();
- // Chain
- return History;
- };
- /**
- * History.doubleCheckClear()
- * Clear a double check
- * @return {History}
- */
- History.doubleCheckClear = function(){
- // Clear
- if ( History.doubleChecker ) {
- clearTimeout(History.doubleChecker);
- History.doubleChecker = false;
- }
- // Chain
- return History;
- };
- /**
- * History.doubleCheck()
- * Create a double check
- * @return {History}
- */
- History.doubleCheck = function(tryAgain){
- // Reset
- History.stateChanged = false;
- History.doubleCheckClear();
- // Fix IE6,IE7 bug where calling history.back or history.forward does not actually change the hash (whereas doing it manually does)
- // Fix Safari 5 bug where sometimes the state does not change: https://bugs.webkit.org/show_bug.cgi?id=42940
- if ( History.bugs.ieDoubleCheck ) {
- // Apply Check
- History.doubleChecker = setTimeout(
- function(){
- History.doubleCheckClear();
- if ( !History.stateChanged ) {
- //History.debug('History.doubleCheck: State has not yet changed, trying again', arguments);
- // Re-Attempt
- tryAgain();
- }
- return true;
- },
- History.options.doubleCheckInterval
- );
- }
- // Chain
- return History;
- };
- // ====================================================================
- // Safari Bug Fix
- /**
- * History.safariStatePoll()
- * Poll the current state
- * @return {History}
- */
- History.safariStatePoll = function(){
- // Poll the URL
- // Get the Last State which has the new URL
- var
- urlState = History.extractState(History.getLocationHref()),
- newState;
- // Check for a difference
- if ( !History.isLastSavedState(urlState) ) {
- newState = urlState;
- }
- else {
- return;
- }
- // Check if we have a state with that url
- // If not create it
- if ( !newState ) {
- //History.debug('History.safariStatePoll: new');
- newState = History.createStateObject();
- }
- // Apply the New State
- //History.debug('History.safariStatePoll: trigger');
- History.Adapter.trigger(window,'popstate');
- // Chain
- return History;
- };
- // ====================================================================
- // State Aliases
- /**
- * History.back(queue)
- * Send the browser history back one item
- * @param {Integer} queue [optional]
- */
- History.back = function(queue){
- //History.debug('History.back: called', arguments);
- // Handle Queueing
- if ( queue !== false && History.busy() ) {
- // Wait + Push to Queue
- //History.debug('History.back: we must wait', arguments);
- History.pushQueue({
- scope: History,
- callback: History.back,
- args: arguments,
- queue: queue
- });
- return false;
- }
- // Make Busy + Continue
- History.busy(true);
- // Fix certain browser bugs that prevent the state from changing
- History.doubleCheck(function(){
- History.back(false);
- });
- // Go back
- history.go(-1);
- // End back closure
- return true;
- };
- /**
- * History.forward(queue)
- * Send the browser history forward one item
- * @param {Integer} queue [optional]
- */
- History.forward = function(queue){
- //History.debug('History.forward: called', arguments);
- // Handle Queueing
- if ( queue !== false && History.busy() ) {
- // Wait + Push to Queue
- //History.debug('History.forward: we must wait', arguments);
- History.pushQueue({
- scope: History,
- callback: History.forward,
- args: arguments,
- queue: queue
- });
- return false;
- }
- // Make Busy + Continue
- History.busy(true);
- // Fix certain browser bugs that prevent the state from changing
- History.doubleCheck(function(){
- History.forward(false);
- });
- // Go forward
- history.go(1);
- // End forward closure
- return true;
- };
- /**
- * History.go(index,queue)
- * Send the browser history back or forward index times
- * @param {Integer} queue [optional]
- */
- History.go = function(index,queue){
- //History.debug('History.go: called', arguments);
- // Prepare
- var i;
- // Handle
- if ( index > 0 ) {
- // Forward
- for ( i=1; i<=index; ++i ) {
- History.forward(queue);
- }
- }
- else if ( index < 0 ) {
- // Backward
- for ( i=-1; i>=index; --i ) {
- History.back(queue);
- }
- }
- else {
- throw new Error('History.go: History.go requires a positive or negative integer passed.');
- }
- // Chain
- return History;
- };
- // ====================================================================
- // HTML5 State Support
- // Non-Native pushState Implementation
- if ( History.emulated.pushState ) {
- /*
- * Provide Skeleton for HTML4 Browsers
- */
- // Prepare
- var emptyFunction = function(){};
- History.pushState = History.pushState||emptyFunction;
- History.replaceState = History.replaceState||emptyFunction;
- } // History.emulated.pushState
- // Native pushState Implementation
- else {
- /*
- * Use native HTML5 History API Implementation
- */
- /**
- * History.onPopState(event,extra)
- * Refresh the Current State
- */
- History.onPopState = function(event,extra){
- // Prepare
- var stateId = false, newState = false, currentHash, currentState;
- // Reset the double check
- History.doubleCheckComplete();
- // Check for a Hash, and handle apporiatly
- currentHash = History.getHash();
- if ( currentHash ) {
- // Expand Hash
- currentState = History.extractState(currentHash||History.getLocationHref(),true);
- if ( currentState ) {
- // We were able to parse it, it must be a State!
- // Let's forward to replaceState
- //History.debug('History.onPopState: state anchor', currentHash, currentState);
- History.replaceState(currentState.data, currentState.title, currentState.url, false);
- }
- else {
- // Traditional Anchor
- //History.debug('History.onPopState: traditional anchor', currentHash);
- History.Adapter.trigger(window,'anchorchange');
- History.busy(false);
- }
- // We don't care for hashes
- History.expectedStateId = false;
- return false;
- }
- // Ensure
- stateId = History.Adapter.extractEventData('state',event,extra) || false;
- // Fetch State
- if ( stateId ) {
- // Vanilla: Back/forward button was used
- newState = History.getStateById(stateId);
- }
- else if ( History.expectedStateId ) {
- // Vanilla: A new state was pushed, and popstate was called manually
- newState = History.getStateById(History.expectedStateId);
- }
- else {
- // Initial State
- newState = History.extractState(History.getLocationHref());
- }
- // The State did not exist in our store
- if ( !newState ) {
- // Regenerate the State
- newState = History.createStateObject(null,null,History.getLocationHref());
- }
- // Clean
- History.expectedStateId = false;
- // Check if we are the same state
- if ( History.isLastSavedState(newState) ) {
- // There has been no change (just the page's hash has finally propagated)
- //History.debug('History.onPopState: no change', newState, History.savedStates);
- History.busy(false);
- return false;
- }
- // Store the State
- History.storeState(newState);
- History.saveState(newState);
- // Force update of the title
- History.setTitle(newState);
- // Fire Our Event
- History.Adapter.trigger(window,'statechange');
- History.busy(false);
- // Return true
- return true;
- };
- History.Adapter.bind(window,'popstate',History.onPopState);
- /**
- * History.pushState(data,title,url)
- * Add a new State to the history object, become it, and trigger onpopstate
- * We have to trigger for HTML4 compatibility
- * @param {object} data
- * @param {string} title
- * @param {string} url
- * @return {true}
- */
- History.pushState = function(data,title,url,queue){
- //History.debug('History.pushState: called', arguments);
- // Check the State
- if ( History.getHashByUrl(url) && History.emulated.pushState ) {
- throw new Error('History.js does not support states with fragement-identifiers (hashes/anchors).');
- }
- // Handle Queueing
- if ( queue !== false && History.busy() ) {
- // Wait + Push to Queue
- //History.debug('History.pushState: we must wait', arguments);
- History.pushQueue({
- scope: History,
- callback: History.pushState,
- args: arguments,
- queue: queue
- });
- return false;
- }
- // Make Busy + Continue
- History.busy(true);
- // Create the newState
- var newState = History.createStateObject(data,title,url);
- // Check it
- if ( History.isLastSavedState(newState) ) {
- // Won't be a change
- History.busy(false);
- }
- else {
- // Store the newState
- History.storeState(newState);
- History.expectedStateId = newState.id;
- // Push the newState
- history.pushState(newState.id,newState.title,newState.url);
- // Fire HTML5 Event
- History.Adapter.trigger(window,'popstate');
- }
- // End pushState closure
- return true;
- };
- /**
- * History.replaceState(data,title,url)
- * Replace the State and trigger onpopstate
- * We have to trigger for HTML4 compatibility
- * @param {object} data
- * @param {string} title
- * @param {string} url
- * @return {true}
- */
- History.replaceState = function(data,title,url,queue){
- //History.debug('History.replaceState: called', arguments);
- // Check the State
- if ( History.getHashByUrl(url) && History.emulated.pushState ) {
- throw new Error('History.js does not support states with fragement-identifiers (hashes/anchors).');
- }
- // Handle Queueing
- if ( queue !== false && History.busy() ) {
- // Wait + Push to Queue
- //History.debug('History.replaceState: we must wait', arguments);
- History.pushQueue({
- scope: History,
- callback: History.replaceState,
- args: arguments,
- queue: queue
- });
- return false;
- }
- // Make Busy + Continue
- History.busy(true);
- // Create the newState
- var newState = History.createStateObject(data,title,url);
- // Check it
- if ( History.isLastSavedState(newState) ) {
- // Won't be a change
- History.busy(false);
- }
- else {
- // Store the newState
- History.storeState(newState);
- History.expectedStateId = newState.id;
- // Push the newState
- history.replaceState(newState.id,newState.title,newState.url);
- // Fire HTML5 Event
- History.Adapter.trigger(window,'popstate');
- }
- // End replaceState closure
- return true;
- };
- } // !History.emulated.pushState
- // ====================================================================
- // Initialise
- /**
- * Load the Store
- */
- if ( sessionStorage ) {
- // Fetch
- try {
- History.store = JSON.parse(sessionStorage.getItem('History.store'))||{};
- }
- catch ( err ) {
- History.store = {};
- }
- // Normalize
- History.normalizeStore();
- }
- else {
- // Default Load
- History.store = {};
- History.normalizeStore();
- }
- /**
- * Clear Intervals on exit to prevent memory leaks
- */
- History.Adapter.bind(window,"unload",History.clearAllIntervals);
- /**
- * Create the initial State
- */
- History.saveState(History.storeState(History.extractState(History.getLocationHref(),true)));
- /**
- * Bind for Saving Store
- */
- if ( sessionStorage ) {
- // When the page is closed
- History.onUnload = function(){
- // Prepare
- var currentStore, item, currentStoreString;
- // Fetch
- try {
- currentStore = JSON.parse(sessionStorage.getItem('History.store'))||{};
- }
- catch ( err ) {
- currentStore = {};
- }
- // Ensure
- currentStore.idToState = currentStore.idToState || {};
- currentStore.urlToId = currentStore.urlToId || {};
- currentStore.stateToId = currentStore.stateToId || {};
- // Sync
- for ( item in History.idToState ) {
- if ( !History.idToState.hasOwnProperty(item) ) {
- continue;
- }
- currentStore.idToState[item] = History.idToState[item];
- }
- for ( item in History.urlToId ) {
- if ( !History.urlToId.hasOwnProperty(item) ) {
- continue;
- }
- currentStore.urlToId[item] = History.urlToId[item];
- }
- for ( item in History.stateToId ) {
- if ( !History.stateToId.hasOwnProperty(item) ) {
- continue;
- }
- currentStore.stateToId[item] = History.stateToId[item];
- }
- // Update
- History.store = currentStore;
- History.normalizeStore();
- // In Safari, going into Private Browsing mode causes the
- // Session Storage object to still exist but if you try and use
- // or set any property/function of it it throws the exception
- // "QUOTA_EXCEEDED_ERR: DOM Exception 22: An attempt was made to
- // add something to storage that exceeded the quota." infinitely
- // every second.
- currentStoreString = JSON.stringify(currentStore);
- try {
- // Store
- sessionStorage.setItem('History.store', currentStoreString);
- }
- catch (e) {
- if (e.code === DOMException.QUOTA_EXCEEDED_ERR) {
- if (sessionStorage.length) {
- // Workaround for a bug seen on iPads. Sometimes the quota exceeded error comes up and simply
- // removing/resetting the storage can work.
- sessionStorage.removeItem('History.store');
- sessionStorage.setItem('History.store', currentStoreString);
- } else {
- // Otherwise, we're probably private browsing in Safari, so we'll ignore the exception.
- }
- } else {
- throw e;
- }
- }
- };
- // For Internet Explorer
- History.intervalList.push(setInterval(History.onUnload,History.options.storeInterval));
- // For Other Browsers
- History.Adapter.bind(window,'beforeunload',History.onUnload);
- History.Adapter.bind(window,'unload',History.onUnload);
- // Both are enabled for consistency
- }
- // Non-Native pushState Implementation
- if ( !History.emulated.pushState ) {
- // Be aware, the following is only for native pushState implementations
- // If you are wanting to include something for all browsers
- // Then include it above this if block
- /**
- * Setup Safari Fix
- */
- if ( History.bugs.safariPoll ) {
- History.intervalList.push(setInterval(History.safariStatePoll, History.options.safariPollInterval));
- }
- /**
- * Ensure Cross Browser Compatibility
- */
- if ( navigator.vendor === 'Apple Computer, Inc.' || (navigator.appCodeName||'') === 'Mozilla' ) {
- /**
- * Fix Safari HashChange Issue
- */
- // Setup Alias
- History.Adapter.bind(window,'hashchange',function(){
- History.Adapter.trigger(window,'popstate');
- });
- // Initialise Alias
- if ( History.getHash() ) {
- History.Adapter.onDomLoad(function(){
- History.Adapter.trigger(window,'hashchange');
- });
- }
- }
- } // !History.emulated.pushState
- }; // History.initCore
- // Try to Initialise History
- if (!History.options || !History.options.delayInit) {
- History.init();
- }
- })(window);
|