태그 라이브러리 tag-libraries

Granite, CQ 및 Sling 태그 라이브러리는 템플릿 및 구성 요소의 JSP 스크립트에서 사용할 특정 기능에 액세스할 수 있도록 해줍니다.

Granite Tag Library 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-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에 출력하는 편의 태그입니다.

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

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

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

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> 태그 사이에 Analytics JavaScript 코드를 배치했습니다. 키별 메시지 조회는 두 배입니다.

다음 <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> 태그에는 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#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> 태그에 가깝게 포함했습니다.

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

이름

값

예:

<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> 태그에 현재 페이지에 리소스가 포함되어 있습니다.

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

플러시

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 해당 taglibs에 액세스할 접두사입니다. JSTL의 공식 설명서는 다음 위치에서 사용할 수 있습니다. Java EE 5 자습서 - JavaServer Pages Standard Tag Library.