PHP Класс Contao\Widget

The class functions as abstract parent class for all widget classes and provides methods to generate the form field markup and to validate the form field input. Usage: $widget = new TextField(); $widget->name = 'test'; $widget->label = 'Test'; if ($_POST) { $widget->validate(); if (!$widget->hasErrors()) { echo $widget->value; } }
Наследование: extends contao\BaseTemplate
Показать файл Открыть проект Примеры использования класса

Защищенные свойства (Protected)

Свойство Тип Описание
$arrAttributes array Attributes
$arrConfiguration array Configuration
$arrErrors array Errors
$arrOptions array Options
$blnForAttribute boolean For attribute indicator
$blnSubmitInput boolean Submit indicator
$objDca object Data container
$strClass string CSS class
$strId integer Id
$strLabel string Label
$strName string Name
$strPrefix string CSS class prefix
$strWizard string Wizard
$varValue mixed Value

Открытые методы

Метод Описание
__construct ( array $arrAttributes = null ) Initialize the object
__get ( string $strKey ) : string Return an object property
__isset ( string $strKey ) : boolean Check whether an object property exists
__set ( string $strKey, mixed $varValue ) Set an object property
addAttribute ( string $strName, mixed $varValue ) Add an attribute
addAttributes ( array $arrAttributes ) Take an associative array and add it to the object's attributes
addError ( string $strError ) Add an error message
generate ( ) : string Generate the widget and return it as string
generateLabel ( ) : string Generate the label and return it as string
generateWithError ( boolean $blnSwitchOrder = false ) : string Generate the widget with error message and return it as string
getAttribute ( string $strKey ) : string Return a single attribute
getAttributes ( array $arrStrip = [] ) : string Return all attributes as string
getAttributesFromDca ( array $arrData, string $strName, mixed $varValue = null, string $strField = '', string $strTable = '', DataContainer | null $objDca = null ) : array Extract the Widget attributes from a Data Container array
getEmptyStringOrNull ( ) : string | integer | null Return either an empty string or null based on the SQL string
getEmptyStringOrNullByFieldType ( string $sql ) : string | null Return either an empty string or null based on the SQL string
getEmptyValue ( ) : string | integer | null Return the empty value based on the SQL string
getEmptyValueByFieldType ( string $sql ) : string | integer | null Return the empty value based on the SQL string
getErrorAsHTML ( integer $intIndex ) : string Return a particular error as HTML string
getErrorAsString ( integer $intIndex ) : string Return a particular error as string
getErrors ( ) : array Return the errors array
getErrorsAsString ( string $strSeparator = null ) : string Return all errors as string separated by a given separator
hasErrors ( ) : boolean Return true if the widget has errors
optionChecked ( string $strOption, mixed $varValues ) : string Return a "checked" attribute if the option is checked
optionSelected ( string $strOption, mixed $varValues ) : string Return a "selected" attribute if the option is selected
parse ( array $arrAttributes = null ) : string Parse the template file and return it as string
submitInput ( ) : boolean Return true if the widgets submits user input
validate ( ) Validate the user input and set the value

Защищенные методы

Метод Описание
addSubmit ( ) : string Generate a submit button
getPost ( string $strKey ) : mixed Find and return a $_POST variable
isChecked ( array $arrOption ) : string Check whether an option is checked
isSelected ( array $arrOption ) : string Check whether an option is selected
isValidOption ( mixed $varInput ) : boolean Check whether an input is one of the given options
validator ( mixed $varInput ) : mixed Recursively validate an input variable

Описание методов

__construct() публичный Метод

Initialize the object
public __construct ( array $arrAttributes = null )
$arrAttributes array An optional attributes array

__get() публичный Метод

Return an object property
public __get ( string $strKey ) : string
$strKey string The property name
Результат string The property value

__isset() публичный Метод

Check whether an object property exists
public __isset ( string $strKey ) : boolean
$strKey string The property name
Результат boolean True if the property exists

__set() публичный Метод

Set an object property
public __set ( string $strKey, mixed $varValue )
$strKey string The property name
$varValue mixed The property value

addAttribute() публичный Метод

Add an attribute
public addAttribute ( string $strName, mixed $varValue )
$strName string The attribute name
$varValue mixed The attribute value

addAttributes() публичный Метод

Take an associative array and add it to the object's attributes
public addAttributes ( array $arrAttributes )
$arrAttributes array An array of attributes

addError() публичный Метод

Add an error message
public addError ( string $strError )
$strError string The error message

addSubmit() защищенный Метод

Generate a submit button
Устаревший: Deprecated since Contao 4.0, to be removed in Contao 5.0.
protected addSubmit ( ) : string
Результат string The submit button markup

generate() абстрактный публичный Метод

Generate the widget and return it as string
abstract public generate ( ) : string
Результат string The widget markup

generateLabel() публичный Метод

Generate the label and return it as string
public generateLabel ( ) : string
Результат string The label markup

generateWithError() публичный Метод

Generate the widget with error message and return it as string
public generateWithError ( boolean $blnSwitchOrder = false ) : string
$blnSwitchOrder boolean If true, the error message will be shown below the field
Результат string The form field markup

getAttribute() публичный Метод

Return a single attribute
public getAttribute ( string $strKey ) : string
$strKey string The attribute name
Результат string The attribute markup

