Итак начнём.
для начала определимся с понятиями...
- string - В программировании, строковый тип (англ. string «нить, вереница») Подробнее.
- integer - Целое, целочисленный тип данных (англ. Integer) Подробнее.
- object - просто объект, но в него можно вложить другие понятия, перечисленные выше и ниже как и его самого.
- boolean - Логический тип данных, или булевый тип (от англ. Boolean или logical data type) Подробнее.
- function - просто функция, которая что-то должна сделать.
- max/min - тут всё понятно, максимальное значение или минимальное.
- array - Массив (в некоторых языках программирования также таблица, ряд, матрица) Подробнее
- float - Число с плавающей запятой (или число с плавающей точкой) Подробнее
Остальные параметры будут понятны из функций.
Окно создаём так
Код <a href="javascript://" onclick="new _uWnd(name, title, width, height, opts, content, menuitems, app);return false;">Запуск окна</a>
Теперь рассмотрим более подробно....
- name(string) - Имя окна, идентификатор, нигде не виден, но можно использовать в скриптах.
- title(string) - Имя окна, уже виден в заголовке(шапке окна).
- width(integer) - Ширина окна.
- height(integer) - Высота окна.
- opts(object) - дополнительные параметры(пишутся в фигурных скобках через запятую):
- autosize(boolean) - автоопределение размеров окна по содержимому.
- autosizewidth(boolean) - автоопределение ширины окна по содержимому.
- autosizeonimages(boolean) - автоматически изменять размеры после загрузки картинок.
- hideonresize(boolean) - прятать содержимое при изменении размеров окна.
- waitimages(boolean) - ждём загрузки всех картинок.
- markload(string) - текст загрузки.
- align(string) - выравнивание. align:'left','center','right'
- shadow(boolean) - тень окна делаем или нет.
- header(boolean) - отображаем шапку окна или нет.
- min(boolean) - отображать кнопку "свернуть окно" или нет.
- max(boolean) - отображать кнопку "развернуть в полноэкранный режим" или нет.
- design(string) - дизайн. Является ключём объекта _uWnd.designs.
- close(boolean) - отображать ли кнопку закрыть. Пример: {close:1} - показываем, {close:0} - не показываем
- hidden(boolean) - скрытое окно если 1, применяем в скрипте.
- modal(boolean) - модальное окно (все остальное пространство закрывается полупрозрачным слоем). Для изменения прозрачности в ксс пишем это
.myWinGrid {
opacity: 0.25 !important;
}
где 0.25 почти прозрачно, 1 не прозрачно.
- alert(boolean) - окно будет отображаться выше модальных окон.
- popup(boolean) - закрывать ли окно при клике на пространстве вне окна. 1 - да, 0 - нет.
- nomove(boolean) - запрещаем перемещения окна.
- hideonmove(boolean) - скрывать содержимое окна при перемещении окна.
- resize(boolean) - разрешаем или нет изменения размера окна пользователю.
- fixed(boolean) - фиксированное окно (прокручивается вместе со страницей).
- minh(integer) - минимальная высота.
- maxh(integer) - максимальная высота.
- minw(integer) - минимальная ширина.
- maxw(integer) - максимальная ширина.
- icon(srting) - иконка окна, отображается рядом с title.
- oncontent(function) - функция, выполняющаяся после добавления контента в окно.
- onclose(function) - функция, выполняющаяся после закрытия окна.
- onbeforeclose(function) - функция, выполняющаяся до закрытия окна (после клика на кнопку закрытия).
- oninit(function) - функция, выполняющаяся при открытии окна.
- onmousemove(function) - функция, выполняющаяся движении мышью над контентом окна.
- onposchange(function) - функция, выполняющаяся при каждом изменении позиции окна.
- onactivate(function) - функция, выполняющаяся при получении окном фокуса.
- ondeactivate(function) - функция, выполняющаяся при потере окошком фокуса.
- closeonesc(boolean) - закрывать ли окно при нажатии клавишу Esc.
- initstate(max/min) - состояние при открытии.
- headerc(string/object) - содержимое шапки. Строка или DOM-узел.
- hideheader(boolean/object) - прятать ли шапку при загрузке.
- footerh(integer) - высота футера(footer).
- footerс(string/object) - содержимое футера. Строка или DOM-узел.
- hidefooter(boolean/object) - прятать футер при загрузке или нет.
- center(boolean) - по центру или нет.
- customButtons(object) - дополнительные кнопки. Каждому ключу name ассоциируется массив вида. А тут есть свои функции...
Код init_visible,actionfunc,thispar,param
- init_visible(boolean) - показывать ли кнопку при инициализации окна.
- actionfunc(function) - функция, которая будет вызвана при клике на кнопку. Аргументы: [ссылка на окно, параметры]. Объект this будет указывать на thispar.
- thispar(mixed(хммм... пока не определил)) - второй аргумент для функции.
- param(mixed(хмм... тоже пока не определил)) - параметр. Если не указан, используется имя окна.
- havemenu(boolean) - наличие меню. Определяется автоматически, в зависимости от аргумента menuitems.
- menuopts(object) - опции меню.
- fadetype(0/1/2) - вид открывания окна.
- fadespeed(0/999999) - время открывания окна.
- fadeclosetype(0/1/2) - вид закрывания окна.
- fadeclosespeed(0/999999) - время закрывание окна.
- content(object/string/function) - контент. Может быть строкой, объектом или функцией, возвращающей строку. Объект может содержать следующие свойства и методы:
- url(string) - ссылка на документ, может быть как прямой так и относительной
- form(sting) - ID формы, данные которой нужно отправить серверу.
- xml(boolean) - обрабатывать полученный код как XML или нет.
- type(get/post) - тип запроса.
- cache(boolean) - разрешить / запретить кеширование.
- async(boolean) - устанвить режим запроса (синхронный / асинхронный).
- success(function) - функция, срабатывающая после успешного получения данных. Принимает 2 аргумента:
- data(string/object) - непосредственно запрошенный документ.
- status(integer) - статус.
- error(function) - функция обработки ошибок.
- dataType(string) - тип данных. Нужен для функции success.
Так же есть следующие функции, рассмотрим...
Код _uWnd.alert(txt,title,opts)
Создает всплывающее окошко-alert в правом нижнем углу.
Аргументы:
- txt(string/object/function) - контент, аналогично аргументу content функции _uWnd.
- title(string) - заголовок окна.
- opts(object) - дополнительные параметры:
- w(integer) - ширина окна.
- h(integer) - высота окна.
- tm(integer) - "время жизни" окна. По прошествии указанного времени окно закроется.
- close(boolean) - отображать ли кнопку закрыть.
- align(string) - выравнивание текста в окошке.
- icon(string) - иконка окна.
- name(string) - имя окна.
- pad(string) - padding. Записывается в style, единственное свойство.
Код _uWnd.messageBox(txt,title,b,onselect,opts,param,app)
Создает всплывающее окошко-alert по центру, блокирует все остальное пространство.
Аргументы:
- txt(string/object/function) - контент, аналогично аргументу content функции _uWnd.
- title(string) - заголовок окна.
- b(array) - массив из строк с ID либо объектов со следующими ключами:
- id(string) - ID.
- t(string) - Текст кнопки. Если не указан, используется ID.
- def(1/2) - стандартное состояние. 1: фокус получен, 2: ???.
- opts(object) - опции.
- onselect(function) - функция, которая будет вызвана при выделении.
Работа с аякс-окнами.
Возвращает ссылку на объект окна с именем name (первый параметр при создании окна).
Закрывает окно с name="name" (первый аргумент при создании окна).
Аналог: метод close() самого окна.
Код _uWnd.header(name,content)
Устанавливает содержимое шапки на content для окна с name="name" (первый аргумент при создании окна).
Аналог: метод header(content) самого окна.
Код _uWnd.content(name,content)
Устанавливает контент content для окна с name="name" (первый аргумент при создании окна).
Аналог: метод content(content) самого окна.
Код _uWnd.footer(name,content)
Устанавливает содержимое футера на content для окна с name="name" (первый аргумент при создании окна).
Аналог: метод footer(content) самого окна.
Код _uWnd.headerheight(name,h)
Устанавливает высоту шапки в h пикселей для окна с name="name" (первый аргумент при создании окна).
Аналог: метод headerheight(content) самого окна.
Код _uWnd.footerheight(name,h)
Устанавливает высоту футера в h пикселей для окна с name="name" (первый аргумент при создании окна).
Аналог: метод footerheight(content) самого окна.
Код _uWnd.reload(name,content)
Переустанавливает контент content для окна с name="name" (первый аргумент при создании окна, для документов, полученных от сервера).
Аналог: метод reload(content) самого окна.
Код _uWnd.setTitle(name,title)
Устанавливает заголовок title для окна с name="name".
Аналог: метод setTitle(title) самого окна.
Код new _uWnd(/*params*/).checksize()
Этот метод запускает авторесайз окна.
Код new _uWnd(/*params*/).minimize()
Сворачивает окно.
Код new _uWnd(/*params*/).maximize()
Разворачивает окно на максимум.
Код new _uWnd(/*params*/).restore()
Восстанавливает нормальные размеры окна.
Код new _uWnd(/*params*/).showcustombutton(name, isVisible)
Показывает или прячет (в зависимости от истинности isVisible) кнопку с именем name (ключ объекта custombuttons).
Часть №2 >>> |