標籤程式庫 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

cs — 逗號分隔的客戶端庫類別的清單。 這會包含指定類別的所有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中輸出元件文本。

它有下列選用屬性：

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

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

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

cs — 逗號分隔的客戶端庫類別的清單。 這會包含指定類別的所有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> 標籤。

它具有以下屬性：

名稱

值

範例:

<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 Tag Library時，指令碼必須以下列程式碼開頭：

<%@ 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標準標籤庫 包含許多有用的標準標籤。 核心、格式和函式標籤由 /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 Standard標籤庫.