up.link up.link.config

JavaScript property

An array of CSS selectors matching links that will be followed through Unpoly.

You can customize this property to automatically follow all links on a page without requiring an [up-follow] attribute. See Handling all links and forms.

Exceptions to config.followSelectors.

Matching links will not be followed through Unpoly, even if they match config.followSelectors.

By default Unpoly excludes:

• Links with an [up-follow=false] attribute.
• Links with a cross-origin [href].
• Links with a [target] attribute (to target an iframe or open new browser tab).
• Links with a [download] attribute.
• Links with an [href] attribute starting with javascript:.
• Links with an [href="#"] attribute that don't also have local HTML in an [up-document], [up-fragment] or [up-content] attribute.

An array of CSS selectors matching links that are followed on mousedown instead of on click.

You can customize this property to follow all links on mousedown without requiring an [up-instant] attribute. See Handling all links and forms.

Note that an instant link must also by followable, usually by giving it an [up-follow] attribute or by configuring up.link.config.followSelectors.

Exceptions to config.followSelectors.

Matching links will not be followed through Unpoly, even if they match config.followSelectors.

By default Unpoly excludes:

• Links with an [up-instant=false] attribute.
• Links that are not followable.

An array of CSS selectors matching links that are preloaded on hover.

You can customize this property to preload all links on mousedown without requiring an [up-preload] attribute. See Handling all links and forms.

Exceptions to config.preloadSelectors.

Matching links will not be preloaded on hover, even if they match config.preloadSelectors.

By default Unpoly excludes:

• Links with an [up-preload=false] attribute.
• Links that are not followable.
• When the link destination cannot be cached.

The number of milliseconds to wait before [up-preload] starts preloading.

Whether Unpoly will load preload requests.

With the default setting ("auto") Unpoly will load preload requests unless up.network.shouldReduceRequests() detects a poor connection.

If set to true, Unpoly will always preload links.

If set to false, Unpoly will never preload links.

You may also configure a function that accepts a link element and returns true, false or 'auto'.

Regardless of what you configure here, Unpoly will only preload links with safe methods.

A list of CSS selectors matching elements that should behave like links or buttons.

To make the link-like element as accessible as possible, it gains the following behaviors:

• The element is given an [role=link] attribute so screen readers announce it as link.
• The element shows pointer cursor when hovered over.
• The element can be focused with the keyboard.
• The element emits an up:click event when activated.
• You may also assign an [up-instant] attribute to make the element activate on mousedown instead of click.

See [up-clickable], [up-href].