nativeLabel

nativeLabel создаёт текстовую метку, связанную с другим компонентом.

XML-элемент

nativeLabel

Java-класс

NativeLabel

Основы

Используйте nativeLabel, когда вместо атрибута label нужна отдельная метка.

Задайте в setFor идентификатор компонента, который описывает метка. В следующем примере метка связана с checkbox:

<div>
    <checkbox id ="checkbox"/>
    <nativeLabel text="Enable Notifications" setFor="checkbox"/>
</div>
label basic

Связывание надписи с компонентом позволяет вспомогательным технологиям, таким как программы чтения с экрана, правильно интерпретировать текст надписи.

Для добавления текста, не связанного с компонентом, используйте компоненты span или div.

Динамическая надпись

Присвойте nativeLabel идентификатор, инжектируйте компонент в контроллер и вызовите setText(), чтобы обновить текст:

XML
<nativeLabel id="dynamicLabel" setFor="button"/>
<button id="button" text="Click"/>
Java
@ViewComponent
private NativeLabel dynamicLabel;

@Subscribe("button")
public void onButtonClick(final ClickEvent<JmixButton> event) {
    dynamicLabel.setText("Button clicked " + event.getClickCount() + " times.");
}
label dynamic

Варианты темы

Используйте атрибут themeNames, чтобы оформить метку как бейдж. Сочетайте badge с вариантами цвета, акцента, формы или размера.

Вариант Описание Поддерживается в

badge

Применяет оформление бейджа.

Aura, Lumo

success, warning, error, contrast

Применяет семантический цвет.

Aura, Lumo

primary

Добавляет более выраженный визуальный акцент.

Aura, Lumo

pill

Скругляет углы бейджа.

Aura, Lumo

small

Уменьшает размер бейджа.

Aura, Lumo

normal

Использует обычный размер бейджа.

Aura, Lumo

Атрибуты

В Jmix существует множество общих атрибутов, которые служат одной цели для всех компонентов. Следующие атрибуты специфичны для nativeLabel:

Имя Описание По умолчанию

themeNames

Применяет один или несколько вариантов из раздела Варианты темы.

—

setFor

Связывает метку с компонентом по указанному идентификатору, чтобы вспомогательные технологии могли интерпретировать эту связь.

—

Обработчики

Имя Описание

AttachEvent

Срабатывает при присоединении метки к UI.

DetachEvent

Срабатывает при отсоединении метки от UI.

Смотрите также