FineUI小技巧（2）将表单内全部字段禁用、只读、设置无效标识

2023-07-29 15:49:46

需求描述

对表单内的所有字段进行操作也是常见需求，这些操作有：

禁用：表单字段变灰，不响应用户动作。
只读：表单字段不变灰，但不接受用户输入（实际上是设置DOM节点的readonly属性），有触发器的要隐藏起来
设置无效标识：一般用在服务器端验证失败的提示信息

界面效果

默认状态
禁用状态
只读状态
设置无效标识状态

前台代码

前台代码非常直观，只是一个Form控件外加几个Button控件，按钮的响应事件在后台完成：

 <f:PageManager ID="PageManager1" runat="server" />

 <f:Form Width="600px" LabelWidth="100px" OffsetRight="10px" LabelSeparator="："

     BodyPadding="5px" EnableCollapse="true" ID="Form1" runat="server" Title="表单">

     <Rows>

         <f:FormRow>

             <Items>

                 <f:Label ID="Label3" Label="电话" Text="0551-1234567" runat="server" />

                 <f:Label ID="Label16" runat="server" Label="申请人" Text="admin">

                 </f:Label>

             </Items>

         </f:FormRow>

         <f:FormRow>

             <Items>

                 <f:Label ID="Label4" Label="编号" Text="200804170006" runat="server" />

                 <f:TextBox ID="TextBox2" Required="true" ShowRedStar="true" Label="电子邮箱" RegexPattern="EMAIL"

                     RegexMessage="请输入有效的邮箱地址！" runat="server">

                 </f:TextBox>

             </Items>

         </f:FormRow>

         <f:FormRow>

             <Items>

                 <f:DropDownList ID="DropDownList3" Label="审批人" runat="server" ForceSelection="false" Required="true" ShowRedStar="True">

                     <f:ListItem Text="老大甲" Value="0"></f:ListItem>

                     <f:ListItem Text="老大乙" Value="1"></f:ListItem>

                     <f:ListItem Text="老大丙" Value="2"></f:ListItem>

                 </f:DropDownList>

                 <f:NumberBox ID="NumberBox1" Label="申请数量" MaxValue="1000" Required="true" runat="server"

                     ShowRedStar="True" />

             </Items>

         </f:FormRow>

         <f:FormRow>

             <Items>

                 <f:DatePicker runat="server" Required="true" Label="日期" EmptyText="请选择日期"

                     ID="DatePicker1" SelectedDate="2014-07-10" ShowRedStar="True">

                 </f:DatePicker>

                 <f:TimePicker ID="TimePicker1" ShowRedStar="True" Label="时间" Increment="30"

                     Required="true" Text="08:30" EmptyText="请选择时间" runat="server">

                 </f:TimePicker>

             </Items>

         </f:FormRow>

         <f:FormRow>

             <Items>

                 <f:FileUpload runat="server" ID="filePhoto" EmptyText="请选择一张照片" Label="个人头像" Required="true"

                     ShowRedStar="true">

                 </f:FileUpload>

             </Items>

         </f:FormRow>

         <f:FormRow>

             <Items>

                 <f:TextArea ID="TextArea1" runat="server" Label="描述" ShowRedStar="True" Required="True">

                 </f:TextArea>

             </Items>

         </f:FormRow>

         <f:FormRow>

             <Items>

                 <f:CheckBoxList ID="CheckBoxList1" Label="复选框列表" ColumnNumber="3" runat="server">

                     <f:CheckItem Text="可选项 1" Value="value1" />

                     <f:CheckItem Text="可选项 2" Value="value2" Selected="true" />

                     <f:CheckItem Text="可选项 3" Value="value3" Selected="true" />

                     <f:CheckItem Text="可选项 4" Value="value4" Selected="true" />

                     <f:CheckItem Text="可选项 5" Value="value5" Selected="true" />

                 </f:CheckBoxList>

             </Items>

         </f:FormRow>

         <f:FormRow>

             <Items>

                 <f:RadioButtonList ID="RadioButtonList2" Label="单选框列表" ColumnNumber="3" runat="server">

                     <f:RadioItem Text="可选项 1" Value="value1" />

                     <f:RadioItem Text="可选项 2" Value="value2" />

                     <f:RadioItem Text="可选项 3" Value="value3" Selected="true" />

                     <f:RadioItem Text="可选项 4" Value="value4" />

                     <f:RadioItem Text="可选项 5" Value="value5" />

                 </f:RadioButtonList>

             </Items>

         </f:FormRow>

     </Rows>

 </f:Form>

 <br />

 <f:Button ID="btnDisableAll" Text="全部禁用" CssClass="marginr" runat="server" OnClick="btnDisableAll_Click">

 </f:Button>

 <f:Button ID="btnEnableAll" Text="全部启用" CssClass="marginr" runat="server" OnClick="btnEnableAll_Click">

 </f:Button>

 <f:Button ID="btnReadOnlyAll" Text="全部只读" CssClass="marginr" runat="server" OnClick="btnReadOnlyAll_Click">

 </f:Button>

 <f:Button ID="btnCancelReadOnlyAll" Text="取消只读" CssClass="marginr" runat="server" OnClick="btnCancelReadOnlyAll_Click">

 </f:Button>

 <br />

 <br />

 <f:Button ID="btnMarkInvalid" Text="设置无效标识" CssClass="marginr" runat="server" OnClick="btnMarkInvalid_Click">

 </f:Button>

 <f:Button ID="btnClearInvalid" Text="取消无效标识" CssClass="marginr" runat="server" OnClick="btnClearInvalid_Click">

 </f:Button>

