Input 输入框

收集简短的单行文本并明确表达输入状态。

Beta

示例

直接操作示例,查看组件在具体任务中的状态与反馈。

受控编辑本地项目名称并即时回报校验结果,同时对照只读、禁用和失败状态。
设置区域项目资料
字符数8 / 24
保存方式本地预览
项目名称
当前项目名称:组件目录发布准备
权限与校验对照
小、中、大三种输入高度适配工具栏、常规表单和高触达区域。
图标说明输入用途,尾部内容提供不抢占文本区域的单位或状态。
只读、禁用与校验失败分别表达可复制、不可操作和需要修正。

使用建议

单行信息保持单一目的

一个 Input 只收集一种短信息,并由可见标签说明含义;placeholder 不能代替标签。

区分只读与禁用

readOnly 适合允许复制但不可编辑的值,disabled 适合当前不可参与提交或操作的控件。

尺寸跟随表单密度

同一表单区域保持统一 controlSize,不用尺寸变化暗示字段重要程度。

引入方式

从已验证的公开子路径导入组件;全局样式接入方式见安装指南。

import { BaseInput } from '@inf-monkeys-tech/monkeys-design/components/base';

当前限制

  • Input 不解析、清洗或提交业务值;格式化、异步校验和敏感信息处理必须由宿主应用实现。
  • Deterministic visual evidence is pending T17/T23.
export interface BaseInputProps
  extends Omit<
    InputHTMLAttributes<HTMLInputElement>,
    'className' | 'disabled' | 'readOnly' | 'style'
  > {
  icon?: ReactNode;
  trailing?: ReactNode;
  invalid?: boolean;
  disabled?: boolean;
  readOnly?: boolean;
  controlSize?: BaseControlSize;
  appearance?: BaseAppearance;
  className?: string;
  classNames?: BaseControlClassNames;
  style?: CSSProperties;
}
属性说明类型默认值
icon显示在主要内容旁的图标。ReactNode
trailing显示在主要内容末尾的附加内容。ReactNode
invalid是否进入无效状态并应用相应的校验样式与语义。booleanfalse
disabled是否禁用该组件及其可交互行为。booleanfalse
readOnly是否将控件设为只读,同时保留聚焦与内容读取能力。booleanfalse
controlSize内部表单控件使用的预设尺寸。BaseControlSize
appearance覆盖组件使用的外观令牌或局部样式配置。BaseAppearance
className追加到组件根元素的 CSS 类名。string
classNames按组件公开的结构插槽分别追加 CSS 类名。BaseControlClassNames
style追加到组件根元素的内联样式。CSSProperties