Ядро JavaScript API

Диалоговые окна

Все методы для работы с диалоговыми окнами находятся в объекте

$.ics.dialog

confirm

Диалоговое окно для подтверждения действия пользователя:

$.ics.dialog.confirm(options);

Note: Метод является асинхронным. Для проверки результата действия пользователя нужно устаналивать callback.

Для поддержки всех функцинальных возможностей должен быть подключен файл jquery.alerts.js. Если плагин не подключен то будут использованы встроенные возможности браузера с урезанной функциональностью.

Опции:

Наименование	Описание	Значение по умолчанию
`message`	Текст запроса.	Пустая строка
`title`	Заголовок окна с сообщением.	Пустая строка
`callback`	Функция для обработки результата выбора пользователя. Первый аргумент функции - результат выбора пользователя: `true` для кнопки `OK` и `false` для кнопки `Cancel`.	`undefined`
`okButtonText`	Текст для кнопки `OK`.	`$.ics.configuration.dialog.okButtonText`
`cancelButtonText`	Текст для кнопки `Cancel`.	`$.ics.configuration.dialog.cancelButtonText`

Пример использования:

$.ics.dialog.confirm({
    message: 'Удалить файл?',
    title: 'Подтверждение удаления файла',
    callback: function (res) {
        if (res) {
            // При нажатии OK.
            deleteFile();
        } else {
            // При нажати Cancel.
            cancelFileDeleting();
        }
    }
});

Результат (с подключенным плагином jquery.alerts):

Результат (без плагина jquery.alerts):

alert

Диалоговое окно для отображения информации для пользователя:

$.ics.dialog.alert(options);

Note: Метод является асинхронным. Для проверки результата действия пользователя нужно устаналивать callback.

Если вместо опций будет передан текст, то будут использованы опции по умолчанию с указанным сообщением.

Пример использования:

$.ics.dialog.alert({
    message: 'Файл успешно удалён!',
    title: 'Внимание',
    callback: function () {
        // После закрытия окна.
        // ...
    }
});

Результат (с подключенным плагином jquery.alerts):

Результат (без плагина jquery.alerts):

Диалоговое модальное окно:

$.ics.dialog.modal(options);

Note: Метод является асинхронным. Для проверки результата действия пользователя нужно устаналивать callback.

Для работы метода обязательно подключение плагина jQuery Thickbox.

Опции:

Наименование	Описание	Значение по умолчанию
`content`	Содержимое, отображаемое в окне. Может быть HTML.	`undefined` (пустая строка)
`href`	Ссылка на страницу, которую нужно отобразить. Этот параметр имеет больший приоритет по сравнению с `content`.	`undefined` (пустая строка)
`title`	Заголовок окна.	`undefined` (пустая строка)
`callback`	Функция обратного вызова перед закрытием окна пользователем. Передаваемый аргумент позволяет отменить закрытие окна.	`undefined`
`width`	Ширина окна в пикселях.	`$.ics.configuration.dialog.width`
`height`	Ширина окна в пикселях.	`$.ics.configuration.dialog.height`	-
`modal`	Флаг модального окна. В случае `true` отсутствует возможность закрыть окно.	`true`

Возвращаемый объект:

Наименование	Описание
`close`	Метод для закрытия окна.
`closed`	Флаг закрытого окна, позволяющий определить, открыто ли ещё окно.
`context`	Контекст для отображаемого окна. Если отображаются данные по ссылке, то `context` ссылается на объект `window` открытого окна, иначе это объект `window` текущего окна.

Пример использования:

var modal = $.ics.dialog.modal({
    width: 500,
    content: '<strong>Выполняется сохранение...</strong>',
    title: 'Ждите!',
    modal: false,
    callback: function() {
        // После закрытия окна.
        // ...
    }
});

setTimeout(function() {
    modal.close();
}, 4000);

Результат:

Специальные функции

generateUniqueId

Генерация уникального идентификатора DOM-элемента.

$.ics.generateUniqueId(prefix);

Параметры:

Наименование	Описание	Значение по умолчанию
`prefix`		Префикс для генерируемого идентификатора.		`undefined` (пустая строка)
}

Пример использования:

var uniqueId = $.ics.generateUniqueId('element_'); // element_032452