field.list

Компонент, позволяющий исполнителю самостоятельно добавлять и удалять элементы списка, например текстовые поля для заполнения.

Так вы сможете разрешить исполнителю дать несколько ответов на вопрос.

Компоненты, которые используются в примере
  • view.list — отображает данные списком;
  • data.output — определяет данные задания, которые вы получите после его отправки исполнителем;
  • view.text — показывает текст;
  • data.relative — представляет данные в виде элементов списка;
  • condition.not — возвращает значение, обратное данному;
  • condition.empty — проверяет, что данные не получили значения.

В элементах может быть любой компонент, в том числе список других компонентов. Например, это позволит создать таблицу, в которую можно добавлять и удалять строки.

Компоненты, которые используются в примере
  • view.list — отображает данные списком;
  • field.date — добавляет поле для ввода даты;
  • data.output — определяет данные задания, которые вы получите после его отправки исполнителем;
  • layout.columns — располагает данные по столбцам;
  • view.text — показывает текст;
  • data.relative — представляет данные в виде элементов списка;
  • condition.required — проверяет, что поле с данными заполнено.

Управление компонентом

Для добавления нового элемента списка надо нажать на кнопку. Для удаления — на крестик справа (появляется при наведении на элемент списка).

Чтобы запретить исполнителю добавлять слишком много элементов списка, установите максимальную длину списка. Вы также можете заблокировать управление компонентом с помощью свойства editable, например при наступлении какого-то события.

Свойства компонента

Название

Тип

Описание

type*

"field.list"

Задает тип компонента.

data*

writable

Данные, значения которых будут обработаны или изменены.

label

string

Надпись над компонентом.

addedItems

array

–

addedItems[]

view

–

buttonLabel

string

Текст на кнопке добавления элементов.

direction

string

Направление списка:

  • vertical (по умолчанию) — вертикальное.
  • horizontal — горизонтальное.

editable

boolean

Свойство, которое указывает, разрешено ли добавление и удаление элементов. Укажите false, чтобы запретить. По умолчанию true — разрешено.

hint

string

Текст подсказки.

maxLength

number

Максимальное количество элементов.

minLength

number

–

removeVariant

string

–

render*

view

Шаблон интерфейса для элементов списка, например текстовое поле.

В во вложенных компонентах field.* для записи ответов используйте data.relative, иначе во всех элементах списка будет одно и то же значение.

size

string

Расстояние между элементами. Допустимые значения в порядке возрастания: s, m (по умолчанию).

validation

condition

Валидация на основе условия (condition).
Предыдущая
field.image-annotation
Следующая
field.map