Components/EUI extensions

ETextArea Text area

import EUI 1.0

Examples

Multiline input, word count and autosize

QML sourceQML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 ETextArea { maximumLength: 120 resize: "vertical" showWordLimit: true width: Math.min(560, parent.width) autosize: ({minRows: 3, maxRows: 6}) placeholderText: qsTr("Type multiple lines\n\n drag the lower right corner to resize") }

Preview

Run the code to try the component

Edit text, properties, or events, then select Run.

Code runs in this browser Licenses

Text area

QML sourceQML

import EUI 1.0 import QtQuick 2.15 import QtQuick.Layouts 1.15 import QtQuick.Controls 2.15 Column { spacing: 16 width: parent.width ETextArea { width: Math.min(parent.width, 520) placeholderText: qsTr("Enter multiple lines") } ETextArea { height: 72 size: EStyle.Small adaptiveHeight: false text: qsTr("Fixed height") width: Math.min(parent.width, 520) } }

Preview

Run the code to try the component

Edit text, properties, or events, then select Run.

Code runs in this browser Licenses

Properties

PropertyDescriptionValues and default

adaptiveHeightbool

Adjust height automatically to text content.

Defaulttrue

autosizevar

Resize the text area height to its content, with optional row limits.

true / false
Object fields: minRows, maxRows

Defaultundefined

enabledbool

Allow interaction; false disables the control.

Defaulttrue

fontfont

Font settings for the family, size and text style.

Common fields:
family, pixelSize, pointSize
bold, italic, weight
underline, strikeout
letterSpacing, wordSpacing

Defaultapplication font

heightreal

Component size in pixels; may be bound to its parent layout.

DefaultimplicitHeight

maximumLengthint

Maximum allowed input characters.

Default2147483647

placeholderTextstring

Placeholder shown when the value is empty.

Default""

readOnlybool

Prevent user editing or rating while allowing programmatic value changes.

Defaultfalse

resizestring

Directions in which the user can resize the text area.

"none" / "vertical"
"horizontal" / "both"

Default"none"

rowsint

Text rows or skeleton rows.

Default1

showWordLimitbool

Show the current character count and length limit.

Defaultfalse

sizeint

Control size; inherits the nearest EConfigProvider by default.

EStyle.Small
EStyle.Medium
EStyle.Large

DefaultInherited; EStyle.Medium by default

styleTypeint

Semantic color style.

EStyle.Default
EStyle.Primary
EStyle.Success
EStyle.Info
EStyle.Warning
EStyle.Danger

DefaultEStyle.Default

textstring

Displayed text.

Default""

textColorcolor

Text color.

DefaultDynamic binding

validateEventbool

Request enclosing-form validation when the value changes.

Defaulttrue

validationMessagestring

Validation message or externally supplied error text.

Default""

validationStateint

Input validation state.

EValidationState.None
EValidationState.Success
EValidationState.Warning
EValidationState.Error

DefaultEValidationState.None

visiblebool

Whether the component is visible.

Defaulttrue

widthreal

Component size in pixels; may be bound to its parent layout.

DefaultimplicitWidth

automaticHeightrealRead only

Automatic text-area height derived from rows and content.

DefaultComputed at runtime

hasValidationErrorboolRead only

Whether validation state is Error.

DefaultComputed at runtime

lineHeightrealRead only

Text line height derived from font size.

DefaultComputed at runtime

maximumRowsrealRead only

Maximum or minimum rows allowed by auto-sized text areas.

DefaultComputed at runtime

minimumRowsintRead only

Maximum or minimum rows allowed by auto-sized text areas.

DefaultComputed at runtime

wordCountintRead only

Current input character count.

DefaultComputed at runtime