태그 라이브러리 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> 태그 js, css 또는 테마 라이브러리가 될 수 있는 AEM html 클라이언트 라이브러리를 포함합니다. 다른 유형의 여러 포함(예: 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에만 적용됩니다(범주 또는 테마 포함에 대해서는 해당되지 않음).

다음 <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 taglib을 선언하고 <cq:defineObjects /> 태그에 가깝게 배치하십시오. 이렇게 하면 구성 요소의 jsp 코드가 단축되고 간소화됩니다.

<cq:text> cq-text

다음 <cq:text> 태그는 JSP에서 구성 요소 텍스트를 출력하는 편의 태그입니다.

여기에는 다음과 같은 선택적 속성이 있습니다.

속성 - 사용할 속성의 이름입니다. 이름은 현재 리소스를 기준으로 합니다.

값 - 출력에 사용할 값. 이 속성이 있으면 속성 속성 사용을 덮어씁니다.

oldValue - 차이 출력에 사용할 값. 이 속성이 있으면 속성 속성 사용을 덮어씁니다.

escapeXml - 결과 문자열의 <, >, &, ' 및 " 문자를 해당 문자 엔티티 코드로 변환할지 여부를 정의합니다. 기본값은 false입니다. 이스케이프는 선택적 형식 다음에 적용됩니다.

형식 - 텍스트 서식 지정에 사용할 선택적 java.text.Format.

noDiff - 차이 정보가 있어도 차이 출력을 계산하지 않습니다.

tagClass - 비어 있지 않은 출력을 둘러싸는 요소의 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

script

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> 태그 js, css 또는 테마 라이브러리일 수 있는 AEM html 클라이언트 라이브러리를 포함합니다. 다른 유형의 여러 포함(예: js 및 css)의 경우, 이 태그는 jsp에서 여러 번 사용해야 합니다. 이 태그는 의 편리한 래퍼입니다 com.day.cq.widget.HtmlLibraryManager 서비스 인터페이스.

여기에는 다음과 같은 속성이 있습니다.

카테고리 - 쉼표로 구분된 클라이언트 라이브러리 범주 목록입니다. 여기에는 해당 범주에 대한 모든 JavaScript 및 CSS 라이브러리가 포함됩니다. 요청에서 테마 이름이 추출됩니다.

다음과 같음: com.day.cq.widget.HtmlLibraryManager#writeIncludes

테마 - 쉼표로 구분된 클라이언트 라이브러리 범주 목록입니다. 지정된 카테고리에 대한 모든 테마 관련 라이브러리(CSS 및 JS 모두)가 여기에 포함됩니다. 요청에서 테마 이름이 추출됩니다.

다음과 같음: com.day.cq.widget.HtmlLibraryManager#writeThemInclude

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

현재 디자인 이름

리소스 디자인 이름

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

addSelector

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

resourceResolution

.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 표준 태그 라이브러리 에는 많은 유용한 표준 태그가 포함되어 있습니다. 코어, 서식 및 함수 태그바는 /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 표준 태그 라이브러리.