DocumentatieAEM 6.5Handboek

Componenten voor inhoudsfragmenten components-for-content-fragments

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar

Componenten voor het ontwerpen van fragmenten components-for-fragment-authoring

CAUTION
Het wordt afgeraden de werkelijke componenten die in de fragmenteditor worden gebruikt, uit te breiden of te wijzigen, omdat deze nog steeds kunnen worden gewijzigd.

Zie het Beheer API van het Fragment van de Inhoud - cliënt-kant.

Componenten voor paginaontwerp components-for-page-authoring

CAUTION
De Component van de Kern van het Fragment van de Inhoudwordt nu geadviseerd. Zie het Ontwikkelen van de Componenten van de Kernvoor meer details.
Deze sectie detailleert de originele die component voor gebruik met inhoudsfragmenten (wordt geleverd het Fragment van de Inhoud in de Algemene groep).
NOTE
Zie ook de Fragmenten die van de Inhoud Componenten vormen voor het Teruggevenvoor verdere informatie.

Adobe Experience Manager (AEM) inhoudsfragmenten worden gecreeerd en geleid als pagina-onafhankelijke activa. U kunt hiermee kanaalneutrale inhoud maken, samen met (mogelijk kanaalspecifieke) variaties. u kunt deze fragmenten, en hun variaties dan gebruiken, wanneer het ontwerpen van uw inhoudspagina's. U kunt een bestaand element van het inhoudsfragment ook gebruiken door het van activa browser aan pagina 🔗 te slepen (zoals voor andere op activa-gebaseerde componenten, zoals het Beeld van de stichtingscomponent). De uit-van-de-doos component van het inhoudsfragment toont slechts één elementvan het referenced inhoudsfragment. Gebruikend de componentendialoog kunt u het element, de variatie en de waaier van fragmentparagrafenbepalen die u op de pagina wilt tonen.

NOTE
Deze component van het Fragment van de Inhoud werd geïntroduceerd in AEM 6.2 als verbeterde versie van de component van het Artikel, die is afgekeurd.
NOTE
Inhoudsfragmenten worden niet ondersteund in de klassieke UI.

Definitie definition

