JFavicon — простая библиотека для управления favicon

в 12:11, , рубрики: canvas, favicon, javascript, JFavicon, JS, веб-дизайн, динамика, оповещения, сайты, счетчик, метки: , , , , ,

image

Данная библиотека является доработкой tinyicon с использованием всех пожеланий пользователей. Давайте разрабатывать вместе ©

Представляю Вам новую библиотеку JFavicon. Сразу после подключения ее к сайту и инициализации Вы получаете удобный инструмент для динамического изменения favicon. В ее функционал входит:

  • Автоматическая установка favicon
  • Изменение favicon, в зависимости от каких-либо событий
  • Счетчик, с возможностью смены стиля, прямо в favicon
  • Динамическое изменение title страницы

Основной функционал

Для управления JF используется переменная JFavicon или jf

Инициализация и настройка

Для удобства я совместил инициализацию и настройку библиотеки. В следствии чего появилась возможность инициализировать ее неограниченное количество раз. Делается это достаточно просто:

JFavicon.init({
     extract: 1, //Добавляет в глобальную область видимости переменную jf
     showMessage: 1, //Включает изменение title во всех браузерах
     message: 'Новых: {c} - {s}', //Задает title. {c} - счетчик; {s} - стандартный title
     fav: '/icons/favicon.ico', //Задает местоположение favicon
     bg: '#000', //Задает цвет заднего фона счетчика
     ct: '#fff', //Задает цвет текста счетчика
     font: 'normal 8px sans-serif' //Задает шрифт счетчика
});
Управление

Управление производится 5 командами:

   JFavicon.draw(6); //Устанавливает счетчик равным числу, переданному в качестве аргумента. Возвращает this
   JFavicon.add(3); //Увеличивает значение счетчика на число, переданное аргументом. Если аргумент не передан, то увеличивает на 1. Возвращает this
   JFavicon.deduct(4); //Уменьшает значение счетчика на число, переданное аргументом. Если аргумент не передан, то уменьшает на 1. Возвращает this
   JFavicon.reset(); //Устанавливает стандартный favicon. Сбрасывает счетчик. Возвращает текущее значение счетчика
   JFavicon.disable(); //Устанавливает стандартный счетчик. Возвращает this
Пользовательские стили

Вы можете задать неограниченное количество стилей. Но указывать их надо до инициализации (или еще раз инициализировать JF после задания стилей). Стили позволяют менять favicon в зависимости от счетчика:

JFavicon.setStyle({
     title: 'myStyle',
     pref: 'fav',
     ext: '.png',
     maxNum: 5
}).init({
     dir: '/favicons/',
     style: 'myStyle'
});

Данный код будет менять favicon, в зависимости от счетчика так:

если счетчик < 5
/favicons/myStyle/fav[1-5].png

если счетчик >= 5
/favicons/myStyle/favmax.png

Замена title

Замена title автоматически производится в браузерах IE и Safari. Для активации этой функции в других браузерах передайте переменную showMessage в функцию инициализации с действительным значением.
Для изменения текста title передайте переменную message в функцию инициализации. Доступны следующие ключевые слова: {c} — счетчик; {s} — стандартный title

Прочая информация

UPD1: На данный момент ведется разработка возможности менять размеры buble (прямоугольника со счетчиком) и его форму.

Автор: Jaguar_ko


* - обязательные к заполнению поля


https://ajax.googleapis.com/ajax/libs/jquery/3.4.1/jquery.min.js