Главная > Статьи > Drupal Form API - полный список свойств полей

Drupal Form API - полный список свойств полей

4345

При создании Drupal форм необходимо указывать различные свойства полей. Таких свойств достаточно много, для разных типов полей они могут отличаться.

drupal-form-api-properties

Полный список свойств полей в 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;
#access – есть доступ к полю или нет, значения: true, false;
#action - путь, по которому будет отправлена форма;
#after_build – массив с именами функций, которые нужно вызвать после построения поля;
#ajax – управляет ajax функционалом формы, значения: callback, effect, event, keypress, method, path, prevent, progress, trigger_as, wrapper;
#array_parents - массив имен родителей элемента (включая себя) в форме;
#attached - позволяет загружать CSS, JavaScript, библиотеки или настраиваемые типы при создании формы;
#attributes - дополнительные атрибуты HTML;
#autocomplete_path - путь сценария автозаполнения AJAX, используется в качестве источника для автозаполнения;
#built - используется для определения того, был ли создан элемент формы, значения: true, false;
#button_type - добавляет класс CSS к кнопке в форме, это НЕ задает тип атрибута HTML кнопки;
#children - дочерние элементы элемента;
#collapsed - указывает, свернут ли по умолчанию набор полей, значения: true, false;
#collapsible - указывает, можно ли сгенерировать набор полей с помощью JavaScript. Значения: true, false;
#cols - сколько столбцов должно быть в текстовом поле;
#default_tab - открытая вкладка по умолчанию;
#default_value - значение элемента формы, которое будет отображаться или выбираться первоначально, если форма еще не была отправлена;
#delta - количество весов для выбора, например, при значении 10 в поле выбора веса будут отображаться номера от -10 до 10;
#description - описание элемента формы, обязательно заключите внутри функции t, чтобы это свойство можно было перевести;
#disabled – отключает элемент ввода формы;
#element_validate - список пользовательских функций для проверки поля;
#empty - текст, отображаемый, если свойство #options пустое;
#empty_option - метка, отображаемая для начальной опции в элементе списка;
#empty_value - значение для начального параметра в элементе списка, который используется для определения того, представил ли пользователь значение или нет;
#error - указывает, отмечен ли элемент формы как ошибка;
#executes_submit_callback - указывает, должен ли выполняться обработчик отправки при отправке формы с помощью этого элемента кнопки, значения: true, false;
#field_prefix - текст или код, который помещается непосредственно перед текстовым полем;
#field_suffix - текст или код, который помещается непосредственно после текстового поля;
#group - указывает группу, которая может использоваться для группировки полей в вертикальных вкладках;
#header - заголовки столбцов;
#id - используется для заполнения id элемента формы;
#js_select - включает флажок для выбора всех значений;
#limit_validation_errors - массивы, указывающие разделы, которые должны быть проверены;
#markup - используется для установки HTML, который будет выводиться в форме;
#maxlength - максимальное количество символов для ввода в качестве входных данных;
#method - HTTP-метод, с которым будет отправлена форма, по умолчанию post;
#multiple - указывает, может ли пользователь выбрать более одного значения;
#name - атрибут name соответствующего элемента HTML;
#options - выбираемые опции для элемента формы, который позволяет использовать несколько вариантов;
#parents - определяет элементы родительской формы;
#post_render - выполняемая функция (функции) после рендеринга;
#prefix - текст или разметка для включения перед элементом формы;
#pre_render - выполняемая функция (функции) для вызова перед рендерингом;
#printed - используется для определения того, был ли напечатан элемент формы;
#process - массив функций, вызываемых при обработке элемента;
#processed - используется для определения того, был ли обработан элемент формы;
#required – обязательно ли поле, значения: true, false;
#resizable - разрешено ли пользователям изменять размер текстовой области;
#return_value - элемент значения, который должен возвращаться при выборе;
#rows - сколько строк должно быть в текстовом поле;
#size - ширина текстового поля;
#src - URL-адрес изображения кнопки;
#states - добавляет JavaScript в элемент, чтобы он имел разные активные состояния;
#submit - список настраиваемых функций отправки, которые будут вызываться при отправке элемента;
#suffix - текст или разметка для включения после элемента формы;
#theme - функция темы для вызова элемента;
#theme_wrappers - функция темы для вызова элемента, после визуализации элемента и дочерних элементов;
#title - название элемента формы;
#title_display - указывает, как должна отображаться метка. Значения: before, after, invisible, attribute;
#tree - используется для создания коллекций элементов формы, значения: true, false;
#type – используется для определения типа элемента формы;
#validate - список настраиваемых функций проверки, которые необходимо передать;
#validation_arguments – аргументы для валидации поля;
#value - используется для установки значений, которые пользователь не может редактировать;
#value_callback - указывает имя функции пользовательских значений, которая реализует, как пользовательский ввод сопоставляется с свойством #value элемента;
#weight - используется для сортировки списка элементов формы до вывода.

Как видно, список свойств полей довольно значительный. Следует понимать, что каждое конкретное свойство может быть использовано избирательно - только для того поля, которое его поддерживает.

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

Как проверить скорость сайта на Drupal →

Комментарии (0)

Для комментирования войдите или зарегистрируйтесь.