Icontem

jQuery Load Favicon: jQuery plugin to load an image as page favicon

Recommend this page to a friend!
  Info   View files View files (16)   DownloadInstall with Composer Download .zip   Reputation   Support forum   Blog    
Last Updated Ratings Unique User Downloads Download Rankings
2014-08-12 (4 years ago) RSS 2.0 feedStarStarStarStar 73%Total: 205 All time: 232 This week: 4Up
Version License JavaScript version Categories
jquery-load-favicon 1.0BSD License1.0Animation, jQuery, Graphics, Cache
Description Author

This is a jQuery plugin to load an image as page favicon.

It can create an image page element and load a given image in it to set it as the current page favicon image. It can load multiple images to create favicon animations.

The plugin can also load images into canvas objects, as well cache data in localStorage or sessionStorage containers.

Innovation Award
JavaScript Programming Innovation award nominee
August 2014
Number 4
Favicons are images used by browsers to display as icons that represent the current site page.

This object can dynamically change the current page favicon using dynamic requests.

Manuel Lemos
  Performance   Level  
Name: Thomas Björk <contact>
Classes: 5 packages by
Country: Sweden Sweden
Age: 50
All time rank: 401 in Sweden Sweden
Week rank: 4 Up1 in Sweden Sweden Equal
Innovation award
Innovation award
Nominee: 4x

Details

JUtils

JUtils is a javascript library for jQuery with loads of small useful utilities.

jQuery(selector).fn

These functions is attached to jQuerys selector.

jQuery(selector).faviconAdd()

Load an image and use it as a favicon in the browser.

Loads images found by the jQuery-selector and converts them into a favicon which is inserted into the documents head. If multiple elements are found then it is up to the browser to select which favicon to use. (The browser might use the first available favicon or, most likely, the last defined icon. This is entirely up to the browser and its internal design.)

jQuery(selector).faviconAnimationAdd(options)

Adds images that matches the given selector to the animation list for the favicon.

If the options object has the property "start" set to true then the animation starts directly. The options property "delay" specifies the interval between each image. This is given in milliseconds.

To change the delay just call jQuery.faviconAnimationStart(newDelay); where "newDelay" is the new interval to use.

options.start

Set to true to start the interval directly.

If start is omitted or set to false then the animation can be started by calling jQuery.faviconAnimationStart();

options.delay

Sets the delay for the update interval. This time is specified in milliseconds. When the interval gets too low then the favicon will flicker and you will not get a proper result.

jQuery(selector1).imageToCanvas(selector2)

Loads images found by the jQuery-selector (selector1) and converts them to canvas elements. These are attached to the object specified by the selector called selector2.

jQuery.fn

These functions can be reached from the jQuery-object itself without specifying a selector.

jQuery.faviconAdd(url)

This function loads an image to a internal canvas object and transform it to a png which is used as an favicon.

Load an image from the specified URL and use it as an favicon.

jQuery.faviconAnimationAdd(url)

Adds an image to the animationList to create an animated favicon.

jQuery.faviconAnimationStart(delay)

Start looping the images in the animationList. The delay specified is the time between shifting images for the favicon.

If the delay, which is measured in milliseconds, is to small then the favicon will start to flicker and you will not get the intended result.

If this function is called a second time then it will only set the delay once again. This makes it possible to change the delay efter the animation has been started.

jQuery.faviconAnimationStop()

Stop an ongoing favicon animation.

jQuery.imageToCanvas(url)

Load an image from the specified URL and convert it into a canvas object. The returned object is an jQuery object containing the canvas object.

jQuery.storage

jQuery.storage.getEngineName()

Returns which engine is used. Currently there are three valid values (localStorage, sessionStorage, local).

localStorage

The internal localStorage is used. Any value set here will remain until removed or until it moves beyond the timeout.

sessionStorage

The internal sessionStorage is used. Any value here will remain until the session expires or until it moves beyond the timeout.

internal

The browser doesn't support any webStorage so the data is stored in an object as key-value pairs. Any value here will be lost when the page reloads or when it moves beyond the timeout.

jQuery.storage.get(key)

Gets the value for the specified key from storage.

If the key is invalid than the function returns null.

jQuery.storage.set(key, value, timeout)

Set the key to value in the storage.

The timeout specifies for how long the key is valid in the storage. This time is given in seconds. If the timeout is omitted then the timesout defaults to 3600 seconds.

jQuery.storage.isset(key)

Checks if the value for the given key is valid in storage.

jQuery.storage.unset(key)

Removes the value for the given key from storage.

jQuery.storage.touch(key, timeout)

Refreshes the the timeout for the given key with a new timeout defined in seconds by the argument named timeout. If this argument for the timeout is omitted then the default timeout of 3600 seconds is used.

jQuery.storage.getValid(key)

Returns the time left until the value for the given key gets invalid.

If the key is missing or invalid then this function returns false.

  Files folder image Files  
File Role Description
Files folder imageexamples (12 files)
Plain text file jquery.utils-min.js Class Class source
Plain text file jquery.utils.js Class Class source
Accessible without login Plain text file LICENSE Lic. License text
Accessible without login Plain text file README.md Doc. Documentation

  Files folder image Files  /  examples  
File Role Description
  Accessible without login Image file favicon.png Data Auxiliary data
  Accessible without login Plain text file favicon.svg Data Auxiliary data
  Accessible without login Plain text file favicon1.html Example Example for favicon
  Accessible without login Plain text file favicon2.html Example Example for favicon
  Accessible without login Plain text file favicon3.html Example Example for favicon
  Accessible without login Plain text file favicon4.html Example Example for favicon
  Accessible without login Plain text file favicon5.html Example Example for favicon
  Accessible without login Plain text file favicon_blue.svg Data Auxiliary data
  Accessible without login Plain text file imgtocvs1.html Example Example for image to canvas
  Accessible without login Plain text file imgtocvs2.html Example Example for image to canvas
  Accessible without login Plain text file index.html Example Example
  Accessible without login Plain text file storage1.html Example Example for webstorage

 Version Control Unique User Downloads Download Rankings  
 100%
Total:205
This week:0
All time:232
This week:4Up
 User Ratings  
 
 All time
Utility:93%StarStarStarStarStar
Consistency:100%StarStarStarStarStarStar
Documentation:68%StarStarStarStar
Examples:100%StarStarStarStarStarStar
Tests:-
Videos:-
Overall:73%StarStarStarStar
Rank:9