Text field - Frameworks

A text field is a single-line input component used for entering and editing textual data.

AndroidreleasedElementsreleasediOSreleasedReactreleasedVuereleased

Vue

AndroidElementsiOSReactVue

Import

Use in entire app

import { Forms } from '@warp-ds/vue'
app.use(Forms)

Use in one component and special imports

You can import the component like so:

import { wTextfield } from '@warp-ds/vue';

or import it individually to optimize your JS bundle size by adding only the components you need:

import { wTextfield } from '@warp-ds/vue/forms';

Syntax

<w-textfield label="A label" hint="A hint" v-model="model" />

Props

The props documented below have defaults set or are unique to this component, all typical HTML5 attributes are valid props.

Optional props

Name	Type	Default	Description
type	string	text	Allowed types are: text | search | email | password | url | tel | number
autocomplete	string	off
mask	object		See the Masking section below for more information

Masking

To use input masking, first provide the default export from the cleave.js package as shown below. Once you've done that, any options from Cleave are valid options on the mask prop.

// in setup, if you only need masking in one component
import { provide } from 'vue'
import Cleave from 'cleave.js'

export default {
  setup() {
    provide('Cleave', Cleave)
  }
}
// or install app-wide by using the provide method on app
app.provide('Cleave', Cleave)

Affixes

If you wish to use an affix you must first import the wAffix component

import { wAffix } from '@warp-ds/vue';

Then you include it as a child to w-textfield and pass the appropiate props. You must specify which slot to set the affix into (either prefix or suffix).

Suffix

<w-textfield #suffix v-model="inputModel" label="Search for items">
  <w-affix suffix search aria-label="Search" @click="handleSearch"/>
</w-textfield>

Prefix

<w-textfield #prefix v-model="inputModel" label="Price">
  <w-affix prefix label="kr"/>
</w-textfield>

For prefixes wider than 40px, push the input further to the right by setting a --w-prefix-width value on the w-textfield component. This will increase left padding of its input element. This value needs to be hardcoded until we find a more robust solution.

<w-textfield class="[--w-prefix-width:56px]" #prefix label="Price in kroner">
  <w-affix prefix label="kroner"></w-affix>
</w-textfield>

You can also use both a prefix and suffix

<w-textfield v-model="inputModel" label="Price">
  <template #prefix><w-affix prefix label="kr" /></template>
  <template #suffix><w-affix suffix clear aria-label="Clear text" @click="handleClear" /></template>
</w-textfield>

Validation

Validating Elements

Every form element accepts a prop rules which takes an array of functions. These functions will be run in order until one returns an object. If all functions return true the field is considered valid.

[v => v.trim().length > 5 || { valid: false, hint: 'This should be longer' }]

The function has one argument, the current value of the form element — and can either return true or an object with attributes described below

attribute	type	notes
valid	boolean
hint	string
always	boolean

Collecting Validation with wForm

The wForm component registers element descendants at any level, and provides the aggregate validation status.

prop	type	default	notes
v-model	boolean		True when all descendants are valid
v-model:completed	boolean		True when all descendants are completed - passing their required rule
should-validate	boolean		Can be used to instruct all descendants to immediately validate. Note that this will not update if the should-validate logic is updated elsewhere.
as	string	form	The DOM element to emit for the wrapper

Programmatic validation

The wField component can provide access to programmatic validation beyond what wForm's props can. For information on which methods are available, see the documentation on Field.

<w-field #control="{ form }">
  <button @click="submit(form)">Submit</button>
</w-field>

Validation and required Form Elements

If the form element is marked required, a special rule will be inserted before any user-defined rules.

The required prop can accept a function that will be used as the required-rule.

FIELD Syntax

<w-field label="I can be anything!" hint="Isn't that neat?">
  <your-custom-element />
<w-field>

Optional props

Name	Type	Default	Description
label	string		The content to display as the label
hint	string		The string can contain HTML.
invalid	boolean		Renders the field in an invalid state. Often paired with hint to provide feedback about the error.
label-level	number		Usable on toggles, will make the emitted legend element into a heading for accessibility.
optional	string		Mark label to indicate that this input is optional.
read-only	string		Whether the input can be selected but not changed by the user.

Questions?

Feel free to ask any questions on usage in the Warp DS Slack channel: #warp-design-system