Configuration des modules externes d’éditeur de texte enrichi configure-the-rich-text-editor-plug-ins
Les fonctionnalités d’éditeur de texte enrichi sont rendues disponibles par l’intermédiaire d’une série de modules externes, chacun avec sa propriété features. Vous pouvez configurer la propriété features pour activer ou désactiver une ou plusieurs fonctions de l’éditeur de texte enrichi. Cet article décrit comment configurer spécifiquement les modules externes d’éditeur de texte enrichi.
Pour plus d’informations sur les autres configurations d’éditeur de texte enrichi, voir Configuration de l’éditeur de texte enrichi.
Activation d’un module externe et configuration de la propriété features activateplugin
Pour activer un module externe, procédez comme suit : Certaines étapes ne sont nécessaires que lorsque vous configurez un module externe pour la première fois, car les nœuds correspondants n’existent pas.
Par défaut, les modules externes format
, link
, list
, justify
et control
, ainsi que toutes leurs fonctions, sont activés dans l’éditeur de texte enrichi.
rtePlugins
respectif est désigné sous le nom de <rtePlugins-node>
pour éviter les doublons dans cet article.-
À l’aide de CRXDE Lite, cherchez le composant Texte pour votre projet.
-
Créez le nœud parent
<rtePlugins-node>
s’il n’existe pas, avant de configurer tout module externe d’éditeur de texte enrichi :-
Selon votre composant, les nœuds parents sont les suivants :
config: .../text/cq:editConfig/cq:inplaceEditing/config
- un nœud de configuration alternatif :
.../text/cq:editConfig/cq:inplaceEditing/inplaceEditingTextConfig
text: .../text/dialog/items/tab1/items/text
-
Ils sont du type : jcr:primaryType
cq:Widget
-
Possèdent tous deux les propriétés suivantes :
- Nom
name
- Type
String
- Valeur
./text
- Nom
-
-
Selon l’interface pour laquelle vous effectuez la configuration, créez un nœud
<rtePlugins-node>
, s’il n’existe pas :- Nom
rtePlugins
- Type
nt:unstructured
- Nom
-
Voici comment créer un nœud pour chaque module externe à activer :
- Type
nt:unstructured
- Nom ID du module externe requis
- Type
Après activation d’un module externe, suivez ces instructions pour configurer la propriété features
.
String
(multichaîne ; définissez le type sur String
et cliquez sur Multi
dans CRXDE Lite)*
(astérisque)Compréhension du module externe findreplace findreplace
Le module externe findreplace
n’a pas besoin de configuration. Il est prêt à l’emploi.
Lors de l’utilisation de la fonctionnalité de remplacement, la chaîne à remplacer doit être saisie en même temps que la chaîne de recherche. Cependant, vous pouvez toujours cliquer sur Rechercher pour rechercher la chaîne avant de la remplacer. Si la chaîne de remplacement est saisie après avoir cliqué sur Rechercher, la recherche est réinitialisée au début du texte.
La boîte de dialogue de recherche et de remplacement devient transparente lorsque l’utilisateur clique sur Rechercher et devient opaque lorsque l’utilisateur clique sur Remplacer. Le comportement permet à l’auteur de vérifier le texte à remplacer. Si les utilisateurs cliquent sur Tout remplacer, la boîte de dialogue se ferme et affiche le nombre de remplacements effectués.
Configuration des modes de collage pastemodes
Lorsqu’ils utilisent l’éditeur de texte enrichi, les créateurs et créatrices peuvent coller du contenu dans l’un des trois modes suivants :
-
Mode Navigateur : collage de texte avec la mise en œuvre de collage par défaut du navigateur. Il ne s’agit pas d’une méthode recommandée, car elle peut introduire des balises indésirables.
-
Mode Texte brut : collage du contenu du Presse-papiers en tant que texte brut. Cela supprime tous les éléments de style et de mise en forme du contenu copié avant insertion dans le composant Experience Manager.
-
Mode MS Word : collage du texte, y compris des tableaux, avec la mise en forme lors de la copie à partir de MS Word. La copie et le collage de texte depuis une autre source, telle qu’une page web ou MS Excel ne sont pas pris en charge et conservent uniquement une mise en forme partielle.
Configuration des options de collage disponibles sur la barre d’outils de l’éditeur de texte enrichi configure-paste-options-available-on-the-rte-toolbar
Les trois icônes ci-dessous peuvent être mises à la disposition des auteurs dans la barre d’outils de l’éditeur de texte enrichi :
-
Coller (Ctrl + V) : peut être préconfigurée pour correspondre à l’un des trois modes de collage ci-dessus.
-
Coller en tant que texte : fournit la fonctionnalité du mode Texte brut.
-
Coller à partir de Word : fournit la fonctionnalité du mode MS Word.
Pour configurer l’éditeur de texte enrichi afin qu’il affiche les icônes requises, procédez comme suit.
- Accédez à votre composant, par exemple
/apps/<myProject>/components/text
. - Accédez au nœud
rtePlugins/edit
. Voir Activation d’un module externe si le nœud n’existe pas. - Créez la propriété
features
sur le nœudedit
et ajoutez une ou plusieurs des fonctions. Enregistrez toutes les modifications.
Configuration du comportement de l’icône et du raccourci Coller (Ctrl + V) configure-the-behavior-of-the-paste-ctrl-v-icon-and-shortcut
Vous pouvez préconfigurer le comportement de l’icône Coller (Ctrl+V) en vous aidant des étapes suivantes. Cette configuration définit également le comportement du raccourci clavier Ctrl+V que les créateurs et créatrices utilisent pour coller du contenu.
La configuration permet d’utiliser les trois types de cas suivants :
-
Collage de texte avec la mise en œuvre de collage par défaut du navigateur. Il ne s’agit pas d’une méthode recommandée, car elle peut introduire des balises indésirables. Configuré à l’aide de
browser
ci-dessous. -
Collage du contenu du Presse-papiers en tant que texte brut. Cela supprime tous les éléments de style et de mise en forme du contenu copié avant insertion dans le composant Experience Manager. Configuré à l’aide de
plaintext
ci-dessous. -
Collez le texte, y compris les tableaux, avec la mise en forme lors de la copie à partir de MS Word. La copie et le collage de texte depuis une autre source, telle qu’une page web ou MS Excel ne sont pas pris en charge et conservent uniquement une mise en forme partielle. Configuré à l’aide de
wordhtml
ci-dessous.
-
Dans votre composant, accédez au nœud
<rtePlugins-node>/edit
. Créez les nœuds s’ils n’existent pas. Pour plus d’informations, voir Activation d’un module externe. -
Dans le nœud
edit
, créez une propriété à l’aide des informations suivantes :- Nom
defaultPasteMode
- Type
String
- Valeur est l’un des modes de collage requis parmi
browser
,plaintext
ouwordhtml
.
- Nom
Configuration des formats autorisés lors du collage de contenu pasteformats
Le mode Coller comme élément Microsoft Word (paste-wordhtml
) peut être configuré de manière plus détaillée de manière à pouvoir autoriser explicitement quelques styles pour coller des éléments dans Experience Manager à partir d’un autre programme tel que Microsoft Word.
Par exemple, s’il n’est possible de coller que des formats gras et des listes dans Experience Manager, vous pouvez écarter les autres formats en les filtrant. Il s’agit du filtrage du collage configurable, qui peut être effectué pour les deux types de filtrage :
Pour les liens, vous pouvez également définir les protocoles acceptés automatiquement.
Pour configurer les formats autorisés afin de coller du texte dans à partir d’un autre programme :Experience Manager
-
Dans votre composant, accédez au nœud
<rtePlugins-node>/edit
. Créez les nœuds s’ils n’existent pas. Pour plus d’informations, voir Activation d’un module externe. -
Créez un nœud sous le nœud
edit
destiné à contenir les règles de collage HTML :- Nom
htmlPasteRules
- Type
nt:unstructured
- Nom
-
Créez un nœud sous
htmlPasteRules
, destiné à contenir les détails des formats de base autorisés :- Nom
allowBasics
- Type
nt:unstructured
- Nom
-
Pour contrôler les différents formats admis, créez une ou plusieurs des propriétés ci-dessous sur le nœud
allowBasics
:- Nom
bold
- Nom
italic
- Nom
underline
- Nom
anchor
(pour les liens et les ancres nommées) - Nom
image
Toutes les propriétés sont de type
Boolean
. Ainsi, dans la valeur appropriée, vous pouvez cocher ou désélectionner la case pour activer/désactiver les fonctionnalités.note note NOTE Si le format n’est pas défini explicitement, la valeur par défaut true est utilisée et le format est admis. - Nom
-
D’autres formats peuvent également être définis à l’aide de différentes propriétés ou de différents nœuds, également appliqués au nœud
htmlPasteRules
:
allowBlockTags
String
fallbackBlockTag
String
allowBlockTags
. En général, p
suffit.table
nt:unstructured
remove
pour supprimer le contenu du tableau et paragraph
pour transformer des cellules en paragraphes.list
nt:unstructured
allow
(de type Boolean) pour définir s’il est autorisé de coller des listes. Si allow
est défini sur false
, spécifiez la propriété ignoreMode
(de type String
) pour définir comment gérer le contenu d’une liste collée. Les valeurs valides de ignoreMode sont remove
pour supprimer le contenu de la liste et paragraph
pour transformer des éléments de la liste en paragraphes.Voici un exemple de structure htmlPasteRules
valide :
"htmlPasteRules": {
"allowBasics": {
"italic": true,
"link": true
},
"allowBlockTags": [
"p", "h1", "h2", "h3"
],
"list": {
"allow": false,
"ignoreMode": "paragraph"
},
"table": {
"allow": true,
"ignoreMode": "paragraph"
}
}
- Enregistrez toutes les modifications.
Configuration des styles de texte textstyles
Les créateurs et créatrices peuvent appliquer des styles pour modifier l’apparence d’une portion de texte. Les styles sont basés sur les classes CSS que vous avez prédéfinies dans votre feuille de style CSS. Le contenu stylisé est inclus dans les balises span
à l’aide de l’attribut class
pour faire référence à la classe CSS. Par exemple :
<span class=monospaced>Monospaced Text Here</span>
Lorsque le module externe Styles est activé pour la première fois, aucun style par défaut n’est disponible. La liste contextuelle est vide. Pour fournir des styles aux créateurs et créatrices, procédez comme suit :
- Activez le sélecteur de liste déroulante Style.
- Spécifiez un ou plusieurs emplacements des feuilles de style.
- Spécifiez les différents styles qui peuvent être sélectionnés dans la liste pop-up Style.
Pour les configurations ultérieures (par exemple, afin d’ajouter davantage de styles), suivez les instructions pour faire référence à une nouvelle feuille de style et spécifier les styles supplémentaires.
Activation de la liste du sélecteur de liste déroulante Style styleselectorlist
Cette opération et effectuée en activant le module externe Styles.
-
Dans votre composant, accédez au nœud
<rtePlugins-node>/styles
. Créez les nœuds s’ils n’existent pas. Pour plus d’informations, voir Activation d’un module externe. -
Créez la propriété
features
sur le nœudstyles
:- Nom
features
- Type
String
- Valeur
*
(astérisque)
- Nom
-
Enregistrez toutes les modifications.
Spécification de l’emplacement de la feuille de style locationofstylesheet
Ensuite, spécifiez l’emplacement de la ou des feuilles de style à référencer :
-
Accédez au nœud racine de votre composant Texte, par exemple
/apps/<myProject>/components/text
. -
Ajoutez la propriété
externalStyleSheets
au nœud parent de<rtePlugins-node>
:- Nom
externalStyleSheets
- Type
String[]
(multichaîne ; cliquez sur Multi dans CRXDE) - Valeurs Chemin d’accès et nom de fichier de chaque feuille de style que vous souhaitez inclure. Utilisez les chemins d’accès au référentiel.
note note NOTE Vous pouvez ajouter des références à d’autres feuilles de style ultérieurement. - Nom
-
Enregistrez toutes les modifications.
Lors de l’utilisation de l’éditeur de texte enrichi dans une boîte de dialogue (IU classique), vous pouvez spécifier des feuilles de style optimisées pour la modification de texte enrichi. En raison de restrictions techniques, le contexte CSS est perdu dans l’éditeur. Vous pouvez émuler ce contexte afin d’améliorer l’expérience WYSIWYG.
L’éditeur de texte enrichi utilise un élément DOM de conteneur doté d’un ID CQrte
qui fournit différents styles de vue et de modification :
#CQ td {
// defines the style for viewing
}
#CQrte td {
// defines the style for editing
}
Spécification des styles disponibles dans la liste pop-up stylesindropdown
-
Dans la définition du composant, accédez au nœud
<rtePlugins-node>/styles
tel que créé dans Activation du sélecteur de liste déroulante Style. -
Sous le nœud
styles
, créez un nœud (également appeléstyles
) destiné à contenir la liste mise à disposition :- Nom
styles
- Type
cq:WidgetCollection
- Nom
-
Créez un nœud sous le nœud
styles
pour représenter un style individuel :- Nom, vous pouvez spécifier le nom, mais il doit être adapté au style
- Type
nt:unstructured
-
Ajoutez la propriété
cssName
à ce nœud pour référencer la classe CSS :- Nom
cssName
- Type
String
- Valeur Nom de la classe CSS (non précédé d’un point « . » ; par exemple,
cssClass
au lieu de.cssClass
)
- Nom
-
Ajoutez la propriété
text
au même nœud. Elle définit le texte affiché dans la boîte de dialogue de sélection :- Nom
text
- Type
String
- Valeur. Description du style, s’affiche dans la zone de sélection de la liste déroulante Style.
- Nom
-
Enregistrez les modifications.
Répétez les étapes ci-dessus pour chaque style requis.
Configuration de l’éditeur de texte enrichi pour des coupures de mots optimales en japonais jpwordwrap
Les auteurs qui utilisent Experience Manager pour créer du contenu en japonais peuvent appliquer un style aux caractères afin d’éviter un saut de ligne lorsqu’il n’est pas nécessaire. Les auteurs peuvent ainsi couper les phrases où ils le souhaitent. Le style de cette fonctionnalité est basé sur la classe CSS prédéfinie dans la feuille de style CSS.
Pour créer le style que les auteurs peuvent appliquer au texte japonais, procédez comme suit :
-
Créez un nœud sous le nœud styles. Voir Spécification d’un style.
- Nom :
jpn-word-wrap
- Type :
nt:unstructure
- Nom :
-
Ajoutez la propriété
cssName
au nœud pour référencer la classe CSS. Ce nom de classe est un nom réservé pour la fonction de retour automatique à la ligne du japonais.- Nom :
cssName
- Type :
String
- Valeur :
jpn-word-wrap
(sans préfixe.
)
- Nom :
-
Ajoutez la propriété text au même nœud. La valeur est le nom du style que les auteurs voient lors de la sélection du style.
- Nom :
text
*Type :String
- Valeur :
Japanese word-wrap
- Nom :
-
Créez une feuille de style et spécifiez son chemin d’accès. Consultez spécification de l’emplacement de la feuille de style. Ajoutez le contenu suivant à la feuille de style. Modifiez la couleur d’arrière-plan selon vos besoins.
code language-css .text span.jpn-word-wrap { display:inline-block; } .is-edited span.jpn-word-wrap { background-color: #ffddff; }
Configuration des formats de paragraphe paraformats
Tout texte saisi dans l’éditeur de texte enrichi est placé dans une balise block dont la valeur par défaut est <p>
. En activant le module externe paraformat
, vous spécifiez d’autres balises block, qui peuvent être affectées à des paragraphes, à l’aide d’une liste déroulante de sélection. Les formats de paragraphe déterminent le type de paragraphe en affectant la balise block appropriée. L’auteur ou l’autrice peut les sélectionner et les attribuer à l’aide du sélecteur Format. Les exemples de balises block incluent, entre autres, le paragraphe standard <p> et les en-têtes <h1>, <h2>, etc.
<hr>
, ne peut pas être affectée à un paragraphe, ce n’est pas un cas d’utilisation valide pour un module externe paraformat
.Lorsque le plug-in Formats de paragraphe est activé pour la première fois, aucun format de paragraphe par défaut n’est disponible. La liste contextuelle est vide. Pour fournir des formats de paragraphes aux auteurs, procédez comme suit :
- Activez la liste du sélecteur pop-up Format.
- Spécifiez les balises block qui peuvent être sélectionnées comme formats de paragraphes dans le menu pop-up.
Pour les reconfigurations ultérieures, par exemple, afin d’ajouter davantage de formats, suivez uniquement la partie correspondante des instructions.
Activation du sélecteur de liste déroulante Format formatselectorlist
Pour activer le module externe paraformat
, procédez comme suit :
-
Dans votre composant, accédez au nœud
<rtePlugins-node>/paraformat
. Créez les nœuds s’ils n’existent pas. Pour plus d’informations, voir Activation d’un module externe. -
Créez la propriété
features
sur le nœudparaformat
:- Nom
features
- Type
String
- Valeur
*
(astérisque)
- Nom
<p>
), En-tête 1 (<h1>
), En-tête 2 (<h2>
) et En-tête 3 (<h3>
).<p>
est supprimée, l’auteur du contenu ne peut pas sélectionner l’option Formats des paragraphes même si d’autres formats sont configurés.Spécification des formats de paragraphe disponibles paraformatsindropdown
Les formats de paragraphe sont mis à disposition pour être sélectionnés :
-
Dans la définition du composant, accédez au nœud
<rtePlugins-node>/paraformat
, tel que créé dans Activation du sélecteur de liste déroulante Format. -
Sous le nœud
paraformat
, créez un nœud destiné à contenir la liste de formats :- Nom
formats
- Type
cq:WidgetCollection
- Nom
-
Créez un nœud sous le nœud
formats
, qui contient les détails pour un format spécifique :- Nom, vous pouvez spécifier le nom, mais il doit être adapté au format (par exemple, myparagraph, myheading1).
- Type
nt:unstructured
-
Sur ce nœud, ajoutez la propriété pour définir la balise block utilisée :
-
Nom
tag
-
Type
String
-
Valeur La balise block pour le format, par exemple : p, h1, h2, etc.
Vous n’avez pas besoin de saisir les crochets de séparation.
-
-
Sur le même nœud, ajoutez une autre propriété pour que le texte descriptif s’affiche dans la liste déroulante :
- Nom
description
- Type
String
- Valeur Texte descriptif pour ce format, par exemple, paragraphe, titre 1, titre 2, etc. Ce texte est affiché dans la liste de sélection Format.
- Nom
-
Enregistrez les modifications.
Répétez les étapes pour chaque format requis.
<p>
, <h1>
, <h2>
et <h3>
) sont supprimés. Recréez le format <p>
, car il s’agit du format par défaut.Configuration des caractères spéciaux spchar
Dans une installation Experience Manager standard, lorsque le module externe misctools
est activé pour les caractères spéciaux (specialchars
), une sélection par défaut est disponible immédiatement. Par exemple, les symboles de copyright et de marque.
Vous pouvez configurer l’éditeur de texte enrichi de manière à mettre à disposition votre sélection de caractères, en définissant des caractères distincts ou une séquence entière.
Définition d’un caractère unique definesinglechar
-
Dans votre composant, accédez au nœud
<rtePlugins-node>/misctools
. Créez les nœuds s’ils n’existent pas. Pour plus d’informations, voir Activation d’un module externe. -
Créez la propriété
features
sur le nœudmisctools
:-
Nom
features
-
Type
String[]
-
Valeur
specialchars
(ou
String / *
si toutes les fonctions sont appliquées pour ce module externe)
-
-
Sous
misctools
, créez un nœud destiné à contenir les configurations de caractères spéciaux :- Nom
specialCharsConfig
- Type
nt:unstructured
- Nom
-
Sous
specialCharsConfig
, créez un autre nœud destiné à contenir la liste de caractères :- Nom
chars
- Type
nt:unstructured
- Nom
-
Sous
chars
, ajoutez un nœud destiné à contenir une définition de caractère individuel :- Nom Vous pouvez spécifier le nom, mais il doit refléter le caractère, par exemple, « moitié ».
- Type
nt:unstructured
-
Ajoutez la propriété suivante à ce nœud :
- Nom
entity
- Type
String
- Valeur Représentation HTML du caractère nécessaire, par exemple,
&189;
pour la fraction un demi.
- Nom
-
Enregistrez les modifications.
Dans CRXDE, une fois la propriété enregistrée, le caractère représenté s’affiche. Voir ci-dessous sous l’exemple du caractère demi. Répétez les étapes ci-dessus pour rendre plus de caractères spéciaux disponibles pour les auteurs.
Définition d’une série de caractères definerangechar
-
Appliquez les étapes 1 à 3 de la section Définition d’un caractère unique.
-
Sous
chars
, ajoutez un nœud destiné à contenir la définition de la plage de caractères :- Nom Vous pouvez spécifier le nom, mais il doit refléter la plage de caractères, par exemple, « crayons ».
- Type
nt:unstructured
-
Sous ce nœud (nommé en fonction de votre plage de caractères spéciaux), ajoutez les deux propriétés suivantes :
-
Enregistrez les modifications.
Par exemple, définissez une plage comprise entre 9 998 et 1 0000 vous fournit les caractères suivants.
Figure : Définition dans CRXDE d’une série de caractères pour qu’elle soit disponible dans l’éditeur de texte enrichi
Configuration des styles de tableau tablestyles
Les styles sont généralement appliqués au texte, mais un ensemble distinct de styles peut également être appliqué à un tableau ou à quelques cellules de tableau. Ces styles sont à la disposition des auteurs au niveau de la boîte du sélecteur de style dans la boîte de dialogue de propriétés de la cellule ou du tableau. Les styles sont disponibles lors de la modification d’un tableau dans un composant Texte (ou dérivé), et non dans le composant Tableau standard.
-
Dans votre composant, recherchez le nœud
<rtePlugins-node>/table
. Créez les nœuds s’ils n’existent pas. Pour plus d’informations, voir Activation d’un module externe. -
Créez la propriété
features
sur le nœudtable
:- Nom
features
- Type
String
- Valeur
*
note note NOTE Si vous ne souhaitez pas activer toutes les fonctionnalités de tableau, vous pouvez créer la propriété features
, comme suit :-
Type
String[]
-
Valeurs Un ou deux des éléments ci-dessous, au besoin :
-
table
pour permettre de modifier les propriétés du tableau, dont les styles. -
cellprops
pour permettre de modifier les propriétés des cellules, dont les styles.
- Nom
-
Définissez l’emplacement des feuilles de style CSS pour y faire référence. Voir Spécification de l’emplacement de votre feuille de style, car cela revient à définir les styles de texte. L’emplacement peut être défini si vous avez défini d’autres styles.
-
Sous le nœud
table
, créez les nœuds suivants selon les besoins :-
Pour définir des styles pour le tableau entier (disponibles sous Propriétés du tableau) :
- Nom
tableStyles
- Type
cq:WidgetCollection
- Nom
-
Pour définir des styles pour des cellules individuelles (disponibles sous Propriétés de la cellule) :
- Nom
cellStyles
- Type
cq:WidgetCollection
- Nom
-
-
Créez un nœud (sous le nœud
tableStyles
oucellStyles
, selon ce qui est approprié) pour représenter un style individuel :- Nom Vous pouvez spécifier le nom, mais il doit refléter le style.
- Type
nt:unstructured
-
Sur ce nœud, créez les propriétés :
-
Pour définir le style CSS référencé,
- Nom
cssName
- Type
String
- Valeur Nom de la classe CSS (sans préfixe
.
, par exemple,cssClass
au lieu de.cssClass
)
- Nom
-
Pour définir un texte descriptif à afficher dans le sélecteur pop-up,
- Nom
text
- Type
String
- Valeur Texte à afficher dans la liste de sélection
- Nom
-
-
Enregistrez toutes les modifications.
Répétez les étapes ci-dessus pour chaque style requis.
Configuration d’en-têtes masqués dans les tableaux pour l’accessibilité hiddenheader
Dans certains cas, vous pouvez créer des tableaux de données sans texte visuel dans un en-tête de colonne en supposant que l’objectif de l’en-tête est induit par la relation visuelle de la colonne avec d’autres colonnes. Dans ce cas, il est nécessaire de fournir du texte interne masqué dans la cellule d’en-tête pour permettre aux lecteurs d’écran et aux autres technologies d’assistance d’aider les lecteurs ayant divers besoins à comprendre l’objectif de la colonne.
Pour améliorer l’accessibilité dans de telles situations, l’éditeur de texte enrichi prend en charge les cellules d’en-tête masquées. De plus, il fournit des paramètres de configuration associés aux en-têtes masqués dans les tableaux. Ces paramètres permettent d’appliquer des styles CSS à des en-têtes masqués en mode modification et aperçu. Pour aider les auteurs à identifier les en-têtes masqués en mode modification, incluez les paramètres ci-dessous dans votre code :
hiddenHeaderEditingCSS
: spécifie le nom de la classe CSS appliquée à la cellule hidden-header lorsque l’éditeur de texte enrichi est modifié.hiddenHeaderEditingStyle
: spécifie une chaîne Style appliquée à la cellule hidden-header lorsque l’éditeur de texte enrichi est modifié.
Si vous spécifiez la chaîne CSS et la chaîne Style dans le code, la classe CSS prévaut sur la chaîne Style et peut remplacer les modifications apportées à la configuration en raison de la chaîne Style.
Pour aider les créateurs à appliquer la feuille de style CSS à des en-têtes masqués en mode aperçu, vous pouvez inclure les paramètres ci-dessous dans votre code :
hiddenHeaderClassName
: spécifie le nom de la classe CSS appliquée à la cellule d’en-tête masqué en mode aperçu.hiddenHeaderStyle
: spécifie une chaîne Style appliquée à la cellule d’en-tête masqué en mode aperçu.
Si vous spécifiez la chaîne CSS et la chaîne Style dans le code, la classe CSS prévaut sur la chaîne Style et peut remplacer les modifications apportées à la configuration en raison de la chaîne Style.
Ajout de dictionnaires au vérificateur orthographique adddict
Lorsque le module externe Contrôle d’orthographe est activé, l’éditeur de texte enrichi utilise les dictionnaires de chaque langue appropriée. Ils sont sélectionnés en fonction de la langue du site web, d’après la propriété language de la sous-arborescence ou à partir de la langue de l’adresse URL, par exemple. Pour la branche /en/
, la vérification est effectuée pour l’anglais ; pour la branche /de/
, pour l’allemand.
Une installation Experience Manager standard comprend les dictionnaires pour les langues suivantes :
- Anglais américain (en_us)
- Anglais britannique (en_gb)
/libs/cq/spellchecker/dictionaries
, avec les fichiers Lisez-moi correspondants. Ne modifiez pas les fichiers.Pour ajouter d’autres dictionnaires, si nécessaire, procédez comme suit.
-
Accédez à la page https://extensions.openoffice.org/.
-
Sélectionnez la langue requise et téléchargez le fichier ZIP contenant les définitions d’orthographe. Extrayez le contenu de l’archive dans votre système de fichiers.
note caution CAUTION Seuls les dictionnaires au format MySpell
pour OpenOffice.org v2.0.1 ou version inférieure, sont pris en charge. Comme les dictionnaires sont désormais des fichiers d’archive, il est recommandé de vérifier l’archive après son téléchargement. -
Recherchez les fichiers .aff et .dic. Conservez le nom du fichier en minuscules. Par exemple,
de_de.aff
etde_de.dic
. -
Chargez les fichiers .aff et.dic dans le référentiel à l’emplacement
/apps/cq/spellchecker/dictionaries
.
Configuration de la taille de l’historique pour les actions d’annulation et de rétablissement undohistory
L’éditeur de texte enrichi permet aux auteurs et autrices d’annuler ou de rétablir quelques dernières modifications. Par défaut, 50 modifications sont stockées dans l’historique. Vous pouvez configurer cette valeur, au besoin.
-
Dans votre composant, recherchez le nœud
<rtePlugins-node>/undo
. Créez ces nœuds s’ils n’existent pas. Pour plus d’informations, voir Activation d’un module externe. -
Sur le nœud
undo
, créez la propriété :- Nom
maxUndoSteps
- Type
Long
- Valeur Nombre d’étapes annulées à enregistrer dans l’historique. La valeur par défaut est de 50. Utilisez
0
pour désactiver complètement l’annulation/le rétablissement.
- Nom
-
Enregistrez les modifications.
Configuration de la taille de tabulation tabsize
Lorsque vous appuyez sur le caractère de tabulation dans un texte, un nombre prédéfini d’espaces est inséré ; par défaut, il s’agit de trois espaces insécables et d’un espace.
Pour définir la taille de la tabulation :
-
Dans votre composant, accédez au nœud
<rtePlugins-node>/keys
. Créez les nœuds s’ils n’existent pas. Pour plus d’informations, voir Activation d’un module externe. -
Sur le nœud
keys
, créez la propriété :- Nom
tabSize
- Type
String
- Valeur Nombre d’espaces à utiliser pour le tabulateur.
- Nom
-
Enregistrez les modifications.
Définition de la marge de retrait indentmargin
Lorsque la mise en retrait est activée (par défaut), vous pouvez définir la taille du retrait :
-
Dans votre composant, recherchez le nœud
<rtePlugins-node>/lists
. Créez ces nœuds s’ils n’existent pas. Pour plus d’informations, voir Activation d’un module externe. -
Sur le nœud
lists
, créez le paramètreidentSize
:- Nom :
identSize
- Type :
Long
- Valeur Nombre de pixels nécessaires pour la marge en retrait.
- Nom :
Configuration de la hauteur de l’espace modifiable editablespace
Vous pouvez définir la hauteur de l’espace modifiable affiché dans la boîte de dialogue du composant. La configuration n’est applicable que lors de l’utilisation de l’éditeur de texte enrichi dans une boîte de dialogue. Elle ne modifie pas la hauteur de la fenêtre de la boîte de dialogue.
-
Sur le nœud
../items/text
de la définition de boîte de dialogue pour le composant, créez une propriété :- Nom
height
- Type
Long
- Valeur Hauteur du canevas de publication, exprimée en pixels.
- Nom
-
Enregistrez les modifications.
Configuration des styles et des protocoles pour les liens linkstyles
Lors de l’ajout de liens dans Experience Manager, vous pouvez définir les styles CSS à utiliser et les protocoles à accepter automatiquement. Pour configurer la façon dont les liens sont ajoutés dans Experience Manager à partir d’un autre programme, définissez des règles HTML.
-
À l’aide de CRXDE Lite, cherchez le composant Texte pour votre projet.
-
Créez un nœud au même niveau que
<rtePlugins-node>
, c’est-à-dire créez le nœud sous le nœud parent de<rtePlugins-node>
:- Nom
htmlRules
- Type
nt:unstructured
note note NOTE Le nœud ../items/text
possède la propriété :- Nom
xtype
- Type
String
- Valeur
richtext
L’emplacement du nœud ../items/text
peut varier en fonction de la structure de votre boîte de dialogue. Deux exemples sont/apps/myProject>/components/text/dialog/items/text
et/apps/<myProject>/components/text/dialog/items/panel/items/text
. - Nom
-
Sous
htmlRules
, créez un nœud.- Nom
links
- Type
nt:unstructured
- Nom
-
Sous le nœud
links
, définissez les propriétés, au besoin :-
Style CSS pour les liens internes :
- Nom
cssInternal
- Type
String
- Valeur Nom de la classe CSS (non précédé d’un point « . » ; par exemple,
cssClass
au lieu de.cssClass
)
- Nom
-
Style CSS pour les liens externes
- Nom
cssExternal
- Type
String
- Valeur Nom de la classe CSS (non précédé d’un point « . » ; par exemple,
cssClass
au lieu de.cssClass
)
- Nom
-
Tableau de protocoles valides, dont les protocoles
https://
,https://
,file://
,mailto:
et autres,- Nom
protocols
- Type
String[]
- Valeurs Un ou plusieurs protocoles
- Nom
-
defaultProtocol (propriété de type String) : protocole à utiliser si l’utilisateur n’en a pas spécifié un explicitement.
- Nom
defaultProtocol
- Type
String
- Valeurs Un ou plusieurs protocoles par défaut
- Nom
-
Définition de la gestion de l’attribut cible d’un lien. Créez un nœud :
- Nom
targetConfig
- Type
nt:unstructured
Sur le nœud
targetConfig
: définissez les propriétés nécessaires :-
Spécifiez le mode cible :
-
Nom
mode
-
Type
String
) -
Valeurs :
-
auto
: signifie qu’une cible automatique est choisie(spécifié par la propriété
targetExternal
pour les liens externes outargetInternal
pour les liens internes). -
manual
: non applicable dans ce contexte -
blank
: non applicable dans ce contexte
-
-
-
Cible des liens internes :
- Nom
targetInternal
- Type
String
- Valeur Cible des liens internes (utilisée uniquement lorsque le mode est
auto
)
- Nom
-
Cible des liens externes :
- Nom
targetExternal
- Type
String
- Valeur Cible des liens externes (utilisé uniquement lorsque le mode est
auto
).
- Nom
- Nom
-
-
Enregistrez toutes les modifications.