| Current File : /home/jvzmxxx/wiki/vendor/oojs/oojs-ui/php/widgets/TextInputWidget.php |
<?php
namespace OOUI;
/**
* Input widget with a text field.
*/
class TextInputWidget extends InputWidget {
use IconElement;
use IndicatorElement;
/* Properties */
/**
* Input field type.
*
* @var string
*/
protected $type = null;
/**
* Prevent changes.
*
* @var boolean
*/
protected $readOnly = false;
/**
* Allow multiple lines of text.
*
* @var boolean
*/
protected $multiline = false;
/**
* @param array $config Configuration options
* @param string $config['type'] HTML tag `type` attribute: 'text', 'password', 'search', 'email',
* 'url', 'date' or 'number'. Ignored if `multiline` is true. (default: 'text')
*
* Some values of `type` result in additional behaviors:
* - `search`: implies `icon: 'search'` and `indicator: 'clear'`; when clicked, the indicator
* empties the text field
* @param string $config['placeholder'] Placeholder text
* @param boolean $config['autofocus'] Ask the browser to focus this widget, using the 'autofocus'
* HTML attribute (default: false)
* @param boolean $config['readOnly'] Prevent changes (default: false)
* @param number $config['maxLength'] Maximum allowed number of characters to input
* @param boolean $config['multiline'] Allow multiple lines of text (default: false)
* @param int $config['rows'] If multiline, number of visible lines in textarea
* @param boolean $config['required'] Mark the field as required.
* Implies `indicator: 'required'`. (default: false)
* @param boolean $config['autocomplete'] If the field should support autocomplete
* or not (default: true)
*/
public function __construct( array $config = [] ) {
// Config initialization
$config = array_merge( [
'type' => 'text',
'readOnly' => false,
'autofocus' => false,
'required' => false,
'autocomplete' => true,
], $config );
if ( $config['type'] === 'search' ) {
if ( !array_key_exists( 'icon', $config ) ) {
$config['icon'] = 'search';
}
}
if ( $config['required'] ) {
if ( !array_key_exists( 'indicator', $config ) ) {
$config['indicator'] = 'required';
}
}
// Parent constructor
parent::__construct( $config );
// Properties
$this->type = $this->getSaneType( $config );
$this->multiline = isset( $config['multiline'] ) ? (bool)$config['multiline'] : false;
// Traits
$this->initializeIconElement( $config );
$this->initializeIndicatorElement( $config );
// Initialization
$this
->addClasses( [ 'oo-ui-textInputWidget', 'oo-ui-textInputWidget-type-' . $this->type ] )
->appendContent( $this->icon, $this->indicator );
$this->setReadOnly( $config['readOnly'] );
if ( isset( $config['placeholder'] ) ) {
$this->input->setAttributes( [ 'placeholder' => $config['placeholder'] ] );
}
if ( isset( $config['maxLength'] ) ) {
$this->input->setAttributes( [ 'maxlength' => $config['maxLength'] ] );
}
if ( $config['autofocus'] ) {
$this->input->setAttributes( [ 'autofocus' => 'autofocus' ] );
}
if ( $config['required'] ) {
$this->input->setAttributes( [ 'required' => 'required', 'aria-required' => 'true' ] );
}
if ( !$config['autocomplete'] ) {
$this->input->setAttributes( [ 'autocomplete' => 'off' ] );
}
if ( $this->multiline && isset( $config['rows'] ) && $config['rows'] ) {
$this->input->setAttributes( [ 'rows' => $config['rows'] ] );
}
}
/**
* Check if the widget is read-only.
*
* @return boolean
*/
public function isReadOnly() {
return $this->readOnly;
}
/**
* Set the read-only state of the widget. This should probably change the widget's appearance and
* prevent it from being used.
*
* @param boolean $state Make input read-only
* @return $this
*/
public function setReadOnly( $state ) {
$this->readOnly = (bool)$state;
if ( $this->readOnly ) {
$this->input->setAttributes( [ 'readonly' => 'readonly' ] );
} else {
$this->input->removeAttributes( [ 'readonly' ] );
}
return $this;
}
protected function getInputElement( $config ) {
if ( isset( $config['multiline'] ) && $config['multiline'] ) {
return new Tag( 'textarea' );
} elseif ( $this->getSaneType( $config ) === 'number' ) {
return ( new Tag( 'input' ) )->setAttributes( [
'step' => 'any',
'type' => 'number',
] );
} else {
return ( new Tag( 'input' ) )->setAttributes( [ 'type' => $this->getSaneType( $config ) ] );
}
}
private function getSaneType( $config ) {
$allowedTypes = [
'text',
'password',
'search',
'email',
'url',
'date',
'number'
];
return in_array( $config['type'], $allowedTypes ) ? $config['type'] : 'text';
}
/**
* Check if input supports multiple lines.
*
* @return boolean
*/
public function isMultiline() {
return (bool)$this->multiline;
}
public function getConfig( &$config ) {
if ( $this->isMultiline() ) {
$config['multiline'] = true;
$rows = $this->input->getAttribute( 'rows' );
if ( $rows !== null ) {
$config['rows'] = $rows;
}
}
if ( $this->type !== 'text' ) {
$config['type'] = $this->type;
}
if ( $this->isReadOnly() ) {
$config['readOnly'] = true;
}
$placeholder = $this->input->getAttribute( 'placeholder' );
if ( $placeholder !== null ) {
$config['placeholder'] = $placeholder;
}
$maxlength = $this->input->getAttribute( 'maxlength' );
if ( $maxlength !== null ) {
$config['maxLength'] = $maxlength;
}
$autofocus = $this->input->getAttribute( 'autofocus' );
if ( $autofocus !== null ) {
$config['autofocus'] = true;
}
$required = $this->input->getAttribute( 'required' );
$ariarequired = $this->input->getAttribute( 'aria-required' );
if ( ( $required !== null ) || ( $ariarequired !== null ) ) {
$config['required'] = true;
}
$autocomplete = $this->input->getAttribute( 'autocomplete' );
if ( $autocomplete !== null ) {
$config['autocomplete'] = false;
}
return parent::getConfig( $config );
}
}