Выбор даты/месяца

v-date-picker является автономным компонентом, который может использоваться во многих существующих компонентах Vuetify. Он предлагает пользователю визуальное представление для выбора даты/месяца.

Применение

Date pickers come in two orientation variations, portrait (default) and landscape. By default they are emitting input event when the day (for date picker) or month (for month picker), but with reactive prop they can update the model even after clicking year/month.

API

v-date-picker
Имя
allowed-dates
По умолчанию
null
Тип
function

Ограничения, которые могут быть выбраны

Имя
color
По умолчанию
undefined
Тип
string

Применяет заданный цвет к элементу управления

Имя
dark
По умолчанию
false
Тип
boolean

Применяет тёмный вариант темы

Имя
day-format
По умолчанию
null
Тип
function

Позволяет настроить формат дневной строки, отображаемой в таблице даты. Вызывается с датой (строка ISO 8601) и locale (string).

Имя
disabled New in — v1.4
По умолчанию
false
Тип
boolean

Components.DatePickers.

Имя
event-color
По умолчанию
warning
Тип
array | function | object | string

Устанавливает цвет для точки события. Это может быть строка (все события будут иметь один и тот же цвет) или объект, где атрибутом является дата события, а значение - цвет указанной даты или функция, принимающий дату в качестве параметра и возвращающий цвет для этой даты

Имя
events
По умолчанию
null
Тип
array | function | object

Отмечает дату как событие (только для выбора даты)

Имя
first-day-of-week
По умолчанию
0
Тип
string | number

Устанавливает первый день недели, начиная с 0 для воскресенья.

Имя
full-width
По умолчанию
false
Тип
boolean

Форсировать 100% ширины

Имя
header-color
По умолчанию
undefined
Тип
string

Определяет цвет заголовка. Если он не указан, он будет использовать цвет, определяемый свойством color или цветом по умолчанию

Имя
header-date-format
По умолчанию
null
Тип
function

Позволяет настроить формат строки месяца, который отображается в заголовке календаря. Вызывается с датой (строка ISO 8601) и locale (string).

Имя
landscape
По умолчанию
false
Тип
boolean

Ориентировать picker по горизонтали

Имя
light
По умолчанию
false
Тип
boolean

Применяет светлый вариант темы

Имя
locale
По умолчанию
'en-us'
Тип
string

Устанавливает языковой стандарт. Принимает строку с тегом языка BCP 47.

Имя
max
По умолчанию
undefined
Тип
string

Максимальный допустимый день/месяц

Имя
min
По умолчанию
undefined
Тип
string

Минимальный допустимый день/месяц

Имя
month-format
По умолчанию
null
Тип
function

Функция форматирования, используемая для отображения месяцев в таблице месяцев. Вызывается с датой (строка ISO 8601) и locale (string).

Имя
multiple New in — v1.2
По умолчанию
false
Тип
boolean

Components.DatePickers.

Имя
next-icon
По умолчанию
'$vuetify.icons.next'
Тип
string

Устанавливает иконку для кнопки следующего месяца/года

Имя
no-title
По умолчанию
false
Тип
boolean

Скрыть у picker заголовок

Имя
picker-date
По умолчанию
undefined
Тип
string

Отображается год/месяц

Имя
prev-icon
По умолчанию
'$vuetify.icons.prev'
Тип
string

Устанавливает иконку для кнопки предыдущий месяц/год

Имя
reactive
По умолчанию
false
Тип
boolean

Components.DatePickers.

Имя
readonly
По умолчанию
false
Тип
boolean

Делает сборщик readonly (не позволяет выбрать новую дату или перемещаться по месяцам/годам)

Имя
scrollable
По умолчанию
false
Тип
boolean

Позволяет изменять отображаемый месяц с помощью мыши

Имя
show-current
По умолчанию
true
Тип
boolean | string

Переключает видимость текущей даты/месяца или показывает предоставленную дату/месяц как текущий

Имя
show-week New in — v1.4
По умолчанию
false
Тип
boolean

Components.DatePickers.

Имя
title-date-format
По умолчанию
null
Тип
function

Позволяет настроить формат строки даты, который отображается в заголовке выбора даты. Вызывается с датой (строка ISO 8601) и locale (string).

Имя
type
По умолчанию
'date'
Тип
string

Определяет тип выбора- date для выбора даты, month для выбора месяца

Имя
value
По умолчанию
undefined
Тип
array | string

Контроль видимости

Имя
weekday-format New in — v1.3
По умолчанию
null
Тип
function

Components.DatePickers.

