VTextField

Base class for text-field

Props

Name	Type	Description
appearance	Enum: fieldset ghost
auto-complete	string
autofocus	boolean	Indicates that this element should get focus after the page finishes loading. See https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#htmlattrdefautofocus
char-count	boolean	Use in combination with maxlength to display a character count.
disabled	boolean	Sets the element's disabled state. A disabled element will not be included during form submission.
error-text	string	Provides a custom error message. Any current error state will be overridden.
helper-text	string	Provides additional information to help the user enter the correct information. To add HTML to the helper text, use the helper-text slot instead.
icon	Enum: 10-sec-backward-line 10-sec-backward-solid 10-sec-forward-line 10-sec-forward-solid 30-sec-backward-line 30-sec-backward-solid 30-sec-forward-line 30-sec-forward-solid 5-sec-backward-line 5-sec-backward-solid 5-sec-forward-line 5-sec-forward-solid ... 1231 more ...	A decorative icon the custom element should have. See the Vivid Icon Gallery for available icons: https://icons.vivid.vonage.com/
initial-value	string	The default value of the element. This value sets the value property only when the value property has not been explicitly set.
inputmode	string	Hints at the type of data that might be entered by the user while editing the element or its contents. This allows a browser to display an appropriate virtual keyboard.
label	string	The label for the form element.
list	string	Allows associating a https://developer.mozilla.org/en-US/docs/Web/HTML/Element/datalist
maxlength	number	The maximum number of characters a user can enter.
minlength	number	The minimum number of characters a user can enter.
name	string	The name of the element. This element's value will be surfaced during form submission under the provided name.
pattern	string	A regular expression that the value must match to pass validation.
placeholder	string	Sets the placeholder value of the element, generally used to provide a hint to the user.
readonly	boolean	When true, the control will be immutable by user interaction. See https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly
required	boolean	Require the field to be completed prior to form submission.
scale	Enum: condensed normal	The size the text-field should have.
shape	Enum: rounded pill
size	number	Sets the width of the element to a specified number of characters.
spellcheck	boolean	Controls whether or not to enable spell checking for the input field, or if the default spell checking configuration should be used.
success-text	string	Provides a custom success message. Any current error state will be overridden.
type	Enum: email password tel text url	Allows setting a type or mode of text.
value	string	The current value of the element.

Events

Name	Event Type	Description
blur	FocusEvent	Fires when the element loses focus.
change	CustomEvent<undefined>	Fires a custom 'change' event when the value has changed
click	MouseEvent	Fires when a pointing device button (such as a mouse's primary mouse button) is both pressed and released while the pointer is located inside the element.
focus	FocusEvent	Fires when the element receives focus.
input	Event	Fires when the value of an element has been changed.
keydown	KeyboardEvent	Fires when a key is pressed.
keyup	KeyboardEvent	Fires when a key is released.

Slots

Name	Description
action-items	Used to add action items to the end of the text-field.
helper-text	Describes how to use the text-field. Alternative to the helper-text attribute.
leading-action-items	Used to add action items to the start of the text-field.

Methods

Name	Type	Description
checkValidity	() => boolean	Return the current validity of the element.
focus	() => unknown
reportValidity	() => boolean	Return the current validity of the element. If false, fires an invalid event at the element.
select	() => unknown	Selects all the text in the text field
validate	() => unknown	{@inheritDoc (FormAssociated:interface).validate}