Checkbox
Компонент Checkbox позволяет пользователю выбрать логическое значение (да/нет, true/false). Настройка hasThreeStates включает третье состояние — null (значение не задано).
См. описание Checkbox на Form.io
См. общее описание компонента Checkbox
Видимость компонента: customConditional и Logic
Checkbox поддерживает два независимых механизма управления видимостью:
customConditional — JavaScript-выражение на вкладке Conditional. Переменной
showприсваиваетсяtrueилиfalse, определяющее, должен ли компонент отображаться.Logic — правила на вкладке Logic, которые могут программно устанавливать свойство
component.hidden.
Оба механизма работают независимо и применяются совместно:
компонент скрыт, если
customConditionalвернулfalseили Logic установилаhidden = true.при отсутствии запрещающих условий компонент доступен для показа с учётом общих настроек видимости формы.
Пример customConditional
Скрыть Checkbox, пока поле status не равно "active":
show = data.status === 'active';
Пример совместного использования
На форме есть Checkbox с:
customConditional:
show = data.role === 'manager';Logic: при событии
changeполяdepartmentустанавливаетcomponent.hidden = true.
В этом случае Checkbox отображается только если оба условия разрешают показ:
компонент скрыт, когда data.role !== 'manager' или когда Logic установила hidden = true.
Особенности реализации (для разработчиков)
Checkbox в Citeck переопределяет метод updateVisible базового класса formiojs и вызывает функцию applyCheckboxVisibility. Она не изменяет DOM в режиме редактора форм (options.builder) и при пустом списке component.logic.
В остальных случаях вычисляется признак необходимости скрытия:
const shouldBeHidden = !!component.hidden || _visible === false;
где:
component.hidden— свойство, которое в том числе может задаваться Logic-правилами;_visible— результат обработки условий видимости, включаяcustomConditionalиconditional.
Строгая проверка === false для _visible важна: она предотвращает ложное скрытие компонента,
пока formiojs ещё не инициализировал это поле. Само значение undefined не запрещает показ.
Логика работы updateVisible
|
|
|
Примечание |
|---|---|---|---|
|
|
|
Нормальное состояние |
|
|
|
customConditional запретил показ |
|
|
|
Logic скрыла компонент |
|
|
|
Оба механизма скрывают |
|
|
|
formiojs ещё не инициализировал _visible |
DOM обновляется только при наличии element и отличии shouldBeHidden от текущего состояния атрибута hidden:
Если
shouldBeHidden === true, устанавливаются атрибутhidden,visibility: hiddenиposition: absolute. Эта ветка применяется и внутри Columns.Если
shouldBeHidden === falseи компонент находится в Columns сautoAdjust, устанавливаютсяvisibility: hiddenиposition: relative. Эта ветка не снимает атрибутhidden.В остальных случаях показа атрибут
hiddenснимается, устанавливаютсяvisibility: visibleиposition: relative.
Таким образом, таблица описывает вычисляемый признак скрытия, а не гарантирует итоговую видимость элемента во всех режимах компоновки.
Тестирование логики видимости
Функция applyCheckboxVisibility вынесена как именованный экспорт из Checkbox.js,
что позволяет тестировать её без рендеринга полного компонента:
import { applyCheckboxVisibility } from '.../Checkbox';
const ctx = {
options: { builder: false },
component: { hidden: false, logic: [{}] },
_visible: false,
element: document.createElement('div')
};
applyCheckboxVisibility(ctx);
// ctx.element.hidden === true
См. также
Columns — контейнер с autoAdjust
Настройки компонентов — customDefaultValue, Allow Manual Override и другие настройки