Имя
width
По умолчанию
290
Тип
number | string

Ширина содержимого

Имя
year-format
По умолчанию
null
Тип
function

Позволяет настроить формат строки года, отображаемой в заголовке календаря. Вызывается с датой (строка ISO 8601) и locale (string).

Имя
year-icon
По умолчанию
undefined
Тип
string

Создаёт иконку рядом с годом

Примеры

Выбор даты - Цвета

Цвета выбора даты можно установить с помощью свойств color и header-color. Если header-color не указан, заголовок будет использовать значение color .

Выбор даты - В диалоговом окне и меню

При интеграции "выбора" в поле v-text рекомендуется использовать readonly. Это предотвратит запуск мобильных клавиатур. Чтобы сохранить вертикальную ориентацию, вы также можете скрыть заголовок выбора.

Выбор даты выставляет доступный слот, который позволяет вам подключаться к функциям сохранения и отмены. Оно поддерживать старое значение, которое может быть заменено, если пользователь отменяет событие.

Date pickers - formatting date

If you need to display date in the custom format (different than YYYY-MM-DD) you need to use the formatting function.

Date pickers - formatting date using external libs

Formatting dates is possible also with external libs such as Moment.js or date-fns

Выбор даты - Допустимые значения

Вы можете указать допустимые даты с использованием массивов, объектов и функций.

Date pickers - Mutiple

Date picker can now select multiple dates with the multiple prop. If using multiple then date picker expects its model to be an array.

Выбор даты - установка ширины

Вы можете указать допустимую ширину или сделать её на всю ширину.

Выбор даты - день рождения

Начиная с выбора года по умолчанию, ограничивая диапазон дат и закрывая меню выбора после выбора дня, сделайте идеальный выбор день рождения.

Выбор даты - реакция на изменение месяца/года

Вы можете наблюдать за pickerDate, который является отображаемым месяцем/годом (в зависимости от типа выбора и активного вида), чтобы выполнять некоторые действия, когда он изменяется.

Выбор даты - События

Вы можете указать события, используя массивы, объекты и функции. Чтобы изменить цвет по умолчанию для события, используйте event-color prop.

Выбор даты - интернационализация

Выбор даты поддерживает интернационализацию через объект JavaScript Date. Укажите тег языка BCP 47, используя locale, а затем установите первый день недели с помощью first-day-of-week .

Выбор даты - иконки

Вы можете переопределить иконки по умолчанию, используемые в сборщике.

Выбор даты - только для чтения

Выбор новой даты может быть отключён путём добавления readonly prop.

Выбор даты - текущий индикатор даты

По умолчанию текущая дата отображается с помощью контурной кнопки - show-current prop позволяет удалить границу или выбрать другую дату, которая будет отображаться как текущая.

Выбор месяца

Выбор месяца имеет два варианта ориентации: портретная (по умолчанию) и альбомная.

Выбор месяца - цвета

Цвета Выбора месяца можно установить с помощью color и header-color props. Если header-color prop не указан, заголовок будет использовать значение color.

Выбор месяца - В диалоговом окне и меню

При интеграции выбора v-text-field рекомендуется использовать readonly prop. Это предотвратит запуск мобильных клавиатур. Чтобы сохранить вертикальную ориентацию, вы также можете скрыть заголовок выбора.

Сборщики выставляют доступный слот, который позволяет вам подключаться к функциям сохранения и отмены. Это будет поддерживать старое значение, которое может быть заменено, если пользователь отменяет.

Выбор месяца - допустимые значения

Вы можете указать допустимые месяцы, используя массивы, объекты и функции.

Month pickers - Multiple

Month pickers can now select multiple months with the multiple prop. If using multiple then the month picker expects its model to be an array.

Выбор месяца - установка ширины

Вы можете указать допустимую ширину или сделать её на всю ширину.

Выбор месяца - интернационализация

Выбор даты поддерживает интернационализацию через объект JavaScript Date. Укажите тег языка BCP 47, используя locale, а затем установите первый день недели с помощью first-day-of-week .

Выбор месяца - иконки

Вы можете переопределить значки по умолчанию.

Выбор месяца - только для чтения

Выбор новой даты можно отключить, добавив readonly prop.

Выбор месяца - текущий индикатор месяца

По умолчанию текущий месяц отображается с помощью кнопки-контура - show-current prop позволяет удалить границу или выбрать другой месяц, который будет отображаться как текущий.

Edit this page | language on Github
Vuetify 3 is now available!The latest version of Vuetify is now available!
Learn about Vuetify 3's new features and functionality for modern Vue applications
Start exploringExplore