Вход Регистрация
ruen

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

При создании 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 - используется для сортировки списка элементов формы до вывода.

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

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

Последние статьи

Популярные разделы

Eqsash (Инструменты)

Приложение для Android - VK LAST USER ID, отучитель от зависимости и т.д.:
Доступно в Google Play

Amessage (Общение)

Вход в веб-версию
Приложение для Android:
Доступно в Google Play

Поделиться

Подписаться

YouTube

Книги

IT-заметки - Простым языком о самом нужном (HTML, CSS, JavaScript, PHP, базы данных, Drupal, Битрикс, SEO, домены, безопасность и другое), PDF, 500 стр.