[原创]FineUI秘密花园（五） — 按钮控件

曾经最普普通通的按钮，在FineUI中摇身一变，法力无边，下面就来看看你曾经最熟悉的按钮？

 

按钮的状态与大小

按钮有启用/禁用，按下/正常几种状态，对应的属性分别为Enabled、EnablePress、Pressed三个属性。显示效果如图所示：

 

按钮有大中小三个尺寸，对应的属性为Size，显示效果如下所示：

 

按钮上的图标

按钮上的图标可以通过Icon（枚举类型，FineUI内置了很多图标）或者IconUrl两个属性来指定，图标的位置可以位于文本的上下左右四个位置，通过IconAlign属性来指定。

 

对于不显示文字的按钮，只需要指定Icon或者IconUrl属性，而不用指定Text属性即可。

 

 

按钮的点击事件

默认按钮的点击会触发一次AJAX的回发，典型的代码示例如下：

<ext:Button ID="btnServerClick" Text="服务器端事件" OnClick="btnServerClick_Click" runat="server">
</ext:Button>

protected void btnServerClick_Click(object sender, EventArgs e)
{
    // 事件处理
}

 

如果希望在客户端通过JavaScript代码来处理按钮的点击事件，需要设置EnablePostBack和OnClientClick两个属性，典型的代码如下所示：

<ext:Button ID="btnClientClick" Text="客户端事件" OnClientClick="alert('这是客户端事件');" EnablePostBack="false" runat="server">
</ext:Button>

有时，我们希望在服务器端通过C#代码注册客户端的事件脚本，典型代码如下所示：

<ext:Button ID="btnClientClick2" Text="服务器端生成的客户端事件" EnablePostBack="false" runat="server">
</ext:Button>

protected void Page_Load(object sender, EventArgs e)
{
    if (!IsPostBack)
    {
        btnClientClick2.OnClientClick = Alert.GetShowInTopReference("这是在服务器端生成的客户端事件");
    }
}

按钮点击事件的一个隐藏特性

在使用ASP.NET的按钮编程时，我们经常需要额外处理一个情况：防止按钮的重复提交！

而这个特性已经内置在FineUI的按钮中，并且公开了一个属性DisableControlBeforePostBack（默认已经启用这个功能），是不是很方便，FineUI的细腻之处很多都体现在这些非常实用的功能上，后面你会在Grid、DropDownList、Window等很多控件上看到类似的手笔。

 

FineUI是怎么做到这一点的呢？

道理也非常简单，在Web.config中打开DebugMode参数，然后查看页面的HTML源代码，你会发现如下的脚本：

在AJAX的响应正文，会再次启用这个按钮：

 

 

客户端验证表单

按钮的一个主要用途是提交表单，以前我们或许要写一堆JavaScript代码了验证每个表单控件，然后在点击按钮回发之前弹出错误提示框。在FineUI的应用场景中，我们只需要为每个控件设置验证规则，然后设置按钮需要验证哪个表单或者哪些表单，这是通过ValidateForms属性来实现的。

 

如果需要验证多个表单，只需要将这些表单的ID以逗号分隔的形式设置到ValidateForms属性即可。可以查看这个示例页面。

<ext:Button ID="btnSubmitAll" Text="验证两个表单并提交" runat="server" OnClick="btnSubmitAll_Click" ValidateForms="extForm1,extForm2" />

在客户端验证失败时，会显示如下的提示框，并阻止本次表单提交：

 

如果你采用类似示例站点的IFrame框架结构，一定不要错过另一个属性ValidateTarget，它指定了错误提示框显示的位置，可以是本页面也可以是父页面。

 

带有菜单的按钮

按钮也可以拥有自己的菜单，这个示例的效果图如下所示：

ASPX页面的标签也非常干净利落:

