標籤庫

Granite、CQ和Sling標籤程式庫可讓您存取特定函式，以便在範本和元件的JSP指令碼中使用。

Granite標籤庫

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> tag包含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> 標籤的使用方式如下：

<%-- 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標籤庫包含有用的函式。

若要在指令碼中使用CQ標籤庫，指令碼必須以下列程式碼開頭：

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

注意

當 /libs/foundation/global.jsp 檔案包含在指令碼中，taglib會自動宣告。

開發AEM元件的jsp指令碼時，建議在指令碼頂端包含下列程式碼：

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

它會宣告sling、CQ和jstl taglibs，並公開 <cq:defineObjects /> 標籤之間。這會縮短並簡化元件的jsp程式碼。

<cq:text>

此 <cq:text> 標籤是在JSP中輸出元件文字的方便標籤。

它具有下列選擇性屬性：

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

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

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

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

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

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

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

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

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

<div><span class="cq-text-placeholder">¶</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> 標籤會建立i18n本地化內容，並儲存在 javax.servlet.jsp.jstl.fmt.localizationContext 設定變數。

它有下列屬性：

語言 — 要擷取資源套件的地區設定語言。

source — 地區設定的來源位置。可將其設定為下列其中一個值：

靜態 — 地區設定取自 language 屬性（若有的話），否則會從伺服器預設地區設定。
頁面 — 地區設定會從目前頁面或資源的語言取得（如果有的話），否則會從 language 屬性（若有的話），否則會從伺服器預設地區設定。
請求 — 地區設定取自請求地區設定( request.getLocale())。
自動 — 地區設定取自 language attribute （若有的話），否則會來自目前頁面的語言或資源（若有的話），否則會來自請求。

如果 source 屬性未設定：

如果 language 屬性已設定，則 source 屬性預設為" static.
如果 language 屬性未設定， source 屬性預設為 auto.

「內容套件組合」僅供標準JSTL使用 <fmt:message> 標籤之間。依索引鍵的訊息查詢方式有兩種：

首先，系統會搜尋目前轉譯之基礎資源的JCR屬性以取得轉譯。這可讓您定義簡單的元件對話方塊以編輯這些值。
如果節點不包含名稱與索引鍵完全相同的屬性，則備援是從sling請求( SlingHttpServletRequest.getResourceBundle(Locale))。此套裝的語言或地區設定是由 <cq:setContentBundle> 標籤之間。

此 <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> 標籤包含進入目前頁面的資源。

它有下列屬性：

排清

布林值，定義在包含目標之前是否清除輸出。

路徑

要包含在目前要求處理中的資源物件的路徑。如果此路徑是相對路徑，則會附加至其指令碼包含指定資源的目前資源的路徑。必須指定path和resourceType或指令碼。

resourceType

要包含的資源的資源型別。如果已設定資源型別，則路徑必須是資源物件的確切路徑：在此情況下，不支援在路徑中新增引數、選取器和副檔名。
如果要包含的資源是以無法解析為資源的路徑屬性指定的，則標籤可能會建立路徑及此資源型別以外的合成資源物件。
必須指定path和resourceType或指令碼。

指令碼

要包含的jsp指令碼。必須指定path和resourceType或指令碼。

ignoreComponentHierarchy

布林值，控制是否應忽略元件階層以進行指令碼解析。如果為true，則只會考慮搜尋路徑。

範例:

<%@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" %> 以包含指令碼？

此 <%@ include file="myScript.jsp" %> 指示詞會通知JSP編譯器將完整的檔案加入目前的檔案中。就好像所包含檔案的內容直接貼到原始檔案中一樣。
使用 <cq:include script="myScript.jsp"> 標籤中，檔案會包含在執行階段。

您是否應該使用 <cq:include> 或 <sling:include>？

開發AEM元件時，Adobe建議您使用 <cq:include>.
<cq:include> 可讓您在使用script屬性時直接包含依名稱排序的指令碼檔案。這會考量元件和資源型別繼承，且通常比使用選取器和擴充功能嚴格遵守Sling的指令碼解析更簡單。

<cq:includeClientLib>

注意

<cq:includeClientLib> 自AEM 5.6起已棄用。 <ui:includeClientLib> 應該改用。

此 <cq:includeClientLib> tag包含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> 標籤的使用方式如下：

<%-- 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> 標籤會公開以下定期使用的指令碼物件，以供開發人員參考。它也會公開由定義的物件 <sling:defineObjects> 標籤之間。

componentContext

請求的目前元件內容物件(com.day.cq.wcm.api.components.ComponentContext介面)。

元件

目前資源的目前AEM元件物件(com.day.cq.wcm.api.components.Component interface)。

currentdesign

目前頁面的目前設計物件(com.day.cq.wcm.api.designer.Design介面)。

目前頁面

目前的AEM WCM頁面物件(com.day.cq.wcm.api.Page介面)。

目前樣式

目前儲存格的目前樣式物件(com.day.cq.wcm.api.designer.Style介面)。

設計工具

用來存取設計資訊的設計工具物件(com.day.cq.wcm.api.designer.Designer介面)。

editContext

AEM元件的編輯上下文物件(com.day.cq.wcm.api.components.EditContext介面)。

pageManager

頁面層級作業的頁面管理員物件(com.day.cq.wcm.api.PageManager介面)。

