dont-go

Client-side library to change the title and/or favicon of the page when it is inactive

Usage no npm install needed!

<script type="module">
  import dontGo from 'https://cdn.skypack.dev/dont-go';
</script>

README

Dont go


Do the old favicon switcheroo in under 500 bytes

Table of Contents

About

leo

Dont-go is a small client-side library with zero dependencies to change the title and/or favicon of the page when it is inactive. Minified version weighs in at a whopping 476 Bytes when minified. Note that You must include a default favicon in your webpage.

As Seen In

Install

Install with cdn

<script src="https://cdn.rawgit.com/tiaanduplessis/dont-go/master/lib/dont-go.js"></script>
<!-- Or -->
<script src="https://unpkg.com/dont-go/lib/dont-go.js"></script>

Install with npm

$ npm install dont-go

Install with yarn

$ yarn add dont-go

Usage

example

To use, simply call the function with options.


dontGo({
    title: 'Alternative title text right here!',
    faviconSrc: 'path/to/Alternative/favicon.ico',
    timeout: 5000 //5 seconds
});

The faviconSrc property is optional and will keep the same icon if not set.

The timeout property is optional, it takes an interval in milliseconds to before title & favicon change.

It is also possible to set the title property to an array of values and set an interval to switch between them as seen in the example below;


dontGo({
    title: ['Alternative title text', 'Another alternative title'],
    faviconSrc: 'path/to/Alternative/favicon.ico',
    interval: 1000 //1 second
});

Demo

Check out the demo here.

Examples

Please see the example directory for more usage examples.

Contributing

All Contributions are welcome! Please open up an issue if you would like to help out. :smile:

License

Licensed under the MIT License.

Icons made by Madebyoliver from www.flaticon.com is licensed by CC 3.0 BY.