Gewusst wie: Anpassen des HTML-Editor-Feldsteuerelements

Letzte Änderung: Montag, 27. September 2010

Gilt für: SharePoint Server 2010

Inhalt dieses Artikels
Einschränkungen
Vordefinierte Tabellenformate
Rechtschreibprüfung

Mit dem HTML-Editor-Feldsteuerelement können Sie HTML-Inhalt auf einer Veröffentlichungsseite hinzufügen. Seitenvorlagen, die den Spaltentyp HTML wird veröffentlicht enthalten, weisen auch das HTML-Editor-Feldsteuerelement auf. In diesem Editor gibt es spezielle Funktionen, wie z. B. angepasste Stylesheets, Bearbeitungseinschränkungen, Unterstützung wiederverwendbarer Inhalte, eine Rechtschreibprüfung sowie das Auswählen von Dokumenten und Bildern zum Einfügen in den Seiteninhalt mithilfe der Objektauswahl. In diesem Thema wird beschrieben, wie Sie bestimmte Features und Attribute des HTML-Editor-Feldsteuerelements ändern.

Einschränkungen

Wenn der Inhaltstyp eines Seitenlayouts die Seiteninhalt-Spalte unterstützt, können Sie mit Markup wie dem Folgenden dem Seitenlayout ein Rich-HTML-Feldsteuerelement hinzufügen.

<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"/>

Im obigen Beispiel ist RichHTMLField der Name des Feldsteuerelements, das umfassendere HTML-Bearbeitungsmöglichkeiten bietet. Mit Attributen wie z. B. AllowFonts und AllowTables werden Einschränkungen für das Feld angegeben.

Das HTML-Feldsteuerelement ermöglicht Font-Tags. Nicht zulässig sind jedoch für die aktuelle Websitesammlung externe URLs, in einer zentralen Liste gespeicherte wiederverwendbare Inhalte, standardmäßige HTML-Überschriften-Tags, Hyperlinks, Bilder, nummerierte Listen oder Aufzählungen, Tabellen oder Textmarkup.

Tabelle 1. Eigenschaften des HTML-Editor-Feldsteuerelements

Vordefinierte Tabellenformate

Der HTML-Editor enthält standardmäßig eine Reihe vordefinierter Tabellenformate, die so angepasst werden können, dass sie dem Stil einer einzelnen Seite entsprechen. Die einzelnen Tabellenformate bestehen aus einer Sammlung von Cascading Stylesheet (CSS)-Klassen für die einzelnen Tabellen-Tags. Sie können Stylesheets für die erste und letzte Zeile, für ungerade und gerade Zeilen, die erste und letzte Spalte usw. definieren.

Der HTML-Editor wendet bestimmte Formatvorlagen aus den angegebenen Stylesheets dynamisch auf die Seite an und macht sie für Benutzer beim Formatieren einer Tabelle verfügbar. Die entsprechenden Klassennamen müssen sich an das Format PREFIXTableXXX-NNN halten, damit ein benutzerdefiniertes Stylesheet beim Formatieren einer Tabelle verfügbar ist. Dabei gilt Folgendes:

• PREFIX ist standardmäßig ms-rte, Sie können jedoch diesen Standardwert mithilfe der PrefixStyleSheet()-Eigenschaft des RichHTML-Feldsteuerelements überschreiben.

• XXX ist der entsprechende Tabellenabschnitt, wie z. B. EvenRow oder OddRow.

• NNN ist der Name zum Identifizieren des Tabellenformats.

Das folgende Beispiel enthält einen kompletten Satz von Klassen für ein Tabellenformat.

.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;}

In gibt es Microsoft SharePoint Server 2010 eine Reihe von Standardtabellenformaten. Wenn jedoch neue Stylesheets gefunden werden, die nicht aus der CSS-Standarddatei stammen, wird der Standardsatz entfernt, und im HTML-Editor-Dialogfeld werden nur diese neu definierten Stylesheets angezeigt.

Rechtschreibprüfung

In SharePoint Server 2010 enthält der HTML-Editor eine Rechtschreibprüfung, die von Entwicklern mit dem SpellCheckV4Action-Websteuerelement und dem SpellCheckToolbarButton-Websteuerelement angepasst werden kann. Während der Rechtschreibprüfung werden Clientdateien und Daten registriert. Außerdem gibt es eine Methode zum Abrufen der Konsolenregisterkarte und zum Aufrufen der Benutzerrechte, um zu überprüfen, ob der aktuelle Benutzer berechtigt ist, die Rechtschreibprüfung für das ausgewählte Element auszuführen. Bei der Rechtschreibprüfung wird der entsprechende ECMAScript (JavaScript, JScript)-Code aufgerufen, und Informationen zu möglichen Schreibungen und zur zu verwendenden Standardsprache werden an den Client gesendet.

Siehe auch

Konzepte

Vorgehensweise: Anpassen von Formaten

Gewusst wie: Anpassen der Objektauswahl