website logo
👥 Community🎯 Samples on GitHub🚦 System Status
💡 Guides
🚀 Examples
🍕 Developer Reference
⚡️ Changelog
🎥 Video Library
Navigate through spaces
⌘K
Overview
Reference
Actions
Data
UI
Widgets
Docs powered by
Archbee
Reference
UI

jc-list-item

92min

The schema defines the following properties:

Property

Type

Required

Description

type

component.list-item

true



instanceId

InstanceId | Expression

false



when

Expression | boolean

false



options

List Item Options

true



instanceId (InstanceId | Expression)

when (Expression | boolean)

options (List Item Options, required)

Properties of the options object:

Property

Type

Required

Description

title

string | Expression | TextWithFormat | TextLocale

true

First line of text - text won't wrap.

subtitle

string | Expression | TextWithFormat | TextLocale

false

Second line of text - text won't wrap.

style

List Item Style

false

More of them can be true. It will be evaluated based on priority.

color

object[]

false

Changing color of list item based on conditions. First evaluated to true will be used.

divider

enum<string>

false

Space between two items in list. Transparent divider will make 1pt "margin" between two items. Solid displays colored line.

leftElement

icon | AvatarElement | ImageElement | progress | checkbox

false



rightElement

AmountControl | badge | button | icon | switch | value | checkbox

false



onPress

keg-action-in-background

false

Action Keg component that will be triggered by pressing on this list item.

value

string | string

false

Value of list item. It is used when selection for example

progress

number | string

false

Value between 0 and 1 to show progress as background of list item

label

Label

false

Display label on list-item

horizontalItemSize

HorizontalListItemSize

false

Define variations of horizontal item

avatars

string

false



description

string | Expression | TextWithFormat | TextLocale

false

Third line of text - text won't wrap.

swipeable

object

false

Right and left actions that are displayed when list item is swiped to the left/right

title (string | Expression | TextWithFormat | TextLocale, required)

First line of text - text won't wrap.

subtitle (string | Expression | TextWithFormat | TextLocale)

Second line of text - text won't wrap.

style (List Item Style)

More of them can be true. It will be evaluated based on priority.

Properties of the style object:

Property

Type

Required

Description

isDisabled

boolean | string

false

Change style to disabled.

isError

boolean | string

false

Change style to error.

isWarning

boolean | string

false

Change style to error.

isPositive

boolean | string

false

Change style to error.

isStrikeThrough

boolean | string

false

If the text is crossed out

isHighlighted

boolean | string

false

Change background to highlight item

isWaitingSync

boolean | string

false

Will display "Waiting sync" indicator

isDisabled (boolean | string)

Change style to disabled.

The object must be any of the following types:

isDisabled (string)

isError (boolean | string)

Change style to error.

The object must be any of the following types:

isError (string)

isWarning (boolean | string)

Change style to error.

The object must be any of the following types:

isWarning (string)

isPositive (boolean | string)

Change style to error.

The object must be any of the following types:

isPositive (string)

isStrikeThrough (boolean | string)

If the text is crossed out

The object must be any of the following types:

isStrikeThrough (string)

isHighlighted (boolean | string)

Change background to highlight item

The object must be any of the following types:

isHighlighted (string)

isWaitingSync (boolean | string)

Will display "Waiting sync" indicator

The object must be any of the following types:

isWaitingSync (string)

color (object[])

Changing color of list item based on conditions. First evaluated to true will be used.

The object is an array with all elements of the type object.

The array object has the following properties:

divider (enum<string>)

Space between two items in list. Transparent divider will make 1pt "margin" between two items. Solid displays colored line.

This element must be one of the following enum values:

  • none
  • transparent
  • solid

Default: "none"

leftElement (icon | AvatarElement | ImageElement | progress | checkbox)

The object must be any of the following types:

leftElement (icon)

leftElement (AvatarElement)

leftElement (ImageElement)

leftElement (progress)

Properties of the leftElement object:

Property

Type

Required

Description

element

progress

true

Type of component

