MobileCheckbox

Overview

The MobileCheckbox component displays a checkbox element for multiple selections.

---

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
borderVisible	boolean	true	Show/Hide the border
disabled	boolean	false	Enable/Disable the component from selecting
requiredIcon	boolean	false	Show/Hide the required icon
visible	boolean	true	Show/Hide the component
items	Array\<Item>	[]	List of options to display	Will result an error if the value of items is not an array
Item.label	string	null	Text for each option	If Item.label is unspecified, the value of Item.value is displayed on the UI
Item.value	string	null	Value of each option	Will result an error if there is duplicated value in Item.value
value	Array\<string>	[]	Selected value	Will result an error if the value of items is not an array Will result an error if there is duplicated value in an array No option will be selected if the value is unspecified

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

MobileCheckbox(options)
Here is a list of available constructors:

Parameter

Name	Type	Default	Description	Remark
options	object	{}	Object that includes component properties

---

Sample Code

Here is a sample code when all parameters are specified:

const space = kintone.mobile.app.record.getSpaceElement('space');
const mobileCheckbox = new Kuc.MobileCheckbox({
  label: 'Fruit',
  requiredIcon: true,
  items: [
    {
      label: 'orange',
      value: 'Orange'
    },
    {
      label: 'apple',
      value: 'Apple'
    }
  ],
  value: ['Orange'],
  error: 'Error occurred!',
  className: 'options-class',
  id: 'options-id',
  visible: true,
  disabled: false,
  borderVisible: true
});
space.appendChild(mobileCheckbox);

mobileCheckbox.addEventListener('change', event => {
  console.log(event);
});