<ajax:navigation />
Intended for use in Designs, ajax:navigation improves the performance of browser navigation by updating a list of ajax:region controls, rather than reloading the entire page.
Performance Benefits:
- Page load times are reduced, as only the regions that need to be updated are refreshed.
- The browser's back and forward buttons can be used to navigate between pages, without reloading the entire page.
- Region content is pre-cached on mousedown, so that when the user clicks a link, the content is already available.
If there are several ajax:navigation controls, the one with a parent page nearest to our navigation target will have its update regions refreshed.
Where two ajax:navigation controls both define regions for the same page, a union of the regions will be updated.
Navigating to a page that does not use the same Design as the current page will cause a full page reload.
Pages must be declared in the Pages attribute, otherwise the page will not be handled by AJAX Navigation. Page content should be considered carefully, as not all page content is suitable for AJAX Navigation.
Related Controls
Attributes
id
string
Give this control a unique id. Can be accessed in the client DOM (eg, document.getElementById('myid') or in the server DOM using [? $myid ?] or [? $('myid') ?]).
pages
string
Pages
Comma separated list of page Ids which should be handled by AJAX Navigation (Includes Children)
updateRegions
string|array
Update Regions
Comma separated list of ajax:region control Ids to refresh.
