Forms

TextField

Text input with v-model support. Wraps the Polaris <s-text-field> web component.

Usage

<script setup>
const title = ref('')
</script>

<template>
  <ShTextField
    v-model="title"
    label="Product title"
    placeholder="Enter product title"
    required
  />
</template>

Props

PropTypeDefaultDescription
modelValuestringBound value (use with v-model)
labelstringInput label
placeholderstringPlaceholder text
errorstringError message
detailsstringHelp text below the input
iconPolarisIconIcon displayed in the field
prefixstringText prefix
suffixstringText suffix
maxLengthnumberMaximum character length
minLengthnumberMinimum character length
autocompletestringAutocomplete attribute
defaultValuestringDefault value (uncontrolled)
labelAccessibilityVisibility'visible' | 'exclusive'Label visibility for assistive tech
readOnlybooleanMakes the field read-only
requiredbooleanMarks the field as required
disabledbooleanDisables the field
idstringElement ID
namestringForm field name

Events

EventPayloadDescription
update:modelValuestringEmitted when value changes (v-model)
inputInputEventNative input event
changeInputEventNative change event
focusInputEventEmitted on focus
blurInputEventEmitted on blur

Slots

SlotDescription
defaultAdditional content

Polaris Element

Renders as <s-text-field>. See Polaris TextField docs.

© 2026 KiriminAja. Polaris and Shopify are trademarks of Shopify Inc.

KiriminAja not affiliated with Shopify.