标记库 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-4/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包含项（不适用于类别或主题包含项）。

的 <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 — 禁止计算差异输出，即使存在差异信息也是如此。

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

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

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

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

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

一些示例 <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> 标记将资源包含到当前页面中。

它具有以下属性：

刷新

路径

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包含项（不适用于类别或主题包含项）。

的 <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

currentPage

currentStyle

设计器

editContext

pageManager

pageProperties

属性

resourceDesign

resourcePage

requestName

responseName

resourceName

nodeName

logName

resourceResolverName

slingName

componentContextName

editContextName

propertiesName

pageManagerName

currentPageName

resourcePageName

pagePropertiesName

componentName

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> 标记将资源包含到当前页面中。

它具有以下属性：

刷新

resource

路径

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

resource

currentNode

日志

requestName

responseName

nodeName

l ogName resourceResolverName

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 Standard标记库 包含许多有用的标准标记。 核心、格式和函数标签由 /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 用于访问这些标记的前缀。 JSTL的正式文件可在 Java EE 5教程 — JavaServer Pages标准标记库.