Form API позволяет вам объявлять собственные формы, их структуру, валидацию и отправку.
Описание самой формы происходит при помощи render array, который в дальнейшем преобразуется в HTML и отображается клиенту. Когда пользователь отправляет форму, Drupal автоматически производит обработку входящих данных и передает форме на валидацию и отправку. Вы полностью контролируете процесс формы, от её создания, до её отправки без необходимости использовать HTML.
Описание форм при помощи структурированных массивов, вместо использования обычного HTML имеет некоторые преимущества:
- Стабильная разметка для всех форм на сайте, поддающаяся модификации при помощи тем.
- Формы, объявленные одним модулем, могут быть легко изменены другим модулем при помощи хуков, без необходимости производить сложные операции или что-либо хакать.
- Комплексные элементы форм, например, загрузка файлов или виджет рейтинга, могут быть объявлены как компоненты и использоваться в любых формах и любом количестве, автоматически со всей необходимой логикой обработки данных полученных в форме, предоставляя готовый результат.
¶Ссылки
- Drupal 8: Form API что изменилось и как использовать, Niklan, 2015
