OneCode FormField 基础表单字段 功能说明

一、基础表单组件

组件名称	功能说明
CustomFormComponent	基础表单布局组件，负责表单数据的加载、绑定、校验和提交，支持自定义布局和事件处理
CustomMFormComponent	主从表单组件，支持主子表数据结构，实现主表与子表数据的联动加载、保存和校验
TableFormComponent	表格表单组件，基于数据库表元数据动态生成表单，支持字段权限控制和动态列显示
FormLayoutModule	表单布局管理器，根据FormAnnotation配置渲染表单布局，支持行列布局、栅格布局和卡片布局
MFormLayoutModule	主从表单布局管理器，处理主从表单的嵌套布局，支持子表动态增删行和数据联动
CustomFormDataBean	表单数据载体，封装表单字段值和校验状态，提供数据访问和修改的统一接口
CustomFormButton	表单按钮组件，支持按钮权限控制、状态切换和点击事件绑定
CustomFormViewBean	表单视图配置，定义表单字段的显示方式、布局和交互行为

二、核心字段组件

2.1 输入类组件

组件名称	功能说明
InputFieldBean	单行文本输入框，支持文本类型限制（文本/数字/邮箱等）、长度限制和实时校验
TextEditorFieldBean	多行文本编辑器，支持换行、字数统计和基础文本格式化
RichEditorFieldBean	富文本编辑器，支持图文混排、表格插入、公式编辑和HTML源码编辑
CodeEditorFieldBean	代码编辑器，支持语法高亮、代码折叠、行号显示和基础代码提示
JavaEditorFieldBean	Java代码编辑器，集成编译检查、语法提示和代码格式化功能
HiddenInputFieldBean	隐藏输入框，用于存储页面级临时数据或传递后端参数，不显示在UI中

2.2 选择类组件

组件名称	功能说明
CheckBoxFieldBean	复选框组件，支持多选、默认值设置和全选/取消全选功能，值以数组形式返回
RadioBoxFieldBean	单选框组件，支持横向/纵向排列，支持图标和文本组合展示
ComboInputFieldBean	下拉输入框，支持模糊搜索、远程数据加载和自定义模板渲染，兼具输入和选择功能
ComboxFieldBean	标准下拉框，支持静态数据加载和本地过滤，适用于选项较少的场景
SimpleComboBean	轻量级下拉组件，简化版下拉选择器，适用于简单选项列表和性能敏感场景

2.3 日期时间类组件

组件名称	功能说明
DatePickerFieldBean	日期选择器，支持日期范围选择、快捷日期（今天/昨天等）和自定义日期格式化
TimePickerFieldBean	时间选择器，支持小时/分钟/秒级选择，支持12小时/24小时制切换
TimerFieldBean	计时器组件，支持倒计时和正计时功能，可配置时间格式和回调事件
ComboDateFieldBean	高级日期组合组件，支持日期联动（如开始日期<=结束日期）和日期范围预设

2.4 特殊输入类组件

组件名称	功能说明
ColorPickerFieldBean	颜色选择器，支持RGB、HSB和十六进制格式，提供颜色面板和自定义颜色输入
SliderFieldBean	滑块组件，支持单滑块/双滑块模式，可配置步长、范围和刻度显示
ProgressBarFieldBean	进度条组件，展示任务完成度，支持线性/环形进度展示和动画效果
LabelBean	标签组件，用于静态文本展示，支持文本样式自定义和国际化
SpanFieldBean	内联文本组件，用于文本与其他组件的混合排版，支持样式继承
TipsBean	提示信息组件，支持悬浮展示详细说明，可配置提示位置、触发方式和样式

三、高级组合组件

3.1 复合输入组件

组件名称	功能说明
CustomComboBoxComponent	高级下拉组合框，支持自定义下拉面板内容，可嵌入表格、树形等复杂组件
CustomComboLabelComponent	标签式组合组件，支持多选标签创建和删除，适用于标签编辑场景
CustomComboListComponent	列表式组合组件，支持分页加载和虚拟滚动，适用于大数据量选择场景
CustomComboNumberComponent	数字组合组件，支持数字输入、范围选择和单位显示，内置数字格式化
CustomComboPopComponent	弹窗式组合组件，点击触发弹窗选择，支持复杂选择逻辑和多步骤选择
CustomComboRichEditorComponent	富文本组合组件，支持模板插入和内容片段复用，提升富文本编辑效率

3.2 列表与树组件

组件名称	功能说明
ListFieldBean	基础列表组件，支持简单数据展示和行样式自定义，适用于静态列表展示
CustomListBean	自定义列表组件，支持复杂列表布局、行操作和数据联动，可高度定制
PopTreeDataBean	树形选择弹窗组件，支持树形结构数据展示和选择，支持异步加载子节点
PopTreeViewBean	树形展示组件，支持节点展开/折叠、勾选和右键菜单操作
TreeDataBaseBean	树形数据基础组件，处理层级数据结构，提供树形数据操作的基础方法

四、媒体与展示组件

