OOUI\TextInputWidget Class Reference

Input widget with a text field. More...

Inheritance diagram for OOUI\TextInputWidget:

Collaboration diagram for OOUI\TextInputWidget:

Public Member Functions
	__construct (array $config=[])
	isReadOnly ()
	Check if the widget is read-only.
	setReadOnly ( $state)
	Set the read-only state of the widget.
	getConfig (&$config)
	@inheritDoc
Public Member Functions inherited from OOUI\InputWidget
	getValue ()
	Get the value of the input.
	setDir ( $dir)
	Set the directionality of the input.
	setValue ( $value)
	Set the value of the input.
	setDisabled ( $disabled)
	@inheritDoc
	setInputId ( $id)
	Set the 'id' attribute of the <input> element.
Public Member Functions inherited from OOUI\Widget
	isDisabled ()
	Check if the widget is disabled.
	getInputId ()
	Get an ID of a labelable node which is part of this widget, if any, to be used for <label for> value.
	setLabelledBy ( $id)
	Set the element with the given ID as a label for this widget.
Public Member Functions inherited from OOUI\Element
	getTagName ()
	Get the HTML tag name.
	toggle ( $show=null)
	Toggle visibility of an element.
	getData ()
	Get element data.
	setData ( $data)
	Set element data.
	supports ( $methods)
	Check if element supports one or more methods.
	registerConfigCallback (callable $func)
	Register an additional function to call when building the config.
	toString ()
	Render element into HTML.
Public Member Functions inherited from OOUI\Tag
	__construct ( $tag='div')
	Create element.
	hasClass ( $class)
	Check for CSS class.
	addClasses (array $classes)
	Add CSS classes.
	removeClasses (array $classes)
	Remove CSS classes.
	toggleClasses (array $classes, $toggle=null)
	Toggle CSS classes.
	getTag ()
	getAttribute ( $key)
	Get HTML attribute value.
	setAttributes (array $attributes)
	Add HTML attributes.
	removeAttributes (array $keys)
	Remove HTML attributes.
	removeContent (... $content)
	Remove any items that match by reference.
	appendContent (... $content)
	Add content to the end.
	prependContent (... $content)
	Add content to the beginning.
	clearContent ()
	Remove all content.
	getElementGroup ()
	Get group element is in.
	setElementGroup ( $group)
	Set group element is in.
	setInfusable ( $infusable)
	Enable widget for client-side infusion.
	isInfusable ()
	Get client-side infusability.
	ensureInfusableId ()
	Ensure that this given Tag is infusable and has a unique id attribute.
	__toString ()
	Magic method implementation.

Protected Member Functions
	getInputElement ( $config)
	@inheritDoc
	getValidType ( $config)
Protected Member Functions inherited from OOUI\InputWidget
	cleanUpValue ( $value)
	Clean up incoming value.
Protected Member Functions inherited from OOUI\Element
	getJavaScriptClassName ()
	The class name of the JavaScript version of this widget.
	getGeneratedAttributes ()

Protected Attributes
string	$type = null
	Input field type.
bool	$readOnly = false
	Prevent changes.
Protected Attributes inherited from OOUI\InputWidget
Tag	$input
	Input element.
string	$value = ''
	Input value.
Protected Attributes inherited from OOUI\Widget
bool	$disabled = false
	Disabled.
Protected Attributes inherited from OOUI\Element
mixed	$data = null
	Element data.
bool	$visible = true
array	$ownClasses = []
	Strings of the CSS classes explicitly configured for this element (as opposed to #$classes, which contains all classes for this element).
callable[]	$configCallbacks = []
Protected Attributes inherited from OOUI\Tag
string	$tag = ''
	Tag name for this instance.
array	$attributes = []
	Attributes.
array	$classes = []
	Classes.
array	$content = []
	Content.
GroupElement null	$elementGroup = null
	Group.
bool	$infusable = false
	Infusion support.

Additional Inherited Members
Static Public Member Functions inherited from OOUI\Element
static	warnDeprecation ( $message='')
	Emits a deprecation warning with provided message.
static	getDir (Tag $element)
	Get the direction of the user interface for a given element.
static	setDefaultDir ( $dir)
	Set the default direction of the user interface.
static	configFromHtmlAttributes (array $attrs)
	A helper method to massage an array of HTML attributes into a format that is more likely to work with an OOUI PHP element, camel-casing attribute names and setting values of boolean ones to true.
Static Public Member Functions inherited from OOUI\Tag
static	generateElementId ()
	Generate a unique ID for element.
static	resetElementId ()
	Reset the unique ID, for consistent test output.
static	isSafeUrl ( $url)
	Check whether user-supplied URL is safe, that is, whether outputting it will not result in XSS vulnerability.
Static Public Attributes inherited from OOUI\Element
static string	$tagName = 'div'
	HTML tag name.
static string	$defaultDir = 'ltr'
	Default text direction, used for some layout calculations.

Detailed Description

Input widget with a text field.

Constructor & Destructor Documentation

__construct()

OOUI\TextInputWidget::__construct

(

array

$config = []

)

Parameters

array

$config

Configuration options string $config['type'] HTML tag type attribute: 'text', 'password', 'email', 'url' or 'number'. (default: 'text') string $config['placeholder'] Placeholder text bool $config['autofocus'] Ask the browser to focus this widget, using the 'autofocus' HTML attribute (default: false) bool $config['readOnly'] Prevent changes (default: false) int $config['maxLength'] Maximum allowed number of characters to input For unfortunate historical reasons, this counts the number of UTF-16 code units rather than Unicode codepoints, which means that codepoints outside the Basic Multilingual Plane (e.g. many emojis) count as 2 characters each. int $config['minLength'] Minimum allowed number of characters to input Same considerations for maxLength apply as mentioned above. bool|string $config['autocomplete'] If the field should support autocomplete or not (default: true). Can also be an autocomplete type hint. bool $config['spellcheck'] If the field should support spellcheck or not (default: browser-dependent)

Reimplemented from OOUI\InputWidget.

Reimplemented in OOUI\ComboBoxInputWidget, OOUI\MultilineTextInputWidget, OOUI\NumberInputWidget, and OOUI\SearchInputWidget.

Member Function Documentation

getConfig()

OOUI\TextInputWidget::getConfig

(

&

$config

)

@inheritDoc

Reimplemented from OOUI\InputWidget.

Reimplemented in OOUI\ComboBoxInputWidget, OOUI\MultilineTextInputWidget, and OOUI\NumberInputWidget.

getInputElement()

OOUI\TextInputWidget::getInputElement ( $config )

protected

@inheritDoc

Reimplemented from OOUI\InputWidget.

Reimplemented in OOUI\MultilineTextInputWidget.

getValidType()

OOUI\TextInputWidget::getValidType ( $config )

protected

Parameters

array

$config

Returns

string

Reimplemented in OOUI\SearchInputWidget.

isReadOnly()

OOUI\TextInputWidget::isReadOnly

(

)

Check if the widget is read-only.

Returns

bool

setReadOnly()

OOUI\TextInputWidget::setReadOnly

(

$state

)

Set the read-only state of the widget.

This should probably change the widget's appearance and prevent it from being used.

Parameters

bool

$state

Make input read-only

Returns

$this

---

The documentation for this class was generated from the following file:

• php/widgets/TextInputWidget.php