Поле date
Поле используется для выбора даты и обрабатывает время в ISO формате.
- Ключевое слово
date. - WhatWG Спецификация.
Параметры
placeholder Необязательный
- Тип
stringСтроковая метка, отображается, когда в поле нет данных.
mask Необязательный
- Тип
string. - По умолчанию:
YYYY/MM/DD.
Маска задаёт формат отображение даты. Маска может состоять из символов любых символов, однако ключевыми являются Y, M, D, H и h. На их позицию будут подставлены соотвествующие значений.
handlers
- Тип: 'array'
Массив обработчиков, которые можно применить к значению поля ввода. Массив должен состоять из двух элементов. Первый является обработчиком значения из модели форму к типу Date. Второй обработчик является конвертером из строки(значения, находящееся внутри поля ввода) в значение, которое необходимо хранить в модели данных формы.
Example
<template>
<FormField type="date" :handlers="[handlerForm, handlerTo]" mask = "YYYY-MM-DD HH"/>
</template>
<script setup>
import {DateController} from "jenesius-vue-form";
function handlerFrom(formValue) {
return new Date(formValue)
}
function handlerTo(strValue) {
return DateController.ConvertToDate(strValue, 'YYYY-MM-DD HH').toISOString()
}
</script>
<template>
<FormField type="date" :handlers="[handlerForm, handlerTo]" mask = "YYYY-MM-DD HH"/>
</template>
<script setup>
import {DateController} from "jenesius-vue-form";
function handlerFrom(formValue) {
return new Date(formValue)
}
function handlerTo(strValue) {
return DateController.ConvertToDate(strValue, 'YYYY-MM-DD HH').toISOString()
}
</script>В текущем примере мы установили новую маску для данного поля, а также определили обработчики для конвертации значения в ISO формат даты.
Так же все параметры, общие для всех FormField. Информацию о них можно посмотреть на этой странице.
Значение
Значение поля выступает строка соответсвующая упрощённому расширенному ISO формату (ISO 8601).
Спецификация
- Поле доступно при использовании
TabиShift + Tab. - Ввод даты возможно используя поле ввода.
- Для выбора даты доступен дополнительный контроллер: календарь.
- Календарь не должен быть доступен для
TabилиShift + Tab. - Блокировка полей отменяет навигацию используя
Tab. Также происходит изменение стилистикиdate. - При неудачной валидации поле должно изменить стилистику
date.
Примеры
Для данного поля нет дополнительных обязательных параметров, по этому нам необходимо указать лишь type и name:
<form-field name = "created" type="date"/><form-field name = "created" type="date"/>import {FormField} from "jenesius-vue-form";import {FormField} from "jenesius-vue-form";Поле по умолчанию:
Дата создания
DD/MM/YYYY
В заблокированном состоянии:
Заблокированное
DD/MM/YYYY
Поле не прошло валидацию:
С ошибкой
DD/MM/YYYY
Seleact this fields
Изменённое значение mask:
С переданными mask
YYYY_MM
Текущее состояние формы:
{}{}