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
modelValuestring—Bound value (use with v-model)
labelstring—Input label
allowstring—Allowed date range
disallowstring—Disallowed date range
allowDaysstring—Allowed days of week
disallowDaysstring—Disallowed days of week
viewstring—Calendar view
defaultViewstring—Default calendar view
placeholderstring—Placeholder text
errorstring—Error message
detailsstring—Help text below the input
autocompletestring—Autocomplete attribute
defaultValuestring—Default value (uncontrolled)
labelAccessibilityVisibility'visible' | 'exclusive'—Label visibility for assistive tech
readOnlyboolean—Makes the field read-only
requiredboolean—Marks the field as required
disabledboolean—Disables the field
idstring—Element ID
namestring—Form 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.