Shadcn Admin Kit表单组件全攻略:TextInput到RichTextInput实战

📅 发布时间:2026/7/25 20:43:36
Shadcn Admin Kit表单组件全攻略:TextInput到RichTextInput实战 Shadcn Admin Kit表单组件全攻略TextInput到RichTextInput实战【免费下载链接】shadcn-admin-kitComponent kit to build your Admin app with shadcn/ui项目地址: https://gitcode.com/gh_mirrors/sh/shadcn-admin-kitShadcn Admin Kit是基于shadcn/ui构建的强大组件套件提供了从基础文本输入到富文本编辑的完整表单解决方案。本文将带您全面掌握TextInput、RichTextInput等核心表单组件的使用方法帮助您快速构建专业级管理应用界面。表单组件基础SimpleForm容器所有表单组件都需要在SimpleForm容器中使用它提供了表单布局、验证、提交等核心功能。SimpleForm默认采用每行一个输入组件的布局并在底部显示取消和保存按钮。基本用法示例import { Edit, SimpleForm, TextInput, BooleanInput } from /components/admin; export const ProductEdit () ( Edit SimpleForm TextInput sourcename / BooleanInput sourceavailable / /SimpleForm /Edit );SimpleForm支持自定义验证、默认值和工具栏满足各种复杂表单需求。详细文档请参考SimpleForm.md。基础文本输入TextInput组件单行长文本输入TextInput是最常用的表单组件用于接收单行文本输入。它包装了Shadcn的Input组件提供了表单绑定、验证等增强功能。基本用法import { TextInput } from /components/admin; TextInput sourcetitle /多行文本输入通过设置multiline属性TextInput可以转换为文本区域textareaTextInput sourcedescription multiline rows{4} /核心属性属性类型描述sourcestring字段名称必填multilineboolean是否使用多行文本框labelstring | false自定义标签或隐藏标签disabledboolean是否禁用输入validateValidator | Validator[]验证规则⚠️ 注意不要使用typenumber这会导致值以字符串形式返回。应使用专门的NumberInput组件处理数字输入。高级富文本编辑RichTextInput组件对于需要格式化文本的场景Shadcn Admin Kit提供了功能强大的RichTextInput组件基于TipTap编辑器实现支持富文本编辑并以HTML格式存储内容。安装RichTextInput是可选组件默认不包含在admin注册表中需要单独安装npx shadcnlatest add https://marmelab.com/shadcn-admin-kit/r/rich-text-input.json基本用法import { Edit, SimpleForm } from /components/admin; import { RichTextInput } from /components/rich-text-input; const PostEdit () ( Edit SimpleForm RichTextInput sourcebody / /SimpleForm /Edit );自定义工具栏默认工具栏包含丰富的格式化选项撤销/重做、粗体/斜体/下划线、标题、文本颜色、列表、引用、链接和图片操作等。您也可以自定义工具栏import { RichTextInput, RichTextInputToolbar } from /components/rich-text-input; import { Button } from /components/ui/button; RichTextInput sourcebody toolbar{ RichTextInputToolbar Button typebutton onClick{() editor.chain().focus().toggleBold().run()} 粗体 /Button {/* 其他自定义按钮 */} /RichTextInputToolbar } /性能优化RichTextInput依赖TipTap和ProseMirror库会增加JavaScript包体积。对于不常用该组件的页面建议使用懒加载const RichTextInput React.lazy(() import(/components/rich-text-input).then((module) ({ default: module.RichTextInput, })), );实用表单组件推荐除了TextInput和RichTextInputShadcn Admin Kit还提供了多种实用表单组件数组输入ArrayInput用于输入数组类型的数据如标签列表、多值选择等。用法示例import { ArrayInput, SimpleFormIterator, TextInput } from /components/admin; ArrayInput sourcetags SimpleFormIterator TextInput source. / /SimpleFormIterator /ArrayInput自动完成输入AutocompleteInput提供搜索建议功能的高级输入组件适合从大量选项中选择。日期时间选择DateTimeInput用于选择日期和时间的专用组件提供直观的日历界面。表单验证最佳实践Shadcn Admin Kit集成了react-hook-form支持多种验证方式输入级验证在Input组件上直接定义验证规则import { required, email, minLength } from ra-core; TextInput sourceemail validate{[required(), email()]} / TextInput sourcepassword validate{[required(), minLength(8)]} /表单级验证在SimpleForm上定义整体验证规则const validateUser (values) { const errors {}; if (!values.firstName) errors.firstName 名字不能为空; if (values.password ! values.confirmPassword) { errors.confirmPassword 两次密码不一致; } return errors; }; SimpleForm validate{validateUser} {/* 表单字段 */} /SimpleForm总结Shadcn Admin Kit提供了从基础到高级的完整表单解决方案TextInput满足日常文本输入需求RichTextInput则处理复杂的富文本编辑场景。配合SimpleForm容器和其他专用输入组件您可以轻松构建出功能完善、用户体验出色的管理应用表单界面。所有组件都遵循shadcn/ui的设计理念确保视觉一致性和交互体验。通过合理使用这些表单组件您可以显著提高管理应用的开发效率和质量。要开始使用Shadcn Admin Kit只需克隆仓库并按照文档进行安装git clone https://gitcode.com/gh_mirrors/sh/shadcn-admin-kit更多组件详情和高级用法请参考项目文档。【免费下载链接】shadcn-admin-kitComponent kit to build your Admin app with shadcn/ui项目地址: https://gitcode.com/gh_mirrors/sh/shadcn-admin-kit创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考