Använda och utöka widgetar (Classic UI) using-and-extending-widgets-classic-ui

NOTE
Den här sidan beskriver användningen av widgetar i det klassiska användargränssnittet, som togs bort i AEM 6.4.
Adobe rekommenderar att du använder modern pekaktiverat användargränssnitt baserat på Coral UI och Granite-gränssnitt.

Adobe Experience Manager (AEM) webbaserade gränssnitt använder AJAX och andra moderna webbläsartekniker för att möjliggöra WYSIWYG-redigering och -formatering av innehåll direkt på webbsidan.

AEM använder ExtJS widgetbiblioteket, som innehåller mycket prydliga gränssnittselement som fungerar i alla de viktigaste webbläsarna och gör det möjligt att skapa användargränssnitt i skrivbordsmiljö.

Dessa widgetar ingår i AEM och kan användas av alla webbplatser som byggs med AEM, utöver AEM.

En fullständig referens till alla tillgängliga widgetar i AEM finns i API-dokumentation för widget eller lista över befintliga xtypes. Dessutom finns det många exempel på hur du använder ExtJS-ramverket på Sencha webbplats, ramverkets ägare.

På den här sidan finns information om hur du använder och utökar widgetar. Först beskrivs hur inkludera klientsidig kod på en sida. Sedan beskrivs några exempelkomponenter som har skapats för att illustrera grundläggande användning och tillägg. Dessa komponenter är tillgängliga i Använda ExtJS-widgetar package on Paketresurs.

Paketet innehåller exempel på:

NOTE
Det klassiska användargränssnittet i Adobe Experience Manager bygger på ExtJS 3.4.0.

Inkludera klientsideskoden på en sida including-the-client-sided-code-in-a-page

Klientsidig JavaScript- och formatmallskod ska placeras i ett klientbibliotek.

Så här skapar du ett klientbibliotek:

  1. Skapa en nod nedan /apps/<project> med följande egenskaper:

    • name="clientlib"
    • jcr:mixinTypes="[mixa:låsbar]"
    • jcr:primärType="cq:ClientLibraryFolder"
    • sling:resourceType="widgets/clientlib"
    • categories="[<category-name>]"
    • beroenden="[cq.widgets]"

    Note: <category-name> is the name of the custom library (for example, "cq.extjstraining") and is used to include the library on the page.

  2. Nedanför clientlib skapa css och js mappar (not:folder).

  3. Nedanför clientlib skapa css.txt och js.txt filer (inte:filer). Dessa .txt-filer listar de filer som ingår i biblioteket.

  4. Redigera js.txt: måste börja med ' #base=js' följt av en lista över de filer som sammanställs av CQ-klientbibliotekstjänsten, till exempel:

    code language-none
    #base=js
     components.js
     exercises.js
     CustomWidget.js
     CustomBrowseField.js
     InsertTextPlugin.js
    
  5. Redigera css.txt: måste börja med ' #base=css' följt av en lista över de filer som sammanställs av CQ-klientbibliotekstjänsten, till exempel:

    code language-none
    #base=css
     components.css
    
  6. Under js placerar du de JavaScript-filer som tillhör biblioteket.

  7. Under css mapp, placera .css filer och de resurser som används av css-filerna (till exempel my_icon.png).

NOTE
Det är valfritt att hantera formatmallar som beskrivs ovan.

Så här inkluderar du klientbiblioteket i sidkomponentens jsp:

  • om du vill ta med både JavaScript-kod och formatmallar:
    <ui:includeClientLib categories="<category-name1>, <category-name2>, ..."/>
    där <category-nameX> är namnet på klientbiblioteket.

  • så att endast JavaScript-kod inkluderas:
    <ui:includeClientLib js="<category-name>"/>

Mer information finns i beskrivningen av <ui:includeClientLib>taggen🔗.</ui:includeClientLib>

Ibland bör ett klientbibliotek bara vara tillgängligt i redigeringsläge och bör exkluderas i publiceringsläge. Det kan uppnås på följande sätt:

    if (WCMMode.fromRequest(request) != WCMMode.DISABLED) {
        %><ui:includeClientLib categories="cq.collab.blog"/><%
    }

Komma igång med exemplen getting-started-with-the-samples

Installera paketet om du vill följa självstudiekurserna på den här sidan Använda ExtJS-widgetar i en lokal AEM och skapa en exempelsida där komponenterna inkluderas. Gör så här:

  1. I din AEM hämtar du paketet som anropas Använda ExtJS-widgetar (v01) från Paketresurs och installera paketet. Det skapar projektet extjstraining nedan /apps i databasen.
  2. Inkludera klientbiblioteket som innehåller skript (js) och formatmallen (css) i head-taggen för Geometrixx page jsp. Du kommer att inkludera exempelkomponenterna på en ny sida i Geometrixx gren: in CRXDE Lite öppna filen /apps/geometrixx/components/page/headlibs.jsp och lägg till cq.extjstraining till befintlig <ui:includeClientLib> -tagg enligt följande:
    %><ui:includeClientLib categories="apps.geometrixx-main, cq.extjstraining"/><%
  3. Skapa en sida i Geometrixx förgrening nedan /content/geometrixx/en/products och ringa Använda ExtJS-widgetar.
  4. Gå till designläge och lägg till alla komponenterna i gruppen som kallas Använda ExtJS-widgetar till utformningen av Geometrixx
  5. Gå tillbaka i redigeringsläge: komponenterna i gruppen Använda ExtJS-widgetar finns i Sidekick.
