FormRendererInterface
интерфейс FormRendererInterface
Отображает форму в HTML.
Методы
| FormRendererEngineInterface | getEngine() Возвращает движок, используемый этим рендерером. | |
| setTheme(FormView $view, mixed $themes, bool $useDefaultThemes = true) Устанавливает тему(ы) для отображения представления и его дочерних элементов. | ||
| string | renderBlock(FormView $view, string $blockName, array $variables = array()) Отображает именованный блок темы формы. | |
| string | searchAndRenderBlock(FormView $view, string $blockNameSuffix, array $variables = array()) Ищет и отображает блок для данного суффикса имени. | |
| string | renderCsrfToken(string $tokenId) Отображает токен CSRF. | |
| string | humanize(string $text) Преобразует техническое имя в читаемое человеком. |
Подробности
FormRendererEngineInterface getEngine()
Возвращает движок, используемый этим рендерером.
Возвращаемое значение
| FormRendererEngineInterface | Движок рендера |
setTheme(FormView $view, mixed $themes, bool $useDefaultThemes = true)
Устанавливает тему(ы) для отображения представления и его дочерних элементов.
Параметры
| FormView | $view | Представление, которому назначена(ы) тема(ы) |
| mixed | $themes | Тема(ы). Тип этих тем открыт для реализации. |
| bool | $useDefaultThemes | Если true, использует темы по умолчанию, указанные в рендерере |
string renderBlock(FormView $view, string $blockName, array $variables = array())
Отображает именованный блок темы формы.
Параметры
| FormView | $view | Представление, для которого нужно отобразить блок |
| string | $blockName | Имя блока |
| array | $variables | Переменные, которые нужно передать в шаблон |
Возвращаемое значение
| string | HTML разметка |
string searchAndRenderBlock(FormView $view, string $blockNameSuffix, array $variables = array())
Ищет и отображает блок для данного суффикса имени.
Блок ищется путём объединения имён блоков, хранящихся в представлении формы, с заданным суффиксом. Если имя блока найдено, этот блок отображается.
Если этот метод вызывается рекурсивно, поиск блока продолжается с места, где был найден блок ранее.
Параметры
| FormView | $view | Представление, для которого нужно отобразить блок |
| string | $blockNameSuffix | Суффикс имени блока |
| array | $variables | Переменные, которые нужно передать в шаблон |
Возвращаемое значение
| string | HTML разметка |
string renderCsrfToken(string $tokenId)
Отображает токен CSRF.
Используйте этот помощник для защиты CSRF без накладных расходов на создание формы.
<input type="hidden" name="token" value="<?php $renderer->renderCsrfToken('rm_user_'.$user->getId()) ?>">
Проверьте токен в вашем действии, используя тот же идентификатор токена.
// $csrfProvider being an instance of Symfony\Component\Security\Csrf\TokenGenerator\TokenGeneratorInterface
if (!$csrfProvider->isCsrfTokenValid('rm_user_'.$user->getId(), $token)) {
throw new \RuntimeException('CSRF attack detected.');
}
Параметры
| string | $tokenId | Идентификатор токена CSRF |
Возвращаемое значение
| string | Токен CSRF |
string humanize(string $text)
Преобразует техническое имя в читаемое человеком.
Последовательности подчеркиваний заменяются на пробелы. Первая буква результирующей строки делается заглавной, а все остальные — строчными.
Параметры
| string | $text | Текст, который нужно преобразовать |
Возвращаемое значение
| string | Преобразованный текст |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
https://api.symfony.com/4.1/Symfony/Component/Form/FormRendererInterface.html