组件/EUI 扩展

ETextArea 多行输入

import EUI 1.0

示例与代码

多行输入、字数与自适应高度

QML 代码QML

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("输入多行内容；右下角可调整高度") }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

多行输入

QML 代码QML

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 { placeholderText: qsTr("请输入多行内容") width: Math.min(parent.width, 520) } ETextArea { height: 72 size: EStyle.Small text: qsTr("固定高度") adaptiveHeight: false width: Math.min(parent.width, 520) } }

效果

运行代码，体验组件交互

可修改文字、属性和事件，再点击运行。

代码在当前浏览器中运行 许可

属性

属性说明取值与默认值

adaptiveHeightbool

是否根据文本内容自动调整高度。

默认值true

autosizevar

根据内容自动调整文本域高度，可限制行数。

true / false
对象字段：minRows, maxRows

默认值undefined

enabledbool

是否允许交互；false 时控件禁用。

默认值true

fontfont

字体配置，控制字体、字号及文字样式。

常用字段：
family、pixelSize、pointSize
bold、italic、weight
underline、strikeout
letterSpacing、wordSpacing

默认值应用字体

heightreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitHeight

maximumLengthint

最多允许输入的字符数。

默认值2147483647

placeholderTextstring

空值时显示的占位文字。

默认值""

readOnlybool

禁止用户编辑或评分，仍可通过属性设置值。

默认值false

resizestring

允许用户拖动调整的尺寸方向。

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

默认值"none"

rowsint

文本行数或骨架行数。

默认值1

showWordLimitbool

显示当前字数与长度上限。

默认值false

sizeint

控件尺寸；默认继承最近的 EConfigProvider。

EStyle.Small
EStyle.Medium
EStyle.Large

默认值继承 Provider，默认 EStyle.Medium

styleTypeint

语义配色风格。

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

默认值EStyle.Default

textstring

显示的文字内容。

默认值""

textColorcolor

文字颜色。

默认值动态绑定

validateEventbool

值变化时是否向所属表单派发校验请求。

默认值true

validationMessagestring

校验结果说明或外部错误文字。

默认值""

validationStateint

输入校验状态。

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

默认值EValidationState.None

visiblebool

是否显示组件。

默认值true

widthreal

组件尺寸，单位为像素；可绑定父布局尺寸。

默认值implicitWidth

automaticHeightreal只读

文本域根据行数及内容计算的自动高度。

默认值由运行时计算

hasValidationErrorbool只读

当前校验状态是否为 Error。

默认值由运行时计算

lineHeightreal只读

根据字号计算的文本行高。

默认值由运行时计算

maximumRowsreal只读

自动高度文本域允许的最大或最小行数。

默认值由运行时计算

minimumRowsint只读

自动高度文本域允许的最大或最小行数。

默认值由运行时计算

wordCountint只读

当前输入字符数量。

默认值由运行时计算