NOTE
Exemplen på den här Geometrixx baseras på exempelinnehållet, som inte längre levereras med AEM, som har ersatts av We.Retail. Se Implementering av referens för Vi.butik för att hämta och installera Geometrixx.

Grundläggande dialogrutor basic-dialogs

Dialogrutor används ofta för att redigera innehåll, men kan även visa information. Ett enkelt sätt att visa en komplett dialogruta är att få tillgång till dess representation i json-format. Om du vill göra det pekar du i webbläsaren på:

https://localhost:4502/<path-to-dialog>.-1.json

Den första komponenten i Använda ExtJS-widgetar gruppen i Sidekick anropas 1. Grundläggande om dialogrutor och innehåller fyra grundläggande dialogrutor som är byggda med färdiga widgetar och utan anpassad JavaScript-logik. Dialogrutorna sparas nedan /apps/extjstraining/components/dialogbasics. De grundläggande dialogrutorna är:

  • dialogrutan Fullständig ( full nod): visar ett fönster med tre flikar där varje flik har två textfält.
  • dialogrutan Enstaka panel( singlepanel node): den visar ett fönster med en flik som har två textfält.
  • dialogrutan Flera paneler( multipanel nod): den visas på samma sätt som dialogrutan Fullständig, men den byggs på ett annat sätt.
  • dialogrutan Design( design node): den visar ett fönster med två flikar. Den första fliken har ett textfält, en nedrullningsbar meny och ett komprimerbart textområde. Den andra fliken har ett fält med fyra textfält och ett komprimerbart fält med två textfält.

Inkludera 1. Grundläggande om dialogrutor -komponenten på exempelsidan:

  1. Lägg till 1. Grundläggande om dialogrutor till exempelsidan från Använda ExtJS-widgetar i Sidekick.
  2. Komponenten visar en titel, en del text och en EGENSKAPER länk. När du väljer länken visas egenskaperna för det stycke som lagras i databasen. Klicka på länken igen för att dölja egenskaperna.

Komponenten visas enligt följande:

chlimage_1-60

Exempel 1: Fullständig dialogruta example-full-dialog

