ResizableTextArea 控制

用户输入的组件。

备注

GitHub 代码组件存储库中的完整文档和源代码。

说明

文本区域为用户提供输入和编辑文本的方法。 它们用于需要文本输入的窗体、模式对话、表和其他界面。

此组件允许用户调整文本区域的大小以方便使用。

备注

GitHub 代码组件存储库中有组件源代码和更多信息。

属性

键属性

属性	说明
Text	在控件中设置的文本值。 这是在模型驱动应用中使用时的默认绑定属性。
Default	重置控件或更改默认值时控件具有的默认值。 这允许控件以与画布应用窗体中的控件类似的方式工作。
MaxLength	可输入的最大字符数
HintText	未设置文本值时显示的文本
EmptyPlaceholderText	没有值且控件没有焦点时将显示的文本。 当模型驱动文本控件在没有填充值时显示 --- 时，此属性提供类似样式。
DefaultHeight	初始设置的文本区域的高度。如果未在画布应用/自定义页面设置，大小将默认为代码组件高度。 对于模型驱动应用，此属性是必需的，因为窗体不提供初始高度。
DefaultWidth	初始设置的文本区域的宽度。 如果未在画布应用/自定义页面设置，大小将默认为代码组件高度。 对于模型驱动应用，此属性不是必需的，因为默认宽度将是窗体列的宽度。
MinHeight	textarea 可以调整到的最小高度。 设置为零将没有限制。
MaxHeight	textarea 可以调整到的最大高度。 设置为零将没有限制。
Min Width	textarea 可以调整到的最小宽度。 设置为零将没有限制。
MaxWidth	textarea 可以调整到的最大宽度。 设置为零将没有限制。
AllowResize	定义 textarea 可以调整大小的方向。 无、两个方向、垂直或水平。
EnableSpellCheck	定义浏览器是否应该对 textarea 进行拼写检查。

输出属性

属性	Description
Resized Height** (output) - The user adjusted height | Resized Width** （output）- 用户调整的宽度

样式属性

属性	说明
PaddingLeft	要在 textarea 内添加的填充
PaddingRight	要在 textarea 内添加的填充
PaddingTop	要在 textarea 内添加的填充
PaddingBottom	要在 textarea 内添加的填充
Left Padding Adjustment	在模型驱动应用中，即使标签被隐藏，代码组件左侧也有填充来保留图标（例如，锁定图标）。 要对此进行更正，必须通过将左填充调整设置为 21 来减小宽度。 当同时存在标签时，“左填充调整”必须设置为标签的宽度。
RenderBorderStyle	可以设置为正常或居中。 当设置为“正常”时，文本区域框内的边框宽度会增加，但使用居中将使文本区域框边缘四周的边框居中。 使用“居中”来与 Power Apps 经典控件兼容，对模型驱动和 Fluent UI 控件使用“正常”。
Accessibility Label	aria 标签

并非所有样式/状态的组合都由每个组件实现。 请参阅 GitHub 组件文档中的状态相关样式属性。

事件属性

属性	说明
Input Event	将 Input Event 属性设置为以 SetFocus 开头的字符串来将焦点设置在控件上。 您必须包含一个随机后缀来触发事件。

其他属性与标准 text input 控件相同。

行为

支持 SetFocus 作为 InputEvent。

限制

此代码组件只能在画布应用、自定义页面和模型驱动应用中使用。

在 GitHub 文档的设计挑战一节查看更多限制说明。