Tagbibliotheken tag-libraries

Met de tagbibliotheken Granite, CQ en Sling hebt u toegang tot specifieke functies voor gebruik in het JSP-script van uw sjablonen en componenten.

Graniet-tagbibliotheek granite-tag-library

De tagbibliotheek Granite bevat nuttige functies.

Wanneer u het jsp manuscript van een component van Granite UI ontwikkelt, wordt het geadviseerd om volgende code bij de bovenkant van het manuscript te omvatten:

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

Globaal verklaart ook de Verschuivende bibliotheek.

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

<ui:includeClientLib> ui-includeclientlib

De tag <ui:includeClientLib> bevat een AEM HTML-clientbibliotheek, die js, css of een themabibliotheek kan zijn. Voor meerdere inclusies van verschillende typen, bijvoorbeeld js en css, moet deze tag meerdere keren worden gebruikt in de jsp. Deze tag is een handige omslag rond de service-interface van [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) .

Deze heeft de volgende kenmerken:

categorieën - een lijst van komma-gescheiden categorieën van de cliëntbibliotheek. Dit omvat alle JavaScript- en CSS-bibliotheken voor de opgegeven categorieën. De themanaam wordt uit de aanvraag geëxtraheerd.

Equivalent aan: com.adobe.granite.ui.clientlibs.HtmlLibraryManager#writeIncludes

thema - een lijst van komma-gescheiden categorieën van de cliëntbibliotheek. Dit omvat alle themabibliotheken (zowel CSS als JS) voor de opgegeven categorieën. De themanaam wordt uit de aanvraag geëxtraheerd.

Equivalent aan: com.adobe.granite.ui.clientlibs.HtmlLibraryManager#writeThemeInclude

js - een lijst van komma-gescheiden categorieën van de cliëntbibliotheek. Dit geldt ook voor alle JavaScript-bibliotheken voor de opgegeven categorieën.

Equivalent aan: com.adobe.granite.ui.clientlibs.HtmlLibraryManager#writeJsInclude

css - een lijst van komma-gescheiden categorieën van de cliëntbibliotheek. Dit omvat alle CSS-bibliotheken voor de opgegeven categorieën.

Equivalent aan: com.adobe.granite.ui.clientlibs.HtmlLibraryManager#writeCssInclude

thema - een vlag die van slechts de thema's of niet-thema bibliotheken wijst zou moeten worden omvat. Als deze waarde wordt weggelaten, worden beide sets opgenomen. Alleen van toepassing op zuivere JS- of CSS-include-bestanden (niet voor categorieën of thema-include-bestanden).

De tag <ui:includeClientLib> kan als volgt worden gebruikt in een 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-tagbibliotheek cq-tag-library

De CQ-tagbibliotheek bevat nuttige functies.

Als u de CQ-tagbibliotheek in uw script wilt gebruiken, moet het script beginnen met de volgende code:

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

Wanneer u het Jsp manuscript van een AEM component ontwikkelt, wordt het geadviseerd om volgende code bij de bovenkant van het manuscript te omvatten:

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

De tags sling, CQ en jstl worden gedeclareerd en de regelmatig gebruikte scriptobjecten die door de tag <cq:defineObjects /> worden gedefinieerd, worden getoond. Hierdoor wordt de jsp-code van uw component verkort en vereenvoudigd.

<cq:text> cq-text

De tag <cq:text> is een gebruikstag die de componenttekst in een JSP uitvoert.

Het heeft de volgende optionele kenmerken:

bezit - Naam van het bezit aan gebruik. De naam is relatief ten opzichte van de huidige bron.

waarde - Waarde voor output te gebruiken. Als dit kenmerk aanwezig is, wordt het gebruik van het eigenschapkenmerk overschreven.

oldValue - Waarde om voor diff output te gebruiken. Als dit kenmerk aanwezig is, wordt het gebruik van het eigenschapkenmerk overschreven.

escapeXml - bepaalt of de karakters <, >, &, " en " in het resulterende koord in hun overeenkomstige codes van de karakterentiteit zouden moeten worden omgezet. De standaardwaarde is false. De escaping wordt toegepast na de optionele opmaak.

formaat - Facultatieve java.text.Format aan gebruik voor het formatteren van de tekst.

