用途:帮助开发者使用 FineUI 的表单能力,搭建录入/编辑表单。涵盖 Form / SimpleForm 容器、基础字段(TextBox、TextArea、NumberBox、DatePicker、DropDownList、CheckBox、RadioButtonList、CheckBoxList、TimePicker、Label、Hidden)、高级字段(FileUpload、TriggerBox、DropDownBox、HtmlEditor)以及 Calendar 内嵌日历。
主要能力:配置字段、标签、必填红星、单列/多列布局;字段校验(必填、正则、比较、自定义)与整表提交校验;读取与回填字段值;用 Calendar 选择日期、日期范围、月份、年份或时间。参考文件分为 form-layout.md、fields.md、advanced-fields.md、calendar.md、validation.md,可按需查阅。
使用方式:先判定写法,再决定单列还是多列。单列用 SimpleForm(C# 字段直接放 Items),F.js 用 Form + layout:'anchor';多列用 Form(C# 需 Rows/FormRow/ColumnWidths),F.js 用嵌套 Panel layout:'column' + columnWidth。各写法大小写约定不同:F.js 用 fieldLabel/required,C# 用 Label/Required,FineUI.Java 用 label/required(属性值仍 PascalCase)。必填红星需 Required 配 ShowRedStar 才显示。整表校验设在提交按钮上,如 ValidateForms="表单ID",TagHelper 用 _ValidateForms,FineUI.Java 直接写 validate-forms 并逗号分隔多表单,不设在 Form 容器上。读值方式随写法不同:Pro/Core-RazorForms 用控件字段,Core-MVC/RazorPages 用回发参数或 UIHelper,FineUI.Java 用 getter/setter。
适用场景:FineUI 项目的表单录入与编辑、字段校验、日期时间选择。
限制:须先确定写法且不混用;Form 的字段必须包在 Rows/FormRow/Items 中;Calendar 与 DatePicker 不同,Calendar 直接显示面板,写值依据 references/calendar.md;官方 API 文档地址见资料。其他功能、收费与平台信息暂未提供。