coldfusion - 使用自定义标签来避免 CFM 文件与大量 HTML 标记混合？

Question

您在使用 View 的自定义标记来提高可维护性方面是否取得过成功？

使用自定义标签是否比使用基本标签有任何好处 <cfinclude> ？

您之前编写过任何可以提高 HTML 可维护性的自定义标记吗？

谢谢

Answer 1

是的，是的。

自定义标签非常适合分离可重用的 HTML 元素。优点是它们是范围安全的，并且您可以将参数传递给它们来更改它们的行为，而 cfinclude 则无法做到这一点。您甚至可以创建嵌套标签，根据其父项更改其行为。我在 ColdFusion 中的大多数 HTML 布局看起来都是这样的:

<cf_layout>
    <cf_head title="My Page>
    <!--- Some local head stuff ---->
    </cf_head>

    <cf_content>
        Lots of stuff goes here.
    </cf_content>
</cf_layout>

这显然大大简化了，但我可以通过更改自定义标记甚至更改自定义标记文件夹来更改网站的整个布局(考虑动态 this.customTagPaths 来交换布局。

自定义标签没有得到足够的喜爱。拥抱它们，享受吧:)。

这是我所做的另一个例子:

<cfset arOrders = OrderService.getOrders() />

<table>
    <cfloop array="#arOrders#" index="currentOrder">
        <cf_orderrow order="#currentOrder#" />
    </cfloop>
</table>

我的 OrderRow 自定义标记处理用于在表中显示订单行的所有显示。这包括添加/编辑/删除按钮、必须发生的计算、我必须改变显示的条件。我可以在管理区域中的任何位置显示订单行。在客户详情页面，显示某个时间段内所有订单的页面。没什么区别。我的用户知道，他们在任何地方看到描述订单的行，它看起来都会像他们期望的那样。

以下是我在多个应用程序中使用的小型自定义标签的一些更具体的示例。

cf_jquery

这包括页面中的 jQuery 和 jQueryUI，但前提是应用程序中没有其他模板已在此请求中添加 jQuery。这允许我在一个页面中构建多个 jQuery 部分，无论我以什么顺序调用它们，我总是知道 jQuery 只被添加到文档的头部一次。

<cfif thisTag.ExecutionMode EQ "end" AND (NOT StructKeyExists(Request, "JQueryInited") OR Request.JQueryInited EQ False)>
    <cfparam name="Attributes.IncludeUI" default="False" />
    <cfparam name="Request.jQueryUIInited" default="False" />
    <script type="text/javascript" src="//ajax.googleapis.com/ajax/libs/jquery/1.5.1/jquery.min.js"></script>
    <cfif Attributes.IncludeUI AND Request.jQueryUIInited IS False>
        <link href="/shared/css/smoothness/jquery-ui-1.8.11.custom.css" rel="stylesheet" />
        <script type="text/javascript" src="//ajax.googleapis.com/ajax/libs/jqueryui/1.8.11/jquery-ui.min.js"></script>
        <cfset Request.jQueryUIInited = True />
    </cfif>
    <cfset Request.JQueryInited = True />
</cfif>

我什至为小信息构建标签，我知道这些信息将在整个应用程序的多个位置使用，例如这个 cf_contact 标签:

<cfif thisTag.ExecutionMode EQ "end">
    <cfparam name="Attributes.Phone" default="xxx.xxx.xxxx" />
    <cfparam name="Attributes.Email" default="me@you.com" />
    <cfparam name="Attributes.EmailName" default="Email Support" />
    <h2 style="font: bold 12px Verdana, Geneva, Arial, Helvetica, sans-serif; margin-bottom: 0;">Contact Us</h2>
    <p style="text-align: left; margin-top: 0;"><cfoutput>#Attributes.Phone#</cfoutput><br />
    <cfoutput><a href="mailto:#Attributes.Email#">#Attributes.EmailName#</a></cfoutput></p>
</cfif>

为什么要为这么小的东西制作标签？为什么不？如果我在整个应用程序中将所有联系信息设置为相同的样式(我应该如此，以便用户可以轻松识别事物)，那么我可以为它创建一个标签，就像我可以创建一个包含一样轻松。如果我决定希望在那里发生一些其他编程行为，我的应用程序已经设置为使用它。

cf_timeblock

此自定义标记显示一组用于选择时间 block (hh:mm tt) 的选择列表。我在处理调度的应用程序中使用它，所以我有一个标签，可以让我显示一个 block 一段时间，并且我可以发送应预先选择的值(我缺少对属性的验证，但就假装它现在就在那里):

<cfif thisTag.ExecutionMode EQ "end">
    <cfsilent>
        <!--- Get Time Blocks --->
        <cfset TimeBlocks = Application.DAO.getTimeQueries() />
    </cfsilent>
    <select name="hour" style="width: auto; float: none;">
        <cfoutput query="TimeBlocks.Hours">
            <option value="#TimeBlocks.Hours.Value#"<cfif TimeBlocks.Hours.Value EQ Attributes.Hour> selected="selected"</cfif>>
                #TimeBlocks.Hours.Value#
            </option>
        </cfoutput>
    </select>:<select name="min" style="width: auto; float: none;">
        <cfoutput query="TimeBlocks.Mins">
            <option value="#TimeBlocks.Mins.Value#"<cfif TimeBlocks.Mins.Value EQ Attributes.Min> selected="selected"</cfif>>
                #TimeBlocks.Mins.Value#
            </option>
        </cfoutput>
    </select>
    <select name="mer" style="width: auto; float: none;">
        <cfoutput query="TimeBlocks.Mer">
            <option value="#TimeBlocks.Mer.Value#"<cfif TimeBlocks.Mer.Value EQ FORM.mer> selected="selected"</cfif>>
                #TimeBlocks.Mer.Value#
            </option>
        </cfoutput>
    </select>
</cfif>

我使用的比这多，但它们都是非常特定于应用程序/对象的。几乎每次我开始将某些内容提取到包含中，或者如果我发现自己将一段显示逻辑从一个页面复制到另一个页面，我就会开始考虑如何将该代码推送到自定义标记中。

这里还有一些我认为有用的自定义标签库示例。

• cfUniform
• Ben Nadel's POI Custom Tags