Modal dialogs custom element.


Keywords
javascript, JS, modal, window, den1n
License
MIT

Documentation

Modal

Компонент модального окна.

Параметры

Конструктор Modal принимает следующие параметры:

  • target целевой элемент.
  • options параметры:
    • container родительский контейнер модального окна.
    • titleSelector селектор заголовка окна, который будет вырезан из содержимого.
    • submitSelector селектор кнопки типа submit.
    • overlayClose закрывать открытое окно по клику мыши за его границей?
    • fontAwesome использовать Font Awesome (только, если FA подключен)?
    • handleForms выполнять обработку форм ввода?
    • resizable позволять изменять размер окна?
    • lang язык интерфейса (en, ru).

Локализация

Объект Modal.locale содержит локализованные строки текста используемые в интерфейсе окна.

В параметре Modal.locale.lang устанавливается текущий язык интерфейса окна.

Специальные классы

В содержимом окна можно использовать специальные CSS-классы, чтобы определять поведение отображаемых элементов.

Возможные значения классов:

  • modal-apply-button при клике на элементе, закрыть окно приняв изменения.
  • modal-cancel-button при клике на элементе, закрыть окно отменив изменения.
  • modal-persist если указан у submit элемента формы, то окно не будет автоматически закрываться после обработки формы.

Ограничения загрузки файлов на сервер

Если модальное окно обрабатывает форму загрузки файлов на сервер, то перед загрузкой форма может проверить количество загружаемых файлов, их размер и другие параметры. Для этого используйте следующие скрытые поля формы:

  • max_files максимальное число загружаемых файлов.
  • max_file_size максимальный объём одного файла (в байтах).
  • max_post_size максимальный объём всех загружаемых файлов (в байтах).
  • min_image_width минимальная ширина изображения (в пикселях).
  • min_image_height минимальная высота изображения (в пикселях). Если не указано, то использует min_image_width.
  • max_image_width максимальная ширина изображения (в пикселях).
  • max_image_height максимальная высота изображения (в пикселях). Если не указано, то использует max_image_width.

Обработчик формы проверит установленные ограничения и выведет соответствующее сообщение, если ограничения будут нарушены пользователем.

Простое окно

Для немедленного отображения окна с указанным сообщением можно использовать статический метод Modal.alert.

Функция принимает следующие параметры:

  • content содержимое окна, включая заголовок.
  • options параметры (см. параметры Modal).