Procédure : Personnaliser le contrôle de champ de l’éditeur HTML
Dernière modification : lundi 27 septembre 2010
S’applique à : SharePoint Server 2010
Dans cet article
Contraintes
Formats de tableau prédéfinis
Vérificateur d’orthographe
Vous pouvez utiliser le contrôle de champ Éditeur HTML pour insérer du contenu HTML dans une page de publication. Les modèles de page qui incluent un type de colonne HTML de publication contiennent également le contrôle de champ Éditeur HTML. Cet éditeur offre des fonctionnalités spéciales, telles que des styles personnalisés, des contraintes d’édition, la prise en charge du contenu réutilisable, un vérificateur de l’orthographe et le recours à des sélecteurs de biens pour sélectionner des documents et des images à insérer dans le contenu d’une page. Cette rubrique décrit comment modifier certaines fonctionnalités et attributs du contrôle de champ Éditeur HTML.
Contraintes
Si le type de contenu d’une mise en page prend en charge la colonne Contenu de la page, vous pouvez ajouter un contrôle de champ HTML enrichi à votre mise en page en utilisant les balises suivantes.
<PublishingWebControls:RichHtmlField id="ArticleAbstract" FieldName="ArticleAbstract"
AllowExternalUrls="false"
AllowFonts="true"
AllowReusableContent="false"
AllowHeadings="false"
AllowHyperlinks="false"
AllowImages="false"
AllowLists="false"
AllowTables="false"
AllowTextMarkup="false"
AllowHTMLSourceEditing="false"
DisalbeBasicFormattingButtons="false"
runat="server"/>
Dans l’exemple ci-dessus, RichHTMLField est le nom du contrôle de champ qui procure l’expérience d’édition HTML la plus enrichie. Les attributs tels que AllowFonts et AllowTables spécifient des restrictions sur le champ.
Le contrôle de champ HTML autorise les balises de police, mais il n’autorise pas les URL externes à la collection de sites active, le contenu réutilisable stocké dans une liste centralisée, les balises d’en-têtes HTML standard, les liens hypertexte, les images, les listes numérotées ou à puces, les tableaux ou le balisage de texte.
Tableau 1. Propriétés du contrôle de champ d’éditeur HTML
Attribut |
Description |
|---|---|
AllowExternalUrls |
Seules les URL internes à la collection de sites active peuvent être référencées dans un lien ou une image. |
AllowFonts |
Le contenu peut contenir des balises de police. |
AllowHtmlSourceEditing |
L’Éditeur HTML peut basculer dans un mode qui autorise la modification directe du code HTML. |
AllowReusableContent |
Le contenu peut contenir des fragments de contenu réutilisable stockés dans une liste centralisée. |
AllowHeadings |
Le contenu peut contenir des balises d’en-têtes HTML (H1, H2, et ainsi de suite.) |
AllowTextMarkup |
Le contenu peut contenir du texte en gras, en italique et souligné. |
AllowImages |
Le contenu peut contenir des images. |
AllowLists |
Le contenu peut contenir des listes numérotées ou à puces. |
AllowTables |
Le contenu peut contenir des balises relatives à des tableaux, du type <table>, <tr> et <td>. |
AllowHyperlinks |
Le contenu peut contenir des liens vers d'autres URL. |
AllowHtmlSourceEditing |
Si l’éditeur HTML prend la valeur false, il ne peut pas être activé en mode d’édition de source HTML. |
AllowHyperlinks |
Obtient ou définit la contrainte qui permet d’ajouter des liens hypertexte au code HTML. Si cet indicateur a la valeur false, les balises <A>, <AREA> et <MAP> sont supprimées du code HTML. La valeur par défaut est true. Cette propriété détermine également si l’interface utilisateur de modification autorise ces opérations. |
AllowImageFormatting |
Obtient ou définit des éléments de mise en forme d’image. Cette restriction désactive uniquement les menus et ne force pas le contenu à adhérer à cette restriction. |
AllowImagePositioning |
Obtient ou définit la position de l’image. Cette restriction désactive uniquement les menus et ne force pas le contenu à adhérer à cette restriction. |
AllowImageStyles |
Obtient ou définit une valeur indiquant si le menu Styles de tableau est activé. Cette restriction désactive uniquement le menu et ne force pas le contenu à adhérer à cette restriction. |
AllowInsert |
Obtient ou définit une valeur indiquant si des options Insertion sont affichées. Cette restriction désactive uniquement le menu et ne force pas le contenu à adhérer à cette restriction. |
AllowLists |
Obtient ou définit la contrainte qui permet d’ajouter des balises de listes au code HTML. Si cet indicateur a la valeur false, les balises <LI>, <OL>, <UL>, <DD>, <DL>, <DT> et <MENU> sont supprimées du code HTML. La valeur par défaut est true. Cette propriété détermine également si l’interface utilisateur de modification autorise ces opérations. |
AllowParagraphFormatting |
Obtient ou définit une valeur indiquant si les éléments de mise en forme de paragraphe sont activés. Cette restriction désactive uniquement les menus et ne force pas le contenu à adhérer à cette restriction. |
AllowStandardFonts |
Obtient ou définit une valeur indiquant si les polices standard sont activées. Cette restriction désactive uniquement les menus et ne force pas le contenu à adhérer à cette restriction. |
AllowStyles |
Obtient ou définit une valeur indiquant si le menu Style est activé. Cette restriction désactive uniquement le menu et ne force pas le contenu à adhérer à cette restriction. |
AllowTables |
Obtient ou définit la contrainte permettant d’ajouter des tables lors de la modification de ce champ. |
AllowTableStyles |
Obtient ou définit une valeur indiquant si le menu Styles de tableau est activé. Cette restriction désactive uniquement le menu et ne force pas le contenu à adhérer à cette restriction. |
AllowTextMarkup |
Obtient ou définit la contrainte permettant d’ajouter du balisage de texte lors de la modification de ce champ. |
AllowThemeFonts |
Obtient ou définit une valeur indiquant si les polices de thèmes sont activées. Cette restriction désactive uniquement les menus et ne force pas le contenu à adhérer à cette restriction. |
Formats de tableau prédéfinis
L’éditeur HTML est fourni avec un ensemble de formats de tableau prédéfinis, mais il peut être personnalisé pour répondre au style d’une page en particulier. Chaque format de tableau est constitué d’une collection de classes de feuilles de style en cascade pour chaque balise de tableau. Vous pouvez définir un style pour la première et la dernière ligne, les lignes paires et impaires, la première et la dernière colonne, et ainsi de suite.
L’éditeur HTML applique dynamiquement certains styles à partir des feuilles de style référencées dans la page et les met à disposition des utilisateurs lors de la mise en forme d’un tableau. Pour qu’un style personnalisé soit disponible lors de la mise en forme d’un tableau, les noms de classes appropriés doivent respecter le format PREFIXTableXXX-NNN, où :
PREFIX est ms-rte par défaut, mais vous pouvez remplacer la valeur par défaut à l’aide de la propriété PrefixStyleSheet() du contrôle de champ RichHTML.
XXX correspond à la section du tableau spécifique, telle que EvenRow ou OddRow.
NNN correspond au nom qui permet d'identifier le style du tableau.
L’exemple de code suivant présente un ensemble complet de classes pour un format de style de tableau.
.ms-rteTable-1 {border-collapse:collapse;border-top:gray 1.5pt;
border-left:gray 1.5pt;border-bottom:gray 1.5pt;
border-right:gray 1.5pt;border-style:solid;}
.ms-rteTableHeaderRow-1 {color:Green;background:yellow;text-align:left}
.ms-rteTableHeaderFirstCol-1 {padding:0in 5.4pt 0in 5.4pt;}
.ms-rteTableHeaderLastCol-1 {padding:0in 5.4pt 0in 5.4pt;}
.ms-rteTableHeaderOddCol-1 {padding:0in 5.4pt 0in 5.4pt;}
.ms-rteTableHeaderEvenCol-1 {padding:0in 5.4pt 0in 5.4pt;}
.ms-rteTableOddRow-1 {color:black;background:#FFFFDD;}
.ms-rteTableEvenRow-1 {color:black;background:#FFB4B4;}
.ms-rteTableFirstCol-1 {padding:0in 5.4pt 0in 5.4pt;}
.ms-rteTableLastCol-1 {padding:0in 5.4pt 0in 5.4pt;}
.ms-rteTableOddCol-1 {padding:0in 5.4pt 0in 5.4pt;}
.ms-rteTableEvenCol-1 {padding:0in 5.4pt 0in 5.4pt;}
.ms-rteTableFooterRow-1 {color:blue;font-style:bold;
font-weight:bold;background:white;border-top:solid gray 1.0pt;
border-bottom:solid gray 1.0pt;border-right:solid silver 1.0pt;
border-style:solid;}
.ms-rteTableFooterFirstCol-1 {padding:0in 5.4pt 0in 5.4pt;
border-top:solid gray 1.0pt;text-align:left}
.ms-rteTableFooterLastCol-1 {padding:0in 5.4pt 0in 5.4pt;
border-top:solid gray 1.0pt;text-align:left}
.ms-rteTableFooterOddCol-1 {padding:0in 5.4pt 0in 5.4pt;
text-align:left;border-top:solid gray 1.0pt;}
.ms-rteTableFooterEvenCol-1 {padding:0in 5.4pt 0in 5.4pt;
text-align:left;border-top:solid gray 1.0pt;}
Microsoft SharePoint Server 2010 est fourni avec un ensemble de styles de tableaux par défaut. Toutefois, si le système détecte de nouveaux styles qui ne proviennent pas du fichier .css par défaut, il supprime l’ensemble par défaut et présente uniquement les styles nouvellement définis dans la boîte de dialogue de l’éditeur HTML.
Vérificateur d’orthographe
Dans SharePoint Server 2010, l’éditeur HTML inclut un vérificateur d’orthographe, qui peut être personnalisé par des développeurs à l’aide des contrôles Web SpellCheckV4Action et SpellCheckToolbarButton. L’action de vérificateur d’orthographe enregistre des données et fichiers clients durant une vérification de l’orthographe. Il inclut également une méthode permettant d’obtenir l’onglet de console et appelle les droits de l’utilisateur pour vérifier que l’utilisateur actuel est autorisé à effectuer une opération de vérification de l’orthographe sur l’élément sélectionné. L’action de vérificateur d’orthographe appelle le code ECMAScript (JavaScript, JScript) approprié et envoie des informations au client concernant les orthographes disponibles et la langue par défaut à utiliser pour la demande.