后台代码

因为几个按钮的逻辑类似，这里我们定义一个代理（delegate），把相同的逻辑放在一个函数中完成，如下所示：

 private delegate void ProcessFormField(Field field);

 private void ResolveFormField(ProcessFormField process)

 {

     foreach (FormRow row in Form1.Rows)

     {

         foreach (Field field in row.Items)

         {

             if (field != null)

             {

                 process(field);

             }

         }

     }

 }

几个按钮的只需要调用刚刚定义的ResolveFormField函数，并传入自己的代理实现即可：

 protected void btnDisableAll_Click(object sender, EventArgs e)

 {

     ResolveFormField(delegate(Field field)

     {

         field.Enabled = false;

     });

 }

 protected void btnEnableAll_Click(object sender, EventArgs e)

 {

     ResolveFormField(delegate(Field field)

     {

         field.Enabled = true;

     });

 }

 protected void btnReadOnlyAll_Click(object sender, EventArgs e)

 {

     ResolveFormField(delegate(Field field)

     {

         if (!(field is Label))

         {

             field.Readonly = true;

         }

     });

 }

 protected void btnCancelReadOnlyAll_Click(object sender, EventArgs e)

 {

     ResolveFormField(delegate(Field field)

     {

         if (!(field is Label))

         {

             field.Readonly = false;

         }

     });

 }

 protected void btnMarkInvalid_Click(object sender, EventArgs e)

 {

     ResolveFormField(delegate(Field field)

     {

         if (!(field is Label))

         {

             field.MarkInvalid("这个字段出错了！");

         }

     });

 }

 protected void btnClearInvalid_Click(object sender, EventArgs e)

 {

     ResolveFormField(delegate(Field field)

     {

         if (!(field is Label))

         {

             field.ClearInvalid();

         }

     });

 }

本章小结

本篇文章介绍了如何对表单内全部字段进行批量操作，要注意禁用和只读的区别，虽然两种情况下表单字段都不响应用户动作，但还是有一些细微的差别，首先是颜色的变化不同，其次只读时会隐藏TriggerBox右侧的触发按钮。

后台的代码实现用到了C#代理（delegate），从JavaScript的角度看其实就是个回调函数，只不过C#的强类型限制，必须把这个回调函数抽象成一个类型而已。

专业版截图

FineUI（专业版）是由三生石上全新打造的基于 jQuery 的专业 ASP.NET 控件库，计划在七月下旬正式发布。

选择FineUI（专业版）的四大理由：
1. 简单：专业版和开源版兼容（v4.x），您现在就可以使用开源版进行开发，等正式版发布时只需替换 DLL 即可。
2. 极速：专业版基于 jQuery 库重写，使得 JS 和 CSS 体积大幅减少，页面加载速度将是开源版的 2 倍以上。
3. 多彩：专业版内置 24 种 jQueryUI 皮肤，用户还可以使用 jQueryUI ThemeRoller 创建专属自己的皮肤。
4. 便宜：专业版不限开发者数量和永久免费升级，使得典型授权案例的费用减少为开源版的 1/3 左右。

声明：