Выражение привязки
Выражения привязок инструментальной панели очень похожи на выражения привязок сервера. Однако выражения привязок в виджетах могут включать несколько основных типов ссылок:
- Стандартные ссылки (без схемы), которые указывают на переменные или функции контекста, их поля или свойства
- Ссылки на компоненты (использующие схему
form/
), которые указывают на свойства компонентов инструментальной панели
- Специальные ссылки Web UI (использующие схему
web/
), которые запускают специфичные для Web UI операции
Ссылки на компоненты
Ссылка на компонент указывает на свойство компонента инструментальной панели (например, текст метки). Она имеет следующий формат:
form/component:property
form
- имя схемы, используемой для идентификации ссылок на компонент. Схема говорит обработчику языка выражений использовать распознаватель, которые понимает ссылки на компоненты и знает, что с ними делать. Ссылки на компоненты необходимо всегда начинать с form/
.
component
- имя компонента инструментальной панели, с которым вы хотите работать. Имя компонента отображается в дереве компонентов и в заголовке окна свойств компонентов, если компонент выбран в конструкторе.
property
- имя определенного свойства внутри компонента. Имена свойств можно найти в описании свойств каждого компонента инструментальной панели. Указывать свойство в ссылке на компонент необязательно. Если свойство не указано, ссылка ведет к свойству по умолчанию компонента.
Формат свойства, т.е. типа значения, возвращаемого ссылкой на свойство компонента, можно найти в описании этого свойства в справочнике компонентов.
Примеры ссылок на свойство компонента
{form/userNameField:}
{form/userNameField:text}
Обе ссылки разрешаются в текст, который содержится в userNameField
(при условии, что это текстовое поле). Первая ссылка указывает на свойство по умолчанию компонента, то есть text
, а вторая прямо называет его (:text
).
Специальные ссылки web UI
Специальная ссылка инициирует выполнение операции, специфичной для Web UI. Ссылка имеет следующий формат:
web/operation(["parameter"])
Поддерживаются следующие операции:
web/logout()
- прекращает текущую сессию Web UI и осуществляет выход пользователяweb/redirect("context" [, parameter1 [, parameter2...]])
- переадресует текущего пользователя на другую веб инструментальную панель согласно указанному пути контекстаweb/executeAction("context:action!")
- выполняет действие из контекста с указанным путем
Пример выражения привязки инструментальной панели
{form/numberField1:value} * 100
Это выражение разрешится в число, равное свойству value компонента Числовое поле, названного numberField1, умноженному на 100.