Создание формы в Drupal - какие типы полей существуют

02.08.18 ИТ / Drupal 5954

При создании формы в Drupal необходимо указывать для каждого поля его тип. Какие типы полей существуют в Drupal, а точнее какой #type можно указать в форме? Значений достаточно много, перечислим общие:

• checkbox - создает поле-переключатель в виде одной галочки;
• checkboxes – создает поле, содержащее переключатели в виде множества галочек;
• date – поле для ввода даты;
• fieldset – позволяет создать рамку вокруг формы;
• file – поле, позволяющее загрузить файл;
• machine_name – поле для указания машинного имени;
• managed_file – позволяет создать поле для загрузки файла, с кнопками загрузить или удалить файл прямо на странице редактирования;
• password – поле для ввода пароля;
• password_confirm – поле для подтверждения ввода пароля;
• radio – поле-радиокнопка;
• radios – создает поле, содержащее переключатели в виде множества радиокнопок;
• select – поле для выбора значения из списка;
• tableselect – создает таблицу, в которой в левом столбце можно выбрать значение при помощи чекбоксов или радиокнопок;
• text_format – поле, позволяющее ввести текст большой длины и с переносами. Дополнительно можно выбрать формат ввода текста;
• textarea – поле для ввода большого текста;
• textfield – простое поле для ввода недлинных значений;
• vertical_tabs – создает поле в виде вертикальных вкладок;
• weight – поле для удобного указания веса элемента.

Также есть и специальные типы, рассмотрим и их:

• actions - элемент-обертка для группировки одной или нескольких кнопок в форме, помогает обеспечить правильную стилизацию тем и позволить другим модулям правильно изменять действия формы. Обычно это кнопки «Сохранить», «Удалить», «Отмена»;
• button – обычно такой тип служит для создания кнопки для предпросмотра. Когда кнопка нажата, форма будет отправлена, где она будет проверена и перестроена, но при этом обработчик отправки не вызывается;
• container – поле создает HTML для переноса дочерних элементов в контейнер. Окружает дочерние элементы с помощью тега div и добавляет такие атрибуты, как классы или идентификатор;
• image_button – кнопка-изображение;
• submit – кнопка для отправки формы;
• form - создает поле, содержащее элементы формы;
• hidden – создает скрытое поле, для передачи каких-либо дополнительных данных;
• token - поле, позволяющее выбрать токен;
• markup – поле, позволяющее задать свою разметку HTML;
• item – создает элемент формы только для отображения, позволяющий указать заголовок и описание;
• value – поле для задания значения формы, которое является внутренним и никогда не отображается на экране.

Как видно, типов полей в Drupal достаточно много - при помощи Form API можно создать практически любой элемент ввода, под любые нужды. Были рассмотрены общие и специальные типы полей, которые можно создавать в Drupal.