Latest web development tutorials
 

jQuery pagecreate Event

< jQuery Mobile Events

Example

Alert some text when the page has been created, but before enhancement is complete:

$(document).on("pagecreate",function(){
  alert("pagecreate event fired!")
});
Try it Yourself »

Definition and Usage

The pagecreate event is triggered when the page has been created in the DOM (via ajax or other), but before jQuery Mobile has finished enhancing the page.

Use this event instead of the jQuery DOM ready() method to place all other jQuery events and functions, because it will work whether the page is loaded directly or through the AJAX call of another page. Note: Before version 1.4, we used the pageinit event (deprecated) to handle this.

Note: This event is only triggered once per "page" - Every time a page is loaded for the first time, jQuery Mobile caches pages in the DOM (memory), so when you navigate back from pagetwo to pageone (for example), this event will not fire, because then, pageone is already initialized.

Tip: This event is also useful for user's that want to create their own custom widget enhancement:

$(document).on("pagecreate","#pagetwo",function(event){
  $.(":jqmData(role='my-plugin')").myPlugin();
});

Related events:

  • pagebeforecreate - triggered when the page is about to be initialized, but before enhancement has begun

Syntax

To trigger the event for all pages in jQuery Mobile:

$("document").on("pagecreate",function(event){...}) Try it

To trigger the event for a specific page:

$("document").on("pagecreate","page",function(event){...}) Try it

Parameter Description
function(event) Required. Specifies the function to run when the pagecreate event occurs

The function has an optional event object, which can contain any jQuery event properties (e.g. event.target, event.type, etc.) See jQuery Events Reference for more information.
page Optional. Points to the id of the page to specify the pagecreate event for. For internal pages, use #id. For external pages, use externalfile.html.

Try it Yourself - Examples

A demonstration of pagebeforecreate and pagecreate
A demonstration that shows when pagebeforecreate and pagecreate fire.

The event object
Using the event.type property to return the triggered event type.


< jQuery Mobile Events