Надпись (Label
) − текстовый компонент, отображающий статический текст либо значение атрибута сущности.
XML-имя компонента: label
Компонент Label
реализован для блоков Web Client и Desktop Client.
Пример задания надписи с текстом, взятым из пакета локализованных сообщений:
<label value="msg://orders"/>
Атрибут value
предназначен для задания текста надписи.
В веб клиенте текст, содержащийся в атрибуте value
, будет разбит на несколько строк, если по длине он превысит значение атрибута width. Поэтому для отображения многострочной надписи, достаточно указать абсолютное значение атрибута width. Если текст надписи слишком длинный, а значение атрибута width не определено, то текст будет урезан.
<label value="Надпись, которая должна быть разбита на несколько строк" width="200px"/>
Параметры надписи можно задать в контроллере экрана. Для этого необходимо задать компоненту идентификатор, по которому получить ссылку на него в контроллере:
<label id="dynamicLabel"/>
@Inject private Label dynamicLabel; public void init(Map<String, Object> params) { dynamicLabel.setValue("Some value"); }
Компонент Label
может отображать значение атрибута сущности. Для этого используются атрибуты datasource и property. Например:
<dsContext> <datasource id="customerDs" class="com.sample.sales.entity.Customer" view="_local"/> </dsContext> <layout> ... <label datasource="customerDs" property="name"/>
В данном случае компонент отображает атрибут name
сущности Customer
, находящейся в источнике данных customerDs
.
Атрибут htmlEnabled
указывает, каким образом будет рассматриваться значение атрибута value: как html
-код, при htmlEnabled="true"
, или как строка. Обратите внимание, что не все html
-теги поддерживаются в десктоп-реализации экрана.
Атрибуты label
:
Элементы label
: