Een nieuwe graniet UI-veldcomponent maken

Graniet UI biedt een reeks componenten die zijn ontworpen voor gebruik in formulieren; deze worden velden in de woordenlijst van de gebruikersinterface van Granite. De standaardcomponenten voor graniet-formulieren zijn beschikbaar onder:

/libs/granite/ui/components/foundation/form/*

Gebruik het granite UI Foundation-framework om granitecomponenten te ontwikkelen en/of uit te breiden. Dit heeft twee elementen:

• server:

  • een verzameling stichtingscomponenten

    • stichting - modulair, composable, laagbaar, herbruikbaar
    • componenten - Sling-componenten

  • hulpverleners voor de ontwikkeling van toepassingen

• clientzijde:

  • een verzameling clientlibs die een woordenschat biedt (d.w.z. uitbreiding van de HTML-taal) om generieke interactiepatronen te bereiken via een door Hypermedia gestuurde UI

De generische graniet UI-component field bestaat uit twee belangstellende bestanden:

• init.jsp: verwerkt de generieke verwerking; een label, beschrijving en een formulierwaarde die u nodig hebt bij het weergeven van uw veld.
• render.jsp: Hier wordt de daadwerkelijke rendering van het veld uitgevoerd en moet deze worden overschreven voor het aangepaste veld. is opgenomen in init.jsp.

Raadpleeg de Granite UI-documentatie - Veld als u meer details wilt.

Zie voor voorbeelden:

• cqgems/customizingfield/components/colorpicker

  • door de Codevoorbeeld

• granite/ui/components/foundation/form

Het serverscript voor de component maken

Het aangepaste veld mag alleen het render.jsp script, waar u de markering voor uw component opgeeft. U kunt JSP (d.w.z. het teruggevende manuscript) als omslag voor uw prijsverhoging beschouwen.

1. Maak een nieuwe component die de sling:resourceSuperType over te nemen eigenschap van:

   /libs/granite/ui/components/foundation/form/field

2. Overschrijf het script:

   render.jsp

   In dit script moet u de hypermediamarkering genereren (verrijkte markering die de hypermediabelelans bevat), zodat de client weet hoe deze moet communiceren met het gegenereerde element. Dit zou de server-zijstijl van Granite UI van codering moeten volgen.

   Het enige contract dat u tijdens het aanpassen moet fulfill moet de formulierwaarde lezen (geïnitialiseerd in init.jsp) van het verzoek met:

   // Delivers the value of the field (read from the content)
   ValueMap vm = (ValueMap) request.getAttribute(Field.class.getName());
   vm.get("value, String.class");
   

   Voor meer informatie, gelieve te verwijzen naar de implementatie van uit-de-doos gebieden van de Vergroting UI; bijvoorbeeld: /libs/granite/ui/components/foundation/form/textfield.

   OPMERKING

   Op dit moment is JSP de voorkeursscriptmethode, aangezien het niet gemakkelijk is om informatie door te geven van de ene component naar de andere (die in de context van formulier/velden veel voorkomt) in HTML.

De clientbibliotheek voor de component maken

Specifiek gedrag aan de clientzijde toevoegen aan de component:

1. Een clientlib van een categorie maken cq.authoring.dialog.

2. Een clientlib van een categorie maken cq.authoring.dialog en definieer uw JS/ CSS erin.

   Definieer uw JS/ CSS in de clientlib.

   OPMERKING

   Op dit moment biedt de graniet-interface geen out-of-the-box listeners of haken die u rechtstreeks kunt gebruiken om JS-gedrag toe te voegen. Zo, om extra gedrag JS aan uw component toe te voegen, moet u een haak JS aan een douaneklasse uitvoeren die u dan aan uw component tijdens de prijsverhogingsgeneratie toewijst.

Business.Adobe.com-bronnen

Multichannel Communication Managed Cloud Content As A Service Web Content Management Dynamic Media Dynamic Forms