ChoiceFormField
class ChoiceFormField extends FormField
ChoiceFormField представляет поле формы выбора.
Он создаётся из тега HTML select, или тегов HTML checkbox, или radio.
Методы
| __construct(DOMElement $node) Конструктор. | из FormField | |
| string | getName() Возвращает имя поля. | из FormField |
| string|array | getValue() Получает значение поля. | из FormField |
| setValue(string $value) Устанавливает значение поля. | ||
| bool | hasValue() Возвращает true, если поле должно быть включено в значения, отправляемые на сервер. | |
| bool | isDisabled() Проверяет, является ли текущий выбранный параметр отключённым. | |
| select(string $value) Устанавливает значение поля. | ||
| tick() Помечает checkbox как выбранный. | ||
| untick() Снимает отметку с checkbox. | ||
| addChoice(DOMElement $node) Добавляет вариант к существующим. | ||
| string | getType() Возвращает тип поля выбора (radio, select или checkbox). | |
| bool | isMultiple() Возвращает true, если поле может принимать несколько значений. | |
| bool | containsOption(string $optionValue, array $options) Проверяет, содержится ли заданное значение среди существующих вариантов. | |
| array | availableOptionValues() Возвращает список доступных вариантов поля. | |
| ChoiceFormField | disableValidation() Отключает внутреннюю валидацию поля. |
Подробности
__construct(DOMElement $node)
Конструктор.
Параметры
| DOMElement | $node | Узел, связанный с этим полем |
string getName()
Возвращает имя поля.
Значение
| string | Имя поля |
string|array getValue()
Получает значение поля.
Значение
| string|array | Значение поля |
setValue(string $value)
Устанавливает значение поля.
Параметры
| string | $value | Значение поля |
Исключения
| InvalidArgumentException | При неверном типе значения |
bool hasValue()
Возвращает true, если поле должно быть включено в отправляемые значения.
Значение
| bool | true, если поле должно быть включено в отправляемые значения, иначе false |
bool isDisabled()
Проверяет, является ли текущий выбранный параметр отключённым.
Значение
| bool |
select(string $value)
Устанавливает значение поля.
Параметры
| string | $value | Значение поля |
tick()
Помечает checkbox как выбранный.
Исключения
| LogicException | При неверном типе |
untick()
Снимает отметку с checkbox.
Исключения
| LogicException | При неверном типе |
addChoice(DOMElement $node)
Добавляет вариант к существующим.
Параметры
| DOMElement | $node |
Исключения
| LogicException | Если предоставленный вариант не является множественным или radio |
string getType()
Возвращает тип поля выбора (radio, select или checkbox).
Значение
| string | Тип |
bool isMultiple()
Возвращает true, если поле может принимать несколько значений.
Значение
| bool | true, если поле может принимать несколько значений, иначе false |
bool containsOption(string $optionValue, array $options)
Проверяет, содержится ли заданное значение среди существующих вариантов.
Параметры
| string | $optionValue | |
| array | $options |
Значение
| bool |
array availableOptionValues()
Возвращает список доступных вариантов поля.
Значение
| array |
ChoiceFormField disableValidation()
Отключает внутреннюю валидацию поля.
Значение
| ChoiceFormField |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/2.7/Symfony/Component/DomCrawler/Field/ChoiceFormField.html
