123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291 |
- /*
- 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 jQuery 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||{},
- jQuery = window.jQuery;
- // Check Existence
- if ( typeof History.Adapter !== 'undefined' ) {
- throw new Error('History.js Adapter has already been loaded...');
- }
- // Add the Adapter
- History.Adapter = {
- /**
- * History.Adapter.bind(el,event,callback)
- * @param {Element|string} el
- * @param {string} event - custom and standard events
- * @param {function} callback
- * @return {void}
- */
- bind: function(el,event,callback){
- jQuery(el).bind(event,callback);
- },
- /**
- * History.Adapter.trigger(el,event)
- * @param {Element|string} el
- * @param {string} event - custom and standard events
- * @param {Object=} extra - a object of extra event data (optional)
- * @return {void}
- */
- trigger: function(el,event,extra){
- jQuery(el).trigger(event,extra);
- },
- /**
- * History.Adapter.extractEventData(key,event,extra)
- * @param {string} key - key for the event data to extract
- * @param {string} event - custom and standard events
- * @param {Object=} extra - a object of extra event data (optional)
- * @return {mixed}
- */
- extractEventData: function(key,event,extra){
- // jQuery Native then jQuery Custom
- var result = (event && event.originalEvent && event.originalEvent[key]) || (extra && extra[key]) || undefined;
- // Return
- return result;
- },
- /**
- * History.Adapter.onDomLoad(callback)
- * @param {function} callback
- * @return {void}
- */
- onDomLoad: function(callback) {
- jQuery(callback);
- }
- };
- // Try and 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);
|