spektr / blib-old

(in progress) My blocks library

Библиотека автономных и полуавтономных блоков, которые можно впилить в любой интерфейс.

---

• blib - движок (операции над элементами дом дерева + подключение блоков(css,js,html) в момент обьявления и/или в момент первой загрузки)
• blib-build - расширение движка для построения дом дерева из json (много обьяснять ^_^)

Функционал b-blib
метод	описание
blib(selector)	выделение дом элемента (урезанный аналог $ jquery)
	selector - поиск по тегу #selector - поиск по идентификатору .selector - поиск по классу массив селекторов формируется из аргументов (selector, #selector, .selector) возвращает объект
example = blib(selector) example.each(function) example.html(string) example.append(object) example.length example[number]	example - обьект с методами
	function - функция, применяемая к каждому элементу в обьекте string - текст для вставки в дом элемент, если нет аргументов возвращает то, что было object - добавляет дом элемент внутрь каждого length - сколько всего выделено элементов number - индексы элементов
blib.include(file [,target])	основной метод подключения блока (css - сразу, шаблон - если есть, js - после загрузки дом дерева )
	file - путь до блока, target - селектор контейнера, куда будет загружен блок
blib.css(cssFile [,inCache])	подрубить таблицу стилей к шапке
	cssFile - путь до css файла, inCache - массив имен стилевых таблиц содержащихся в подключенном css(в случае если подключается кэш а не стили для отдельного блока)
blib.js(jsFile [,inCache])	подрубить файлы скриптов к шапке
	jsFile - путь до js файла, inCache - массив имен скриптов содержащихся в подключенном js(в случае если подключается кэш а не скрипты для отдельного блока)
дополнительные методы
blib.vanishLoad({ 'script':(bool), 'exception':(array), 'order': (array) })	Метод для склейки и кеширования файлов (стилей и скриптов) решение о подгрузке принимается на основе данных localStotage
	{ script - грузить все скрипты или только прописанные в order, exception - блоки которые надо игнорировать при сборке кеша, order - порядок склейки блоков (jQuery раньше jQuery-ui) }
расширения
blib.build({ 'blockName'(string), handler(function)}|| { 'get':{'x':n, 'y':n}, 'data':{'x':n, 'y':n}, 'post1':n, 'post2':n ... })	метод для отправки запроса на сервер и сбора дом дерева на стороне клиента из ответа(ajax)
	{ blockName(string) - идентификатор для сопоставления заранее загруженного обработчика, handler(function) - собственно сам обработчик, } { 'get':{object} - обьект параметров передаваемых в запросе get-методом, следующие параметры - передаются post-ом, кроме data - передаются post-ом сам обьект без идентификатора (чистые данные) }
blib.build.handler({server's request})	метод для обработки сериализованных данных взятых на клиентской стороне
	{server's request} - сериализованные данные.
blib.build.ready(handler(function))	задание обработчиков вызываемых каждый раз после перестройки дом дерева
	handler(function) - обработчик