noDiff - onderdrukt de berekening van een diff output, zelfs als diff informatie aanwezig is.

tagClass - CSS klassennaam van een element dat een niet lege output zal omringen. Als dit leeg is, wordt geen element toegevoegd.

tagName - Naam van het element dat een niet-lege output zal omringen. De standaardwaarde is DIV.

placeholder - Standaardwaarde voor ongeldige of lege tekst op geef wijze uit, namelijk placeholder. De standaardcontrole wordt uitgevoerd na de optionele opmaak en escape, d.w.z. dat deze ongewijzigd naar de uitvoer wordt geschreven. De standaardwaarde is:

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

gebrek - Standaardwaarde om voor ongeldige of lege tekst te gebruiken. De standaardcontrole wordt uitgevoerd na de optionele opmaak en escape, dat wil zeggen dat deze ongewijzigd naar de uitvoer wordt geschreven.

Hier volgen enkele voorbeelden van het gebruik van de tag <cq:text> in een 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

De tag <cq:setContentBundle> maakt een i18n-lokalisatiecontext en slaat deze op in de configuratievariabele javax.servlet.jsp.jstl.fmt.localizationContext .

Deze heeft de volgende kenmerken:

taal - de taal van de scène waarvoor om de middelbundel terug te winnen.

bron - de bron waar de scène zou moeten worden genomen van. Deze kan op een van de volgende waarden worden ingesteld:

Als het kenmerk source niet is ingesteld:

De "inhoudsbundel" kan worden gebruikt door standaard JSTL <fmt:message> -tags. De zoekopdracht van berichten via sleutels is tweeledig:

De tag <cq:setContentBundle> kan als volgt worden gebruikt in een JPEG-bestand.

Voor pagina's die hun taal bepalen:

... %><cq:setContentBundle source="page"/><%  %>
<div class="error"><fmt:message key="Hello"/>
</div> ...

Voor gepersonaliseerde pagina's van de gebruiker:

... %><cq:setContentBundle scope="request"/><% %>
<div class="error"><fmt:message key="Hello"/>
</div> ...

<cq:include> cq-include

De tag <cq:include> bevat een bron op de huidige pagina.

Deze heeft de volgende kenmerken:

flush

weg

resourceType

manuscript

ignoreComponentHierarchy

Voorbeeld:

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

Moet u <%@ include file="myScript.jsp" %> of <cq:include script="myScript.jsp" %> gebruiken om een script op te nemen?

Moet u <cq:include> of <sling:include> gebruiken?

<cq:includeClientLib> cq-includeclientlib

De tag <cq:includeClientLib> bevat een AEM HTML-clientbibliotheek, die kan bestaan uit een JS, een css of een themabibliotheek. Voor meerdere inclusies van verschillende typen, bijvoorbeeld js en css, moet deze tag meerdere keren worden gebruikt in de jsp. Deze tag is een handige omslag rond de service-interface van com.day.cq.widget.HtmlLibraryManager .

Deze heeft de volgende kenmerken:

categorieën - een lijst van komma-gescheiden categorieën van de cliëntbibliotheek. Dit omvat alle JavaScript- en CSS-bibliotheken voor de opgegeven categorieën. De themanaam wordt uit de aanvraag geëxtraheerd.

Equivalent aan: com.day.cq.widget.HtmlLibraryManager#writeIncludes

thema - een lijst van komma-gescheiden categorieën van de cliëntbibliotheek. Dit omvat alle themabibliotheken (zowel CSS als JS) voor de opgegeven categorieën. De themanaam wordt uit de aanvraag geëxtraheerd.

Equivalent aan: com.day.cq.widget.HtmlLibraryManager# writeThemeInclude

js - een lijst van komma-gescheiden categorieën van de cliëntbibliotheek. Dit geldt ook voor alle JavaScript-bibliotheken voor de opgegeven categorieën.

Equivalent aan: com.day.cq.widget.HtmlLibraryManager#writeJsInclude

css - een lijst van komma-gescheiden categorieën van de cliëntbibliotheek. Dit omvat alle CSS-bibliotheken voor de opgegeven categorieën.

Equivalent aan: com.day.cq.widget.HtmlLibraryManager#writeCssInclude