组件名称	功能说明
CustomImageComponent	图片展示组件，支持图片预览、缩放、旋转和下载，支持懒加载和错误占位
CustomAudioComponent	音频播放组件，支持播放/暂停、进度控制、音量调节和播放速度设置
CustomVideoComponent	视频播放组件，支持全屏、画质切换、播放速度和字幕显示
CustomCameraComponent	摄像头组件，支持拍照和录像功能，可配置分辨率和图片质量
CustomFlashComponent	Flash组件，支持传统Flash内容展示，提供Flash参数配置接口
CustomIconComponent	图标组件，支持FontAwesome图标库，支持图标大小、颜色和旋转等样式设置

五、布局与容器组件

组件名称	功能说明
CustomDivComponent	基础容器组件，用于页面布局划分，支持样式自定义和响应式布局
CustomBlockComponent	块级容器组件，支持标题、操作区和内容区的标准布局，常用于功能模块封装
CustomFieldGridComponent	网格布局组件，支持响应式栅格系统，可配置列数和间距
CustomFieldGroupComponent	字段组组件，用于相关字段归类展示，支持折叠/展开和标题设置
CustomFieldTabsComponent	标签页组件，支持多标签页内容切换，支持标签位置和样式自定义
CustomFieldFoldingTabsComponent	折叠标签组件，支持标签页折叠，节省页面空间，适用于多标签场景
CustomFieldStacksComponent	堆叠布局组件，支持组件层叠展示，可配置堆叠方向和对齐方式
CustomFieldPanelComponent	面板组件，支持边框、阴影和背景样式，用于内容区域划分和强调

六、SVG图形组件

6.1 基础图形

组件名称	功能说明
CustomSVGCircleComponent	圆形组件，支持动态半径调整、填充色和边框样式设置
CustomSVGRectComponent	矩形组件，支持圆角、宽高比和背景渐变设置
CustomSVGEllipseComponent	椭圆组件，支持拉伸、旋转和动画效果
CustomSVGPathComponent	路径组件，支持自定义路径绘制和路径动画
CustomSVGTextComponent	文本组件，支持文本曲线排列和字体样式自定义
CustomSVGImageComponent	SVG图像组件，嵌入外部SVG资源，支持缩放和颜色替换
CustomSVGGroupComponent	组合组件，管理多个SVG图形元素，支持整体变换
CustomSVGConnectorComponent	连接线组件，用于流程图节点连接，支持折线和曲线连接

6.2 组合图形

组件名称	功能说明
CustomSVGCircleCombComponent	圆形组合组件，支持批量绘制圆形并设置布局方式
CustomSVGRectCombComponent	矩形组合组件，支持网格排列矩形并设置间距和大小
CustomSVGEllipseCombComponent	椭圆组合组件，支持环形布局和放射状布局
CustomSVGPathCombComponent	路径组合组件，支持路径动画序列和路径集合管理
CustomSVGImageCombComponent	图像组合组件，支持画廊布局和图片墙效果

七、业务功能组件

组件名称	功能说明
CustomButtonComponent	自定义按钮组件，支持图标、加载状态和多种样式变体，支持权限控制
CustomFieldButtonViewsComponent	按钮组组件，支持批量操作按钮展示，可折叠多余按钮
CustomStatusButtonsComponent	状态按钮组件，支持状态切换和联动，常用于审批状态等场景
CustomHTMLButtonComponent	HTML按钮组件，支持自定义HTML内容，用于复杂按钮样式实现
CustomFileUploadComponent	文件上传组件，支持拖拽上传、多文件上传和断点续传，支持文件类型限制
CustomModuleRefComponent	模块引用组件，支持跨模块集成，实现模块间数据交互和页面跳转
CustomModuleInnerComponent	内部模块组件，支持模块内功能复用，减少代码冗余
CustomAPICallComponent	API调用组件，支持RESTful接口集成，简化前后端数据交互

八、图表与数据可视化

组件名称	功能说明
CustomFieldEChartComponent	ECharts图表组件，支持折线图、柱状图、饼图等多种图表类型，支持动态数据更新
CustomFieldFChartComponent	基础图表组件，轻量级数据展示，适用于简单数据可视化场景
CustomFieldGalleryComponent	图片画廊组件，支持缩略图预览和大图查看，支持图片懒加载
CustomTensorComponent	张量可视化组件，支持多维数据展示，适用于科学计算和AI模型可视化

组件命名规范说明

1. 基础字段组件：以FieldBean结尾（如InputFieldBean），表示基础输入字段
2. 复杂组件：以Component结尾（如CustomButtonComponent），表示复杂交互组件
3. 组合组件：以Combo为前缀（如CustomComboInputComponent），表示组合多个基础组件
4. SVG组件：以SVG为前缀（如CustomSVGCircleComponent），表示SVG图形组件
5. 表单相关组件：以Form为前缀（如FormLayoutModule），表示表单布局或管理组件

所有组件均遵循OneCode的注解驱动设计，通过@AnnotationType与对应注解类绑定，由WidgetConfigFactory统一管理组件映射关系，实现灵活的组件扩展和复用。