標籤庫 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中輸出元件文字。

它具有下列選擇性屬性：

屬性 — 要使用的屬性名稱。 此名稱是相對於目前資源的名稱。

value — 要用於輸出的值。 如果此屬性存在，則會覆寫屬性屬性的使用。

oldValue — 要用於diff輸出的值。 如果此屬性存在，則會覆寫屬性屬性的使用。

escapeXml — 定義是否應將結果字串中的字元<、>、&、'和''轉換為對應的字元實體代碼。 預設值為false。 逸出套用在選擇性格式之後。

format — 用於格式化文字的可選java.text.Format。

noDiff — 即使存在diff資訊，也會抑制差異輸出的計算。

tagClass — 將包圍非空白輸出的專案的CSS類別名稱。 如果留空，則不會新增任何元素。

tagName — 將包圍非空白輸出的元素名稱。 其預設值為DIV。

預留位置 — 在編輯模式下用於空值或空白文字的預設值，也就是預留位置。 預設檢查會在選擇性格式化和逸出之後執行，即依照原樣寫入輸出。 其預設值為：

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

預設 — 要用於Null或空白文字的預設值。 預設檢查會在選擇性格式化和逸出之後執行，也就是說，會依原樣寫入輸出。

如何在JSP中使用<cq:text>標籤的一些範例：

<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 — 地區設定應該取用的來源。 它可以設定為下列其中一個值：

如果未設定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

currentPage

currentStyle

設計工具

editContext

pageManager

pageProperties

屬性

resourceDesign

resourcePage

requestName

responseName

resourceName

nodeName

logName

resourceResolverName

slingName

componentContextName

editContextName

屬性名稱

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>標籤。

它具有下列屬性：

名稱

值

範例：

<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>標籤中移除具有指定名稱和值的要求引數。 如果未提供值，則會移除具有指定名稱的所有引數。

它具有下列屬性：

名稱

範例：

<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

資源

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標準標籤庫包含許多有用的標準標籤。 核心、格式和函式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首碼來存取這些taglibs。 您可以在Java™ EE 5教學課程 — JavaServer Pages Standard Tag Library取得JSTL的官方檔案。