Checkbox

Overview

The Checkbox 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
itemLayout	string	"horizontal"	Orientation for displaying the options	Available options: "horizontal" : Horizontal "vertical" : Vertical
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
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
value *1	Array<string>	[]	Selected value	No option will be selected if the value and selectedIndex are unspecified If setting duplicated value and not setting selectedIndex, the first mapped value item in Item.value will be selected and selectedIndex will be the index number Will result an error if the value is not an array
selectedIndex *1	Array<Number>	[]	List of index of selected item	It supports specifying which duplicated Item.value will be selected if there is duplicated Item.value in items If value is not set and selectedIndex is valid, item that has the index number will be selected If value is set with duplicated Item.value and selectedIndex value maps with duplicated Item.value specified in value, item that has the index number will be selected Will result an error if the value of selectedIndex is not an array

info

*1: You can set duplicated value in value and Item.value. In case setting duplicated value, you can handle selected item using value and selectedIndex property.
Example: When setting items = [{label: 'Orange', value: 'fruit'}, {label: 'Apple', value: 'fruit'}, {label: 'Carrot', value: 'vegetable'}, {label: 'Lemon', value: 'fruit'}]

• If setting value and not setting selectedIndex as follows:

  • value = ['fruit', 'vegetable']: The first and third items will be selected.
  • value = ['meat', 'other']: No item will be selected.

• If not setting value and setting selectedIndex as follows:

  • selectedIndex = [0, 1]: The first and second items will be selected.
  • selectedIndex = [98, 99]: No item will be selected.

• If setting value and selectedIndex as follows:

  • value = ['fruit', 'vegetable'], selectedIndex = [1, 3]: The second and third items will be selected.
  • value = ['fruit', 'fruit', 'vegetable'], selectedIndex = [1, 3]: The second, third, and fourth items will be selected.
  • value = ['fruit', 'fruit'], selectedIndex = [1, 2, 3]: The first and second items will be selected.
    ※ If both value and selectedIndex are set at the same time, the priority of value will be higher. Therefore, in the first and third examples above, the item corresponding to 3 of selectedIndex will not be selected.

Item

Name	Type	Default	Description	Remark
label	string	null	Text label for each option	If Item.label is unspecified, the value of Item.value is displayed on the UI
value	string	null	Value of each option	Can set duplicated value in Item.value
disabled	boolean	false	Enable/Disable each option

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 when used in event.detail event.detail.oldValue : Value before the change event.detail.value : Value after the change

Constructor

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

Parameter

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

Custom CSS

tip

Please check Custom CSS feature guide at first.

Here is a list of properties that can be used for modifying component style:

Property

Name
--kuc-checkbox-menu-width
--kuc-checkbox-menu-height
--kuc-checkbox-menu-font-size
--kuc-checkbox-menu-color
--kuc-checkbox-menu-color-hover

---

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.app.record.getSpaceElement('space');

const checkbox = new Kuc.Checkbox({
  label: 'Fruit',
  requiredIcon: true,
  items: [
    {
      label: 'orange',
      value: 'Orange'
    },
    {
      label: 'apple',
      value: 'Apple'
    },
    {
      label: 'banana',
      value: 'Banana',
      disabled: true
    }
  ],
  value: ['Orange'],
  selectedIndex: [0],
  itemLayout: 'horizontal',
  error: 'Error occurred!',
  className: 'options-class',
  id: 'options-id',
  visible: true,
  disabled: false,
  borderVisible: true
});
space.appendChild(checkbox);

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

---

Related Articles

• Cleaning check list customization