SxTextArea (多行文本域)

  • Implemented

多行文本输入组件。对齐 Microsoft Fluent UI Blazor TextArea (v4.13.2) 的 API 结构，并说明 NextUI 当前实现状态。

使用场景

  • 备注/说明输入
  • 表单中的多行文本
  • 反馈与评论内容

约束说明

  • Rows/Cols 控制可视尺寸，实际高度可由 CSS 控制。
  • Resize 控制用户可调整方向。

行为说明

  • Immediate 为真时输入过程中触发 ValueChanged。
  • ImmediateDelay 用于延迟输入同步。
  • ReadOnly/Disabled 时不响应输入。

API

Parameters (参数)

状态 参数名 类型 默认值 描述
Implemented Value string? "" 当前值。
Implemented Placeholder string? "" 占位文案。
Implemented Label string? null 顶部标签文本。
Implemented Appearance SxInputAppearance Outline 视觉风格。
Implemented ReadOnly bool false 是否只读。
Implemented Required bool false 是否必填。
Implemented Rows int? 3 可视行数。
Implemented Cols int? null 可视列数。
Implemented Resize TextAreaResize None 调整大小策略。
Implemented MaxLength int? null 最大长度。
Implemented MinLength int? null 最小长度。
Implemented Autofocus bool false 自动聚焦。
Implemented Spellcheck bool? null 拼写检查。
Implemented AriaLabel string? null aria-label。
Implemented Immediate bool false 是否即时同步。
Implemented ImmediateDelay int 0 即时同步延迟 (ms)。
Implemented AccessKey (继承) string? null 快捷键。
Implemented TabIndex (继承) int? null Tab 顺序。
Implemented Disabled (继承) bool false 禁用状态。
Implemented Id (继承) string? null 组件的物理 Id。
Implemented Class (继承) string? null 自定义 CSS 类名。
Implemented Style (继承) string? null 自定义样式。
Implemented Title (继承) string? null HTML title 属性。
Implemented AdditionalAttributes (继承) IEnumerable<KeyValuePair<string, object>>? null 捕获不匹配的 HTML 属性。
Not Implemented ValueExpression Expression<Func<string>>? null 数据绑定验证表达式。

Events (事件)

状态 事件名 类型 描述
Implemented ValueChanged EventCallback<string?> 值改变时触发。
Implemented OnFocus EventCallback<FocusEventArgs> 获得焦点时触发。
Implemented OnBlur EventCallback<FocusEventArgs> 失去焦点时触发。

Methods (方法)

状态 方法名 返回值 描述
Implemented FocusAsync ValueTask 使文本域获得焦点。

示例

<SxTextArea @bind-Value="_bio" Label="个人简介" Rows="5" />

<SxTextArea Placeholder="请输入内容..." Resize="TextAreaResize.Vertical" />

参考设计 (References)

在 Playground 中打开 →