Date input - Web Component

The DateInput component can be used imported from:

Playground

Attention!

The localization format of the input comes from the format settings of the client's operation system.

Parameters

The Web component uses the <z-date-input> tag:

By default, all the parameters are optional or can be set in different, except for the ones marked as required

The parametrization of the component can be done with the following custom HTML params:

Name	Type	Description	Slot	A11y
config	string	The main parameter has two components following the pattern: <shape><?:size>. shape: Establishes the styling of the input. Default value is line . Possible values are: shaped or line. , size: (optional) defines de size of the input. The default value is m, being omitted from the param. The possible values are: m or l. Check the sizes section.
label	string	Label of the input	label
placeholder	string
readonly	boolean	Transforms the input into an output
autocomplete	string	Automated assistance in filling out form field values
model	string	Value of the model
disabled	boolean	Blocks the interaction with the input component.
required	boolean	Marks the input component as required.
name	string	Identification for the field inside the form
help-text	string	The forced message to be shown under the input	help-text
invalid	boolean	The forced state for set the input as invalid
input-type	string	Type of input. Possible values are: date: it will a date, without the day of the month as yyyy-mm-dd. month: it will handle a shorter version of the date, without the day of the month as yyyy-mm. datetime-localit will handle an extended version of the date including the time as yyyy-mm-ddThh:mm following the ISO string format. week: it will provide the year and the week number based on ISO 8601, where the format will be yyyy-Wnn
locale	string
custom-ui	boolean	Use custom UI for the date picker

Events

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

Name	Payload	Description
change	string	Returns the new value of the "value" attribute
enter	void	Triggered when "Enter" in pressed
restarted	void	Emitted on value reset

Slots

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

Name	Tags	Description
label	span
help-text	span

Parameters use

config

The config parameter is used to set the shape of the input between lined and shaped. Being omitted will render the default line 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

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.

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.

invalid

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

custom-ui

Still experimental!

Do not use it in production

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:

• first-weekday
• today-nav
• selected-nav
• calendar-type

Methods

reset()

We can all the reset() method of the WebComponent in order to reset the value. This will clean the internal states and emit the nullable value with the change event, plus a restarted event:

In this example, the button triggers the method:

Value:  undefined

Browser support

Detected engine:  

• Chromium

• Webkit

• Gecko

HTML Examples

CodeSandbox example