ILLA home page
  1. Дата

Компонент дати - це компонент, що дозволяє користувачам вибирати дату з інтерфейсу календаря. Компонент дати зазвичай використовується у формах або інтерфейсах входу даних, де користувачу потрібно вибрати певну дату.

Якщо компонент дати додається на полотно, він за замовчуванням відображає інтерфейс календаря. Користувач може переміщатися через календар натиснувши на попередні або поруч стрілок, щоб рухатися на інший місяць, або натисніть на певну дату, щоб вибрати її. Обрана дата буде відображатися в полі введення.

Properties

Характеристики дати доступні. JavaScript може бути записаний на читання або зміну інформації про компоненти.

ВластивостіОпис
Значення за замовчуваннямПочаткове значення компонента. Ви можете динамічно змінити початкове значення, набравши JavaScript у {{}}.
ФорматуватиДійсний формат дати. Див. dayJS.
Мітка-заповнювачЗначення буде показано, коли поле вводу порожнє.
Максимальна датавстановити максимальну дату, яку користувач може вибрати з інтерфейсу календаря.
Мінімальна датавкажіть найранішу дату, яку користувач може обирати з інтерфейсу календаря.
МіткаІм’я поля, яке відображається користувачеві
ПідписЗаголовок використовується для опису поля докладно
Прихована міткаВкажіть, чи показувати мітки
ПозиціяВстановіть позицію мітки щодо компонента
ВирівнюванняЗадати вирівнювання (по лівому чи правому) мітки
WidthКоли етикетка розташована в лівій частині компонента, встановіть співвідношення ширини етикетки.
Обробник подійТригер запит, компоненти керування, тобто виклик інших API-файлів у відповідь на події компонента.
ВимкненоКерування статусом того, що компонент відключений. Компонент не може бути змінений або змінений, якщо він вимкнений.
Лише для читанняКерування статусом того, чи є компонент лише для читання. Компонент, який доступний лише для читання, може бути вибраний і сфокусований, але не може бути змінений.
ПідказкаТут можна ввести підказку для компонентів. Підказка буде відображатись при зосередженні. Формат Markdown підтримується.
Показувати кнопку очищеннякерувати, показувати кнопку “Очистити чи ні” при введенні
Обов’язкове полеДійсний лише при увімкненому перемикачі.
Користувацьке правилоТут ви можете створити логіку вашої перевірки. Правила повинні бути зроблені в JavaScript і закриті {{}}.
Приховати повідомлення перевіркиВи можете приховати повідомлення про помилку, перемикнувши прихований статус, коли вхідне значення неправильне. Ви можете динамічно змінити прихований стан на JavaScript.
Ключ даних формиВкажіть ключ форми обгортання компонентів при конструюванні атрибуту даних.
HiddenДинамічне керування, чи прихований компонент в мережі. Ви можете змінити прихований статус за допомогою динамічного логічного значення.
Колір темиДозволяє користувачам зазначити колір і непрозорість фону кнопки

Methods

Ви можете використовувати інші компоненти для керування компонентами. Ми підтримуємо наступні чотири методи:

  • setValue

Щоб встановити вхідне значення дати, наприклад, {{‘value1’}}

ВластивостіОпис
ЦінністьInput value
  • clearValue

Щоб очистити значення вибраного компонента

  • validate

Щоб переконатися, що вхідна інформація є правовою

  • очистити дійсність

Щоб очистити повідомлення підтвердження

Обробник подій

ПодіяОпис
ЗмінитиКоли користувач змінює вибране значення дати, виконати певну дію, настроювану користувачами.

Дані

Компонент має найбільш часто використовувані дані, які можна викликати через {{componentName.propertyName}} в додатку.

Ім’я властивостіОпис
кольорова схемавластивість дати
спеціальне правиловласне правило, яке визначено користувачем
формат датиформат дати
вимкнутологічне значення означає інвалідів статус
назва дисплеюім’я цього компонента (ie button1)
formDataKeyключ форми дати
hiddenприхований статус (true чи false)
хідна перевіркалогічне значення вказує, чи приховане повідомлення перевірки
етикетказначення мітки
позначеннявирівнювання мітки для перемикача (ліворуч або праворуч)
міткапозиція перемикача (ліва чи праворуч)
ширина етикеткиціле число показує ширину мітки.
міткалогічне значення вказує, що мітка переповнена.
maxDateмаксимальне значення дати
minDateзначення мінімальної дати
заповнювачзначення місця заповнення
тільки для читаннялогічне значення показує стан вхідних даних тільки готовим.
обов’язковологічне значення вказують на необхідний статус входу.
прокрутитизначення логічного значення вказують на погоду, дата буде чітко показана
підказказначення тексту підказки
значенняInput value

Приклад: {{date1.value}}

Використати регістр

Далі ми продемонструємо, як відмітити початкові дані від даних до дати і встановити поточну дату кнопкою.

Крок 1 Додати дію

Давайте створимо таблицю в REST API під назвою promoteCodes, включаючи 6 стовпців: code, id, createdAt, expiredAt, startedAt, updatedAt. Ми будемо використовувати час оновлення для використання зразка.

Потім ми можемо створити нову дію для REST API зі списку дій, перерахуючи всі дані в promoteCodes і name restapi1.

Натисніть Зберегти і Run для активації цієї дії.

Крок 2 додати компоненти

Далі, ми можемо додати компонент date і button на полотно. Для значення компонента за замовчуванням вказаного в якості останнього часу оновлення перший пратегації коду з інших api даних.

{{restapi1.data.promoteCodes[0].updatedAt}}

Ми також позначили кнопку як “Сьогодні”, як показано нижче

date_time0

Крок 3 налаштувати компонент

Для компоненту button ми можемо налаштувати його на встановлення дати в date компоненті сьогоднішньої дати.

  1. У обробнику подій виберіть елемент управління в дії, виберіть `дату компонент, який ви хочете оновити як ціль події.
  2. Оберіть setValue дію та встановіть значення як {{currentUserInfo.updatedAt}}

date_confg

Крок 4 тест

Тепер, коли ви натискаєте на кнопку “сьогодні”, час повинен змінитися на сьогоднішній день. Що стосується цього, то ми маємо 2023-6, але це може відрізнятися, якщо ви тестуєте його.

date_time1