diff --git a/entries/jQuery.mobile.changePage.xml b/entries/jQuery.mobile.changePage.xml deleted file mode 100644 index e1401a2f..00000000 --- a/entries/jQuery.mobile.changePage.xml +++ /dev/null @@ -1,126 +0,0 @@ - - - jQuery.mobile.changePage() - Programmatically change from one page to another. -
-

Note: is deprecated as of jQuery Mobile 1.4.0 and will be removed in 1.5.0. Use the pagecontainer widget's change() method instead.

-
- - - - - Absolute or relative URL. ( "about/us.html" ) - - - jQuery collection object. ( $( "#about" ) ) - - - - Properties: - - By default, changePage() ignores requests to change to the current active page. Setting this option to true, allows the request to execute. Developers should note that some of the page transitions assume that the fromPage and toPage of a changePage request are different, so they may not animate as expected. Developers are responsible for either providing a proper transition, or turning it off for this specific case. - - - - Decides if the hash in the location bar should be updated. This has the effect of creating a new browser history entry. It also means that, if set to false, the incoming page will replace the current page in the browser history, so the page from which the user is navigating away will not be reachable via the browser's "Back" button. - - - The data to send with an Ajax page request.
Used only when the 'to' argument of changePage() is a URL. - - - - - - - - - The URL to use when updating the browser location upon changePage completion. If not specified, the value of the data-url attribute of the page element is used. - - - Specifies the element that should contain the page. - - - Forces a reload of a page, even if it is already in the DOM of the page container.
Used only when the 'to' argument of changePage() is a URL. - - - Decides what direction the transition will run when showing the page. - - - The data-role value to be used when displaying the page. By default this is undefined which means rely on the value of the @data-role attribute defined on the element. - - - Decides whether or not to show the loading message when loading external pages. - - - The transition to use when showing the page. - - - Specifies the method ("get" or "post") to use when making a page request.
Used only when the 'to' argument of changePage() is a URL. - - - - - Transition to the "about us" page with a slideup transition. - -
-

Page 1

-
-
-
- -]]> - - - - Transition to the "search results" page, using data from a form with an id of "search". - -
-

Page 1

-
-
- -
- -]]> - - - - Transition to the "confirm" page with a "pop" transition without tracking it in history. - -
-

Page 1

-
-
-
- -]]> - - - -

Programmatically change from one page to another. This method is used internally for the page loading and transitioning that occurs as a result of clicking a link or submitting a form, when those features are enabled.

- - - diff --git a/entries/jQuery.mobile.loadPage.xml b/entries/jQuery.mobile.loadPage.xml deleted file mode 100644 index ffeef739..00000000 --- a/entries/jQuery.mobile.loadPage.xml +++ /dev/null @@ -1,113 +0,0 @@ - - - jQuery.mobile.loadPage() - Load an external page, enhance its content, and insert it into the DOM. -
-

Note: is deprecated as of jQuery Mobile 1.4.0 and will be removed in 1.5.0. Use the pagecontainer widget's load() method instead.

-
- - - - - Absolute or relative URL. ( "about/us.html" ) - - - jQuery collection object. ( $( "#about" ) ) - - - - Properties: - - By default, changePage() ignores requests to change to the current active page. Setting this option to true, allows the request to execute. Developers should note that some of the page transitions assume that the fromPage and toPage of a changePage request are different, so they may not animate as expected. Developers are responsible for either providing a proper transition, or turning it off for this specific case. - - - - Decides if the hash in the location bar should be updated. - - - The data to send with an Ajax page request. - - - - - - - - - Forced delay (in ms) before the loading message is shown. This is meant to allow time for a page that has already been visited to be fetched from cache without a loading message. - - - Specifies the element that should contain the page. - - - Forces a reload of a page, even if it is already in the DOM of the page container.
Used only when the 'to' argument of changePage() is a URL. - - - The data-role value to be used when displaying the page. By default this is undefined which means rely on the value of the @data-role attribute defined on the element. - - - Decides whether or not to show the loading message when loading external pages. - - - The transition to use when showing the page. - - - Specifies the method ("get" or "post") to use when making a page request.
Used only when the 'to' argument of changePage() is a URL. - - - - - Load the "about us" page into the DOM. - -

loadPage() demo

- - -
- -

First check if the 'About us' page is in the DOM, Load the page in the DOM and check again

- -
-
'About Us' is in the DOM: The result will be displayed here
-
- ]]> - - - - Load a "search results" page, using data from a form with an id of "search". - - - - - - ]]> - - - -

Load an external page, enhance its content, and insert it into the DOM. This method is called internally by the changePage() function when its first argument is a URL. This function does not affect the current active page so it can be used to load pages in the background. The function returns a deferred promise object that gets resolved after the page has been enhanced and inserted into the document. - -

- - - diff --git a/entries/pagebeforechange.xml b/entries/pagebeforechange.xml index 9393907e..83b1d345 100644 --- a/entries/pagebeforechange.xml +++ b/entries/pagebeforechange.xml @@ -10,16 +10,16 @@ -

It should be noted that callbacks can modify both the toPage and options properties to alter the behavior of the current changePage() call. So for example, the toPage can be mapped to a different url from within a callback to do a sort of redirect.

+

It should be noted that callbacks can modify both the toPage and options properties to alter the behavior of the current pagecontainer change() call. So for example, the toPage can be mapped to a different url from within a callback to do a sort of redirect.

1.0 diff --git a/entries/pagechange.xml b/entries/pagechange.xml index fd9d463f..1c0e1caf 100644 --- a/entries/pagechange.xml +++ b/entries/pagechange.xml @@ -1,18 +1,18 @@ pagechange - This event is triggered after the changePage() request has finished loading the page into the DOM and all page transition animations have completed. + This event is triggered after the pagecontainer change() request has finished loading the page into the DOM and all page transition animations have completed.

Note that any pageshow or pagehide events will have fired *BEFORE* this event is triggered. Callbacks for this particular event will be passed a data object as the 2nd arg. The properties for this object are as follows:

  • toPage (object or string)
      -
    • This property represents the page the caller wishes to make active. It can be either a jQuery collection object containing the page DOM element, or an absolute/relative url to an internal or external page. The value exactly matches the 1st arg to the changePage() call that triggered the event.
      • +
    • This property represents the page the caller wishes to make active. It can be either a jQuery collection object containing the page DOM element, or an absolute/relative url to an internal or external page. The value exactly matches the 1st arg to the pagecontainer change() call that triggered the event.
  • options (object)
      -
    • This object contains the configuration options to be used for the current changePage() call.
      • +
    • This object contains the configuration options to be used for the current pagecontainer change() call.