W3cubDocs

/CakePHP 3.8

Interface ContextInterface

Interface for FormHelper context implementations.

Direct Implementers

Method Summary

  • attributes() public
    Get an associative array of other attributes for a field name.
  • error() public
    Get the errors for a given field
  • fieldNames() public
    Get the fieldnames of the top level object in this context.
  • hasError() public
    Check whether or not a field has an error attached to it
  • isCreate() public
    Returns whether or not this form is for a create operation.
  • Returns true if the passed field name is part of the primary key for this context
  • isRequired() public
    Check if a given field is 'required'.
  • primaryKey() public
    Get the fields used in the context as a primary key.
  • type() public
    Get the abstract field type for a given field name.
  • val() public
    Get the current value for a given field.

Method Detail

attributes()source public

attributes( string $field )

Get an associative array of other attributes for a field name.

Parameters

string $field
A dot separated path to get additional data on.

Returns

array
An array of data describing the additional attributes on a field.

error()source public

error( string $field )

Get the errors for a given field

Parameters

string $field
A dot separated path to check errors on.

Returns

array

An array of errors, an empty array will be returned when the context has no errors.


fieldNames()source public

fieldNames( )

Get the fieldnames of the top level object in this context.

Returns

string[]
A list of the field names in the context.

hasError()source public

hasError( string $field )

Check whether or not a field has an error attached to it

Parameters

string $field
A dot separated path to check errors on.

Returns

boolean
Returns true if the errors for the field are not empty.

isCreate()source public

isCreate( )

Returns whether or not this form is for a create operation.

Returns

boolean

isPrimaryKey()source public

isPrimaryKey( string $field )

Returns true if the passed field name is part of the primary key for this context

Parameters

string $field

A dot separated path to the field a value is needed for.

Returns

boolean

isRequired()source public

isRequired( string $field )

Check if a given field is 'required'.

In this context class, this is simply defined by the 'required' array.

Parameters

string $field
A dot separated path to check required-ness for.

Returns

boolean

primaryKey()source public

primaryKey( )

Get the fields used in the context as a primary key.

Returns

array

type()source public

type( string $field )

Get the abstract field type for a given field name.

Parameters

string $field
A dot separated path to get a schema type for.

Returns

null|string
An abstract data type or null.

See

Cake\Database\Type

val()source public

val( string $field )

Get the current value for a given field.

Classes implementing this method can optionally have a second argument $options. Valid key for $options array are:

  • default: Default value to return if no value found in request data or context record.
  • schemaDefault: Boolean indicating whether default value from context's schema should be used if it's not explicitly provided.

Parameters

string $field

A dot separated path to the field a value is needed for.

Returns

mixed

Magic methods summary

getMaxLength()source public

getMaxLength( $field )

Get maximum length of a field from model validation

Parameters

$field

Returns

integer|null

getRequiredMessage()source public

getRequiredMessage( $field )

Gets the default "required" error message for a field

Parameters

$field

Returns

string|null

© 2005–present 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.8/class-Cake.View.Form.ContextInterface.html