Документация /

Зависимости

Состояние виджетов и их взаимное влияние зависит от зависимостей, которыми они наделены. Существует пять видов зависимостей:

  • ZForms.Dependence.TYPE_REQUIRED — заполненность виджета.
  • ZForms.Dependence.TYPE_VALID — валидность виджета.
  • ZForms.Dependence.TYPE_ENABLED — доступность виджета.
  • ZForms.Dependence.TYPE_OPTIONS — доступность опций виджета (применима только к некоторым видам виджетов, имеющие списки опций)
  • ZForms.Dependence.TYPE_CLASS — управление дополнительными CSS-классами виджета.

Если состояние виджета зависит от нескольких условий, то ему можно добавить несколько зависимостей и объединить их логикой — «и» или «или».

Логика объединения связывает зависимости только одинакового типа.

Зависимости добавляется виджету с помощью объектов зависимостей в параметрах виджетов.

вид зависимости объект зависимости на что влияет
ZForms.Dependence.TYPE_REQUIRED oRequired на CSS-классы zf-required, zf-required-ok
ZForms.Dependence.TYPE_VALID oValid на CSS-классы zf-required, zf-required-ok, zf-invalid, zf-invalid-ok (для версии >= 3.0.2)
ZForms.Dependence.TYPE_ENABLED oEnabled на состояние disabled
ZForms.Dependence.TYPE_OPTIONS oDependedOptions на состояние disabled частей виджета
ZForms.Dependence.TYPE_CLASS oClasses на CSS-классы, определенные в зависимости

При создании зависимостей используется понятие «имя виджета» — это значение атрибута name элемента, на котором этот виджет был создан. Используется для идентификации других виджетов в параметрах зависимостей.