$Q и
* jsQwerlib (точнее window.$Q и
* window.jsQwerlib).
* if ($Q.isCookiesSupported()) {
* $Q.setCookie("test", 1000);
* }
* @constructor
*/
function jsQwerlib() {
};
//**************************************************************************************************
// Константы
//**************************************************************************************************
/**
* Версия jsQwerlib.
* "0.1a"
* @type string
*/
jsQwerlib.VERSION = "0.1a";
//**************************************************************************************************
// Контроль правильности вводимых данных
//**************************************************************************************************
// !!! Константы: надо постоянно синхронизировать с phpQwerlib
/**
* Значение: 10
* @type int
*/
jsQwerlib.TYPE_LOGIN_MAXLENGTH = 10;
/**
* Значение: 2
* @type int
*/
jsQwerlib.TYPE_LOGIN_MINLENGTH = 2;
/**
* Значение: /^[a-zA-Z0-9]*$/
* @type RegExp
*/
jsQwerlib.TYPE_LOGIN_REGEXP = /^[a-zA-Z0-9]*$/;
/**
* Значение: /^[a-zA-Z0-9]*$/
* @type RegExp
*/
jsQwerlib.TYPE_PASSWORD_REGEXP = /^[a-zA-Z0-9]*$/;
/**
* Значение: 25
* @type int
*/
jsQwerlib.TYPE_PASSWORD_MAXLENGTH = 25;
/**
* Значение: 5
* @type int
*/
jsQwerlib.TYPE_PASSWORD_MINLENGTH = 5;
/**
* Значение: 80
* @type int
*/
jsQwerlib.TYPE_FIO_MAXLENGTH = 80;
/**
* Значение: 40
* @type int
*/
jsQwerlib.TYPE_EMAIL_MAXLENGTH = 40;
/**
* Значение: /^([a-zA-Z0-9])+([\.a-zA-Z0-9_-])*@(([a-zA-Z0-9])+(([a-zA-Z0-9-])*([a-zA-Z0-9])+)*\.)+([a-zA-Z]{2,6})$/;
* @type RegExp
*/
jsQwerlib.TYPE_EMAIL_REGEXP = /^([a-zA-Z0-9])+([\.a-zA-Z0-9_-])*@(([a-zA-Z0-9])+(([a-zA-Z0-9-])*([a-zA-Z0-9])+)*\.)+([a-zA-Z]{2,6})$/;
/**
* Значение: 255
* @type int
*/
jsQwerlib.TYPE_TEXT_MAXLENGTH = 255;
/**
* Значение: 5000
* @type int
*/
jsQwerlib.TYPE_COMMENT_MAXLENGTH = 5000;
/**
* Значение: /^[0-9]{4}$/
* @type RegExp
*/
jsQwerlib.TYPE_FULLYEAR_REGEXP = /^[0-9]{4}$/;
/**
* Значение: /^[0-9]{1,11}$/
* @type RegExp
*/
jsQwerlib.TYPE_NUMBER_REGEXP = /^[0-9]{1,11}$/;
/**
* Значение: /^[0-9]{0,10}([.][0-9]{1,2})?$/
* @type RegExp
*/
jsQwerlib.TYPE_PRICE_REGEXP = /^[0-9]{0,10}([.][0-9]{1,2})?$/;
/**
* Значение: 4
* @type int
*/
jsQwerlib.TYPE_TEXTSEARCH_MINLENGTH = 4;
/**
* Значение: 4
* @type int
*/
jsQwerlib.TYPE_CAPTCHA_LENGTH = 4;
/**
* Префикс, который показывается перед сообщением об ошибке ввода данных пользователем.
* "Ошибка ввода данных: "
* @type string
*/
jsQwerlib.inputErrorMsgPrefix = "Ошибка ввода данных: ";
//**************************************************************************************************
// Отладка
//**************************************************************************************************
/**
* Включение отладочного режима: true - включен, false - выключен.
* false
*
* | ' +
' ' +
' ' +
'' +
' ' +
' | ' +
'' +
' ' +
' ' +
'' +
clearLink + ' ' +
'' + directionLink + ' ' + typeLink + ' ' + destroyLink + ' | ' +
'
| ' + '' + ' | ' + '' + '' + ' | ' + '' + '' + ' | ' + '|||
| ' + '' + ' | ' + '' +
'
| ' +
'' + '' + ' | ' + '|||
| ' + '' + ' | ' + '' + '' + ' | ' + '' + '' + ' | ' + '
true - да. Необязательный параметр.
* Значение по умолчанию - false.
*/
jsQwerlib.DebugWin.write = function(str, newline)
{
with (jsQwerlib.DebugWin)
{
// Создадим окно, если его еще нет
create();
if (newline) str += "true - да.
*/
jsQwerlib.DebugWin.changeOpacity = function(fadeOut)
{
with (jsQwerlib.DebugWin)
{
if (fadeOut) {
opacity -= 10;
if (opacity < 20) opacity = 20;
}
else {
opacity += 10;
if (opacity > 100) opacity = 100;
}
win.style.opacity = opacity / 100;
win.style.filter="progid:DXImageTransform.Microsoft.Alpha(opacity=" + opacity + ")";
jsQwerlib.setCookie(opacityCookie, opacity, cookieTime);
}
};
//**************************************************************************************************
/**
* Устанавливает положение и размеры отладочного окна.
* @param {int} l лево;
* @param {int} t верх;
* @param {int} w ширина;
* @param {int} h высота.
*/
jsQwerlib.DebugWin.setPosition = function(l, t, w, h)
{
with (jsQwerlib.DebugWin)
{
// Отладочное окно должно сохранять своё положение независимо от скроллирования окна броузера.
// Поэтому к координатам отладочного окна надо прибавлять координаты страницы, соответствующие
// левому верхнему углу окна броузера
po = jsQwerlib.getPageOffset();
// Если какой-то параметр изменился - устанавливаем его и запоминаем в куках
// Чтобы не было глюков с изменением размеров контейнера в Мозиле, будем устанавливать
// размер размер окна равным размеру текстовой области. Всё равно на вид это не влияет:
// либо контейнер растянется по размеру содержимого, либо содержимое будет немного
// выглядывать за пределы контейнера
if (w != wWidth) {
wWidth = w;
win.style.width = w + "px";
jsQwerlib.getElementById(textContId).style.width = w + "px";
jsQwerlib.setCookie(wWidthCookie, w, cookieTime);
}
if (h != wHeight) {
wHeight = h;
win.style.height = h + "px";
jsQwerlib.getElementById(textContId).style.height = h + "px";
jsQwerlib.setCookie(wHeightCookie, h, cookieTime);
}
if ((l != wLeft) || (po.x != pageOffset.x)) {
wLeft = l;
win.style.left = (l + po.x) + "px";
jsQwerlib.setCookie(wLeftCookie, l, cookieTime);
}
if ((t != wTop) || (po.y != pageOffset.y)) {
wTop = t;
win.style.top = (t + po.y) + "px";
jsQwerlib.setCookie(wTopCookie, t, cookieTime);
}
// Запомним новое смещение страницы
pageOffset = po;
}
};
//**************************************************************************************************
/**
* Обработчик скроллинга окна броузера.
*/
jsQwerlib.DebugWin.scroll = function(e)
{
with (jsQwerlib.DebugWin)
{
setPosition(wLeft, wTop, wWidth, wHeight);
}
};
//**************************************************************************************************
/**
* Обработчик нажатия горячих клавиш.
*
* Событие генерируется циклически, пока клавиша не будет отпущена (исключение Опера, где данное
* событие генерируется только один раз при нажатии клавиши).
*/
jsQwerlib.DebugWin.keyDown = function(e)
{
with (jsQwerlib.DebugWin)
{
// Наши горячие клавиши содержат комбинацию Ctrl + Alt + Shift
if (e.ctrlKey && e.altKey && e.shiftKey)
{
// Общие комбинации клавиш
switch (e.keyCode)
{
// "С" - очистка окна
case 67:
clear();
break;
// "M" - изменение режима вывода: приписывать вереди или добавлять в конец
case 77:
changeMode();
break;
// "T" - переключение типа окна: фрейм/окно
case 84:
changeType();
break;
// "X" - закрыть отладочное окно
case 88:
destroy();
break;
}
// Комбинации клавиш, которые есть только у окна
if (type == 2)
{
switch (e.keyCode)
{
// "D" - двигаем окно на положение по умолчанию
case 68:
// Если было перемещение окна - остановим его
stopMovement();
setPosition(defaultWLeft, defaultWTop, wWidth, wHeight);
break;
// "H" - прячем/показываем окно
case 72:
// Если было перемещение окна - остановим его
stopMovement();
win.style.visibility =
((jsQwerlib.getStyle(win, "visibility").toLowerCase() == "hidden") ? "visible" : "hidden");
break;
// "<" - уменьшаем прозрачность окна
case 188:
changeOpacity(true);
break;
// ">" - увеличиваем прозрачность окна
case 190:
changeOpacity(false);
break;
}
}
}
// "Esc" - прекращаем изменение размеров/перемещение окна/фрейма
if (e.keyCode == 27) stopMovement();
}
};
//**************************************************************************************************
/**
* Обработчик старта drag&drop, поддерживается только IE.
*/
jsQwerlib.DebugWin.dragStart = function(e)
{
// Запрещаем drag&drop
return false;
};
//**************************************************************************************************
/**
* Обработчик нажатия левой клавиши мышки на сплиттере, заголовке или рамке.
*/
jsQwerlib.DebugWin.mouseDown = function(e)
{
with (jsQwerlib.DebugWin)
{
// Нас интересует только левая кнопка мышки
// У Мозилы и Оперы это e.which, у Експлорера - e.button
if (((e.which != undefined) && e.which == 1) || ((e.button != undefined) && e.button == 1))
{
// Если в данный момент есть перемещение (изменение размеров) - остановим его
stopMovement();
// Установим глобальные обработчики на движение и отпускание мышки
jsQwerlib.addEvent(document, "mousemove", mouseMove);
jsQwerlib.addEvent(document, "mouseup", mouseUp);
// В Експлорере будем отменять drag&drop, такое событие есть только там
jsQwerlib.addEvent(document, "dragstart", dragStart);
// Запомним координаты мышки в окне
mouseCoords = {x: e.clientX, y: e.clientY};
// Элемент, на котором произошло событие
var moveTarget = jsQwerlib.getEventTarget(e);
// Запомним курсор документа и заменим его на курсор элемента
bodyCursor = jsQwerlib.getStyle(document.body, "cursor");
moveCursor = document.body.style.cursor = moveTarget.style.cursor;
// Если имеем дело с окном, надо определить на чем именно нажата мышка, и что с этим делать
if (type == 2)
{
switch (moveTarget.id)
{
case borderLId:
dSize = {dX: -1, dY: 0};
break;
case borderLTId:
dSize = {dX: -1, dY: -1};
break;
case borderTId:
dSize = {dX: 0, dY: -1};
break;
case borderRTId:
dSize = {dX: 1, dY: -1};
break;
case borderRId:
dSize = {dX: 1, dY: 0};
break;
case borderRBId:
dSize = {dX: 1, dY: 1};
break;
case borderBId:
dSize = {dX: 0, dY: 1};
break;
case borderLBId:
dSize = {dX: -1, dY: 1};
break;
default:
dSize = {dX: 0, dY: 0};
}
// Если была нажата клавиша Ctrl - двигаем окно
if (e.ctrlKey) {
dSize = {dX: 0, dY: 0};
moveTarget.style.cursor = document.body.style.cursor = "move";
}
}
// Отменяем действие по умолчанию
jsQwerlib.cancelClick(e);
}
}
};
//**************************************************************************************************
/**
* Обработчик движения мышки.
*/
jsQwerlib.DebugWin.mouseMove = function(e)
{
with (jsQwerlib.DebugWin)
{
// Если нажата левая кнопка - идет изменение размера или перемещение
if (((e.which != undefined) && e.which == 1) || ((e.button != undefined) && e.button == 1))
{
// Новые координаты курсора мышки в окне и приросты координат
var c = {x: e.clientX, y: e.clientY};
var dy = c.y - mouseCoords.y;
var dx = c.x - mouseCoords.x;
// Фрейм
if (type == 1)
{
var h = fHeight + dy;
if (h < minFHeight) {
// Виртуально заморозим курсор на той координате, где устанавливается минимальная высота
c.y += (minFHeight - h);
h = minFHeight;
}
if (fHeight != h) {
jsQwerlib.getElementById(textContId).style.height = h + "px";
jsQwerlib.getElementById(toolContId).style.height = h + "px";
fHeight = h;
onResize(null);
// Сохраним новую высоту в куках
jsQwerlib.setCookie(fHeightCookie, h, cookieTime);
}
}
// Окно
else
{
// Новые значения
var w = wWidth, h = wHeight, l = wLeft, t = wTop;
// Вычисляем новые значения в зависимости от приростов размеров
if (dSize.dX < 0) {
w -= dx;
l += dx;
}
if (dSize.dX > 0) {
w += dx;
}
if (dSize.dY < 0) {
h -= dy;
t += dy;
}
if (dSize.dY > 0) {
h += dy;
}
if (dSize.dX == 0 && dSize.dY == 0) {
l += dx;
t += dy;
}
// Минимальные размеры
if (w < minWWidth) {
// Вычислим, на сколько ширина меньше минимальной и установим ширину в минимум
var d = minWWidth - w;
w = minWWidth;
// Виртуально заморозим курсор на той координате, где устанавливается минимальная ширина
// При этом смотрим на направление прироста ширины
if (dSize.dX > 0) {
c.x += d;
}
else {
c.x -= d;
// Пересчитаем координату left с учетом нового положения курсора мышки
l = wLeft + (c.x - mouseCoords.x);
}
}
// Высота аналогично ширине
if (h < minWHeight) {
var d = minWHeight - h;
h = minWHeight;
if (dSize.dY > 0) {
c.y += d;
}
else {
c.y -= d;
t = wTop + (c.y - mouseCoords.y);
}
}
// Установим новое положение и размеры окна
setPosition(l, t, w, h);
}
// Запомним новые координаты мышки в окне
mouseCoords = c;
// Отменяем действие по умолчанию
jsQwerlib.cancelClick(e);
}
// Если левая кнопка не нажата - значит перемещение надо остановить - что-то произошло
else
{
stopMovement();
}
}
};
//**************************************************************************************************
/**
* Останавливает перемещение (изменение размеров) окна
*/
jsQwerlib.DebugWin.stopMovement = function()
{
with (jsQwerlib.DebugWin)
{
// Если было перемещение - отменим его
if (moveTarget) {
jsQwerlib.removeEvent(document, "mousemove", mouseMove);
jsQwerlib.removeEvent(document, "mouseup", mouseUp);
jsQwerlib.removeEvent(document, "dragstart", dragStart);
// Вернём курсоры на место
document.body.style.cursor = bodyCursor;
moveTarget.style.cursor = moveCursor;
// Перемещение (изменение размеров окна) закончено
moveTarget = moveCursor = bodyCursor = null;
}
}
};
//**************************************************************************************************
/**
* Обработчик отпускания клавиши мышки.
*/
jsQwerlib.DebugWin.mouseUp = function(e)
{
with (jsQwerlib.DebugWin)
{
// Если отпущена левая кнопка - перемещение (изменение размера) закончилось
if (((e.which != undefined) && e.which == 1) || ((e.button != undefined) && e.button == 1))
{
stopMovement();
// Отменяем действие по умолчанию
jsQwerlib.cancelClick(e);
}
}
};
//**************************************************************************************************
/**
* Обработчик изменения размеров окна броузера. Используется только если тип окна фрейм.
* Корректирует размеры отладочного окна и контейнера тела документа.
*/
jsQwerlib.DebugWin.onResize = function(e)
{
with (jsQwerlib.DebugWin)
{
var docHeight = document.body.clientHeight - fHeight - splitterSize;
// Высота не может быть отрицательной
if (docHeight < bodyDH) docHeight = bodyDH;
jsQwerlib.getElementById(bodyContId).style.height = docHeight + "px";
jsQwerlib.getElementById(bodyId).style.height = (docHeight - bodyDH) + "px";
}
};
//**************************************************************************************************
/**
* Экранирует специальные HTML-симовлы, заменяя их на аббревиатуры.
*
*
* DEBUG("Мама", "мыла", "раму");
* DEBUGNB("Маша");
* DEBUGNB("ела");
* DEBUG("кашу");
* DEBUG("Всё!");
*
* Рузультат:
* * Мама | мыла | раму * Маша ела кашу * Всё! ** @param {mixed} p1 элементы, которые нужно вывести в отладочное окно. Количество параметров * функции неограничено. * @see #__DEBUG__ * @see #DEBUGNB * @see #openDebug * @see #clearDebug * @see #closeDebug */ jsQwerlib.DEBUG = function(p1) { if (jsQwerlib.__DEBUG__ && arguments.length > 0) { jsQwerlib.DebugWin.write(jsQwerlib.__formatDebugMsg(arguments), true); } }; //************************************************************************************************** /** * Выводит текст, переменные, элементы в отладочное окно, после вывода НЕ переходит на новую строку. * @param {mixed} p1 элементы, которые нужно вывести в отладочное окно. Количество параметров * функции неограничено. * @see #__DEBUG__ * @see #DEBUG * @see #openDebug * @see #clearDebug * @see #closeDebug */ jsQwerlib.DEBUGNB = function(p1) { if (jsQwerlib.__DEBUG__ && arguments.length > 0) { jsQwerlib.DebugWin.write(jsQwerlib.__formatDebugMsg(arguments), false); } }; //************************************************************************************************** // Бенчмаркинг //************************************************************************************************** /** * Приостанавливает (задерживает) выполнение на заданное время. * @param {int} millis время ожидания в миллисекундах */ jsQwerlib.wait = function(millis) { var begin = new Date(); var curr = begin; while(curr - begin < millis) { curr = new Date(); } }; //************************************************************************************************** // Класс jsQwerlib.Timer - Таймер - измерение времени //************************************************************************************************** /** * Создает новый таймер. * @class Таймер - измерение времени. *
* var t = new $Q.Timer(); * t.start(); * doWorkPrepare(); * alert(t.stop()); * inputUserData(); * t.start(true); * doWorkData(); * alert(t.stop());* @constructor * @param {boolean} start запустить таймер непосредственно при создании:
true - да.
* Необязательный параметр. Значение по умолчанию - false.
*/
jsQwerlib.Timer = function(start)
{
/**
* Время запуска/возобновления таймера. Равно null, если таймер остановлен.
* @type Date
*/
this.begin = null;
/**
* Полное время работы таймера в миллисекундах.
* @type int
*/
this.time = 0;
//************************************************************************************************
/**
* Запускает таймер.
*
* true - да.
* Необязательный параметр. Значение по умолчанию - false.
*/
this.start = function(clear)
{
// Очищаем ранее измеренное время, если нужно
if (clear) {
this.time = 0;
this.begin = new Date();
}
// Запускаем таймер только если он еще не запущен
if (!this.begin) {
this.begin = new Date();
}
};
//************************************************************************************************
/**
* Возвращает текущее время таймера - его значение в данный момент.
* @return время работы таймера в секундах с точностью до миллисекунд
* @type float
*/
this.getTime = function()
{
// Если таймер запущен - посчитаем сколько он уже проработал
if (this.begin != null) {
return (this.time + ((new Date()) - this.begin)) / 1000;
}
// Если на паузе - просто вернем его время
else {
return this.time / 1000;
}
};
//************************************************************************************************
/**
* Останавливает таймер и возвращает время его работы.
*
* null, если cookie не установлен
* @type mixed
* @see #setCookie
* @see #deleteCookie
* @see #isCookiesSupported
*/
jsQwerlib.getCookie = function(name)
{
var prefix = name + "=";
var si = document.cookie.indexOf(prefix);
if (si == -1) return null;
var ei = document.cookie.indexOf(";", si + prefix.length);
if (ei == -1) ei = document.cookie.length;
return unescape(document.cookie.substring(si + prefix.length, ei));
};
//**************************************************************************************************
/** Удаляет cookie.
* @param {string} name название cookie
* @see #getCookie
* @see #setCookie
* @see #isCookiesSupported
*/
jsQwerlib.deleteCookie = function(name)
{
document.cookie = name + "=; expires=Fri, 31 Dec 1999 23:59:59 GMT;";
};
//**************************************************************************************************
/** Проверяет, поддерживаются ли cookie.
* @return true - если cookie поддерживаются или false - если нет
* @type boolean
* @see #getCookie
* @see #setCookie
* @see #deleteCookie
*/
jsQwerlib.isCookiesSupported = function()
{
this.setCookie('__jsQwerlib_TestCookie__', 100, 365 * 24 * 60 * 60);
if (this.getCookie('__jsQwerlib_TestCookie__') != 100) {
return false;
}
this.deleteCookie('__jsQwerlib_TestCookie__');
return true;
};
//**************************************************************************************************
// Класс jsQwerlib.CookiesArray - Массив cookies
//**************************************************************************************************
/**
* Создает новый массив cookies.
* @class Массив cookies.
* null, если элемент не установлен.
* @type mixed
* @see jsQwerlib#getCookie
*/
this.getElement = function(index)
{
return jsQwerlib.getCookie(this.name + '[' + index + ']');
};
//************************************************************************************************
/**
* Устанавливает элемент массива.
* @param {string} index индекс элемента. Это не обязательно число, может быть и строка, как
* в массивах php;
* @param {mixed} value значение элемента;
* null, если элемент не найден.
* @type Element
*/
jsQwerlib.getElementById = function(e)
{
if (typeof(e) == 'string') {
if (document.getElementById) e = document.getElementById(e);
else if (document.all) e = document.all[e];
else e = null;
}
return e;
};
//**************************************************************************************************
/**
* Возвращает положение элемента на странице.
* @param {string} e элемент или id элемента.
* @return объект, содержащий координаты левого верхнего угла элемента: {left, top}.
* @type Object
*/
jsQwerlib.getPosition = function(e)
{
var e = jsQwerlib.getElementById(e);
var oLeft = 0;
var oTop = 0;
while (e) {
oLeft += e.offsetLeft;
oTop += e.offsetTop;
e = e.offsetParent;
}
if (navigator.userAgent.indexOf("Mac") != -1 && typeof document.body.leftMargin != "undefined")
{
oLeft += document.body.leftMargin;
oTop += document.body.topMargin;
}
return {left: oLeft, top: oTop}
};
//**************************************************************************************************
/**
* Возвращает вычисленное значение свойства CSS элемента.
* @param {string} e элемент или id элемента;
* @param {string} cssProp название свойства CSS, записанное в стиле CSS (например,
* font-size).
* @return значение заданного свойства или null, если свойство не было установлено.
* @type string
*/
jsQwerlib.getStyle = function(e, cssProp)
{
var e = jsQwerlib.getElementById(e);
var css = null;
// Експлорер работает так
if (e.currentStyle) {
// Тут принимается свойство CSS, записанное в стиле JavaScript, например, fontSize
var parts = cssProp.split("-");
for (var i = parts.length - 1; i > 0; i--) {
parts[i] = parts[i].charAt(0).toUpperCase() + parts[i].substr(1, parts[i].length - 1);
}
css = e.currentStyle[parts.join("")];
if (css == undefined) css = null;
}
// Код для Мозилы и Оперы
else if (window.getComputedStyle) {
css = document.defaultView.getComputedStyle(e, null).getPropertyValue(cssProp);
if (css == "") css = null;
}
return css;
};
//**************************************************************************************************
/**
* Возвращает координаты курсора мышки на странице.
* @param {MouseEvent} ev событие, связанное с мышкой.
* @return объект, содержащий координаты курсора ({x, y}) или null,
* в случае ошибки.
* @type Object
*/
jsQwerlib.getMouseCoords = function(ev)
{
// Мозила и Опера
if (ev.pageX != undefined) {
return {x: ev.pageX, y: ev.pageY};
}
// Експлорер
if (ev.clientX != undefined) {
return {
x: ev.clientX + document.body.scrollLeft - document.body.clientLeft,
y: ev.clientY + document.body.scrollTop - document.body.clientTop
};
}
return null;
};
//**************************************************************************************************
/**
* Возвращает координаты страницы, соответствующие левому верхнему углу окна.
* @return объект, содержащий координаты страницы ({x, y}) или null,
* в случае ошибки.
* @type Object
*/
jsQwerlib.getPageOffset = function()
{
// Мозила и Опера
if (window.pageYOffset != undefined) {
return {x: window.pageXOffset, y: window.pageYOffset};
}
// Експлорер
if (document.body.scrollTop != undefined) {
return {x: document.body.scrollLeft, y: document.body.scrollTop};
}
return null;
};
//**************************************************************************************************
/**
* Устанавливает обработчик события.
* @param {string} e элемент или id элемента, для которого устанавливается обработчик;
* @param {string} evType название события без префикса "on";
* @param {function} fn функция-обработчик события;
* @param {boolean} useCapture - использовать захват: true - да. Необязательный параметр.
* Значение по умолчанию - false. Если useCapture = true,
* то все события указанного типа будут доставлены данному обработчику, прежде чем они будут
* доставлены другим. События, которые "всплывают" вверх по дереву элементов, не вызывают
* обработчик, назначенный с использованием захвата.
* @return true - в случае успеха, false - в случае неудачи.
* @type boolean
* @see #removeEvent
* @see #getEventTarget
*/
jsQwerlib.addEvent = function(e, evType, fn, useCapture)
{
e = jsQwerlib.getElementById(e);
if (!e) return false;
evType = evType.toLowerCase();
if (useCapture == undefined) useCapture = false;
if (e.addEventListener) {
e.addEventListener(evType, fn, useCapture);
return true;
} else if (e.attachEvent) {
return e.attachEvent("on" + evType, fn);
} else {
e["on" + evType] = fn;
return true;
}
};
//**************************************************************************************************
/**
* Убирает обработчик события.
* @param {string} e элемент или id элемента, для которого устанавливается обработчик;
* @param {string} evType название события без префикса "on";
* @param {function} fn функция-обработчик события;
* @param {boolean} useCapture - использовать захват (см. {@link #addEvent}).
* @return true - в случае успеха, false - в случае неудачи.
* @type boolean
* @see #addEvent
* @see #getEventTarget
*/
jsQwerlib.removeEvent = function(e, evType, fn, useCapture)
{
e = jsQwerlib.getElementById(e);
if (!e) return false;
evType = evType.toLowerCase();
if (useCapture==undefined) useCapture = false;
if (e.removeEventListener) {
e.removeEventListener(evType, fn, useCapture);
return true;
} else if (e.detachEvent) {
return e.detachEvent("on" + evType, fn);
} else {
e["on" + evType] = "";
return true;
}
};
//**************************************************************************************************
/**
* Возвращает элемент на котором произошло событие.
*
* this не указывает на элемент,
* на котором данное событие произошло. Данная функция - независимый от броузера способ получения
* элемента события.
* @param {event} e событие.
* @return элемент, на котором произошло событие.
* @type Element
* @see #addEvent
* @see #removeEvent
*/
jsQwerlib.getEventTarget = function(e)
{
var target = window.event ? window.event.srcElement : e ? e.target : null;
if (!target) return false;
while (target.nodeType != 1 && target.nodeName.toLowerCase() != 'body') {
target = target.parentNode;
}
return target;
};
//**************************************************************************************************
/**
* Отключает "всплывание" события.
* @param {event} e событие.
*/
jsQwerlib.stopBubble = function(e)
{
if (window.event && window.event.cancelBubble) window.event.cancelBubble = true;
if (e && e.stopPropagation) e.stopPropagation();
};
//**************************************************************************************************
/**
* Отключает для события действия по умолчанию.
* @param {event} e событие.
*/
jsQwerlib.stopDefault = function(e)
{
if (window.event && window.event.returnValue) window.event.returnValue = false;
if (e && e.preventDefault) e.preventDefault();
};
//**************************************************************************************************
/**
* Отключает и действие по умолчанию и "всплывание" события.
* @param {event} e событие.
*/
jsQwerlib.cancelClick = function(e)
{
jsQwerlib.stopBubble(e);
jsQwerlib.stopDefault(e);
};
//**************************************************************************************************
// Контроль пользовательского ввода
//**************************************************************************************************
/** Проверяет поле на пустоту.
* @param {string} name название поля на странице, как его видит пользователь;
* @param {string} id элемент или id элемента.
* @return true - если поле не пустое и false - в противном случае.
* @type boolean
*/
jsQwerlib.chEmpty = function(name, id)
{
var e = jsQwerlib.getElementById(id);
if (e.value.length > 0) {
return true;
}
else {
e.focus();
alert(jsQwerlib.inputErrorMsgPrefix + "пустое поле '" + name + "'!");
return false;
}
};
//**************************************************************************************************
/** Проверяет поле на минимальную длину.
* @param {string} name название поля на странице, как его видит пользователь;
* @param {string} id элемент или id элемента;
* @param {int} minlength минимальная разрешенная длина текста в поле.
* @return true - если длина текста в поле не меньше минимальной и
* false - в противном случае.
* @type boolean
*/
jsQwerlib.chMinLength = function(name, id, minlength)
{
var e = jsQwerlib.getElementById(id);
if (e.value.length >= minlength) {
return true;
}
else {
e.focus();
alert(jsQwerlib.inputErrorMsgPrefix + "минимальная длина (символов) - " + minlength +
", поле '" + name + "'!");
return false;
}
};
//**************************************************************************************************
/** Проверяет поле на максимальную длину.
* @param {string} name название поля на странице, как его видит пользователь;
* @param {string} id элемент или id элемента;
* @param {int} maxlength максимальная разрешенная длина текста в поле.
* @return true - если длина текста в поле не превышает максимальной и
* false - в противном случае.
* @type boolean
*/
jsQwerlib.chMaxLength = function(name, id, maxlength)
{
var e = jsQwerlib.getElementById(id);
if (e.value.length <= maxlength) {
return true;
}
else {
e.focus();
alert(jsQwerlib.inputErrorMsgPrefix + "превышена максимальная длина, поле '" + name + "'!");
return false;
}
};
//**************************************************************************************************
/** Проверяет поле на соответствие регулярному выражению.
* @param {string} name название поля на странице, как его видит пользователь;
* @param {string} id элемент или id элемента;
* @param {RegExp} regexp регулярное выражение.
* @return true - если текст в поле соответствует регулярному выражению и
* false - в противном случае.
* @type boolean
*/
jsQwerlib.chRegexep = function(name, id, regexp)
{
var e = jsQwerlib.getElementById(id);
if (regexp.test(e.value)) {
return true;
}
else {
e.focus();
alert(jsQwerlib.inputErrorMsgPrefix + "недопустимый формат, поле '" + name + "'!");
return false;
}
};
//**************************************************************************************************
/** Проверяет два поля на совпадение текста (обычно пароль и его подтверждение).
* @param {string} name1 название первого поля на странице, как его видит пользователь;
* @param {string} id1 первый элемент или id элемента;
* @param {string} name2 название второго поля на странице, как его видит пользователь;
* @param {string} id2 второй элемент или id элемента.
* @return true - если текст в полях совпадает и false - в противном
* случае.
* @type boolean
*/
jsQwerlib.chMatch = function(name1, id1, name2, id2)
{
var e1 = jsQwerlib.getElementById(id1);
var e2 = jsQwerlib.getElementById(id2);
if (e1.value == e2.value) {
return true;
}
else {
e1.focus();
alert(jsQwerlib.inputErrorMsgPrefix + "поля '" + name1 + "' и '" + name2 + "' не совпадают!");
return false;
}
};
//**************************************************************************************************
/** Все проверки поля в одной функции (пустота, минимальная и максимальная длина, регулярное
* выражение).
* @param {string} name название поля на странице, как его видит пользователь;
* @param {string} id элемент или id элемента;
* @param {boolean} empty делать проверку поля на пустоту: true - да,
* false (null) - нет;
* @param {int} minlength минимальная разрешенная длина текста в поле или false
* (null) - если данную проверку делать не надо;
* @param {int} maxlength максимальная разрешенная длина текста в поле или false
* (null) - если данную проверку делать не надо;
* @param {RegExp} regexp регулярное выражение или false (null) - если
* данную проверку делать не надо.
* @return true - если все проверки прошли успешно и false - в противном
* случае.
* @type boolean
*/
jsQwerlib.chFormat = function(name, id, empty, minlength, maxlength, regexp)
{
// Если поле пустое, и ему разрешено быть пустым, то дальнейшие проверки уже делать не нужно
var e = jsQwerlib.getElementById(id);
var isEmpty = (e.value.length == 0);
return (!empty || jsQwerlib.chEmpty(name, id)) &&
(isEmpty ||
((!minlength || jsQwerlib.chMinLength(name, id, minlength)) &&
(!maxlength || jsQwerlib.chMaxLength(name, id, maxlength)) &&
(!regexp || jsQwerlib.chRegexep(name, id, regexp))));
};
//**************************************************************************************************
// Инициализация - подключаемся аналогично jQuery
//**************************************************************************************************
window.$Q = jsQwerlib;
window.jsQwerlib = jsQwerlib;
})();