value

number | string

true

Value between 0 and 1

title

string | Expression | TextWithFormat | TextLocale

false

Title displayed in the middle of circle progress

value (number | string, required)

Value between 0 and 1

The object must be any of the following types:

value (string)

title (string | Expression | TextWithFormat | TextLocale)

Title displayed in the middle of circle progress

leftElement (checkbox)

Properties of the leftElement object:

Property

Type

Required

Description

element

checkbox

true

Type of component

value

string | boolean | string

false

Controlled value of checkbox

initialValue

string | boolean | string

false

Uncontrolled value of checkbox

onChange

keg-action-in-background

false

Action Keg component that will be triggered when value is changed

value (string | boolean | string)

Controlled value of checkbox

The object must be any of the following types:

value (string)

initialValue (string | boolean | string)

Uncontrolled value of checkbox

The object must be any of the following types:

initialValue (string)

onChange (keg-action-in-background)

Action Keg component that will be triggered when value is changed

rightElement (AmountControl | badge | button | icon | switch | value | checkbox)

The object must be any of the following types:

rightElement (AmountControl)

rightElement (badge)

Properties of the rightElement object:

Property

Type

Required

Description

element

badge

true

Type of component

isHidden

boolean | string

false

When you want to hide this component

isHidden (boolean | string)

When you want to hide this component

The object must be any of the following types:

isHidden (string)

rightElement (button)

Properties of the rightElement object:

Property

Type

Required

Description

element

button

true

Type of component

title

string | Expression | TextWithFormat | TextLocale

true

Text displayed on button

onPress

keg-action-in-background

true

Action Keg component that will be triggered by pressing on this button.

title (string | Expression | TextWithFormat | TextLocale, required)

Text displayed on button

onPress (keg-action-in-background, required)

Action Keg component that will be triggered by pressing on this button.

rightElement (icon)

rightElement (switch)

Properties of the rightElement object:

Property

Type

Required

Description

element

switch

true

Type of component

value

string | boolean | string

false

Initial value of switch

initialValue

string | boolean | string

false

Uncontrolled value of switch

onChange

keg-action-in-background

false

Action Keg component that will be triggered when value is changed

value (string | boolean | string)

Initial value of switch

The object must be any of the following types:

value (string)

initialValue (string | boolean | string)

Uncontrolled value of switch

The object must be any of the following types:

initialValue (string)

onChange (keg-action-in-background)

Action Keg component that will be triggered when value is changed

rightElement (value)

Properties of the rightElement object:

Property

Type

Required

Description

element

value

true

Type of component

text

string | Expression | TextWithFormat | TextLocale

true

Displayed value - text.

text (string | Expression | TextWithFormat | TextLocale, required)

Displayed value - text.

rightElement (checkbox)

Properties of the rightElement object:

Property

Type

Required

Description

element

checkbox

true

Type of component

value

string | boolean | string

false

Controlled value of checkbox

initialValue

string | boolean | string

false

Uncontrolled value of checkbox

onChange

keg-action-in-background

false

Action Keg component that will be triggered when value is changed

value (string | boolean | string)

Controlled value of checkbox

The object must be any of the following types:

value (string)

initialValue (string | boolean | string)

Uncontrolled value of checkbox

The object must be any of the following types:

initialValue (string)

onChange (keg-action-in-background)

Action Keg component that will be triggered when value is changed

onPress (keg-action-in-background)

Action Keg component that will be triggered by pressing on this list item.

value (string | string)

Value of list item. It is used when selection for example

The object must be any of the following types:

value (string)

progress (number | string)

Value between 0 and 1 to show progress as background of list item

The object must be any of the following types:

progress (string)

label (Label)

Display label on list-item

Properties of the label object:

Property

Type

Required

Description

title

string | Expression | TextWithFormat | TextLocale

true

Title of label

color

object[]

false

Changing color of label based on conditions. First evaluated to true will be used.

isHidden

boolean | string

false

Hide label

title (string | Expression | TextWithFormat | TextLocale, required)

