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

需求描述

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

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

界面效果

1. 默认状态
   
2. 禁用状态
   
3. 只读状态
   
4. 设置无效标识状态
   

前台代码

前台代码非常直观，只是一个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 左右。

声明：

1. FineUI（专业版）授权协议是商业授权，需购买使用。
2. FineUI（开源版）授权协议是Apache License v2.0，免费下载使用，并且会继续维护和开发，个人用户推荐使用开源版。

源代码与在线示例

本系列所有文章的源代码均可自行下载：http://fineui.codeplex.com/

在线示例（暂时不可用）：http://fineui.com/demo/#/demo/form/form_disabled.aspx

这个示例会添加到下个版本的FineUI（开源版）中，因此在线示例还不可见，需要的同学请自行下载全部源代码，自己运行。

如果本文对你有所启发或者帮助，请猛击“好文要顶”，支持原创，支持三石！

《FineUI小技巧》系列文章目录