hashtrack

Hashtrack

The hashtrack.js library provides an implementation of state-hashes in
Javascript application, which is backwards compatible with pre-hashchange
browsers. It also provides much more powerful facilities to utilize the same
structure of a full URL inside the hash, including paths and querystrings.

API of hashtrack.

hashtrack
The only exposed name. The entire API is under this name.

hashtrack.init()
Begins the hashtrack usage. Must be called once after the page has loaded.

hashtrack.onhashchange(callback, callnow)
Registers a callback to be invoked when the hash value changes.
If callnow == true, the callback should be invoked immediately with
the current hash value.

hashtrack.onhashvarchange(varname, callback, callnow)
Registers a callback to be invoked when a specific hash-query variable
changes. This value is parsed out of a query-string syntax segment in the
hash value. For example, the URL

http://colorapp.com/#?color=red

Might call hashtrack.onhashvarchange("color", callback) and callback("red")
would be called.

hashtrack.getAllVars()
Returns an object mapping all hash-query variable names to their values.
The above example URL would return {"color": "red"}

hashtrack.getVar(name)
Returns one variable, by name.

hashtrack.setVar(name, value)
Changes the value of a specific variable in the hash-querystring

hashtrack.getPath()
Returns the path portion of the hash value.

hashtrack.setPath(path)
Changes the path portion of the hash value, but leaves the querystring alone.