Stijlsysteem style-system

Met het Stijlsysteem kan een sjabloonauteur stijlklassen definiëren in het inhoudsbeleid van een component, zodat de auteur van de inhoud deze kan selecteren wanneer hij de component op een pagina bewerkt. Deze stijlen kunnen alternatieve visuele variaties van een component zijn, waardoor de component flexibeler wordt.

Dit elimineert de behoefte om een douanecomponent voor elke stijl te ontwikkelen of het componentendialoogvenster aan te passen om dergelijke stijlfunctionaliteit toe te laten. Het leidt tot herbruikbaardere componenten die snel en gemakkelijk aan de behoeften van inhoudsauteurs zonder enige AEM achterwaartse ontwikkeling kunnen worden aangepast.

Hoofdletters gebruiken use-case

De auteurs van het malplaatje vergen niet alleen de capaciteit om te vormen hoe de componenten voor de inhoudsauteurs functioneren, maar ook om verscheidene alternatieve visuele variaties van een component te vormen.

Op dezelfde manier hebben inhoudsauteurs niet alleen de mogelijkheid nodig om de inhoud te structureren en te rangschikken, maar ook om te selecteren hoe de inhoud visueel wordt weergegeven.

Het systeem van de Stijl verstrekt een verenigde oplossing aan zowel de vereisten van de malplaatjeauteur als van de inhoudauteur:

  • Sjabloonauteurs kunnen stijlklassen definiëren in het inhoudsbeleid van componenten.
  • Inhoudsauteurs kunnen deze klassen vervolgens selecteren in een vervolgkeuzelijst wanneer ze de component op een pagina bewerken, zodat ze de bijbehorende stijlen kunnen toepassen.

De stijlklasse wordt dan opgenomen op het decoratie omslagelement van de component zodat de componentenontwikkelaar zich niet met de behandeling van de stijlen hoeft bezig te houden voorbij het verstrekken van hun CSS regels.

Overzicht overview

Het gebruik van het Stijlsysteem heeft doorgaans de volgende vorm.

  1. De webontwerper maakt verschillende visuele variaties van een component.

  2. De ontwikkelaar van HTML wordt voorzien van de HTML output van de componenten en de gewenste visuele variaties om uit te voeren.

  3. De ontwikkelaar van HTML bepaalt de CSS klassen die aan elke visuele variatie beantwoorden en op het element moeten worden opgenomen die de componenten verpakt.

  4. De HTML-ontwikkelaar implementeert de bijbehorende CSS-code (en eventueel JS-code) voor elk van de visuele variaties, zodat deze er zo uitzien als gedefinieerd.

  5. De AEM ontwikkelaar plaatst verstrekte CSS (en facultatieve JS) in de Bibliotheek van de a Cliënten stelt het op.

  6. De AEM ontwikkelaar of sjabloonauteur configureert de paginasjablonen en bewerkt het beleid van elke opgemaakte component, voegt de gedefinieerde CSS-klassen toe, geeft gebruikersvriendelijke namen aan elke stijl en geeft aan welke stijlen kunnen worden gecombineerd.

  7. De auteur van de AEM pagina kan vervolgens de ontworpen stijlen in de pagina-editor kiezen via het stijlmenu van de werkbalk van de component.

Alleen de laatste drie stappen worden daadwerkelijk in AEM uitgevoerd. Dit betekent dat alle ontwikkeling van de vereiste CSS en JavaScript kan worden uitgevoerd zonder AEM.

Voor een feitelijke implementatie van de stijlen is alleen implementatie op AEM en selectie binnen de componenten van de gewenste sjablonen vereist.

Het volgende diagram illustreert de architectuur van het Systeem van de Stijl.

aem-style-system

Gebruiken use

Om de eigenschap aan te tonen, zullen wij WKNDimplementatie van de 2} titelcomponent van de kerncomponent 🔗 als voorbeeld gebruiken.

De volgende secties als Inhoudsauteuren als Auteur van het Malplaatjebeschrijven hoe te om de functionaliteit van het Systeem van de Stijl te testen gebruikend het Systeem van de Stijl van WKND.

Ga als volgt te werk als u het Stijlsysteem voor uw eigen componenten wilt gebruiken:

  1. Installeer CSS als cliëntbibliotheken zoals die in het sectie Overzichtworden besproken.
  2. Vorm de CSS klassen die u aan uw inhoudsauteurs beschikbaar wilt maken zoals die in de sectie als Auteur van het Malplaatjeworden beschreven.
  3. De auteurs van de inhoud kunnen de stijlen dan gebruiken zoals die in de sectie als Inhoudsauteurworden beschreven.

Als inhoudsauteur as-a-content-author

  1. Nadat u het WKND-project hebt geïnstalleerd, navigeert u naar de hoofdpagina voor de Engelse taal van WKND op http://<host>:<port>/sites.html/content/wknd/language-masters/en en bewerkt u de pagina.

  2. Selecteer a component van de Titel verder onderaan de pagina

    Systeem van de Stijl voor de auteur

  3. Selecteer de knoop van Stijlen op de toolbar van de component van de Lijst om het stijlmenu te openen en de verschijning van de component te veranderen.

    Selecterend stijlen

    note note
    NOTE
    In dit voorbeeld, zijn de Kleuren stijlen (Zwart, Wit, en Grijs) wederzijds exclusief, terwijl de Stijl opties (onderstreept, richt rechts, en Mini die verdelen) kan worden gecombineerd. Dit kan in de sjabloon worden geconfigureerd als sjabloonauteur.

