textArea

ДЕМО

Область для ввода многострочного текста.

  • XML-элемент: textArea

  • Java-класс: JmixTextArea

Основы

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

text area basic 
<textArea label="Comment"
          value="Great job. This is excellent!"/>

Если не задана фиксированная высота, компонент автоматически подстраивает высоту под содержимое. Минимальная и стандартная высота - две строки текста.

Привязка данных

ДЕМО

Привязка данных означает связывание визуального компонента с контейнером данных. Изменения в компоненте или соответствующем контейнере могут вызывать взаимные обновления. Подробнее смотрите в разделе Использование компонентов данных.

Пример создания textArea с привязкой к данным:

<textArea id="textArea" label="Order description"
          dataContainer="orderDc"
          property="description"/>

Убедитесь, что атрибут сущности, к которому выполняется привязка, имеет строковый тип. В отличие от textField, textArea специально предназначен для работы с текстовыми данными.

Варианты оформления

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

Выравнивание

Доступны три варианта: align-left (по умолчанию), align-right, align-center.

text area alignment
XML код 
<textArea themeNames="align-left"/>
<textArea themeNames="align-center"/>
<textArea themeNames="align-right"/>

Положение вспомогательного текста

Опция helper-above-field перемещает вспомогательный текст из стандартного положения под полем на позицию над ним.

text area helper text position
XML код 
<textArea label="Text area label" helperText="Helper text"/>
<textArea themeNames="helper-above-field" label="Text area label" helperText="Helper text"/>

Размер

Доступно два варианта размера: стандартный и уменьшенный (small).

text area size
XML код 
<textArea/>
<textArea themeNames="small"/>

Атрибуты

id - alignSelf - allowedCharPattern - ariaLabel - ariaLabelledBy - autocapitalize - autocomplete - autocorrect - autofocus - autoselect - classNames - clearButtonVisible - css - colspan - dataContainer - enabled - errorMessage - focusShortcut - height - helperText - label - maxHeight - maxWidth - minHeight - minWidth - pattern - placeholder - property - readOnly - required - requiredIndicatorVisible - trimEnabled - themeNames - value - valueChangeMode - valueChangeTimeout - visible - width

Обработчики

AttachEvent - BlurEvent - ClientValidatedEvent - ComponentValueChangeEvent - CompositionEndEvent - CompositionStartEvent - CompositionUpdateEvent - DetachEvent - FocusEvent - InputEvent - KeyDownEvent - KeyPressEvent - KeyUpEvent - statusChangeHandler - validator

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

Элементы

tooltip - prefix - suffix - validator

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

Смотрите документацию Vaadin для получения дополнительной информации.