instant-link
v1.0.7
Published
Speeds up websites by preloading links
Downloads
6
Readme
InstantLink
A library that makes your link's lightning fast.
Installation
npm install --save instant-link
How it works
InstantLink makes links faster by preloading them the moment you hover them.
This usually means that by the time you actually click the link, it is already downloaded, and so you don't have to wait for it to load, it appears immediatly.
This basically means that InstantLink transforms all your links into ajax requests, and you webpage will behave like a single page application.
InstantLink will also cache the preloaded data, so the next time you click the link, it will be even faster.
InstantLink can also optionally compress the data (using LZMA), so even for larger pages, it will not use a lot of memory.
Usage
<script src="instant-link.min.js" data-no-instant></script>
<script data-no-instant>new InstantLink();</script>
That's basically all the boilerplate you need to get it going.
Notice the no-instant
data attribute. This can be put into any script or anchor tag.
On a script, this tells InstantLink that the script should be removed if loaded via InstantLink. This can be used e.g to prevent two instances of InstantLink running at the same time.
For regular links, this directive tells InstantLink to treat this link as a normal link, so clicking it will just redirect.
<a href="index.php" data-no-instant>Regular link</a>
If you have enabled caching, but want to prevent caching of specific links, you can add the no-cache
data attribute.
<a href="index.php?foo=bar" data-no-cache>Dynamic link</a>
Options
| Name | Type | Default | Description | |--------------|---------|-----------|----------------------------------------------------------------------------------------------| | cache | boolean | true | Enables or disabled caching | | compress | boolean | false | If cache enabled, enables LZMA compression of data | | fullCompress | boolean | false | If compress enabled, compress everything in one buffer. Uses less memory, but is much slower | | event | string | mouseover | The event handler that triggers an InstantLink fetchPage | | comment | boolean | true | If enabled, replaces scripts with a data-no-instant attribute with an html comment |
//Example
var options = {
cache: true
compress: true,
fullCompress: true,
event: 'mouseover',
comment: true
}
new InstantLink(options);