span

span может использоваться для добавления небольшого фрагмента текста. Он позволяет применять стили, такие как цвет или шрифт.

XML-элемент

span

Java-класс

Span

Атрибуты

id - alignSelf - classNames - colspan - css - dataContainer - enabled - height - maxHeight - maxWidth - minHeight - minWidth - property - text - themeNames - title - visible - whiteSpace - width

Обработчики

AttachEvent - ClickEvent - DetachEvent

Основы

Как и его HTML-аналог, компонент span может использоваться для добавления и стилизации текста. Однако XML-элемент span не может быть применен к фрагменту текста, содержащемуся в другом XML-элементе.

Используйте компонент html для прямого включения нативного HTML.

Используйте span для создания короткого текста на экране, когда другие компоненты не подходят. Такой текст может сопровождать компонент, если он не умещается в атрибуты label или helperText, или если он имеет другое значение.

Можно комбинировать span с div для обеспечения различного позиционирования относительно компонента.

<div>
    <div text="What is the largest planet in the Solar system?"/>
    <textField/>
    <span classNames="font-bold" text=" Correct! "/>
    <span text="Jupiter has both the greatest mass and volume."/>
</div>
span basic

В приведенном выше примере содержимое div размещается сверху и занимает всю доступную ширину. Текст в span размещается сбоку и требует только необходимое пространство, что позволяет разместить несколько по-разному стилизованных компонентов span в одной строке.

Обратите внимание, что родительский контейнер может принудительно переносить строку после span. Например, корневой контейнер стандартного экрана располагает все компоненты в вертикальный столбец.

Темы

Используйте атрибут themeNames для настройки цвета, размера и формы компонента. Начните с преобразования компонента в бейдж с помощью themeNames = "badge". Затем примените дополнительные темы для улучшения различных визуальных аспектов.

Цвет

Выберите среди четырех вариантов цвета для передачи визуального назначения компонента: по умолчанию, success, error и contrast.

span badge color
XML-код
<span text="default" themeNames="badge"/>
<span text="success" themeNames="badge, success"/>
<span text="error" themeNames="badge, error"/>
<span text="contrast" themeNames="badge, contrast"/>

Сочетайте варианты цвета с темой primary для добавления дополнительного акцента:

span badge color primary
XML-код
<span text="default" themeNames="badge, primary"/>
<span text="success" themeNames="badge, success, primary"/>
<span text="error" themeNames="badge, error, primary"/>
<span text="contrast" themeNames="badge, contrast, primary"/>

Форма

Применение темы pill создает бейдж со скругленными углами. Используйте ее независимо или в сочетании с цветовыми темами:

span badge pill
XML-код
<span text="default" themeNames="badge, pill"/>
<span text="success" themeNames="badge, success, pill"/>
<span text="error" themeNames="badge, error, pill"/>
<span text="contrast" themeNames="badge, contrast, pill"/>

Размер

Доступны два варианта размера: размер по умолчанию normal и small.

span badge size
XML-код
<span text="normal" themeNames="badge, normal"/>
<span text="small" themeNames="badge, small"/>

Атрибуты

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

Следующие атрибуты специфичны для span:

Название

Описание

Значение по умолчанию

themeNames

Добавляет тему к компоненту. Возможные значения: badge, normal, success, error, contrast, primary, small, pill. Чтобы тема вступила в силу, объедините badge с другим значением, как показано выше.

Предопределенные темы — это наборы CSS-классов, которые могут влиять на другие параметры стилизации компонента или его вложенных компонентов.

-

Обработчики

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

Следующие обработчики специфичны для span:

Чтобы сгенерировать заглушку обработчика в Jmix Studio, используйте вкладку Handlers панели инспектора Jmix UI, или команду Generate Handler, доступную на верхней панели контроллера экрана и через меню CodeGenerate (Alt+Insert / Cmd+N).

Название

Описание

ClickEvent

com.vaadin.flow.component.ClickEvent возникает при клике на компонент. Этот обработчик должен указывать один из трех субъектов для определения количества кликов:

click – событие возникает при любом клике на компонент.

singleClick – событие возникает после таймаута, чтобы убедиться, что это не двойной клик.

doubleClick – событие возникает при двойном клике на компонент.

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

Дополнительную информацию смотрите в документации MDN.