Разработка:modlibs/jquery

Материал из DOF
Версия от 17:04, 21 октября 2011; Ilya (обсуждение | вклад) (API)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к: навигация, поиск
Плагин
Название nvg
Тип modlibs


Описание

Эта modlib-библиотека создана как обертка для подключения библиотеки jquery.

Структура папок

Плагин содержит в себе папку lib, которая содержит в себе папки "js" и "css".

Папка js содержит в себе ядро и UI-виджеты, а также дополнительные плагины (если они понадобятся). Скрипты библиотеки представлены в двух вариантах: обычные (для откадки) и сжатые (для использования в рабочей системе). Какие именно файлы подключать (для разработки или для работы системы) указывается в настройках плагина

Папка css содержит в себе парки с темами оформления jquery. Текущая тема задается в настройках плагина.

Плагины

Все плагины, которые подключаются к jquery должны находится в папке modlibs/jquery/plugins/название_плагина/. Названием плагина в данном случае является собственное внутреннее имя плагина внутри системы. Плагин может содержать в себе js и css-файлы. Каждый плагин активируется при помощи функции jquery_plugin_init()

API

jquery_version()

Версия jquery, которая находится в плагине.

jquery_ui_version()

Версия UI которая находится в плагине.

jquery_init()

Обратиться к плагину nvg и подключить все необходимые js-файлы и текущую тему. Файлы должны подключаться независимо от имени, чтобы при обновлении библиотеки не приходилось ничего менять в php-коде.

jquery_plugin_init()

Подключить плагин jquery. Функция обращается к плагину nvg и подключает все нужные js и css файлы.

Параметры:

  • $name - имя плагина jquery

Обновление

Для того чтобы обновить библиотеку - нужно просто заменить старые версии скриптов и стилей новыми. При обновлении UI и плагинов нужно проследить, чтобы

  • Версия UI была совместима с версией ядра
  • Версии плагинов совместимы с версией ядра
  • Версия темы оформления совместима с версией UI