单行文本 控件 可视化代码生成平台 · 基础输入控件

农哥

单行文本 控件

可视化代码生成平台 · 基础输入控件（1/14）

用途：录入短文本——名称、标题、编号、URL、账号、手机号等一行内容。
存储：varchar(255)（长度可配）。
列表/搜索：列表直接显示；搜索为包含匹配（LIKE）。
适用：绝大多数"一个值占一行"的文本字段。

控件解析（外观 · 行为交互 · 样式 · 数据）

维度	说明
外观	单行输入框，圆角浅灰边框；聚焦时边框高亮；占位符灰字提示。
行为交互	点击/聚焦进入输入态；失焦触发必填与最大长度校验；回车不自动提交（由表单级控制）。
样式	边框色、圆角、内边距、宽度随主题或字段属性可调；文字默认左对齐；可加前缀/后缀包裹（如协议、域名）。
数据	varchar(255)（长度可配）；原样存字符串；可搜索为"包含"匹配；前缀/后缀仅展示不参与存储。

属性面板（右侧）功能详解

① 基础设置

字段	说明
字段名	业务表列名，仅小写字母/数字/下划线，发布后锁定。
标签	表单与列表显示的中文名。
提示文案	控件下方灰字，指导填写者。
必填	开启后保存校验，空则拦截提交。
默认值	新增时的初始文本（可留空）。

② 显示设置

字段	说明
进列表	是否在列表页显示该列。
可搜索	是否进入搜索区（模糊匹配）。
排序权重	控件在表单/列表中的先后位置。

③ 校验规则

字段	说明
最大长度	默认 255，超长拦截（同时调表宽）。
格式正则	可选，如手机号 ^1[3-9]\d{9}$。

④ 专属属性

字段	说明
占位符 placeholder	输入框内浅色提示文字。
前缀 / 后缀	如前缀 http:// + 后缀 /，仅展示不入库。

⑤ 高级

字段	说明
启用 / 停用	停用仅隐藏，不删列不丢数据；同名可复活。

演示

商品名称（必填 · 可搜索）

字段名: goods_name | 控件: text | 必填: 是 | 可搜索: 是 | 最大长度: 120

技巧：标题/名称类字段务必勾"可搜索"；带固定域名/协议前缀的字段用"前缀/后缀"包裹，避免用户漏填；长度超过 255 请改用多行文本或 text 类型。

单行文本 控件文档 · 随工具迭代更新