菜单 · 组件

最后更新:2026年8月12日

组件

单行文本输入,适合标题、账号这类短内容。

Input

单行文本输入。

用法

Input {
    mode: InputMode::Text,
    placeholder: Some("邮箱".into()),
    value: Some(email()),
    width: "100%",
    on_change: move |v| email.set(v),
}

密码输入使用系统密码掩码,并在输入框末尾显示跟随当前主题颜色的显隐图标:

Input {
    mode: InputMode::Password,
    placeholder: Some("密码".into()),
    value: Some(password()),
    width: "100%",
    on_change: move |v| password.set(v),
}

纯数字输入会启用数字键盘,并同时过滤键入和粘贴内容中的非 ASCII 数字:

Input {
    mode: InputMode::Number,
    placeholder: Some("验证码".into()),
    value: Some(code()),
    width: "100%",
    on_change: move |v| code.set(v),
}

Props

Prop类型默认说明
placeholderOption<String>None占位文案
valueOption<String>None受控值
modeInputModeTextTextPasswordNumber
heightOption<f32>48固定高度 vp
widthOption<String>NoneCSS 宽度("100%" 表示占满)
invalidboolfalse校验失败时使用 destructive 边框
disabledboolfalse禁止编辑,保留尺寸
read_onlyboolfalse保持外观但禁止焦点和输入
on_changeOption<EventHandler<String>>None文本变更
on_clickOption<EventHandler<()>>None点击输入框