标记库 tag-libraries

通过Granite、CQ和Sling标记库，可访问在模板和组件的JSP脚本中使用的特定函数。

Granite标记库 granite-tag-library

Granite标记库包含有用的函数。

在开发Granite UI组件的jsp脚本时，建议在脚本顶部包含以下代码：

<%@include file="/libs/granite/ui/global.jsp"%>

全球还声明 Sling库.

<%@taglib prefix="sling" uri="https://sling.apache.org/taglibs/sling" %>

<ui:includeClientLib> ui-includeclientlib

此 <ui:includeClientLib> 标记包含AEM html客户端库，该库可以是js、css或主题库。 对于不同类型的多个包含项（例如js和css），必须在jsp中多次使用此标记。 此标记是一个方便的包装工具，可方便您识别 [com.adobe.granite.ui.clientlibs.HtmlLibraryManager](https://helpx.adobe.com/experience-manager/6-5/sites/developing/using/reference-materials/javadoc/com/adobe/granite/ui/clientlibs/HtmlLibraryManager.html) 服务接口。

它具有以下属性：

类别 — 逗号分隔的客户端库类别的列表。 这包括给定类别的所有JavaScript和CSS库。 将从请求中提取主题名称。

等同于： com.adobe.granite.ui.clientlibs.HtmlLibraryManager#writeIncludes

主题 — 逗号分隔的客户端库类别的列表。 这包括给定类别的所有与主题相关的库（CSS和JS）。 将从请求中提取主题名称。

等同于： com.adobe.granite.ui.clientlibs.HtmlLibraryManager#writeThemeInclude

js — 逗号分隔的客户端库类别的列表。 其中包括给定类别的所有JavaScript库。

等同于： com.adobe.granite.ui.clientlibs.HtmlLibraryManager#writeJsInclude

css — 逗号分隔的客户端库类别的列表。 这包括给定类别的所有CSS库。

等同于： com.adobe.granite.ui.clientlibs.HtmlLibraryManager#writeCssInclude

主题 — 只应包含指示主题库或非主题库的标志。 如果省略，则包含两个集。 仅适用于纯JS或CSS includes（不适用于类别或主题包含）。

此 <ui:includeClientLib> 标记可以在jsp中按以下方式使用：

<%-- all: js + theme (theme-js + css) --%>
<ui:includeClientLib categories="cq.wcm.edit" />

<%-- only js libs --%>
<ui:includeClientLib js="cq.collab.calendar, cq.security" />

<%-- theme only (theme-js + css) --%>
<ui:includeClientLib theme="cq.collab.calendar, cq.security" />

<%-- css only --%>
<ui:includeClientLib css="cq.collab.calendar, cq.security" />

CQ标记库 cq-tag-library

CQ标记库包含有用的函数。

要在脚本中使用CQ标记库，脚本必须以以下代码开头：

<%@taglib prefix="cq" uri="https://www.day.com/taglibs/cq/1.0" %>

在开发AEM组件的jsp脚本时，建议在脚本顶部包含以下代码：

<%@include file="/libs/foundation/global.jsp"%>

它声明sling、CQ和jstl taglibs，并公开由定义的常规使用的脚本对象。 <cq:defineObjects /> 标记之前。 这会缩短并简化组件的jsp代码。

<cq:text> cq-text

此 <cq:text> 标记是在JSP中输出组件文本的方便标记。

它具有以下可选属性：

属性 — 要使用的属性的名称。 该名称相对于当前资源。

值 — 用于输出的值。 如果此属性存在，则会覆盖属性属性的使用。

oldValue — 用于比较输出的值。 如果此属性存在，则会覆盖属性属性的使用。

escapeXml — 定义是否应将结果字符串中的<、>、&、'和'字符转换为相应的字符实体代码。 默认值为false。 转义在可选格式设置之后应用。

格式 — 用于设置文本格式的可选java.text.Format。

noDiff — 隐藏差异输出的计算，即使存在差异信息也是如此。

标记类 — 将包围非空输出的元素的CSS类名称。 如果为空，则不会添加任何元素。

tagName — 将包含非空输出的元素的名称。 默认为DIV。

占位符 — 在编辑模式下用于null或空文本的默认值，即占位符。 默认检查在可选格式化和转义之后执行，即按原样写入输出。 默认为：

<div><span class="cq-text-placeholder">&para;</span></div>

默认 — 用于Null或空文本的默认值。 默认检查在可选格式化和转义之后执行，即按原样写入输出。

以下示例介绍了 <cq:text> 标记可以在JSP中使用：

<cq:text property="jcr:title" tagName="h2"/>
<cq:text property="jcr:description" tagName="p"/>

<cq:text value="<%= listItem.getTitle() %>" tagName="h4" placeholder="" />
<cq:text value="<%= listItem.getDescription() %>" tagName="p" placeholder=""/>

<cq:text property="jcr:title" value="<%= title %>" tagName="h3"/><%
    } else if (type.equals("link")) {
        %><cq:text property="jcr:title" value="<%= "\u00bb " + title %>" tagName="p" tagClass="link"/><%
    } else if (type.equals("extralarge")) {
        %><cq:text property="jcr:title" value="<%= title %>" tagName="h1"/><%
    } else {
        %><cq:text property="jcr:title" value="<%= title %>" tagName="h2"/><%

<cq:text property="jcr:description" placeholder="" tagName="small"/>

<cq:text property="tableData"
               escapeXml="false"
               placeholder="<img src=\"/libs/cq/ui/resources/0.gif\" class=\"cq-table-placeholder\" alt=\"\">"
    />

<cq:text property="text"/>

<cq:text property="image/jcr:description" placeholder="" tagName="small"/>
<cq:text property="text" tagClass="text"/>

<cq:setContentBundle> cq-setcontentbundle

此 <cq:setContentBundle> 标记会创建i18n本地化上下文并将其存储在 javax.servlet.jsp.jstl.fmt.localizationContext 配置变量。

它具有以下属性：

语言 — 要检索资源包的区域设置的语言。

源 — 应从中获取区域设置的源。 可以将其设置为以下值之一：

如果 source 属性未设置：

“内容包”可供标准JSTL使用 <fmt:message> 标记之间。 按键查找消息是双重的：

此 <cq:setContentBundle> 标记可以如下在jsp中使用。

对于定义其语言的页面：

... %><cq:setContentBundle source="page"/><%  %>
<div class="error"><fmt:message key="Hello"/>
</div> ...

对于用户个性化页面：

... %><cq:setContentBundle scope="request"/><% %>
<div class="error"><fmt:message key="Hello"/>
</div> ...

<cq:include> cq-include

此 <cq:include> 标记包含进入当前页面的资源。

它具有以下属性：

刷新

path

resourceType

脚本

ignoreComponentHierarchy

示例：

<%@taglib prefix="cq" uri="https://www.day.com/taglibs/cq/1.0" %><%
%><div class="center">
    <cq:include path="trail" resourceType="foundation/components/breadcrumb" />
    <cq:include path="title" resourceType="foundation/components/title" />
    <cq:include script="redirect.jsp"/>
    <cq:include path="par" resourceType="foundation/components/parsys" />
</div>

是否应该使用 <%@ include file="myScript.jsp" %> 或 <cq:include script="myScript.jsp" %> 是否包含脚本？

是否应该使用 <cq:include> 或 <sling:include>？

<cq:includeClientLib> cq-includeclientlib

此 <cq:includeClientLib> 标记包含AEM html客户端库，该库可以是js、css或主题库。 对于不同类型的多个包含项（例如js和css），必须在jsp中多次使用此标记。 此标记是一个方便的包装工具，可方便您识别 com.day.cq.widget.HtmlLibraryManager 服务接口。

它具有以下属性：

类别 — 逗号分隔的客户端库类别的列表。 这包括给定类别的所有JavaScript和CSS库。 将从请求中提取主题名称。

等同于： com.day.cq.widget.HtmlLibraryManager#writeIncludes

主题 — 逗号分隔的客户端库类别的列表。 这包括给定类别的所有与主题相关的库（CSS和JS）。 将从请求中提取主题名称。

等同于： com.day.cq.widget.HtmlLibraryManager#writeThemeInclude

js — 逗号分隔的客户端库类别的列表。 其中包括给定类别的所有JavaScript库。

等同于： com.day.cq.widget.HtmlLibraryManager#writeJsInclude

css — 逗号分隔的客户端库类别的列表。 这包括给定类别的所有CSS库。

等同于： com.day.cq.widget.HtmlLibraryManager#writeCssInclude

主题 — 只应包含指示主题库或非主题库的标志。 如果省略，则包含两个集。 仅适用于纯JS或CSS includes（不适用于类别或主题包含）。

此 <cq:includeClientLib> 标记可以在jsp中按以下方式使用：

<%-- all: js + theme (theme-js + css) --%>
<cq:includeClientLib categories="cq.wcm.edit" />

<%-- only js libs --%>
<cq:includeClientLib js="cq.collab.calendar, cq.security" />

<%-- theme only (theme-js + css) --%>
<cq:includeClientLib theme="cq.collab.calendar, cq.security" />

<%-- css only --%>
<cq:includeClientLib css="cq.collab.calendar, cq.security" />

<cq:defineObjects> cq-defineobjects

此 <cq:defineObjects> 标记公开以下定期使用的脚本对象，开发人员可以引用这些对象。 它还会公开由定义的对象 <sling:defineObjects> 标记之前。

componentContext

组件

currentdesign

当前页面

当前样式

设计者

editContext

pageManager

pageProperties

属性

resourceDesign

resourcePage

请求名称

responseName

resourceName

nodeName

logName

resourceResolverName

slingName

componentContextname

editContextname

propertiesName

pageManagerName

currentPagename

resourcePageName

pagePropertiesName

组件名称

designerName

currentDesignName

resourceDesignName

currentStyleName

示例

<%@page session="false" contentType="text/html; charset=utf-8" %><%
%><%@ page import="com.day.cq.wcm.api.WCMMode" %><%
%><%@taglib prefix="cq" uri="https://www.day.com/taglibs/cq/1.0" %><%
%><cq:defineObjects/>

<cq:requestURL> cq-requesturl

此 <cq:requestURL> 标记将当前请求URL写入JspWriter。 两个标记 <cq:addParam> 和 <cq:removeParam> 并可用于此标记的正文中，以在写入当前请求URL之前对其进行修改。

利用该区域，可使用各种参数创建指向当前页面的链接。 例如，它使您能够转换请求：

mypage.html?mode=view&query=something 到 mypage.html?query=something.

使用 addParam 或 removeParam 仅更改给定参数的出现次数，所有其他参数不受影响。

<cq:requestURL> 没有任何属性。

示例：

<a href="<cq:requestURL><cq:removeParam name="language"/></cq:requestURL>">remove filter</a>

<a title="filter results" href="<cq:requestURL><cq:addParam name="language" value="${bucket.value}"/></cq:requestURL>">${label} (${bucket.count})</a>

<cq:addParam> cq-addparam

此 <cq:addParam> 标记会将具有给定名称和值的请求参数添加到结尾处 <cq:requestURL> 标记之前。

它具有以下属性：

name

值

示例：

<a title="filter results" href="<cq:requestURL><cq:addParam name="language" value="${bucket.value}"/></cq:requestURL>">${label} (${bucket.count})</a>

<cq:removeParam> cq-removeparam

此 <cq:removeParam> 标记会从结尾删除具有给定名称和值的请求参数 <cq:requestURL> 标记之前。 如果未提供任何值，则删除具有给定名称的所有参数。

它具有以下属性：

name

示例：

<a href="<cq:requestURL><cq:removeParam name="language"/></cq:requestURL>">remove filter</a>

Sling标记库 sling-tag-library

Sling标记库包含有用的Sling函数。

在脚本中使用Sling标记库时，脚本必须以下列代码开头：

<%@ taglib prefix="sling" uri="https://sling.apache.org/taglibs/sling/1.0" %>

<sling:include> sling-include

此 <sling:include> 标记包含进入当前页面的资源。

它具有以下属性：

刷新

资源

path

resourceType

replaceSelectors

addSelectors

replaceSuffix

示例：

<div class="item"><sling:include path="<%= pathtoinclude %>"/></div>

<sling:include resource="<%= par %>"/>

<sling:include addSelectors="spool"/>

<sling:include resource="<%= par %>" resourceType="<%= newType %>"/>

<sling:include resource="<%= par %>" resourceType="<%= newType %>"/>

<sling:include replaceSelectors="content" />

<sling:defineObjects> sling-defineobjects

此 <sling:defineObjects> 标记公开以下定期使用的脚本对象，开发人员可以引用这些对象：

slingRequest

slingResponse

resourceResolver

。sling

资源

当前节点

log

请求名称

responseName

nodeName

l ogName资源解析程序名称

slingName

示例：

<%@page session="false" %><%
%><%@page import="com.day.cq.wcm.foundation.forms.ValidationHelper"%><%
%><%@taglib prefix="sling" uri="https://sling.apache.org/taglibs/sling/1.0" %><%
%><sling:defineObjects/>

JSTL标记库 jstl-tag-library

此 JavaServer Pages标准标记库 包含许多有用的标准标记。 核心、格式和函数taglibs由 /libs/foundation/global.jsp 如以下代码片段所示。

/libs/foundation/global.jsp的提取 extract-of-libs-foundation-global-jsp

<%@taglib prefix="c" uri="https://java.sun.com/jsp/jstl/core" %>
<%@taglib prefix="fmt" uri="https://java.sun.com/jsp/jstl/fmt" %>
<%@taglib prefix="fn" uri="https://java.sun.com/jsp/jstl/functions" %>

导入后 /libs/foundation/global.jsp 文件（如前所述），您可以使用 c， fmt 和 fn 用于访问这些taglib的前缀。 JSTL的官方文档位于 Java™ EE 5教程 — JavaServer Pages标准标记库.