FormHelper
class FormHelper extends Helper
FormHelper предоставляет помощники для отображения форм.
Методы
| setCharset(string $charset) Устанавливает кодировку по умолчанию. | из Helper | |
| string | getCharset() Получает кодировку по умолчанию. | из Helper |
| __construct(FormRendererInterface $renderer) | ||
| string | getName() Возвращает каноническое имя этого помощника. | |
| setTheme(FormView $view, string|array $themes) Устанавливает тему для данного представления. | ||
| string | form(FormView $view, array $variables = array()) Отображает HTML для формы. | |
| string | start(FormView $view, array $variables = array()) Отображает открывающий тег формы. | |
| string | end(FormView $view, array $variables = array()) Отображает закрывающий тег формы. | |
| string | enctype(FormView $view) deprecated Отображает атрибут enctype в теге формы, если необходимо. | |
| string | widget(FormView $view, array $variables = array()) Отображает HTML для данного представления. | |
| string | row(FormView $view, array $variables = array()) Отображает всю строку поля формы. | |
| string | label(FormView $view, string $label = null, array $variables = array()) Отображает метку данного представления. | |
| string | errors(FormView $view) Отображает ошибки данного представления. | |
| string | rest(FormView $view, array $variables = array()) Отображает представления, которые еще не были отображены. | |
| string | block(FormView $view, string $blockName, array $variables = array()) Отображает блок шаблона. | |
| string | csrfToken(string $intention) Возвращает токен CSRF. | |
| humanize($text) |
Подробности
setCharset(string $charset)
Устанавливает кодировку по умолчанию.
Параметры
| string | $charset | Кодировка |
string getCharset()
Получает кодировку по умолчанию.
Значение возврата
| string | Кодировка по умолчанию |
__construct(FormRendererInterface $renderer)
Параметры
| FormRendererInterface | $renderer |
string getName()
Возвращает каноническое имя этого помощника.
Значение возврата
| string | Каноническое имя |
setTheme(FormView $view, string|array $themes)
Устанавливает тему для данного представления.
Формат темы: "<пучок>:<контроллер>".
Параметры
| FormView | $view | Экземпляр FormView |
| string|array | $themes | Тема или массив тем |
string form(FormView $view, array $variables = array())
Отображает HTML для формы.
Пример использования:
<?php echo view['form']->form($form) ?>
Вы можете передать параметры при вызове:
<?php echo view['form']->form($form, array('attr' => array('class' => 'foo'))) ?>
<?php echo view['form']->form($form, array('separator' => '+++++')) ?>
Этот метод предназначен в основном для целей прототипирования. Если вы хотите контролировать макет формы более точно, рекомендуется использовать другие методы помощника для отображения частей формы по отдельности. Вы также можете создать пользовательскую тему формы, чтобы адаптировать внешний вид формы.
Параметры
| FormView | $view | Представление, для которого нужно отобразить форму |
| array | $variables | Дополнительные переменные, передаваемые в шаблон |
Значение возврата
| string | HTML разметка |
string start(FormView $view, array $variables = array())
Отображает открывающий тег формы.
Пример использования в шаблонах:
<?php echo $view['form']->start($form) ?>>
Параметры
| FormView | $view | Представление, для которого нужно отобразить открывающий тег |
| array | $variables | Дополнительные переменные, передаваемые в шаблон |
Значение возврата
| string | HTML разметка |
string end(FormView $view, array $variables = array())
Отображает закрывающий тег формы.
Пример использования в шаблонах:
<?php echo $view['form']->end($form) ?>>
Параметры
| FormView | $view | Представление, для которого нужно отобразить закрывающий тег |
| array | $variables | Дополнительные переменные, передаваемые в шаблон |
Значение возврата
| string | HTML разметка |
string enctype(FormView $view) устаревшее
устаревшее
Отображает HTML атрибут enctype в теге формы, если необходимо.
Пример использования в шаблонах:
<form action="..." method="post" <?php echo $view['form']->enctype($form) ?>>
Параметры
| FormView | $view | Представление, для которого нужно отобразить тип кодирования |
Значение возврата
| string | HTML разметка |
string widget(FormView $view, array $variables = array())
Отображает HTML для данного представления.
Пример использования:
<?php echo $view['form']->widget($form) ?>
Вы можете передать параметры при вызове:
<?php echo $view['form']->widget($form, array('attr' => array('class' => 'foo'))) ?>
<?php echo $view['form']->widget($form, array('separator' => '+++++')) ?>
Параметры
| FormView | $view | Представление, для которого нужно отобразить виджет |
| array | $variables | Дополнительные переменные, передаваемые в шаблон |
Значение возврата
| string | HTML разметка |
string row(FormView $view, array $variables = array())
Отображает всю строку поля формы.
Параметры
| FormView | $view | Представление, для которого нужно отобразить строку |
| array | $variables | Дополнительные переменные, передаваемые в шаблон |
Значение возврата
| string | HTML разметка |
string label(FormView $view, string $label = null, array $variables = array())
Отображает метку данного представления.
Параметры
| FormView | $view | Представление, для которого нужно отобразить метку |
| string | $label | Метка |
| array | $variables | Дополнительные переменные, передаваемые в шаблон |
Значение возврата
| string | HTML разметка |
string errors(FormView $view)
Отображает ошибки данного представления.
Параметры
| FormView | $view |
Значение возврата
| string | HTML разметка |
string rest(FormView $view, array $variables = array())
Отображает представления, которые еще не были отображены.
Параметры
| FormView | $view | Родительское представление |
| array | $variables | Массив переменных |
Значение возврата
| string | HTML разметка |
string block(FormView $view, string $blockName, array $variables = array())
Отображает блок шаблона.
Параметры
| FormView | $view | Представление для определения используемых тем |
| string | $blockName | Имя блока для отображения |
| array | $variables | Переменные для передачи в шаблон |
Значение возврата
| string | HTML разметка |
string csrfToken(string $intention)
Возвращает токен CSRF.
Используйте этот помощник для защиты CSRF без необходимости создания формы.
echo $view['form']->csrfToken('rmuser'.$user->getId());
Проверяйте токен в вашем действии, используя то же намерение.
$csrfProvider = $this->get('security.csrf.tokengenerator');
if (!$csrfProvider->isCsrfTokenValid('rmuser_'.$user->getId(), $token)) {
throw new \RuntimeException('CSRF attack detected.');
}
Параметры
| string | $intention | Намерение защищаемого действия |
Значение возврата
| string | Токен CSRF |
Исключения
| BadMethodCallException | если поставщик CSRF не был внедрен в конструктор |
humanize($text)
Параметры
| $text |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/2.7/Symfony/Bundle/FrameworkBundle/Templating/Helper/FormHelper.html