Форма
класс Form расширяет Link и реализует ArrayAccess
Форма представляет собой HTML-форму.
Методы
| __construct(DOMElement $node, string $currentUri, string $method = null, string $baseHref = null) Конструктор. | ||
| DOMElement | getNode() Получает узел, связанный с этим элементом ссылки. | из Link |
| string | getMethod() Получает метод формы. | |
| string | getUri() Получает URI формы. | |
| DOMElement | getFormNode() Получает узел формы, связанный с этой формой. | |
| Form | setValues(array $values) Устанавливает значения полей. | |
| array | getValues() Получает значения полей. | |
| array | getFiles() Получает значения полей типа файл. | |
| array | getPhpValues() Получает значения полей в формате PHP. | |
| array | getPhpFiles() Получает значения полей типа файл в формате PHP. | |
| bool | has(string $name) Возвращает true, если поле с заданным именем существует. | |
| remove(string $name) Удаляет поле из формы. | ||
| FormField | get(string $name) Получает поле с заданным именем. | |
| set(FormField $field) Устанавливает поле с заданным именем. | ||
| FormField[] | all() Получает все поля. | |
| bool | offsetExists(string $name) Возвращает true, если поле с заданным именем существует. | |
| FormField | offsetGet(string $name) Получает значение поля. | |
| offsetSet(string $name, string|array $value) Устанавливает значение поля. | ||
| offsetUnset(string $name) Удаляет поле из формы. | ||
| Form | disableValidation() Отключает валидацию. |
Подробности
__construct(DOMElement $node, string $currentUri, string $method = null, string $baseHref = null)
Конструктор.
Параметры
| DOMElement | $node | Экземпляр \DOMElement |
| string | $currentUri | URI страницы, где вставлена ссылка (или базовый href) |
| string | $method | Метод для ссылки (по умолчанию GET) |
| string | $baseHref | URI атрибута |
Исключения
| LogicException | если узел не является кнопкой внутри тега формы |
DOMElement getNode()
Возвращает узел, связанный с этой ссылкой.
Возвращаемое значение
| DOMElement | Экземпляр \DOMElement |
string getMethod()
Получает метод формы.
Если в форме метод не определён, возвращается GET.
Возвращаемое значение
| string | Метод |
string getUri()
Получает URI формы.
Возвращаемый URI не совпадает с атрибутом "action" формы. Этот метод объединяет значение, если метод GET, чтобы имитировать поведение браузера.
Возвращаемое значение
| string | URI |
DOMElement getFormNode()
Возвращает узел формы, связанный с этой формой.
Возвращаемое значение
| DOMElement | Экземпляр \DOMElement |
Form setValues(array $values)
Устанавливает значения полей.
Параметры
| array | $values | Массив значений полей |
Возвращаемое значение
| Form |
array getValues()
Возвращает значения полей.
Возвращаемый массив не включает поля типа file (см. getFiles).
Возвращаемое значение
| array | Массив значений полей. |
array getFiles()
Возвращает значения полей типа file.
Возвращаемое значение
| array | Массив значений полей типа file. |
array getPhpValues()
Получает значения полей в формате PHP.
Этот метод преобразует поля с обозначением массивов (например, foo[bar] в массивы), как это делает PHP.
Возвращаемое значение
| array | Массив значений полей. |
array getPhpFiles()
Получает значения файлов в формате PHP.
Этот метод преобразует поля с обозначением массивов (например, foo[bar] в массивы), как это делает PHP.
Возвращаемое значение
| array | Массив значений файлов. |
bool has(string $name)
Возвращает true, если поле с заданным именем существует.
Параметры
| string | $name | Имя поля |
Возвращаемое значение
| bool | true, если поле существует, иначе false |
remove(string $name)
Удаляет поле из формы.
Параметры
| string | $name | Имя поля |
Исключения
| InvalidArgumentException | если имя имеет неправильный формат |
FormField get(string $name)
Получает поле по имени.
Параметры
| string | $name | Имя поля |
Возвращаемое значение
| FormField | Экземпляр поля |
Исключения
| InvalidArgumentException | Если поле не найдено в форме |
set(FormField $field)
Устанавливает поле по имени.
Параметры
| FormField | $field | Поле |
FormField[] all()
Получает все поля.
Возвращаемое значение
| FormField[] | Массив полей |
bool offsetExists(string $name)
Возвращает true, если поле с заданным именем существует.
Параметры
| string | $name | Имя поля |
Возвращаемое значение
| bool | true, если поле существует, иначе false |
FormField offsetGet(string $name)
Возвращает значение поля.
Параметры
| string | $name | Имя поля |
Возвращаемое значение
| FormField | Экземпляр связанного поля |
Исключения
| InvalidArgumentException | если поле не существует |
offsetSet(string $name, string|array $value)
Устанавливает значение поля.
Параметры
| string | $name | Имя поля |
| string|array | $value | Значение поля |
Исключения
| InvalidArgumentException | если поле не существует |
offsetUnset(string $name)
Удаляет поле из формы.
Параметры
| string | $name | Имя поля |
Form disableValidation()
Отключает валидацию.
Возвращаемое значение
| Form |
© 2004–2017 Fabien Potencier
Licensed under the MIT License.
http://api.symfony.com/3.0/Symfony/Component/DomCrawler/Form.html