Forms

DateField

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

Usage

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

<template>
  <ShDateField v-model="date" label="Start date" />
</template>

Props

PropTypeDefaultDescription
modelValuestringBound value (use with v-model)
labelstringInput label
allowstringAllowed date range
disallowstringDisallowed date range
allowDaysstringAllowed days of week
disallowDaysstringDisallowed days of week
viewstringCalendar view
defaultViewstringDefault calendar view
placeholderstringPlaceholder text
errorstringError message
detailsstringHelp text below the input
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
invalidEventEmitted when date validation fails
viewchangeEventEmitted when the calendar view changes

Slots

SlotDescription
defaultAdditional content

Polaris Element

Renders as <s-date-field>. See Polaris DateField docs.

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

KiriminAja not affiliated with Shopify.