jQuery pagecreate Event
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.