SxSecurityCode (验证码输入框)
NextUI 扩展组件。专用于 4-6 位数字验证码输入的组件,支持自动聚焦跳转。
使用场景
约束说明
Length 控制输入框数量。
- 仅支持单字符输入。
行为说明
- 输入后自动聚焦下一格。
- 输入完成触发
OnCompleted。
API
Parameters (参数)
| 状态 |
参数名 |
类型 |
默认值 |
描述 |
| Implemented |
Length |
int |
6 |
验证码长度。 |
| Implemented |
Value |
string |
"" |
当前输入值。 |
| 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 |
额外属性。 |
Events (事件)
| 状态 |
事件名 |
类型 |
描述 |
| Implemented |
OnCompleted |
EventCallback<string> |
输入完成触发。 |
| Implemented |
ValueChanged |
EventCallback<string?> |
值改变触发。 |
示例
<SxSecurityCode Length="6" ValueChanged="@OnValueChanged" />
参考设计 (References)