Title of label

color (object[])

Changing color of label based on conditions. First evaluated to true will be used.

The object is an array with all elements of the type object.

The array object has the following properties:

isHidden (boolean | string)

Hide label

The object must be any of the following types:

isHidden (string)

horizontalItemSize (HorizontalListItemSize)

Define variations of horizontal item

Default: "regular"

avatars (string)

The object must be any of the following types:

avatars (string)

description (string | Expression | TextWithFormat | TextLocale)

Third line of text - text won't wrap.

swipeable (object)

Right and left actions that are displayed when list item is swiped to the left/right

Properties of the swipeable object:

Property

Type

Required

Description

left

object[]

false



right

object[]

false



left (object[])

The object is an array with all elements of the type object.

The array object has the following properties:

right (object[])

The object is an array with all elements of the type object.

The array object has the following properties:



Sub Schemas

The schema defines the following additional types:

AvatarElement (avatar)

Avatar

Properties of the AvatarElement object:

Property

Type

Required

Description

element

avatar

true

Type of element

text

string | Expression | TextWithFormat | TextLocale

true

Text displayed when uri is empty.

uri

string | string

false

Source of image displayed as avatar

onPress

keg-action-in-background

false

Action Keg component that will be triggered by pressing on this button.

text (string | Expression | TextWithFormat | TextLocale, required)

Text displayed when uri is empty.

uri (string | string)

Source of image displayed as avatar

The object must be any of the following types:

uri (string)

onPress (keg-action-in-background)

Action Keg component that will be triggered by pressing on this button.

ImageElement (image)

Properties of the ImageElement object:

Property

Type

Required

Description

element

image

true

Type of element

text

string | Expression | TextWithFormat | TextLocale

true

Text displayed when uri is empty.

uri

string | string

false

Source of image displayed as avatar

onPress

keg-action-in-background

false

Action Keg component that will be triggered by pressing on this button.

resizeMode

ResizeMode

false

Image resize mode

text (string | Expression | TextWithFormat | TextLocale, required)

Text displayed when uri is empty.

uri (string | string)

Source of image displayed as avatar

The object must be any of the following types:

uri (string)

onPress (keg-action-in-background)

Action Keg component that will be triggered by pressing on this button.

resizeMode (ResizeMode)

Image resize mode

ResizeMode (enum<string>)

This element must be one of the following enum values:

  • contain
  • cover
  • stretch
  • center

AmountControl (amount-control)

Properties of the AmountControl object:

Property

Type

Required

Description

value

number | string

false

Value of amount control

initialValue

number | string

false

Initial value of amount control

onChange

keg-action-in-background

false

Action Keg component that will be triggered when value is changed

onDelete

ja-execute-entity | ja-execute-entities

false

If this property is set, trash symbol is displayed when the value is 1 or (min + 1).

minimum

number | string

false

Limits the minimum number. Default is 0.

maximum

number | string

false

Limits the maximum number.

step

number | string

false

Step for increment/decrement. Default is 1.

element

amount-control

true

Type of component

value (number | string)

Value of amount control

The object must be any of the following types:

value (string)

initialValue (number | string)

Initial value of amount control

The object must be any of the following types:

initialValue (string)

onChange (keg-action-in-background)

Action Keg component that will be triggered when value is changed

onDelete (ja-execute-entity | ja-execute-entities)

If this property is set, trash symbol is displayed when the value is 1 or (min + 1).

The object must be any of the following types:

onDelete (ja-execute-entity)

onDelete (ja-execute-entities)

minimum (number | string)

Limits the minimum number. Default is 0.

The object must be any of the following types:

minimum (string)

maximum (number | string)

Limits the maximum number.

The object must be any of the following types:

maximum (string)

step (number | string)

Step for increment/decrement. Default is 1.

The object must be any of the following types:

step (string)

HorizontalListItemSize (enum<string>)

Size variants of horizontal list-item

This element must be one of the following enum values:

  • small
  • regular
  • large