pageProperties

目前頁面的頁面屬性物件(org.apache.sling.api.resource.ValueMap)。

屬性

目前資源的屬性物件(org.apache.sling.api.resource.ValueMap)。

resourceDesign

資源頁面的設計物件(com.day.cq.wcm.api.designer.Design介面)。

resourcePage

資源頁面物件(com.day.cq.wcm.api.Page介面)。
它有下列屬性：

requestname

繼承自sling

responsename

繼承自sling

resourceName

繼承自sling

nodeName

繼承自sling

logName

繼承自sling

resourceResolverName

繼承自sling

slingName

繼承自sling

componentContextName

特定於wcm

editContextname

特定於wcm

propertiesName

特定於wcm

pageManagerName

特定於wcm

currentPagename

特定於wcm

resourcePageName

特定於wcm

pagePropertiesName

特定於wcm

componentname

特定於wcm

designerName

特定於wcm

currentDesignName

特定於wcm

resourceDesignName

特定於wcm

currentStyleName

特定於wcm

範例

<%@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/>

注意

當 /libs/foundation/global.jsp 檔案包含在指令碼中， <cq:defineObjects /> 標籤會自動包含在內。

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

它有下列屬性：

名稱

要移除的引數名稱

範例:

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

Sling標籤庫

Sling標籤庫包含有用的Sling函式。

當您在指令碼中使用Sling標籤庫時，指令碼必須以下列程式碼開頭：

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

注意

當 /libs/foundation/global.jsp 檔案包含在指令碼中，則會自動宣告sling taglib。

<sling:include>

此 <sling:include> 標籤包含進入目前頁面的資源。

它有下列屬性：

排清

布林值，定義在包含目標之前是否清除輸出。

resource

要包含在目前請求處理中的資源物件。必須指定資源或路徑。如果兩者都指定，則資源優先。

路徑

要包含在目前要求處理中的資源物件的路徑。如果此路徑是相對路徑，則會附加至其指令碼包含指定資源的目前資源的路徑。必須指定資源或路徑。如果兩者都指定，則資源優先。

resourceType

要包含的資源的資源型別。如果已設定資源型別，則路徑必須是資源物件的確切路徑：在此情況下，不支援在路徑中新增引數、選取器和副檔名。
如果要包含的資源是以無法解析為資源的路徑屬性指定的，則標籤可能會建立路徑及此資源型別以外的合成資源物件。

replaceSelectors

分派時，選取器會取代為此屬性的值。

addSelectors

分派時，會將此屬性的值新增至選取器。

replaceSuffix

傳送時，尾碼會由這個屬性的值取代。

注意

資源及隨附的指令碼的解析度 <sling:include> 標籤與一般sling URL解析度相同。依預設，選擇器、擴充功能等。來自目前請求的也會用於包含的指令碼。可透過標籤屬性加以修改：例如 replaceSelectors="foo.bar" 可讓您覆寫選取器。

範例：

<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> 標籤會公開以下定期使用的指令碼物件，以供開發人員參考：

slingRequest

SlingHttpServletRequest物件，可讓您存取HTTP要求標頭資訊（擴充標準HttpServletRequest），並可讓您存取Sling特有專案，例如資源、路徑資訊、選取器等。

slingResponse

SlingHttpServletResponse物件，提供伺服器所建立HTTP回應的存取權。這目前與其延伸的HttpServletResponse相同。請求
標準JSP要求物件，純HttpServletRequest。回應
標準JSP回應物件，純HttpServletResponse。

resourceResolver

目前的ResourceResolver物件。它與slingRequest.getResourceResolver()相同

.sling

SlingScriptHelper物件，包含指令碼的方便方法，主要是sling.include('/some/other/resource')，用於將其他資源的回應包含在此回應中(例如：內嵌標題html程式碼片段)和sling.getService(foo.bar.Service.class)，以擷取Sling中可用的OSGi服務（類別標籤法取決於指令碼語言）。

resource

目前要處理的資源物件，視請求的URL而定。它與slingRequest.getResource()相同。

目前節點

如果目前資源指向JCR節點（這通常是Sling中的情況），這可讓您直接存取Node物件。否則不會定義此物件。

記錄

提供SLF4J記錄器，用於從指令碼內記錄到Sling記錄系統，例如 log.info（「正在執行我的指令碼」）。
它有下列屬性：

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

此 JavaServer Pages Standard標籤庫包含許多實用且標準的標籤。核心、格式和函式taglib是由 /libs/foundation/global.jsp 如下列程式碼片段所示。

/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 Standard Tag Library.

Business.Adobe.com 資源

Content Insights Embedded Charts Content As A Service Dynamic Media Dynamic Forms Content Management System

標籤庫

Granite標籤庫

<ui:includeClientLib>

CQ標籤庫

<cq:text>

<cq:setContentBundle>

<cq:include>

<cq:includeClientLib>

<cq:defineObjects>

<cq:requestURL>

<cq:addParam>

<cq:removeParam>

Sling標籤庫

<sling:include>

<sling:defineObjects>

JSTL標籤庫

/libs/foundation/global.jsp擷取

Business.Adobe.com 資源

本頁內容

檢視下一個:

學習

說明文件

社群

技術支援

資源

Adobe 帳戶

Adobe