<ext:Button ID="btnMenu" Text="中国科学技术大学" EnablePostBack="false" runat="server">
    <Menu>
        <ext:MenuHyperLink runat="server" Icon="TagGreen" Target="_blank" NavigateUrl="http://scms.ustc.edu.cn/"
            Text="化学与材料科学学院">
        </ext:MenuHyperLink>
        <ext:MenuHyperLink runat="server" Icon="TagBlue" Target="_blank" NavigateUrl="http://business.ustc.edu.cn/zh_CN/"
            Text="管理学院">
            <Menu>
                <ext:MenuHyperLink runat="server" Icon="TagPink" Target="_blank" NavigateUrl="http://is.ustc.edu.cn/"
                    Text="工商管理系">
                </ext:MenuHyperLink>
                <ext:MenuHyperLink runat="server" Icon="TagPurple" Target="_blank" NavigateUrl="http://stat.ustc.edu.cn/"
                    Text="统计与金融系">
                </ext:MenuHyperLink>
            </Menu>
        </ext:MenuHyperLink>
    </Menu>
</ext:Button>

 

工具栏中的按钮

按钮不仅可以单独使用，在表单中作为提交按钮，当放在工具栏中时，它摇身一变成了一个工具栏项。这样我们不仅可以设置按钮工具栏项的状态、添加点击事件、验证表单，而且还可以添加菜单，如下所示：

 

ASPX页面标签如下：

<ext:Panel ShowBorder="true" BodyPadding="5px" Height="300px" Width="450px" ShowHeader="false"
    runat="server">
    <Toolbars>
        <ext:Toolbar runat="server">
            <Items>
                <ext:ToolbarText runat="server" Text="内联项：">
                </ext:ToolbarText>
                <ext:ToolbarSeparator runat="server">
                </ext:ToolbarSeparator>
                <ext:Button EnablePostBack="false" Text="中国科学技术大学" runat="server">
                    <Menu>
                        <ext:MenuHyperLink runat="server" Target="_blank" NavigateUrl="http://scms.ustc.edu.cn/"
                            Text="化学与材料科学学院">
                        </ext:MenuHyperLink>
                        <ext:MenuHyperLink runat="server" Target="_blank" NavigateUrl="http://business.ustc.edu.cn/zh_CN/"
                            Text="管理学院">
                            <Menu>
                                <ext:MenuHyperLink runat="server" Target="_blank" NavigateUrl="http://is.ustc.edu.cn/"
                                    Text="工商管理系">
                                </ext:MenuHyperLink>
                                <ext:MenuHyperLink runat="server" Target="_blank" NavigateUrl="http://stat.ustc.edu.cn/"
                                    Text="统计与金融系">
                                </ext:MenuHyperLink>
                            </Menu>
                        </ext:MenuHyperLink>
                    </Menu>
                </ext:Button>
            </Items>
        </ext:Toolbar>
    </Toolbars>
</ext:Panel>

 

点击按钮前的确认对话框

如果我们希望在点击按钮的时候首先弹出确认对话框（类似于JavaScript的window.confirm），在征得用户的同意后再触发按钮的默认行为，该怎么办？

FineUI也考虑到了这种需求，特意提供了如下几个属性：ConfirmText/ConfirmTitle/ConfirmIcon/ConfirmTarget

 

一个典型的应用是在数据展示表格的工具栏中，放置一个写着“删除选中项”的按钮，用来删除表格中选中的项。为了防止用户误操作，我们一般需要首先提醒用户这个操作是不可恢复的操作，是否确认删除。此时按钮的这些属性就派上用场了，请看这个示例。

 

 

 

小结

这一篇文章没有涉及很多应用技巧，不过介绍的知识都很实用，如果你打算或者正在使用FineUI，一定不要错过按钮的这些功能。

下一篇文章我们会对FineUI中基本的表单控件进行简单的学习。

 

 

注：《FineUI秘密花园》系列文章由三生石上原创，博客园首发，转载请注明出处。文章目录 官方论坛