De component van het Fragment van 0} Inhoud {wordt gebruikt om een verwijzing naar een activa van het inhoudsfragment (effectief verbeterde tekstactiva) te houden. Het middeltype voor het inhoudsfragment is:

dam/cfm/components/contentfragment/contentfragment

De verwijzing wordt gedefinieerd in de eigenschap:

fileReference

Alleen de editor van de interface met aanraakbediening biedt volledige ondersteuning voor componenten van inhoudsfragmenten, waaronder de clientbibliotheek:

cq.authoring.editor.plugin.cfm

Deze bibliotheek voegt eigenschappen, specifiek voor inhoudsfragmenten, aan de redacteur toe. Er is bijvoorbeeld ondersteuning beschikbaar voor de mogelijkheid om inhoudsfragmenten op de pagina toe te voegen en te configureren, de mogelijkheid om te zoeken naar elementen van inhoudsfragmenten in de elementenbrowser en naar bijbehorende inhoud in het zijpaneel.

Tussen inhoud in-between-content

De Fragmen van de Inhoud geen component laat u extra componenten binnen-tussen de verschillende paragrafen van het getoonde elementdalen. In feite bestaat het weergegeven element uit verschillende alinea's (elke alinea wordt gemarkeerd door een regelterugloop). Tussen deze alinea's kunt u inhoud invoegen met behulp van andere componenten.

Vanuit technisch gezichtspunt, leeft elke paragraaf van het getoonde element in zijn eigen parsys, en elke component die u tussen de paragrafen toevoegt wordt (onder de kap) opgenomen in parsys.

Met andere woorden, als de instantie van de inhoudfragment component uit drie paragrafen wordt samengesteld, dan heeft de component drie verschillende parsys in de bewaarplaats. Alle inwendige inhoud die aan het inhoudsfragment wordt toegevoegd wordt eigenlijk gevestigd binnen deze parsys.

In de opslagplaats wordt de tussenliggende inhoud opgeslagen ten opzichte van de positie binnen de algemene alineastijl, dat wil zeggen dat de inhoud niet is gekoppeld aan de werkelijke alinea-inhoud.

U kunt dit als volgt illustreren:

  • Een instantie van een inhoudsfragment dat bestaat uit drie alinea's

  • En dat bepaalde inhoud al is ingevoegd na de tweede alinea

    • Dit betekent dat de inhoud in tweede parsys wordt opgeslagen.

Als de alineabstructuur van dit exemplaar verandert (door de variatie, het element of het bereik van de weergegeven alinea's te wijzigen), kan dit van invloed zijn op de tussenliggende inhoud die wordt weergegeven wanneer de inhoud van het inhoudsfragment:

  • Wordt bewerkt en een andere alinea wordt toegevoegd vóór de tweede alinea:

    • De inhoud tussen wordt weergegeven na de zojuist gemaakte alinea (de tweede alinea bevat nu de zojuist gemaakte alinea).

  • Wordt bewerkt en de tweede alinea wordt verwijderd:

    • De inhoud tussen wordt weergegeven na de alinea die eerder de derde alinea was (de tweede alinea bevat nu de vorige derde alinea).

  • Is zo gevormd dat slechts de eerste paragraaf wordt getoond:

    • De inhoud tussen wordt niet getoond (tweede parsys wordt niet meer teruggegeven toe te schrijven aan de nieuwe configuratie).

De component Inhoudsfragment aanpassen customizing-the-content-fragment-component

Als u de uit-van-de-doos component van het inhoudsfragment als blauwdruk voor uitbreiding wilt gebruiken, zou u het volgende contract moeten respecteren:

  • U kunt het HTML-renderingsscript en de bijbehorende POJO opnieuw gebruiken, zodat u kunt zien hoe de functie voor de tussenliggende inhoud is geïmplementeerd.

  • Het knooppunt voor inhoudsfragmenten opnieuw gebruiken: cq:editConfig

    • De listeners afterinsert/ afteredit/ afterdelete worden gebruikt om JS-gebeurtenissen te activeren. Deze gebeurtenissen worden verwerkt in de cq.authoring.editor.plugin.cfm clientbibliotheek om de bijbehorende inhoud in het zijpaneel weer te geven.
    • De cq:dropTargets zijn geconfigureerd voor het slepen van inhoudsfragmentelementen.
    • cq:inplaceEditing is geconfigureerd voor ondersteuning van het ontwerpen van een inhoudsfragment in de pagina-editor. De fragment op zijn plaats redacteur wordt bepaald in de cq.authoring.editor.plugin.cfm cliëntbibliotheek en staat een snelle verbinding toe om het huidige element/de variatiein de fragmentredacteurte openen.

Herschrijven van element vóór renderen asset-rewriting-before-rendering

Bij Inhoudsfragmentbeheer wordt een intern renderingsproces gebruikt om de uiteindelijke HTML-uitvoer voor een pagina te genereren. Dit wordt intern gebruikt door de component van het Fragment van de Inhoud, maar ook door het achtergrondproces dat referenced fragmenten op het van verwijzingen voorzien pagina's bijwerkt.

Intern wordt de Sling Rewriter gebruikt voor die rendering. De respectievelijke configuratie vindt u in /libs/dam/config/rewriter/cfm en kan, indien nodig, worden aangepast. Zie Apache Sling Rewritervoor meer informatie.

CAUTION
Als u de configuratie van de rewriter aanpast/bedekt:
  • /libs/dam/config/rewriter/cfm
Dan moet serializerType ​ ​worden bijgewerkt aan:
  • serializerType="html5-serializer"

De uit-van-de-doos configuratie gebruikt de volgende transformatoren:

  • transformer-cfm-payloadfilter - alleen voor het ophalen van het body deel ( <body>...</body> ) van de HTML van het fragment

  • transformer-cfm-parfilter - filtert ongewenste alinea's uit als er een alineabereik is opgegeven (zoals u kunt doen met de component Content Fragment)

  • transformer-cfm-assetprocessor - wordt intern gebruikt voor het ophalen van een lijst met elementen die in het fragment zijn ingesloten

Het renderingsproces wordt blootgesteld door com.adobe.cq.dam.cfm.content.FragmentRenderServiceen kan (bijvoorbeeld) door douanecomponenten, indien nodig worden gebruikt.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2