getAttributes() публичный Метод

Return all attributes as string
public getAttributes ( array $arrStrip = [] ) : string
$arrStrip array An optional array with attributes to strip
Результат string The attributes string

getAttributesFromDca() публичный статический Метод

Extract the Widget attributes from a Data Container array
public static getAttributesFromDca ( array $arrData, string $strName, mixed $varValue = null, string $strField = '', string $strTable = '', DataContainer | null $objDca = null ) : array
$arrData array The field configuration array
$strName string The field name in the form
$varValue mixed The field value
$strField string The field name in the database
$strTable string The table name in the database
$objDca DataContainer | null An optional DataContainer object
Результат array An attributes array that can be passed to a widget

getEmptyStringOrNull() публичный Метод

Return either an empty string or null based on the SQL string
public getEmptyStringOrNull ( ) : string | integer | null
Результат string | integer | null The empty value

getEmptyStringOrNullByFieldType() публичный статический Метод

Return either an empty string or null based on the SQL string
public static getEmptyStringOrNullByFieldType ( string $sql ) : string | null
$sql string The SQL string
Результат string | null The empty string or null

getEmptyValue() публичный Метод

Return the empty value based on the SQL string
public getEmptyValue ( ) : string | integer | null
Результат string | integer | null The empty value

getEmptyValueByFieldType() публичный статический Метод

Return the empty value based on the SQL string
public static getEmptyValueByFieldType ( string $sql ) : string | integer | null
$sql string The SQL string
Результат string | integer | null The empty value

getErrorAsHTML() публичный Метод

Return a particular error as HTML string
public getErrorAsHTML ( integer $intIndex ) : string
$intIndex integer The message index
Результат string The HTML markup of the corresponding error message

getErrorAsString() публичный Метод

Return a particular error as string
public getErrorAsString ( integer $intIndex ) : string
$intIndex integer The message index
Результат string The corresponding error message

getErrors() публичный Метод

Return the errors array
public getErrors ( ) : array
Результат array An array of error messages

getErrorsAsString() публичный Метод

Return all errors as string separated by a given separator
public getErrorsAsString ( string $strSeparator = null ) : string
$strSeparator string An optional separator (defaults to "
")
Результат string The error messages string

getPost() защищенный Метод

Find and return a $_POST variable
protected getPost ( string $strKey ) : mixed
$strKey string The variable name
Результат mixed The variable value

hasErrors() публичный Метод

Return true if the widget has errors
public hasErrors ( ) : boolean
Результат boolean True if there are errors

isChecked() защищенный Метод

Check whether an option is checked
protected isChecked ( array $arrOption ) : string
$arrOption array The options array
Результат string The "checked" attribute or an empty string

isSelected() защищенный Метод

Check whether an option is selected
protected isSelected ( array $arrOption ) : string
$arrOption array The options array
Результат string The "selected" attribute or an empty string

isValidOption() защищенный Метод

Check whether an input is one of the given options
protected isValidOption ( mixed $varInput ) : boolean
$varInput mixed The input string or array
Результат boolean True if the selected option exists

optionChecked() публичный статический Метод

Return a "checked" attribute if the option is checked
public static optionChecked ( string $strOption, mixed $varValues ) : string
$strOption string The option to check
$varValues mixed One or more values to check against
Результат string The attribute or an empty string

optionSelected() публичный статический Метод

Return a "selected" attribute if the option is selected
public static optionSelected ( string $strOption, mixed $varValues ) : string
$strOption string The option to check
$varValues mixed One or more values to check against
Результат string The attribute or an empty string

parse() публичный Метод

Parse the template file and return it as string
public parse ( array $arrAttributes = null ) : string
$arrAttributes array An optional attributes array
Результат string The template markup

submitInput() публичный Метод

Return true if the widgets submits user input
public submitInput ( ) : boolean
Результат boolean True if the widget submits user input

validate() публичный Метод

Validate the user input and set the value
public validate ( )

validator() защищенный Метод

Recursively validate an input variable
protected validator ( mixed $varInput ) : mixed
$varInput mixed The user input
Результат mixed The original or modified user input

Описание свойств

$arrAttributes защищенное свойство

Attributes
protected array $arrAttributes
Результат array

$arrConfiguration защищенное свойство

Configuration
protected array $arrConfiguration
Результат array

$arrErrors защищенное свойство

Errors
protected array $arrErrors
Результат array

$arrOptions защищенное свойство

Options
protected array $arrOptions
Результат array

$blnForAttribute защищенное свойство

For attribute indicator
protected bool $blnForAttribute
Результат boolean

$blnSubmitInput защищенное свойство

Submit indicator
protected bool $blnSubmitInput
Результат boolean

$objDca защищенное свойство

Data container
protected object $objDca
Результат object

$strClass защищенное свойство

CSS class
protected string $strClass
Результат string

$strId защищенное свойство

Id
protected int $strId
Результат integer

$strLabel защищенное свойство

Label
protected string $strLabel
Результат string

$strName защищенное свойство

Name
protected string $strName
Результат string

$strPrefix защищенное свойство

CSS class prefix
protected string $strPrefix
Результат string

$strWizard защищенное свойство

Wizard
protected string $strWizard
Результат string

$varValue защищенное свойство

Value
protected mixed $varValue
Результат mixed