Linking to fragments
up.follow(linkOrSelector, [options])
function
Follows the given link via AJAX and replaces the current page with HTML from the response.
By default the page's <body> element will be replaced.
If the link has an attribute like [up-target]
or [up-modal], the corresponding UJS behavior will be activated
just as if the user had clicked on the link.
Emits the event up:link:follow.
Examples
Let's say you have a link with an a[up-target] attribute:
<a href="/users" up-target=".main">Users</a>
Calling up.follow() with this link will replace the page's .main fragment
as if the user had clicked on the link:
var $link = $('a:first');
up.follow($link);
Parameters
An element or selector which is either an <a> tag or any element with an up-href attribute.
The selector to replace.
Defaults to the link's [up-target], [up-modal] or [up-popup] attribute.
If no target is given, the <body> element will be replaced.
The URL to navigate to.
Defaults to the link's [up-href] or [href] attribute.
Whether to reveal the target fragment after it was replaced.
You can also pass a CSS selector for the element to reveal.
Whether to reveal the target fragment when the server responds with an error.
You can also pass a CSS selector for the element to reveal.
Return value
A promise that will be fulfilled when the link destination has been loaded and rendered.