4.5.2.1.14. Label
Надпись (Label
) − текстовый компонент, отображающий статический текст либо значение атрибута сущности.
XML-имя компонента: label

Компонент Label
реализован для блоков Web Client и Desktop Client.
Пример задания надписи с текстом, взятым из пакета локализованных сообщений:
<label value="msg://orders"/>
Атрибут value
предназначен для задания текста надписи.
В веб клиенте текст, содержащийся в атрибуте value
, будет разбит на несколько строк, если по длине он превысит значение атрибута width. Поэтому для отображения многострочной надписи, достаточно указать абсолютное значение атрибута width. Если текст надписи слишком длинный, а значение атрибута width не определено, то текст будет урезан.
<label value="Label, which should be split into multiple lines"
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: при htmlEnabled="true"
как HTML-код, иначе как строка. Обратите внимание, что не все HTML-теги поддерживаются в десктоп-реализации экрана.