Struct stdweb::web::History
[−]
[src]
pub struct History(_);
Methods
impl History
[src]
pub fn push_state<T: JsSerialize>(
&self,
state: T,
title: &str,
url: Option<&str>
)
[src]
&self,
state: T,
title: &str,
url: Option<&str>
)
Adds a new entry to history.
pushState() takes three parameters: a state object, a title (which is currently ignored), and (optionally) a URL. Let's examine each of these three parameters in more detail:
-
state object — The state object is a JavaScript object which is associated with the new history entry created by pushState(). Whenever the user navigates to the new state, a popstate event is fired, and the state property of the event contains a copy of the history entry's state object.
-
title — Firefox currently ignores this parameter, although it may use it in the future. Passing the empty string here should be safe against future changes to the method. Alternatively, you could pass a short title for the state to which you're moving.
-
URL — The new history entry's URL is given by this parameter. Note that the browser won't attempt to load this URL after a call to pushState(), but it might attempt to load the URL later, for instance after the user restarts the browser. The new URL does not need to be absolute; if it's relative, it's resolved relative to the current URL. The new URL must be of the same origin as the current URL; otherwise, pushState() will throw an exception. This parameter is optional; if it isn't specified, it's set to the document's current URL.
pub fn replace_state<T: JsSerialize>(
&self,
state: T,
title: &str,
url: Option<&str>
) -> Result<(), TODO>
[src]
&self,
state: T,
title: &str,
url: Option<&str>
) -> Result<(), TODO>
Operates exactly like history.push_state() except that replace_state() modifies the current history entry instead of creating a new one. Note that this doesn't prevent the creation of a new entry in the global browser history.
pub fn go(&self, offset: i32) -> Result<(), TODO>
[src]
You can use the go() method to load a specific page from session history, identified by its relative position to the current page (with the current page being, of course, relative index 0).
pub fn back(&self) -> Result<(), TODO>
[src]
Move one step backward through history.
pub fn forward(&self) -> Result<(), TODO>
[src]
Move one step forward through history.
pub fn len(&self) -> u32
[src]
Returns the current number of history entries.
Trait Implementations
impl Clone for History
[src]
fn clone(&self) -> History
[src]
Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0[src]
Performs copy-assignment from source
. Read more
impl Debug for History
[src]
fn fmt(&self, __arg_0: &mut Formatter) -> Result
[src]
Formats the value using the given formatter. Read more
impl PartialEq for History
[src]
fn eq(&self, __arg_0: &History) -> bool
[src]
This method tests for self
and other
values to be equal, and is used by ==
. Read more
fn ne(&self, __arg_0: &History) -> bool
[src]
This method tests for !=
.
impl Eq for History
[src]
impl InstanceOf for History
[src]
fn instance_of(reference: &Reference) -> bool
[src]
Checks whenever a given Reference if of type Self
.
impl AsRef<Reference> for History
[src]
impl ReferenceType for History
[src]
unsafe fn from_reference_unchecked(reference: Reference) -> Self
[src]
Converts a given reference into a concrete reference-like wrapper. Doesn't do any type checking; highly unsafe to use! Read more
impl From<History> for Reference
[src]
impl TryFrom<History> for Reference
[src]
type Error = Void
The type returned in the event of a conversion error.
fn try_from(value: History) -> Result<Self, Self::Error>
[src]
Performs the conversion.
impl TryFrom<Reference> for History
[src]
type Error = ConversionError
The type returned in the event of a conversion error.
fn try_from(reference: Reference) -> Result<Self, Self::Error>
[src]
Performs the conversion.
impl<'_r> TryFrom<&'_r Reference> for History
[src]
type Error = ConversionError
The type returned in the event of a conversion error.
fn try_from(reference: &Reference) -> Result<Self, Self::Error>
[src]
Performs the conversion.
impl TryFrom<Value> for History
[src]
type Error = ConversionError
The type returned in the event of a conversion error.
fn try_from(value: Value) -> Result<Self, Self::Error>
[src]
Performs the conversion.
impl<'_r> TryFrom<&'_r Value> for History
[src]
type Error = ConversionError
The type returned in the event of a conversion error.
fn try_from(value: &Value) -> Result<Self, Self::Error>
[src]
Performs the conversion.