Dokumentation AEM Guides Dokumentation om AEM Guides

Anpassa verktygsfältet id172FB00L0V6

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:
KONFIGURATION AV WEBBREDIGERARE

Skapat för:

Erfaren
Administratör

Som standard levereras webbredigeraren med de vanligaste redigeringsfunktionerna som krävs av alla DITA-redigerare. Du kan använda funktioner som att infoga element av typen lista (numrerad eller punktad), korsreferens, innehållsreferens, tabell-, stycke- och teckenformatering i redigeraren. Förutom dessa grundläggande element kan du anpassa Web Editor för att infoga element som används i redigeringsmiljön.

Det finns två sätt att anpassa Web Editors verktygsfält:

Lägga till en ny funktion i verktygsfältet
Ta bort alla befintliga funktioner från verktygsfältet

Lägga till en funktion i verktygsfältet

Om du lägger till en funktion i Web Editor innebär det två primära åtgärder - att lägga till en ikon för funktionen i filen ui_config.json och lägga till bakgrundsfunktionen i JavaScript.

Gör så här för att lägga till en funktion i Web Editor-verktygsfältet:

Om du vill hämta UI-konfigurationsfilen loggar du in på Adobe Experience Manager som administratör.
Klicka på länken Adobe Experience Manager överst och välj Verktyg.
Välj Stödlinjer i listan över verktyg och klicka på Mappprofiler.
Klicka på rutan Global profil.
Välj fliken Konfiguration av XML-redigerare och klicka på ikonen Redigera överst
Klicka på ikonen Hämta för att hämta filen ui_config.json på din lokala dator. Du kan sedan göra ändringar i filen och sedan överföra samma fil.

I filen ui_config.json lägger du till definitionen för den nya funktionen i verktygsfältsavsnittet. Spara filen och överför den.

Vanligtvis kan du skapa en ny verktygsfältsknappgrupp och lägga till en eller flera knappar i den. Du kan också lägga till en ny verktygsfältsknapp i en befintlig verktygsfältgrupp. Följande information krävs för att skapa en ny verktygsfältgrupp:

typ: Ange blockGroup som type -värde. Detta värde anger att du skapar en blockgrupp som skulle innehålla en eller flera verktygsfältsgrupper.

extraclass: Namnet på klassen eller klasserna avgränsade med blanksteg.

objekt: Ange definitionen för alla grupper i verktygsfältet. Varje grupp kan innehålla en eller flera verktygsfältsikoner. Om du vill definiera ikoner i en verktygsfältsgrupp måste du definiera attributet type igen i items och ange dess värde som buttonGroup. Ange ett eller flera klassnamn i egenskapen extraclass. Ange funktionsnamnet i egenskapen label. I följande utdrag från filen ui_config.json visas definitionen för huvudverktygsfältets block, följt av definitionen buttonGroup:

code language-none
`" "toolbar": "type": "blockGroup", "extraclass": "toolbar operations", "objekt": [`

} {
"type": "buttonGroup",
"extraclass": "left-controls",
"label": "Left Controls",
"objekt": [
] "

I samlingen items måste du ange definitionen för en eller flera verktygsfältsikoner.

Du måste definiera följande egenskaper för att lägga till en verktygsfältsikon:

typ: Ange button som type -värde. Detta värde anger att du lägger till en verktygsfältsknapp.

ikon: Ange namnet på den korallikon som du vill använda i verktygsfältet.

variant: Ange quiet som variant -värde.

titel: Ange verktygstipset för ikonen.

on-click: Ange kommandonamnet som är definierat för funktionen i JavaScript-filen. Om kommandot kräver indataparametrar anger du kommandonamnet som:

   &quot;JavaScript
   &quot;on-click&quot;: {&quot;name&quot;: &quot;AUTHOR_INSERT_ELEMENT&quot;, &quot;args&quot;: &quot;simpletable&quot;}
   &quot;

visa eller dölj: Om du definierar egenskapen show anger du de lägen som ikonen ska visas i. Möjliga värden är - @isAuthorMode, @isSourceMode, @isPreviewMode, true (visa i alla lägen) eller false (dölj i alla lägen).

I stället för show kan du också definiera egenskapen hide. Möjliga värden är desamma som i egenskapen show med den enda skillnaden att ikonen inte visas för det angivna läget.

I följande exempel visas AEM Guides versionsnummer när användaren klickar på ikonen Visa version i verktygsfältet.

Lägg till följande kod i en JavaScript-fil:

$(document).ready(setTimeout(function() {
                        fmxml.commandHandler.subscribe({
                        key: 'user.alert',
                        next: function() {
                        alert("AEM Guides version x.x")
                        }
                        })
                        }, 1000))

Lägg till funktionen i filen ui_config.json som:

"type": "button",
"icon": "alert","variant": "quiet","title": "About AEM Guides","show": "true","on-click": "user.alert"

Skapa en clientlib-mapp och lägg till din JavaScript i den här mappen.
Uppdatera egenskapen categories i mappen clientlib genom att tilldela den värdet för apps.fmdita.xml_editor.page_overrides.
Spara filen ui_config.json och läs in webbredigeraren igen.

Ta bort en funktion från verktygsfältet

Ibland kanske du inte vill ge alla funktioner som är tillgängliga i Web Editor, och då kan du ta bort den oönskade funktionen från Web Editor.

Så här tar du bort oönskade funktioner från verktygsfältet:

Om du vill hämta UI-konfigurationsfilen loggar du in på Adobe Experience Manager som administratör.
Klicka på länken Adobe Experience Manager överst och välj Verktyg.
Välj Stödlinjer i listan över verktyg och klicka på Mappprofiler.
Klicka på rutan Global profil.
Välj fliken Konfiguration av XML-redigerare och klicka på ikonen Redigera överst

Klicka på ikonen Hämta för att hämta filen ui_config.json på din lokala dator. Du kan sedan göra ändringar i filen och sedan överföra samma fil.

Filen ui_config.json har tre avsnitt:

verktygsfält: Det här avsnittet innehåller en definition av alla funktioner som är tillgängliga i redigerarens verktygsfält, t.ex. Infoga/ta bort numrerad lista, Stäng, Spara, Kommentarer med mera.
genvägar: I det här avsnittet finns en definition av kortkommandon för en viss funktion i redigeraren.
mallar: Det här avsnittet innehåller den fördefinierade strukturen för DITA-element som du kan använda i ditt dokument. Som standard innehåller mallavsnittet malldefinitioner för ett stycke-, enkel tabell-, tabell- och body-element. Du kan skapa en malldefinition för vilket element som helst genom att lägga till en giltig XML-struktur för det önskade elementet. Om du till exempel vill lägga till ett p-element med alla nya li-element i en lista kan du lägga till följande kod i slutet av mallavsnittet för att uppnå detta:

code language-css
`"li": "<li><p></p></li>"`

I verktygsfältsavsnittet tar du bort den funktion som du inte vill visa för användarna.
Spara filen ui_config.json och läs in webbredigeraren igen.

Överordnat ämne: Anpassa Web Editor

recommendation-more-help

11125c99-e1a1-4369-b5d7-fb3098b9b178