StandardField
- Type
- Abstract Class
- Namespace
- craft\fieldlayoutelements
- Inherits
- craft\fieldlayoutelements\StandardField » craft\fieldlayoutelements\BaseField » craft\base\FieldLayoutElement » yii\base\BaseObject (opens new window)
- Implements
- craft\base\FieldLayoutElementInterface, yii\base\Configurable (opens new window)
- Uses traits
- yii\base\ArrayableTrait (opens new window)
- Extended by
- craft\fieldlayoutelements\AssetTitleField, craft\fieldlayoutelements\EntryTitleField, craft\fieldlayoutelements\StandardTextField, craft\fieldlayoutelements\TitleField
- Since
- 3.5.0
StandardField is the base class for standard fields that can be included in field layouts.
Standard fields can be registered using craft\models\FieldLayout::EVENT_DEFINE_STANDARD_FIELDS.
View source (opens new window)
# Public Properties
# attribute
- Type
- string (opens new window)
- Default value
null
The element attribute this field is for.
View source (opens new window)
# containerAttributes
- Type
- array (opens new window)
- Default value
[]
HTML attributes for the field container
View source (opens new window)
# id
- Type
- string (opens new window), null (opens new window)
- Default value
null
The input’s id
attribute value.
If this is not set, attribute() will be used by default.
View source (opens new window)
# inputContainerAttributes
- Type
- array (opens new window)
- Default value
[]
HTML attributes for the input container
View source (opens new window)
# labelAttributes
- Type
- string (opens new window), null (opens new window)
- Default value
[]
The ID of the field label
View source (opens new window)
# mandatory
- Type
- boolean (opens new window)
- Default value
false
Whether the field must be present within the layout.
View source (opens new window)
# orientation
- Type
- string (opens new window), null (opens new window)
- Default value
null
The field’s orientation (ltr
or rtl
)
View source (opens new window)
# requirable
- Type
- boolean (opens new window)
- Default value
false
Whether the field can optionally be marked as required.
View source (opens new window)
# translatable
- Type
- boolean (opens new window)
- Default value
false
Whether the field is translatable
View source (opens new window)
# Public Methods
Method | Description |
---|---|
__call() (opens new window) | Calls the named method which is not a class method. |
__construct() | Constructor. |
__get() (opens new window) | Returns the value of an object property. |
__isset() (opens new window) | Checks if a property is set, i.e. defined and not null. |
__set() (opens new window) | Sets value of an object property. |
__unset() (opens new window) | Sets an object property to null. |
attribute() | Returns the element attribute this field is for. |
canGetProperty() (opens new window) | Returns a value indicating whether a property can be read. |
canSetProperty() (opens new window) | Returns a value indicating whether a property can be set. |
className() (opens new window) | Returns the fully qualified name of this class. |
extraFields() (opens new window) | Returns the list of fields that can be expanded further and returned by toArray() (opens new window). |
fields() (opens new window) | Returns the list of fields that should be returned by default by toArray() (opens new window) when no specific fields are specified. |
formHtml() | Returns the element’s form HTMl. |
hasCustomWidth() | Returns whether the element can have a custom width. |
hasMethod() (opens new window) | Returns a value indicating whether a method is defined. |
hasProperty() (opens new window) | Returns a value indicating whether a property is defined. |
init() (opens new window) | Initializes the object. |
keywords() | Returns the search keywords for this layout element. |
label() | Returns the field’s label. |
mandatory() | Returns whether the field must be present within the layout. |
requirable() | Returns whether the field can optionally be marked as required. |
selectorHtml() | Returns the selector HTML that should be displayed within field layout designers. |
settingsHtml() | Returns the settings HTML for the layout element. |
toArray() (opens new window) | Converts the model into an array. |
# attribute()
Returns the element attribute this field is for.
View source (opens new window)
Returns
# mandatory()
Returns whether the field must be present within the layout.
View source (opens new window)
Returns
# requirable()
Returns whether the field can optionally be marked as required.
View source (opens new window)
Returns
# Protected Methods
Method | Description |
---|---|
containerAttributes() | Returns the element container HTML attributes. |
defaultInstructions() | Returns the field’s default instructions, which will be used if instructions() is null. |
defaultLabel() | Returns the field’s default label, which will be used if label() is null. |
describedBy() | Returns the aria-describedby attribute value that should be set on the focusable input(s). |
errors() | Returns the field’s validation errors. |
errorsId() | Returns the id of the field errors. |
extractFieldsFor() (opens new window) | Extract nested fields from a fields collection for a given root field Nested fields are separated with dots (.). e.g: "item.id" The previous example would extract "id". |
extractRootFields() (opens new window) | Extracts the root field names from nested fields. |
id() | Returns the id of the input. |
inputContainerAttributes() | Returns input container HTML attributes. |
inputHtml() | Returns the field’s input HTML. |
instructions() | Returns the field’s instructions. |
instructionsId() | Returns the id of the field instructions. |
labelAttributes() | Returns label HTML attributes. |
orientation() | Returns the field’s orientation (ltr or rtl ). |
resolveFields() (opens new window) | Determines which fields can be returned by toArray() (opens new window). |
selectorAttributes() | Returns HTML attributes that should be added to the selector container. |
selectorInnerHtml() | Returns the selector’s inner HTML. |
showLabel() | Returns whether the label should be shown in form inputs. |
statusClass() | Returns the field’s status class. |
statusId() | Returns the id if the field status message. |
statusLabel() | Returns the field’s status label. |
tip() | Returns the field’s tip text. |
tipId() | Returns the id of the field tip. |
translatable() | Returns whether the field is translatable. |
translationDescription() | Returns the descriptive text for how this field is translatable. |
useFieldset() | Returns whether the element’s form HTML should use a <fieldset> + <legend> instead of a <div> + <label> . |
value() | Returns the field’s value. |
warning() | Returns the field’s warning text. |
warningId() | Returns the id of the field warning. |
# containerAttributes()
Returns the element container HTML attributes.
View source (opens new window)
Arguments
$element
(craft\base\ElementInterface, null (opens new window)) – The element the form is being rendered for$static
(boolean (opens new window)) – Whether the form should be static (non-interactive)
Returns
# id()
Returns the id
of the input.
View source (opens new window)
Returns
# inputContainerAttributes()
Returns input container HTML attributes.
View source (opens new window)
Arguments
$element
(craft\base\ElementInterface, null (opens new window)) – The element the form is being rendered for$static
(boolean (opens new window)) – Whether the form should be static (non-interactive)
Returns
# labelAttributes()
Returns label HTML attributes.
View source (opens new window)
Arguments
$element
(craft\base\ElementInterface, null (opens new window)) – The element the form is being rendered for$static
(boolean (opens new window)) – Whether the form should be static (non-interactive)
Returns
# orientation()
Returns the field’s orientation (ltr
or rtl
).
View source (opens new window)
Arguments
$element
(craft\base\ElementInterface, null (opens new window)) – The element the form is being rendered for$static
(boolean (opens new window)) – Whether the form should be static (non-interactive)
Returns
# tip()
Returns the field’s tip text.
View source (opens new window)
Arguments
$element
(craft\base\ElementInterface, null (opens new window)) – The element the form is being rendered for$static
(boolean (opens new window)) – Whether the form should be static (non-interactive)
Returns
string (opens new window), null (opens new window)
# translatable()
Returns whether the field is translatable.
View source (opens new window)
Arguments
$element
(craft\base\ElementInterface, null (opens new window)) – The element the form is being rendered for$static
(boolean (opens new window)) – Whether the form should be static (non-interactive)
Returns
# warning()
Returns the field’s warning text.
View source (opens new window)
Arguments
$element
(craft\base\ElementInterface, null (opens new window)) – The element the form is being rendered for$static
(boolean (opens new window)) – Whether the form should be static (non-interactive)