Класс ArrayContext
Предоставляет поставщик контекста на основе массива для FormHelper.
Этот адаптер полезен при тестировании или когда у вас есть формы, основанные на простых структурах данных массивов.
Важные ключи:
-
defaultsЗначения по умолчанию для полей. Эти значения будут использоваться, когда нет данных запроса. Данные должны быть вложены, следуя путям с разделителями «точка», с помощью которых вы обращаетесь к своим полям. -
requiredВложенный массив полей, взаимосвязей и логических флагов, указывающих, является ли поле обязательным. -
schemaМассив данных, имитирующих структуры столбцов, которые использует Cake\Database\Schema\Table. Этот массив позволяет управлять выведенным типом для полей и позволяет автоматически генерировать атрибуты, такие как maxlength, step и другие атрибуты HTML. Если вы хотите, чтобы работало обнаружение первичного ключа/id, убедитесь, что вы предоставили массив_constraints, который содержитprimary. См. пример ниже. -
errorsМассив ошибок валидации. Ошибки должны быть вложены, следуя путям с разделителями «точка», с помощью которых вы обращаетесь к своим полям.Пример
$data = [ 'schema' => [ 'id' => ['type' => 'integer'], 'title' => ['type' => 'string', 'length' => 255], '_constraints' => [ 'primary' => ['type' => 'primary', 'columns' => ['id']] ] ], 'defaults' => [ 'id' => 1, 'title' => 'First post!', ] ];
- Cake\View\Form\ArrayContext реализует Cake\View\Form\ContextInterface
Краткое описание свойств
Краткое описание методов
- __construct() publicКонструктор.
- attributes() publicПолучить ассоциативный массив дополнительных атрибутов для имени поля.
- error() publicПолучить ошибки для данного поля
- fieldNames() publicПолучить имена полей верхнего уровня в этом контексте.
- hasError() publicПроверить, есть ли у поля ошибка
- isCreate() publicВозвращает, предназначена ли эта форма для операции создания.
- isPrimaryKey() publicВозвращает true, если переданное имя поля является частью первичного ключа для этого контекста
- isRequired() publicПроверить, является ли данное поле обязательным.
- primaryKey() publicПолучить поля, используемые в контексте в качестве первичного ключа.
- type() publicПолучить абстрактный тип поля для данного имени поля.
- val() publicПолучить текущее значение для данного поля.
Подробное описание методов
__construct()source public
__construct( Cake\Network\Request $request , array $context )
Конструктор.
Параметры
-
Cake\Network\Request$request - Объект запроса.
- массив
$context - Информация контекста.
attributes()source public
attributes( string $field )
Получить ассоциативный массив дополнительных атрибутов для имени поля.
Параметры
- строка
$field - Путь с разделителями «точка» для получения дополнительных данных.
Возвращает
массивМассив данных, описывающих дополнительные атрибуты поля.
Реализация
Cake\View\Form\ContextInterface::attributes() error()source public
error( string $field )
Получить ошибки для данного поля
Параметры
- строка
$field - Путь с разделителями «точка» для проверки ошибок.
Возвращает
массивМассив ошибок, пустой массив будет возвращён, когда в контексте нет ошибок.
Реализация
Cake\View\Form\ContextInterface::error() fieldNames()source public
fieldNames( )
Получить имена полей верхнего уровня в этом контексте.
Возвращает
массивСписок имён полей в контексте.
Реализация
Cake\View\Form\ContextInterface::fieldNames() hasError()source public
hasError( string $field )
Проверить, есть ли у поля ошибка
Параметры
- строка
$field - Путь с разделителями «точка» для проверки ошибок.
Возвращает
booleanВозвращает true, если массив ошибок для поля не пустой.
Реализация
Cake\View\Form\ContextInterface::hasError() isCreate()source public
isCreate( )
Возвращает, предназначена ли эта форма для операции создания.
Для того, чтобы этот метод возвращал true, ограничение первичного ключа должно быть определено в данных 'schema', а данные 'defaults' должны содержать значение для всех полей в ключе.
Возвращает
booleanРеализация
Cake\View\Form\ContextInterface::isCreate() isPrimaryKey()source public
isPrimaryKey( string $field )
Возвращает true, если переданное имя поля является частью первичного ключа для этого контекста
Параметры
- строка
$field Путь с разделителями «точка» к полю, для которого необходимо значение.
Возвращает
booleanРеализация
Cake\View\Form\ContextInterface::isPrimaryKey() isRequired()source public
isRequired( string $field )
Проверить, является ли данное поле обязательным.
В этом классе контекста это просто определяется массивом 'required'.
Параметры
- строка
$field - Путь с разделителями «точка» для проверки обязательности.
Возвращает
booleanРеализация
Cake\View\Form\ContextInterface::isRequired() primaryKey()source public
primaryKey( )
Получить поля, используемые в контексте в качестве первичного ключа.
Возвращает
массивРеализация
Cake\View\Form\ContextInterface::primaryKey() type()source public
type( string $field )
Получить абстрактный тип поля для данного имени поля.
Параметры
- строка
$field - Путь с разделителями «точка» для получения типа схемы.
Возвращает
null|строкаАбстрактный тип данных или null.
См.
Cake\Database\TypeРеализация
Cake\View\Form\ContextInterface::type() val()source public
val( string $field , array $options [] )
Получить текущее значение для данного поля.
Этот метод объединяет текущие данные запроса и массив 'defaults'.
Параметры
- строка
$field Путь с разделителями «точка» к полю, для которого необходимо значение.
- массив
$optionsoptional [] Опции: -
default: Значение по умолчанию, которое будет возвращено, если значение не найдено в данных запроса или записи контекста. -schemaDefault: Логическое значение, указывающее, следует ли использовать значение по умолчанию из схемы контекста, если оно явно не указано.
Возвращает
смешанныйРеализация
Cake\View\Form\ContextInterface::val() Подробное описание свойств
END_OF_DOCUMENT_MARKER
© 2005–2017 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/3.3/class-Cake.View.Form.ArrayContext.html