Als sjabloonauteur as-a-template-author

  1. Terwijl het uitgeven van de Engelse taalmeester van WKND homepage bij http://<host>:<port>/sites.html/content/wknd/language-masters/en, geef het malplaatje van de pagina via de Informatie van de Pagina uit > geeft Malplaatje uit.

    geef Malplaatje uit

  2. Bewerk het beleid van de component van de Titel door het Beleid knoop van de component te tikken of te klikken.

    geeft beleid uit

  3. Op het tabblad Stijlen van de eigenschappen kunt u zien hoe de stijlen zijn geconfigureerd.

    geeft eigenschappen uit

    • de Naam van de Groep: de Stijlen kunnen samen binnen het stijlmenu worden gegroepeerd dat de inhoudsauteur wanneer het vormen van de stijl van de component ziet.
    • de Stijlen kunnen worden gecombineerd: staat voor veelvoudige stijlen binnen die groep toe om in één keer worden geselecteerd.
    • Naam van de Stijl: de beschrijving van de stijl die aan de inhoudauteur wanneer het vormen van de stijl van de component zal tonen.
    • CSS Klassen: De daadwerkelijke naam van de CSS klasse verbonden aan de stijl.

    Gebruik de sleephandgrepen om de volgorde van de groepen en de stijlen in de groepen te bepalen. Met de pictogrammen Toevoegen of Verwijderen kunt u groepen of stijlen in de groepen toevoegen of verwijderen.

CAUTION
De CSS klassen - en om het even welke noodzakelijke JavaScript - als stijleigenschappen van het beleid van een component worden gevormd, moeten als Bibliotheken van de Cliëntworden opgesteld om te werken.

Instellen setup

Versie 2 en later van de Componenten van de kern wordt volledig toegelaten om uit het Systeem van de Stijl voordeel te halen en geen extra configuratie te vereisen.

De volgende stappen zijn slechts noodzakelijk om het Systeem van de Stijl voor uw eigen douanecomponenten toe te laten of toe te laten het facultatieve lusje van Stijlen in de Edit dialoog.

Het tabblad Stijl in het dialoogvenster Ontwerpen inschakelen enable-styles-tab-design

Een component werkt alleen met AEM stijlsysteem en geeft het stijltabblad weer in het ontwerpdialoogvenster als de componentontwikkelaar het tabblad Stijl met de volgende instellingen voor de component bevat:

  • path = "/mnt/overlay/cq/gui/components/authoring/dialog/style/tab_design/styletab"
  • sling:resourceType = "granite/ui/components/coral/foundation/include"
NOTE
Dit gebruikt overlays, door middel van de Verschuivende Fusie van het Middel.

Met de gevormde component, worden de stijlen die door de paginaauteurs worden gevormd automatisch opgenomen door AEM op het decoratie element dat AEM automatisch rond elke editable component verpakt. De component zelf hoeft niets anders te doen om dit te bewerkstelligen.

Het tabblad Stijlen inschakelen in het dialoogvenster Bewerken enable-styles-tab-edit

Er is ook een optioneel tabblad Stijlen beschikbaar in het dialoogvenster Bewerken. In tegenstelling tot het tabblad Ontwerpdialoogvenster is het tabblad in het dialoogvenster Bewerken niet essentieel voor het functioneren van het Stijlsysteem, maar is het een optionele alternatieve interface voor de auteur van inhoud om stijlen in te stellen.

Het tabblad Bewerken kan op vergelijkbare wijze worden opgenomen als het tabblad van het dialoogvenster Ontwerpen:

  • path = "/mnt/overlay/cq/gui/components/authoring/dialog/style/tab_edit/styletab"
  • sling:resourceType = "granite/ui/components/coral/foundation/include"
NOTE
Dit gebruikt overlays, door middel van de Verschuivende Fusie van het Middel.
NOTE
Het tabblad Stijlen in het dialoogvenster Bewerken is niet standaard ingeschakeld.

Stijlen met elementnamen styles-with-element-names

Een ontwikkelaar kan ook een lijst met toegestane elementnamen voor stijlen op de component configureren met de eigenschap cq:styleElements string array. Vervolgens kan de sjabloonauteur op het tabblad Stijlen van het beleid in het ontwerpdialoogvenster ook een elementnaam kiezen die voor elke stijl moet worden ingesteld. Hiermee wordt de elementnaam van het omvattende element ingesteld.

Deze eigenschap wordt ingesteld op het knooppunt cq:Component . Bijvoorbeeld:

  • /apps/<yoursite>/components/content/list@cq:styleElements=[div,section,span]
CAUTION
Definieer geen elementnamen voor stijlen die kunnen worden gecombineerd. Wanneer de veelvoudige elementnamen worden bepaald, is de orde van prioriteit:
  1. HTML heeft voorrang op alles: data-sly-resource="${'path/to/resource' @ decorationTagName='span'}
  2. Dan onder veelvoudige actieve stijlen, wordt de eerste stijl in de lijst van stijlen die in het beleid van de component worden gevormd genomen.
  3. Tot slot wordt de component cq:htmlTag/ cq:tagName beschouwd als een terugvalwaarde.

Deze mogelijkheid om stijlnamen te definiëren is handig voor algemene componenten, zoals de container van de layout of de component Content Fragment, zodat ze een extra betekenis krijgen.

Zo kan een container voor lay-out bijvoorbeeld semantiek als <main> , <aside> , <nav> enzovoort krijgen.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab