FineUI小技巧(2)将表单内全部字段禁用、只读、设置无效标识(另附48张专业版高清大图)
FineUI小技巧(2)将表单内全部字段禁用、只读、设置无效标识(另附48张专业版高清大图)
三生石上 发表于3年前
FineUI小技巧(2)将表单内全部字段禁用、只读、设置无效标识(另附48张专业版高清大图)
  • 发表于 3年前
  • 阅读 301
  • 收藏 1
  • 点赞 0
  • 评论 1

需求描述

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

  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(开源版)中,因此在线示例还不可见,需要的同学请自行下载全部源代码,自己运行。 


共有 人打赏支持
三生石上
粉丝 44
博文 21
码字总数 42096
作品 4
评论 (1)
binfenworld
辛苦了
×
三生石上
如果觉得我的文章对您有用,请随意打赏。您的支持将鼓励我继续创作!
* 金额(元)
¥1 ¥5 ¥10 ¥20 其他金额
打赏人
留言
* 支付类型
微信扫码支付
打赏金额:
已支付成功
打赏金额: