跳到主要内容

SmsField 短信字段

组合 Input 与发送动作。调用方提供输入长度、文案和剩余秒数,并维护发送请求及计时。

可以发送 · 已输入 0 位

用法​

<SmsField
value={code}
onChangeText={setCode}
remainingSeconds={remaining}
maxLength={6}
placeholder="请输入 6 位验证码"
sendLabel={remaining > 0 ? `${remaining}s` : '获取验证码'}
sendAccessibilityLabel={
remaining > 0 ? `${remaining} 秒后可重新获取验证码` : '获取验证码'
}
sendDisabled={sending}
onSend={requestSms}
/>

API​

公开类型:SmsFieldProps。

参数类型默认值说明
value / onChangeTextstring / (value: string) => void必填受控原文
remainingSecondsnumber必填大于零时禁用发送;不创建计时器
sendLabel / onSendstring / () => void必填发送按钮当前文案与事件
sendAccessibilityLabelstring按钮文案可给倒计时提供完整读屏说明
sendDisabledbooleanfalse调用方控制发送禁用
maxLength / placeholdernumber / string—长度与提示不预设六位或业务文案
editable / accessibilityLabel / testIDInput 对应字段沿 Input输入状态、名称与定位

使用 number-pad、sms-otp 和 oneTimeCode 原生提示,前缀为 mail 图标。手机号、用途、请求去重、身份和冷却计时均由应用维护。明暗主题、字号与交互沿 Input;原生展厅位于「表单与输入」。