The Fullständig visas ett fönster med tre flikar där varje flik har två textfält. Det är standarddialogrutan för Grundläggande om dialogrutor -komponenten. Dess egenskaper är följande:

  • Definieras av en nod: nodtyp = cq:Dialog, xtype = [dialog](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#dialog).
  • Visar tre flikar (nodtyp = cq:Panel).
  • Varje flik har två textfält (nodtyp = cq:Widget, xtype = [textfield](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#textfield)).
  • Definieras av noden:
    /apps/extjstraining/components/dialogbasics/full
  • Renderas i JSON-format genom att begära:
    https://localhost:4502/apps/extjstraining/components/dialogbasics/full.-1.json

Dialogrutan visas enligt följande:

screen_shot_2012-01-31at45411pm

Exempel 2: Dialogrutan En panel example-single-panel-dialog

The Enkel panel visas ett fönster med en flik som innehåller två textfält. Dess egenskaper är följande:

  • Visar en flik (nodtyp = cq:Dialog, xtype = [panel](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#panel))
  • Fliken har två textfält (nodtyp = cq:Widget, xtype = [textfield](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#textfield))
  • Definieras av noden:
    /apps/extjstraining/components/dialogbasics/singlepanel
  • Renderas i json-format genom att begära:
    https://localhost:4502/apps/extjstraining/components/dialogbasics/singlepanel.-1.json
  • En fördel framför Fullständig dialogruta är att mindre konfiguration behövs.
  • Rekommenderad användning: för enkla dialogrutor som visar information eller bara har ett fåtal fält.

Så här använder du dialogrutan En panel:

  1. Ersätta dialogrutan Grundläggande om dialogrutor -komponenten med Enkel panel dialog:

    1. I CRXDE Lite, ta bort noden: /apps/extjstraining/components/dialogbasics/dialog
    2. Klicka Spara alla för att spara ändringarna.
    3. Kopiera noden: /apps/extjstraining/components/dialogbasics/singlepanel
    4. Klistra in den kopierade noden nedan: /apps/extjstraining/components/dialogbasics
    5. Markera noden: /apps/extjstraining/components/dialogbasics/Copy of singlepaneloch byta namn på den dialog.
  2. Redigera komponenten: dialogrutan visas så här:

screen_shot_2012-01-31at45952pm

Exempel 3: Flera paneler example-multi-panel-dialog

The Flera paneler visas på samma sätt som Fullständig men den är uppbyggd på ett annat sätt. Dess egenskaper är följande:

  • Definieras av en nod (nodtyp = cq:Dialog, xtype = [tabpanel](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#tabpanel)).
  • Visar tre flikar (nodtyp = cq:Panel).
  • Varje flik har två textfält (nodtyp = , xtyp = cq:Widget [textfield](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#textfield)).
  • Definieras av noden:
    /apps/extjstraining/components/dialogbasics/multipanel
  • Renderas i json-format genom att begära:
    https://localhost:4502/apps/extjstraining/components/dialogbasics/multipanel.-1.json
  • En fördel framför Fullständig dialogruta är att den har en förenklad struktur.
  • Rekommenderas: för dialogrutor med flera flikar.

Använda dialogrutan Flera paneler:

  1. Ersätta dialogrutan Grundläggande om dialogrutor -komponenten med Flera paneler dialogrutan: följ stegen som beskrivs för Exempel 2: Dialogrutan En panel
  2. Redigera komponenten: dialogrutan visas så här:

screen_shot_2012-01-31at50119pm

Exempel 4: Multidialog example-rich-dialog

The Rich visas ett fönster med två flikar. Den första fliken har ett textfält, en nedrullningsbar meny och ett komprimerbart textområde. Den andra fliken har ett fält med fyra textfält och ett komprimerbart fält med två textfält. Dess egenskaper är följande:

  • Definieras av en nod (nodtyp = cq:Dialog, xtype = [dialog](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#dialog)).
  • Visar två flikar (nodtyp = cq:Panel).
  • Den första fliken har en [dialogfieldset](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#dialogfieldset) widget med en [textfield](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#textfield) och [selection](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#selection) widget med tre alternativ och en komprimerbar [dialogfieldset](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#dialogfieldset) med [textarea](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#textarea) widget.
  • Den andra fliken har en [dialogfieldset](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#dialogfieldset) widget med fyra [textfield](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#textfield) och en komprimerbar dialogfieldset med två [textfield](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#textfield) widgetar.
  • Definieras av noden:
    /apps/extjstraining/components/dialogbasics/rich
  • Renderas i json-format genom att begära:
    https://localhost:4502/apps/extjstraining/components/dialogbasics/rich.-1.json

Använd Rich dialog:

  1. Ersätta dialogrutan Grundläggande om dialogrutor -komponenten med Rich dialogrutan: följ stegen som beskrivs för Exempel 2: Dialogrutan En panel
  2. Redigera komponenten: dialogrutan visas så här:

screen_shot_2012-01-31at50429pm screen_shot_2012-01-31at50519pm

Dynamiska dialogrutor dynamic-dialogs

Den andra komponenten i Använda ExtJS-widgetar gruppen i Sidekick anropas 2. Dynamiska dialogrutor och innehåller tre dynamiska dialogrutor som är byggda med färdiga widgetar och med anpassad JavaScript-logik. Dialogrutorna sparas nedan /apps/extjstraining/components/dynamicdialogs. De dynamiska dialogrutorna är:

  • i dialogrutan Byt flikar ( switchtabs node): den visar ett fönster med två flikar. Den första fliken har en alternativmarkering med tre alternativ: när ett alternativ är markerat visas en flik som relaterar till alternativet. Den andra fliken har två textfält.
  • den godtyckliga dialogen ( arbitrary nod): visar ett fönster med en flik. Fliken innehåller ett fält där en resurs och ett fält som visar information om sidan som innehåller objektet och om resursen, om det finns någon referens till det, ska släppas eller överföras.
  • dialogrutan Växla fält ( togglefield nod): visar ett fönster med en flik. Fliken har en kryssruta: när den är markerad visas en fältuppsättning med två textfält.

Inkludera 2. Dynamiska dialogrutor -komponenten på exempelsidan:

  1. Lägg till 2. Dynamiska dialogrutor till exempelsidan från Använda ExtJS-widgetar i Sidekick.
  2. Komponenten visar en titel, en del text och en EGENSKAPER länk. När du väljer länken visas egenskaperna för det stycke som lagras i databasen. Klicka på länken igen för att dölja egenskaperna.

Komponenten visas enligt följande:

chlimage_1-61

Exempel 1: Dialogrutan Byt flik example-switch-tabs-dialog

The Växla flikar visas ett fönster med två flikar. Den första fliken har en alternativmarkering med tre alternativ: när ett alternativ är markerat visas en flik som relaterar till alternativet. Den andra fliken har två textfält.

Dess huvudsakliga egenskaper är:

  • Definieras av en nod (nodtyp = cq:Dialog, xtype = [dialog](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#dialog)).
  • Visar två flikar (nodtyp = cq:Panel): en markeringsflik, den andra fliken beror på markeringen på den första fliken (tre alternativ).
  • Har tre valfria flikar (nodtyp = cq:Panel) har vart och ett två textfält (nodtyp = cq:Widget, xtype = [textfield](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#textfield)). Endast en valfri flik i taget visas.
  • Definieras av switchtabs nod vid:
    /apps/extjstraining/components/dynamicdialogs/switchtabs
  • Renderas i json-format genom att begära:
    https://localhost:4502/apps/extjstraining/components/dynamicdialogs/switchtabs.-1.json

Logiken implementeras med händelseavlyssnare och JavaScript-kod enligt följande:

  • Dialognoden har en beforeshow" som döljer alla valfria flikar innan dialogrutan visas:
    beforeshow="function(dialog){Ejst.x2.manageTabs(dialog.items.get(0));}"
    dialog.items.get(0) får tabpanel som innehåller markeringspanelen och de tre valfria panelerna.
  • The Ejst.x2 -objektet definieras i exercises.js fil på:
    /apps/extjstraining/clientlib/js/exercises.js
  • I Ejst.x2.manageTabs() metod, som värdet för index är -1 är alla valfria flikar dolda (i går från 1 till 3).
  • Markeringsfliken har två avlyssnare: en som visar den valda fliken när dialogrutan läses in (" loadcontent" -händelse) och en som visar den valda fliken när markeringen ändras (" selectionchanged" event):
    loadcontent="function(field,rec,path){Ejst.x2.showTab(field);}"
    selectionchanged="function(field,value){Ejst.x2.showTab(field);}"
  • För Ejst.x2.showTab() metod,
    field.findParentByType('tabpanel') får tabpanel som innehåller alla flikar ( field representerar markeringswidgeten)
    field.getValue() hämtar värdet för markeringen, till exempel tab2
    Ejst.x2.manageTabs() visar den valda fliken.
  • Varje valfri flik har en avlyssnare som döljer fliken på render" event:
    render="function(tab){Ejst.x2.hideTab(tab);}"
  • För Ejst.x2.hideTab() metod,
    tabPanel är den tabpanel som innehåller alla flikar
    index är indexet för den valfria fliken
    tabPanel.hideTabStripItem(index) Döljer fliken

Den visas enligt följande:

screen_shot_2012-02-01at114745am

Exempel 2: Godtycklig dialogruta example-arbitrary-dialog

I en dialogruta visas ofta innehåll från den underliggande komponenten. Dialogrutan som beskrivs här kallas Godtycklig i hämtar innehåll från en annan komponent.

The Godtycklig visas ett fönster med en flik. Fliken har två fält: ett för att släppa eller överföra en resurs och ett för att visa viss information om behållarsidan och om resursen om det finns referenser till en sådan.

Dess huvudsakliga egenskaper är:

  • Definieras av en nod (nodtyp = cq:Dialog, xtype = [dialog](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#dialog)).
  • Visar ett tabpanel widget (nodtyp = cq:Widget, xtype = [tabpanel](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#tabpanel)) med en panel (nodtyp = cq:Panel)
  • Panelen har en smartfile-widget (nodtyp = cq:Widget, xtype = [smartfile](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#smartfile)) och en egen widget (nodtyp = cq:Widget, xtype = [ownerdraw](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#ownerdraw))
  • Definieras av arbitrary nod vid:
    /apps/extjstraining/components/dynamicdialogs/arbitrary
  • Renderas i json-format genom att begära:
    https://localhost:4502/apps/extjstraining/components/dynamicdialogs/arbitrary.-1.json

Logiken implementeras med händelseavlyssnare och JavaScript-kod enligt följande:

  • The ownerdraw widgeten har en loadcontent" som visar information om sidan som innehåller komponenten. Det vill säga den resurs som smartfile-widgeten refererar till när innehållet läses in:
    loadcontent="function(field,rec,path){Ejst.x2.showInfo(field,rec,path);}"
    field är inställt med ownerdraw object
    path ställs in med komponentens innehållssökväg (till exempel /content/geometrixx/en/products/triangle/ui-tutorial/jcr:content/par/dynamicdialogs)
  • The Ejst.x2 -objektet definieras i exercises.js fil på:
    /apps/extjstraining/clientlib/js/exercises.js
  • För Ejst.x2.showInfo() metod,
    pagePath är banan för den sida som innehåller komponenten,
    pageInfo representerar sidegenskaperna i json-format,
    reference är sökvägen till den refererade tillgången,
    metadata representerar tillgångens metadata i json-format,
    ownerdraw.getEl().update(html); visar den skapade HTML-koden i dialogrutan

Använd Godtycklig dialog:

  1. Ersätt dialogrutan för komponenten Dynamisk dialogruta med dialogrutan Godtycklig:
    följ stegen som beskrivs för Exempel 2: Dialogrutan En panel
  2. Redigera komponenten: dialogrutan visas på följande sätt:

screen_shot_2012-02-01at115300am

Exempel 3: Växla fält example-toggle-fields-dialog

The Växla fält visas ett fönster med en flik. Fliken har en kryssruta: när den är markerad visas en fältuppsättning med två textfält.

Dess viktigaste egenskaper är:

  • Definieras av en nod (nodtyp = , xtyp = cq:Dialog [dialog](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#dialog)).
  • Visar en widget (nodtyp = , xtyp = ) med en tabpanel panel (nodtyp = [tabpanel](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#textpanel) cq:Widget cq:Panel).
  • Panelen har en urvals-/kryssrutewidget (nodtyp = , xtype = , type = ) och en komprimerbar dialogfältuppsättningswidget (nodtyp = , xtype = ) som är dold som standard, med två textfältswidgetar (nodtyp = , xtype = cq:Widget [dialogfieldset](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#dialogfieldset) [selection](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#selection) [textfield](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#textfield) [checkbox](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#checkbox) cq:Widget cq:Widget).
  • Definieras av togglefields nod vid:
    /apps/extjstraining/components/dynamicdialogs/togglefields
  • Renderas i json-format genom att begära:
    https://localhost:4502/apps/extjstraining/components/dynamicdialogs/togglefields.-1.json

Logiken implementeras med händelseavlyssnare och JavaScript-kod enligt följande:

  • urvalsfliken har två avlyssnare: en som visar dialogfältuppsättningen när innehållet läses in (" loadcontent" event) och en som visar dialogrutans fältuppsättning när markeringen ändras (" selectionchanged" event):
    loadcontent="function(field,rec,path){Ejst.x2.toggleFieldSet(field);}"
    selectionchanged="function(field,value){Ejst.x2.toggleFieldSet(field);}"
  • The Ejst.x2 -objektet definieras i exercises.js fil på:
    /apps/extjstraining/clientlib/js/exercises.js
  • För Ejst.x2.toggleFieldSet() metod,
    box är markeringsobjektet,
    panel är den panel som innehåller markeringen och dialogfältuppsättningswidgetar,
    fieldSet är dialogfältuppsättningsobjektet,
    show är värdet för markeringen (true eller false), baserat på ' show' dialogfältuppsättningen visas eller inte

Använd Växla fält gör du följande:

  1. Ersätta dialogrutan Dynamisk dialogruta -komponenten med Växla fält dialogrutan: följ stegen som beskrivs för Exempel 2: Dialogrutan En panel
  2. Redigera komponenten: dialogrutan visas så här:

screen_shot_2012-02-01at115518am

Anpassade widgetar custom-widgets

De färdiga widgetarna som levereras med AEM bör omfatta de flesta användningsfall. Ibland kan det dock vara nödvändigt att skapa en anpassad widget som täcker ett projektspecifikt krav. Du kan skapa anpassade widgetar genom att utöka befintliga. För att du ska komma igång med en sådan anpassning Using ExtJS Widgets paketet innehåller tre dialogrutor som använder tre olika anpassade widgetar:

  • Dialogrutan Flera fält ( multifield nod) visar ett fönster med en flik. Fliken har en anpassad widget för flera fält som har två fält: en nedrullningsbar meny med två alternativ och ett textfält. Baserat på färdiga multifield widgeten (som bara har ett textfält) har den alla funktioner som finns i multifield widget.
  • dialogrutan Trädbläddring ( treebrowse nod) visar ett fönster med en flik som innehåller en sökvägs-widget: när du klickar på pilen öppnas ett fönster där du kan bläddra i en hierarki och markera ett objekt. Sökvägen för objektet läggs sedan till i sökvägsfältet och bevaras när dialogrutan stängs.
  • en dialogruta baserad på ett plugin-program för RTF-redigering ( rteplugin nod) som lägger till en anpassad knapp i RTF-redigeraren för att infoga anpassad text i huvudtexten. Den består av en richtext widgeten (RTE) och en anpassad funktion som läggs till via plugin-programmet för textredigering.

De anpassade widgetarna och plugin-programmet ingår i komponenten som kallas 3. Anpassade widgetar för paketet Using ExtJS Widgets . Så här inkluderar du den här komponenten på exempelsidan:

  1. Lägg till 3. Anpassade widgetar till exempelsidan från fliken Använda ExtJS-widgetar ​i Sidekick.
  2. Komponenten visar en titel, lite text och, när du klickar på länken PROPERTIES , egenskaperna för det stycke som lagras i databasen. Om du klickar igen döljs egenskaperna.
    Komponenten visas enligt följande:

chlimage_1-62

Exempel 1: Anpassad widget för flera fält example-custom-multifield-widget

The Anpassat multifält widgetbaserad dialogruta visar ett fönster med en flik. Fliken har en anpassad widget för flera fält som, till skillnad från standardwidgeten som har ett fält, har två fält: en listruta med två alternativ och ett textfält.

The Anpassat multifält widgetbaserad dialogruta:

  • Definieras av en nod (nodtyp = cq:Dialog, xtype = [dialog](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#dialog)).

  • Visar ett tabpanel widget (nodtyp = cq:Widget, xtype = [tabpanel](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#tabpanel)) som innehåller en panel (nodtyp = cq:Widget, xtype = [panel](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#panel)).

  • Panelen har en multifield widget (nodtyp = cq:Widget, xtype = [multifield](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#multifield)).

  • The multifield widgeten har en fältkonfiguration (nodtyp = nt:unstructured, xtype = ejstcustom, optionsProvider = Ejst.x3.provideOptions) som baseras på den anpassade xtype ' ejstcustom':

    • ' fieldconfig' är ett config-alternativ för [CQ.form.MultiField](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.form.MultiField) -objekt.

    • ' optionsProvider' är en konfiguration av ejstcustom widget. Den är inställd med Ejst.x3.provideOptions metod som definieras i exercises.js vid:

      /apps/extjstraining/clientlib/js/exercises.js
      och returnerar två alternativ.

  • Definieras av multifield nod vid:
    /apps/extjstraining/components/customwidgets/multifield

  • Renderas i json-format genom att begära:
    https://localhost:4502/apps/extjstraining/components/customwidgets/multifield.-1.json

Den anpassade multifield widget (xtype = ejstcustom):

  • Är ett JavaScript-objekt som anropas Ejst.CustomWidget

  • Är definierad i CustomWidget.js JavaScript-fil på:
    /apps/extjstraining/clientlib/js/CustomWidget.js

  • Utökar [CQ.form.CompositeField](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.form.CompositeField) widget.

  • Har tre fält: hiddenField (textfält), allowField (ComboBox), och otherField (Textfält)

  • Åsidosättningar CQ.Ext.Component#initComponent för att lägga till de tre fälten:

    • allowField är en CQ.form.Selection objekt av typen 'select'. optionsProvider är en konfiguration av Selection-objektet som initieras med optionsProvider-konfigurationen för CustomWidget som definierats i dialogrutan
    • otherField är en CQ.Ext.form.TextField object
  • Åsidosätter metoderna setValue, getValue, och CQ.form.CompositeField🔗 för att ange och getRawValue hämta värdet för CustomWidget med formatet:
    <allowField value>/<otherField value>, for example: 'Bla1/hello'.

  • Registrerar sig själv som ejstcustom' xtype:
    CQ.Ext.reg('ejstcustom', Ejst.CustomWidget);

The Anpassat multifält widgetbaserad dialogruta visas enligt följande:

screen_shot_2012-02-01at115840am

Exempel 2: Anpassad Treebrowse widget example-custom-treebrowse-widget

I den anpassade Treebrowse widgetbaserade dialogrutan visas ett fönster med en flik som innehåller en anpassad bläddringswidget för sökvägar. När du klickar på pilen öppnas ett fönster där du kan bläddra i en hierarki och välja ett objekt. Sökvägen till objektet läggs sedan till i sökvägsfältet och sparas när dialogrutan stängs.

Den anpassade treebrowse dialogrutan:

  • Definieras av en nod (nodtyp = , xtyp = cq:Dialog [dialog](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#dialog)).
  • Visar ett tabpanel widget (nodtyp = cq:Widget, xtype = [tabpanel](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#tabpanel)) som innehåller en panel (nodtyp = cq:Widget, xtype = [panel](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#panel)).
  • Panelen har en anpassad widget (nodtyp = cq:Widget, xtype = ejstbrowse)
  • Definieras av treebrowse nod vid:
    /apps/extjstraining/components/customwidgets/treebrowse
  • Renderas i json-format genom att begära:
    https://localhost:4502/apps/extjstraining/components/customwidgets/treebrowse.-1.json

Widgeten för anpassad trädbläddring (xtype = ejstbrowse):

  • Är ett JavaScript-objekt som anropas Ejst.CustomWidget

  • Är definierad i CustomBrowseField.js JavaScript-fil på:
    /apps/extjstraining/clientlib/js/CustomBrowseField.js

  • Utökar [CQ.Ext.form.TriggerField](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.Ext.form.TriggerField).

  • Definierar ett bläddringsfönster med namnet browseWindow.

  • Åsidosättningar [CQ.Ext.form.TriggerField](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.Ext.form.TriggerField)#onTriggerClick för att visa bläddringsfönstret när någon klickar på pilen.

  • Definierar en CQ.Ext.tree.TreePanel objekt:

    • Den hämtar sina data genom att anropa den server som är registrerad på /bin/wcm/siteadmin/tree.json.
    • Dess rot är " apps/extjstraining".
  • Definierar en window objekt ( [CQ.Ext.Window](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.Ext.Window)):

    • Baserat på den fördefinierade panelen.
    • Har en OK som anger värdet för den markerade banan och döljer panelen.
  • Fönstret är förankrat under Bana fält.

  • Den valda sökvägen skickas från bläddringsfältet till fönstret på show -händelse.

  • Registrerar sig själv som ejstbrowse' xtype:
    CQ.Ext.reg('ejstbrowse', Ejst.CustomBrowseField);

Använd Anpassad trädbläddring widgetbaserad dialogruta:

  1. Ersätta dialogrutan Anpassade widgetar -komponenten med Anpassad trädbläddring dialogrutan: följ stegen som beskrivs för Exempel 2: Dialogrutan En panel
  2. Redigera komponenten: dialogrutan visas så här:

screen_shot_2012-02-01at120104pm

Exempel 3: Plugin-program för RTE-redigerare (Rich Text Editor) example-rich-text-editor-rte-plug-in

Den RTE-baserade dialogrutan (Rich Text Editor) är en RTE-baserad dialogruta som har en anpassad knapp för att infoga anpassad text inom hakparenteser. Den anpassade texten kan parsas av viss logik på serversidan (implementeras inte i det här exemplet), till exempel för att lägga till text som definieras på den angivna sökvägen:

Den RTE-plugin-baserade dialogrutan:

  • Definieras av plugin-programnoden på:
    /apps/extjstraining/components/customwidgets/rteplugin
  • Renderas i json-format genom att begära:
    https://localhost:4502/apps/extjstraining/components/customwidgets/rteplugin.-1.json
  • The rtePlugins noden har en underordnad nod inserttext (nodtyp = nt:unstructured) som namnges efter plugin-programmet. Den har en egenskap som heter features som definierar vilka av plugin-programfunktionerna som är tillgängliga för RTE.

RTE-plugin:

  • Är ett JavaScript-objekt som anropas Ejst.InsertTextPlugin

  • Är definierad i InsertTextPlugin.js JavaScript-fil på:
    /apps/extjstraining/clientlib/js/InsertTextPlugin.js

  • Utökar [CQ.form.rte.plugins.Plugin](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.form.rte.plugins.Plugin) -objekt.

  • Följande metoder definierar [CQ.form.rte.plugins.Plugin](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.form.rte.plugins.Plugin) -objekt och åsidosätts i implementerings-plugin-programmet:

    • getFeatures() returnerar en array med alla funktioner som plugin-programmet gör tillgängliga.
    • initializeUI() lägger till den nya knappen i verktygsfältet för textredigering.
    • notifyPluginConfig() visar rubrik och text när knappen hovras.
    • execute() anropas när användaren klickar på knappen och utför en plugin-åtgärd: det visar ett fönster som används för att definiera texten som ska inkluderas.
  • insertText() infogar en text med hjälp av motsvarande dialogobjekt Ejst.InsertTextPlugin.Dialog (se efteråt).

  • executeInsertText() anropas av apply() metod i dialogrutan som aktiveras när OK klickas på knappen.

  • Registrerar sig själv som inserttext' plugin:
    CQ.form.rte.plugins.PluginRegistry.register("inserttext", Ejst.InsertTextPlugin);

  • den Ejst.InsertTextPlugin.Dialog -objektet definierar den dialogruta som öppnas när plugin-knappen klickas. Dialogrutan består av en panel, ett formulär, ett textfält och två knappar (OK och Avbryt).

Använd RTE-plugin (Rich Text Editor) baserad dialogruta:

  1. Ersätta dialogrutan Anpassade widgetar -komponenten med RTE-plugin (Rich Text Editor) baserad dialogruta: följ stegen som beskrivs för Exempel 2: Dialogrutan En panel
  2. Redigera komponenten.
  3. Klicka på den sista ikonen till höger (den med fyra pilar). Ange en bana och klicka OK: Sökvägen visas inom hakparenteser ([ ]).
  4. Klicka OK så att du stänger RTF-redigeraren.

Den plugin-baserade dialogrutan för RTE-baserad (Rich Text Editor) visas på följande sätt:

screen_shot_2012-02-01at120254pm

NOTE
I det här exemplet visas bara hur du implementerar klientdelen av logiken: platshållarna ([text]) måste sedan tolkas explicit på serversidan (till exempel i komponent-JSP).

Översikt över träd tree-overview

En färdig lösning [CQ.Ext.tree.TreePanel](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.Ext.tree.TreePanel) -objektet tillhandahåller trädstrukturerad gränssnittsrepresentation av trädstrukturerade data. Komponenten Trädöversikt som ingår i paketet Using ExtJS Widgets visar hur du TreePanel använder objektet för att visa ett JCR-träd under en viss sökväg. Själva fönstret kan dockas/avdockas. I det här exemplet är fönsterlogiken inbäddad i komponenten jsp mellan <script> taggar.

Så här inkluderar du komponenten Trädöversikt på exempelsidan:

  1. Lägg till 4. Trädöversiktskomponenten till exempelsidan från fliken Använda ExtJS-widgetar i Sidekick.

  2. Komponenten visar:

    • en titel, med text
    • a EGENSKAPER länk: klicka för att visa egenskaperna för det stycke som lagras i databasen. Klicka igen för att dölja egenskaperna.
    • ett flytande fönster med en trädrepresentation av databasen som kan expanderas.

Komponenten visas enligt följande:

screen_shot_2012-02-01at120639pm

Komponenten Trädöversikt:

  • Definieras vid:
    /apps/extjstraining/components/treeoverview

  • I dialogrutan kan du ange fönstrets storlek och docka eller avdocka fönstret (se informationen nedan).

Komponent-jsp:

  • Hämtar egenskaperna width, height och dockad från databasen.
  • Visar text om trädöversiktens dataformat.
  • Bäddar in fönsterlogiken i komponent-jsp mellan JavaScript-taggar.
  • Definieras vid:
    apps/extjstraining/components/treeoverview/content.jsp

Den JavaScript-kod som är inbäddad i komponent-jsp:

  • Definierar en tree genom att försöka hämta ett trädfönster från sidan.

  • Om fönstret som visar trädet inte finns, treePanel (CQ.Ext.tree.TreePanel) skapas:

    • treePanel innehåller de data som används för att skapa fönstret.

    • Data hämtas genom att anropa servern som är registrerad på:

      /bin/wcm/siteadmin/tree.json

  • The beforeload avlyssnaren kontrollerar att den valda noden har lästs in.

  • The root objektet anger sökvägen apps/extjstraining som trädroten.

  • tree ( [CQ.Ext.Window](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.Ext.Window)) anges baserat på fördefinierade treePaneloch visas med:
    tree.show();

  • Om fönstret finns visas det baserat på egenskaperna width, height och dockad som hämtats från databasen.

Komponentdialogrutan:

  • Visar en flik med två fält som anger storleken (bredd och höjd) på trädöversiktsfönstret och ett fält som kan dockas/avdockas i fönstret
  • Definieras av en nod (nodtyp = cq:Dialog, xtype = [panel](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#panel)).
  • Panelen har en widget för storleksfält (nodtyp = cq:Widget, xtype = [sizefield](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#sizefield)) och en markeringswidget (nodtyp = cq:Widget, xtype = [selection](/docs/experience-manager-65/content/implementing/developing/components/classic-ui-components/xtypes.md#selection), typ = radio) med två alternativ (true/false)
  • Definieras av dialognoden vid:
    /apps/extjstraining/components/treeoverview/dialog
  • Renderas i json-format genom att begära:
    https://localhost:4502/apps/extjstraining/components/treeoverview/dialog.-1.json
  • Visar följande:

screen_shot_2012-02-01at120745pm

Stödrasteröversikt grid-overview

En rutnätspanel representerar data i tabellformat för rader och kolumner. Den består av följande:

  • Store: Den modell som innehåller dataposterna (rader).
  • Kolumnmodell: kolumnsammansättning.
  • View : kapslar in användargränssnittet.
  • Markeringsmodell : markeringsbeteendet.

Stödrasteröversiktskomponenten som ingår i Använda ExtJS-widgetar paketet visar hur du visar data i tabellformat:

  • I exempel 1 används statiska data.
  • I exempel 2 används data som hämtats från databasen.

Så här tar du med komponenten Stödrasteröversikt till exempelsidan:

  1. Lägg till 5. Stödrasteröversikt till exempelsidan från Använda ExtJS-widgetar i Sidekick.

  2. Komponenten visar:

    • en titel med text
    • a EGENSKAPER länk: klicka för att visa egenskaperna för det stycke som lagras i databasen. Klicka igen för att dölja egenskaperna.
    • ett flytande fönster som innehåller data i tabellformat.

Komponenten visas enligt följande:

screen_shot_2012-02-01at121109pm

Exempel 1: Standardstödraster example-default-grid

I den färdiga versionen visar komponenten Rutnätsöversikt ett fönster med statiska data i tabellformat. I det här exemplet är logiken inbäddad i komponenten jsp på två sätt:

  • Den generiska logiken definieras mellan <script> taggar
  • den specifika logiken finns i en separat .js-fil och är länkad till den i jsp-filen. Med den här inställningen kan du växla mellan de två logiken (statisk/dynamisk) genom att kommentera det önskade <script> -taggar.

Komponenten Stödrasteröversikt:

  • Definieras på:
    /apps/extjstraining/components/gridoverview
  • I dialogrutan kan du ställa in fönstrets storlek och docka eller avdocka fönstret.

Komponenten jsp:

  • Hämtar egenskaperna width, height och docked från databasen.
  • Visar text som introduktion till dataformatet för tabellöversikt.
  • Refererar till JavaScript-kod som definierar GridPanel-objektet:
    <script type="text/javascript" src="/apps/extjstraining/components/gridoverview/defaultgrid.js"></script>
    defaultgrid.js definierar vissa statiska data som bas för GridPanel-objektet.
  • Bäddar in JavaScript-kod mellan JavaScript-taggar som definierar det Window-objekt som använder GridPanel-objektet.
  • Definieras vid:
    apps/extjstraining/components/gridoverview/content.jsp

Den JavaScript-kod som är inbäddad i komponent-jsp:

  • Definierar grid genom att försöka hämta fönsterkomponenten från sidan:
    var grid = CQ.Ext.getCmp("<%= node.getName() %>-grid");
  • If grid finns inte, CQ.Ext.grid.GridPanel objekt ( gridPanel) definieras genom att anropa getGridPanel() metod (se nedan). Den här metoden definieras i defaultgrid.js.
  • grid är en [CQ.Ext.Window](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.Ext.Window) -objekt, baserat på den fördefinierade GridPanel, och visas: grid.show();
  • If grid finns, visas den baserat på bredd, höjd och dockade egenskaper som hämtats från databasen.

JavaScript-filen ( defaultgrid.js) som refereras i komponenten jsp definierar getGridPanel() som anropas av skriptet som är inbäddat i JSP och returnerar en [CQ.Ext.grid.GridPanel](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.Ext.grid.GridPanel) -objekt, baserat på statiska data. Logiken är följande:

  • myData är en array med statiska data som formaterats som en tabell med fem kolumner och fyra rader.

  • store är en CQ.Ext.data.Store objekt som förbrukar myData.

  • store har lästs in i minnet:
    store.load();

  • gridPanel är en [CQ.Ext.grid.GridPanel](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.Ext.grid.GridPanel) objekt som förbrukar store:

    • kolumnbredderna ändras alltid:

      forceFit: true

    • bara en rad åt gången kan markeras:

      singleSelect:true

Exempel 2: Referenssökstödraster example-reference-search-grid

När du installerar paketet content.jsp i Stödrasteröversikt -komponenten visar ett rutnät som baseras på statiska data. Det går att ändra komponenten så att ett rutnät visas med följande egenskaper:

  • Har tre kolumner.
  • Baseras på data som hämtats från databasen genom att anropa en server.
  • Cellerna i den sista kolumnen kan redigeras. Värdet sparas i en test egenskapen under noden som definieras av sökvägen som visas i den första kolumnen.

Fönsterobjektet får sin [CQ.Ext.grid.GridPanel](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.Ext.grid.GridPanel) genom att anropa getGridPanel() metod som definieras i defaultgrid.js fil på /apps/extjstraining/components/gridoverview/defaultgrid.js. Komponenten Grid Overview ​ ger en annan implementering för getGridPanel() metod, definition i referencesearch.js fil på /apps/extjstraining/components/gridoverview/referencesearch.js. Genom att byta .js-fil som refereras i komponentens jsp, baseras rutnätet på data som hämtas från databasen.

Byt .js-fil som refereras i komponent-jsp:

  1. I CRXDE Lite, i content.jsp komponentfilen, kommentera raden som innehåller defaultgrid.js så att den ser ut så här:
    <!-- script type="text/javascript" src="/apps/extjstraining/components/gridoverview/defaultgrid.js"></script-->
  2. Ta bort kommentaren från raden som innehåller referencesearch.js så att den ser ut så här:
    <script type="text/javascript" src="/apps/extjstraining/components/gridoverview/referencesearch.js"></script>
  3. Spara ändringarna.
  4. Uppdatera exempelsidan.

Komponenten visas enligt följande:

screen_shot_2012-02-01at121429pm

JavaScript-koden som komponenten jsp refererar till ( referencesearch.js) definierar getGridPanel() metod som anropas från komponent-jsp och returnerar en [CQ.Ext.grid.GridPanel](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.Ext.grid.GridPanel) -objekt, baserat på data som hämtas dynamiskt från databasen. Logiken i referencesearch.js definierar vissa dynamiska data som bas för GridPanel:

  • reader är en [CQ.Ext.data.JsonReader](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.Ext.data.JsonReader)objekt som läser serverletssvaret i json-format för tre kolumner.

  • cm är en [CQ.Ext.grid.ColumnModel](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.Ext.grid.ColumnModel) -objekt för tre kolumner.
    Kolumncellerna i kolumnen"Testa" kan redigeras så som de definieras med en redigerare:
    editor: new [CQ.Ext.form.TextField](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.Ext.form.TextField)({})

  • kolumnerna kan sorteras:
    cm.defaultSortable = true;

  • store är en [CQ.Ext.data.GroupingStore](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.Ext.data.GroupingStore) objekt:

    • hämtar data genom att anropa den server som är registrerad på " /bin/querybuilder.json" med några parametrar för att filtrera frågan
    • baseras på reader, definierad i förväg
    • tabellen sorteras enligt 'jcr:sökväg' kolumn i stigande ordning
  • gridPanel är en [CQ.Ext.grid.EditorGridPanel](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.Ext.grid.EditorGridPanel) objekt som kan redigeras:

    • baseras på den fördefinierade store och i kolumnmodellen cm

    • bara en rad åt gången kan markeras:

      sm: new [CQ.Ext.grid.RowSelectionModel](https://developer.adobe.com/experience-manager/reference-materials/6-5/widgets-api/index.html?class=CQ.Ext.grid.RowSelectionModel)({singleSelect:true})

    • den afteredit avlyssnaren ser till att efter en cell i Testa kolumnen har redigerats:

      • egenskapen ' test' för noden vid sökvägen som definieras av "jcr:sökväg" -kolumnen ställs in i databasen med cellens värde
      • om POSTEN lyckas läggs värdet till i store objekt, annars avvisas det
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2