Skip to content

DateInput ⚠️ Experimental

The DateInput component can be used imported from:

Playground

Parameters

Events

This component has events. Check the documentation about how to use the events.

NamePayloadDescription
onChangestringReturns the new value of the model
onEntervoidTriggered when "Enter" in pressed
onRestartedvoidEmitted on value reset
onBlurvoidEmitted on blur
onValidatedbooleanEmitted when the validation status changes

Slots

This component has slots. Check the documentation about how to use the slots.

NameTagsDescription
labelspan
help-textspan

Parameters use

Check the documentation about how to use the parameters.

config

The config parameter is used to set the shape of the input between lined and shaped. Being omitted will render the default shaped shape.

label

The label parameter is used to set the text label of the component. Make sure you always use it.

Can also use the label slot:

Date input

model

Attention!

If you hardcode this value, it will not be reactive and the selection won't change. Use a variable instead and, ideally, a closed loop.

The model parameter is used to set the date for the input. Make sure you use a valid date format (ISO 8601)

as yyyy-mm-dd:

help-text

The help-text parameter is used to provide additional assistance to the user.

You can also use the help-text slot:

This is a help text

range

The range parameter is used to set the range of the input. It must be an array with two numbers. The first number is the minimum value and the second number is the maximum value.

min

Instead of using range we can use just min. This overrides the range value.

max

Instead of using range we can use just max. This overrides the range value.

input-type

The input-type parameter is used to set the type of input. Possible values are: date, month, datetime-local and week.

Attention!

Firefox and Safari do not support type="month" nor type="week". For type="datetime-local" both don't show a time picker natively.

Check the datetime-local workaround for more details.

name

The name parameter is used to set the name of the component. This is useful when the component is part of a form.

locale

Check this documentation

Flags

disabled

The disabled parameter is used to block the interaction with the component. Not to be confused with readonly.

readonly

The readonly parameter is used to set the component as readonly.

required

The required parameter is used to set the component as required.

The default text adapts to the localization:

invalid

The invalid parameter is used to force the component to be invalid.

The default text adapts to the localization:

custom-ui ⚠️ Experimental

Ables the use of a custom date picker:

The calendar will adjust to the input:

If you use the custom-ui, you can also pass other Calendar modifiers like:

Browser support

Detected engine:  

  • Chromium

  • Webkit

  • Gecko

CodeSandbox example

Sorry, not available yet ☹️