MobileDatePicker
Overview
The MobileDatePicker component allows the user to display a input area and date selection calendar.
Specification
Property
Here is a list of properties that can be used for modifying the component:
Name | Type | Default | Description | Remark |
---|---|---|---|---|
className | string | "" | Component class name | |
error | string | "" | Text to be displayed in error | Error will not be displayed if unspecified or left empty |
id | string | "" | Component id name | |
label | string | "" | Label for the component | Label will not be displayed if unspecified or left empty |
language *1 | string | "auto" | Language setting | Available options: "auto", "en", "ja", "zh", "zh-TW", "es" If setting "auto", it will be according to the HTML lang setting (If the lang setting is other than "en"/"ja"/"zh"/"zh-TW"/"es", the language setting will be "en") |
value | string | "" | Text to be displayed | Format is YYYY-MM-DD The below date can be used (it will be converted to YYYY-MM-DD internally): If the date and/or month is ignored, it will be supplemented with 01 If the date and/or month has only 1 character, 0 will be added to the beginning Will result an error if setting invalid format or value |
disabled | boolean | false | Enable/Disable the component | |
requiredIcon | boolean | false | Show/Hide the required icon | |
visible | boolean | true | Show/Hide the component |
info
*1: The displayed date format is automatically switched depending on the language
property setting as follows:
- "en": MM/DD/YYYY
- "ja", "zh", "zh-TW", "es": YYYY-MM-DD
Event
Here is a list of events that can be specified:
Name | Type | Description | Remark |
---|---|---|---|
change | function | Event handler when the value has been changed | It will pass the event object as the argument You can receive the following values in event.detail event.detail.oldValue : Value before the change event.detail.value : Value after the change |
Constructor
MobileDatePicker(options)
Here is a list of available constructors:
Parameter
Name | Type | Default | Description | Remark |
---|---|---|---|---|
options | object | {} | Object that includes component properties |
Sample Code
tip
Please check the package installation method first.
Here is a sample code when all parameters are specified:
const Kuc = Kucs['1.x.x'];
const space = kintone.mobile.app.record.getSpaceElement('space');
const mobileDatePicker = new Kuc.MobileDatePicker({
label: 'Date',
requiredIcon: true,
language: 'auto',
value: '2021-11-11',
error: 'Error occurred!',
className: 'options-class',
id: 'options-id',
visible: true,
disabled: false
});
space.appendChild(mobileDatePicker);
mobileDatePicker.addEventListener('change', event => {
console.log(event);
});