private
void
_checkIframeLoaded
(
)
Periodically checks whether our internal IFrame is ready to be used.
private
string
_getHash
(
)
location.hash is a bit buggy on Opera. I have seen instances where
navigating the history using the back/forward buttons, and hence
changing the URL, would not change location.hash. That's ok, the
implementation of an equivalent is trivial.
- Returns:
string
- The hash portion of the document's location
private
void
_handleFQStateChange
(
fqstate
)
Sets the new currentState attribute of all modules depending on the new
fully qualified state. Also notifies the modules which current state has
changed.
- Parameters:
-
fqstate <string>
Fully qualified state
- Returns:
void
private
void
_initialize
(
)
Finish up the initialization of the Browser History Manager.
private
void
_storeStates
(
)
Stores all the registered modules' initial state and current state.
On Safari, we also store all the fully qualified states visited by
the application within a single browser session. The storage takes
place in the form field specified during initialization.
private
string
_trim
(
str
)
Trims a string.
- Parameters:
-
str <string>
The string to be trimmed.
- Returns:
string
- The trimmed string
string
getBookmarkedState
(
module
)
Returns the state of a module according to the URL fragment
identifier. This method is useful to initialize your modules
if your application was bookmarked from a particular state.
- Parameters:
-
module <string>
Non-empty string representing your module.
- Returns:
string
- The bookmarked state of the specified module.
string
getCurrentState
(
module
)
Returns the current state of the specified module.
- Parameters:
-
module <string>
Non-empty string representing your module.
- Returns:
string
- The current state of the specified module.
string
getQueryStringParameter
(
paramName
,
queryString
)
Returns the value of the specified query string parameter.
This method is not used internally by the Browser History Manager.
However, it is provided here as a helper since many applications
using the Browser History Manager will want to read the value of
url parameters to initialize themselves.
- Parameters:
-
paramName <string>
Name of the parameter we want to look up.
-
queryString <string>
Optional URL to look at. If not specified,
this method uses the URL in the address bar.
- Returns:
string
- The value of the specified parameter, or null.
void
initialize
(
iframeTarget
)
Initializes the Browser History Manager. Call this method
from a script block located right after the opening body tag.
- Parameters:
-
iframeTarget <string>
Optional - Path to an existing
HTML document accessible from the same domain. If not
specified, defaults to "blank.html". This is only useful
if you use https.
- Returns:
void
boolean
navigate
(
module
,
state
)
Call this method when you want to store a new entry in the browser's history.
- Parameters:
-
module <string>
Non-empty string representing your module.
-
state <string>
String representing the new state of the specified module.
- Returns:
boolean
- Indicates whether the new state was successfully added to the history.
void
register
(
module
,
initialState
,
onStateChange
,
obj
,
override
)
Registers a new module.
- Parameters:
-
module <string>
Non-empty string uniquely identifying the
module you wish to register.
-
initialState <string>
The initial state of the specified
module corresponding to its earliest history entry.
-
onStateChange <function>
Callback called when the
state of the specified module has changed.
-
obj <object>
An arbitrary object that will be passed as a
parameter to the handler.
-
override <boolean>
If true, the obj passed in becomes the
execution scope of the listener.
- Returns:
void