AvatarItemConfig (Avatar)

Properties of the AvatarItemConfig object:

Property

Type

Required

Description

text

string | Expression | TextWithFormat | TextLocale

true

Text as placeholder in case of missing image

uri

string | string

false

Source of image displayed as avatar

text (string | Expression | TextWithFormat | TextLocale, required)

Text as placeholder in case of missing image

uri (string | string)

Source of image displayed as avatar

The object must be any of the following types:

uri (string)



Updated 25 Sep 2023
Did this page help you?
PREVIOUS
jc-line-chart
NEXT
jc-list
Docs powered by
Archbee
TABLE OF CONTENTS
instanceId (InstanceId | Expression)
when (Expression | boolean)
options (List Item Options, required)
title (string | Expression | TextWithFormat | TextLocale, required)
subtitle (string | Expression | TextWithFormat | TextLocale)
style (List Item Style)
isDisabled (boolean | string)
isDisabled (string)
isError (boolean | string)
isError (string)
isWarning (boolean | string)
isWarning (string)
isPositive (boolean | string)
isPositive (string)
isStrikeThrough (boolean | string)
isStrikeThrough (string)
isHighlighted (boolean | string)
isHighlighted (string)
isWaitingSync (boolean | string)
isWaitingSync (string)
color (object[])
divider (enum<string>)
leftElement (icon | AvatarElement | ImageElement | progress | checkbox)
leftElement (icon)
leftElement (AvatarElement)
leftElement (ImageElement)
leftElement (progress)
value (number | string, required)
value (string)
title (string | Expression | TextWithFormat | TextLocale)
leftElement (checkbox)
value (string | boolean | string)
value (string)
initialValue (string | boolean | string)
initialValue (string)
onChange (keg-action-in-background)
rightElement (AmountControl | badge | button | icon | switch | value | checkbox)
rightElement (AmountControl)
rightElement (badge)
isHidden (boolean | string)
isHidden (string)
rightElement (button)
title (string | Expression | TextWithFormat | TextLocale, required)
onPress (keg-action-in-background, required)
rightElement (icon)
rightElement (switch)
value (string | boolean | string)
value (string)
initialValue (string | boolean | string)
initialValue (string)
onChange (keg-action-in-background)
rightElement (value)
text (string | Expression | TextWithFormat | TextLocale, required)
rightElement (checkbox)
value (string | boolean | string)
value (string)
initialValue (string | boolean | string)
initialValue (string)
onChange (keg-action-in-background)
onPress (keg-action-in-background)
value (string | string)
value (string)
progress (number | string)
progress (string)
label (Label)
title (string | Expression | TextWithFormat | TextLocale, required)
color (object[])
isHidden (boolean | string)
isHidden (string)
horizontalItemSize (HorizontalListItemSize)
avatars (string)
avatars (string)
description (string | Expression | TextWithFormat | TextLocale)
swipeable (object)
left (object[])
right (object[])
Sub Schemas
AvatarElement (avatar)
text (string | Expression | TextWithFormat | TextLocale, required)
uri (string | string)
uri (string)
onPress (keg-action-in-background)
ImageElement (image)
text (string | Expression | TextWithFormat | TextLocale, required)
uri (string | string)
uri (string)
onPress (keg-action-in-background)
resizeMode (ResizeMode)
ResizeMode (enum<string>)
AmountControl (amount-control)
value (number | string)
value (string)
initialValue (number | string)
initialValue (string)
onChange (keg-action-in-background)
onDelete (ja-execute-entity | ja-execute-entities)
onDelete (ja-execute-entity)
onDelete (ja-execute-entities)
minimum (number | string)
minimum (string)
maximum (number | string)
maximum (string)
step (number | string)
step (string)
HorizontalListItemSize (enum<string>)
AvatarItemConfig (Avatar)
text (string | Expression | TextWithFormat | TextLocale, required)
uri (string | string)
uri (string)
Docs powered by
Archbee
Copyright © 2023 Jigx, Inc. All rights reserved. Terms of Service