thema - een vlag die van slechts de thema's of niet-thema bibliotheken wijst zou moeten worden omvat. Als deze waarde wordt weggelaten, worden beide sets opgenomen. Alleen van toepassing op zuivere JS- of CSS-include-bestanden (niet voor categorieën of thema-include-bestanden).

De tag <cq:includeClientLib> kan als volgt worden gebruikt in een 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

De tag <cq:defineObjects> stelt de volgende, regelmatig gebruikte scriptobjecten beschikbaar waarnaar de ontwikkelaar kan verwijzen. De tag stelt ook de objecten beschikbaar die door de tag <sling:defineObjects> worden gedefinieerd.

componentContext

component

currentDesign

currentPage

currentStyle

designer

editContext

pageManager

pageProperties

eigenschappen

resourceDesign

resourcePage

requestName

responseName

resourceName

nodeName

logName

resourceResolverName

slingName

componentContextName

editContextName

propertiesName

pageManagerName

currentPageName

resourcePageName

pagePropertiesName

componentName

designerName

currentDesignName

resourceDesignName

currentStyleName

Voorbeeld

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

De tag <cq:requestURL> schrijft de huidige aanvraag-URL naar de JspWriter. De twee tags <cq:addParam> en <cq:removeParam> en kunnen binnen de hoofdtekst van deze tag worden gebruikt om de huidige verzoek-URL te wijzigen voordat deze wordt geschreven.

Hiermee kunt u koppelingen met verschillende parameters maken naar de huidige pagina. Zo kunt u bijvoorbeeld de aanvraag transformeren:

mypage.html?mode=view&query=something in mypage.html?query=something .

Het gebruik van addParam of removeParam wijzigt alleen de instantie van de opgegeven parameter, dit heeft geen invloed op alle andere parameters.

<cq:requestURL> heeft geen kenmerk.

Voorbeelden:

<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

De tag <cq:addParam> voegt een aanvraagparameter met de opgegeven naam en waarde toe aan de omsluitende tag <cq:requestURL> .

Deze heeft de volgende kenmerken:

naam

waarde

Voorbeeld:

<a title="filter results" href="<cq:requestURL><cq:addParam name="language" value="${bucket.value}"/></cq:requestURL>">${label} (${bucket.count})</a>

<cq:removeParam> cq-removeparam

De tag <cq:removeParam> verwijdert een aanvraagparameter met de opgegeven naam en waarde uit de omsluitende tag <cq:requestURL> . Wanneer geen waarde is opgegeven, worden alle parameters met de opgegeven naam verwijderd.

Deze heeft de volgende kenmerken:

naam

Voorbeeld:

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

Tagbibliotheek verkopen sling-tag-library

De tagbibliotheek Sling bevat handige functies voor verkopers.

Wanneer u de Sling-tagbibliotheek in uw script gebruikt, moet het script beginnen met de volgende code:

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

<sling:include> sling-include

De tag <sling:include> bevat een bron op de huidige pagina.

Deze heeft de volgende kenmerken:

flush

middel

weg

resourceType

replaceSelectors

addSelectors

replaceSuffix

Voorbeelden:

<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

De tag <sling:defineObjects> stelt de volgende, regelmatig gebruikte scriptobjecten beschikbaar waarnaar de ontwikkelaar kan verwijzen:

slingRequest

slingResponse

resourceResolver

.sling

middel

currentNode

logboek

requestName

responseName

nodeName

l ogName resourceResolverName

slingName

Voorbeeld:

<%@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-tagbibliotheek jstl-tag-library

De Bibliotheek van de Markering van de Pagina's JavaServer Standaardbevat vele nuttige en standaardmarkeringen. De kern-, opmaak- en functietags worden gedefinieerd door de /libs/foundation/global.jsp , zoals in het volgende fragment wordt getoond.

Extraheren van /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" %>

Nadat u het /libs/foundation/global.jsp -bestand hebt geïmporteerd zoals eerder is beschreven, kunt u de voorvoegsels c , fmt en fn gebruiken om toegang te krijgen tot deze tags. De officiële documentatie van JSTL is beschikbaar bij het EE 5 Leerprogramma Java™ - de Bibliotheek van de Markering van de Pagina's JavaServer Standaard.