通过

如何：自定义 HTML 编辑器字段控件

  • 项目

上次修改时间： 2015年3月9日

适用范围： SharePoint Server 2010

本文内容
约束
预定义表格式
拼写检查器

可使用 HTML 编辑器字段控件将 HTML 内容插入发布页中。包含"发布 HTML"列类型的页模板还包含 HTML 编辑器字段控件。此编辑器具有特殊功能，例如自定义样式、编辑约束、可重用内容支持、拼写检查器以及使用资产选取器选择要插入页面内容的文档和图像。本主题介绍如何修改 HTML 编辑器字段控件的某些功能和属性。

约束

如果页面布局的内容类型支持"页面内容"列，则可通过使用如下标记将 Rich HTML 字段控件添加到页面布局。

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

在上面的示例中，RichHTMLField 为提供更丰富的 HTML 编辑体验的字段控件的名称。属性（例如 AllowFonts 和 AllowTables）指定对字段的限制。

HTML 字段控件允许字体标记，但该控件不允许当前网站集外部的 URL、存储在集中列表中的可重用内容、标准 HTML 标题标记、超链接、图像、编号列表或项目符号列表、表或文本标记。

表 1. HTML 编辑器字段控件属性

属性

说明

AllowExternalUrls

仅允许链接或图像中引用当前网站集内部的 URL。

AllowFonts

内容可包含字体标记。

AllowHtmlSourceEditing

HTML 编辑器可以切换到允许直接编辑 HTML 的模式。

AllowReusableContent

内容可包含集中列表中存储的可重用内容片段。

AllowHeadings

内容可包含 HTML 标题标记（H1、H2 等）。

AllowTextMarkup

内容可包含加粗、倾斜和带下划线的文本。

AllowImages

内容可包含图像。

AllowLists

内容可包含编号或项目符号列表。

AllowTables

内容可包含与表相关的标记（例如 <table>、<tr> 和 <td>）。

AllowHyperlinks

内容可包含指向其他 URL 的链接。

AllowHtmlSourceEditing

如果设置为 false，则会禁用 HTML 编辑器，无法切换到 HTML 源编辑模式。

AllowHyperlinks

获取或设置允许向 HTML 添加超链接的约束。如果此标志设置为 false，则将从 HTML 中删除 <A>、<AREA> 和 <MAP> 标记。默认值为 true。此属性还确定编辑用户界面 (UI) 是否启用这些操作。

AllowImageFormatting

获取或设置图像格式项。此限制仅禁用菜单，并不强制内容遵守此限制

AllowImagePositioning

获取或设置图像位置。此限制仅禁用菜单，并不强制内容遵守此限制。

AllowImageStyles

获取或设置是否启用"表样式"菜单。此限制仅禁用菜单，并不强制内容遵守此限制。

AllowInsert

获取或设置是否显示"插入"选项。此限制仅禁用菜单，并不强制内容遵守此限制。

AllowLists

获取或设置允许向 HTML 添加列表标记的约束。如果此标志设置为 false，则将从 HTML 中删除 <LI>、<OL>、<UL>、<DD>、<DL>、<DT> 和 <MENU> 标记。默认值为 true。此属性还可以确定编辑 UI 是否启用这些操作。

AllowParagraphFormatting

获取或设置是否启用段落格式项。此限制仅禁用菜单，并不强制内容遵守此限制。

AllowStandardFonts

获取或设置是否启用标准字体。此限制仅禁用菜单，并不强制内容遵守此限制。

AllowStyles

获取或设置是否启用"样式"菜单。此限制仅禁用菜单，并不强制内容遵守此限制。

AllowTables

获取或设置允许在编辑此字段时添加表的限制。

AllowTableStyles

获取或设置是否启用"表样式"菜单。此限制仅禁用菜单，并不强制内容遵守此限制。

AllowTextMarkup

获取或设置对编辑此字段时允许添加文本标记的限制。

AllowThemeFonts

获取或设置是否启用主题字体。此限制仅禁用菜单，并不强制内容遵守此限制。

预定义表格式

HTML 编辑器包含一组预定义表格式，但可对其进行自定义以适合单个页的样式。每个表格式都是每个表标记的级联样式表 (CSS) 类的集合。可定义首行和末行、奇数行和偶数行、首列和末列等的样式。

HTML 编辑器在页上动态应用引用的样式表中的某些样式，并使用户可在设置表格式时使用这些样式。对于在设置表格式时可使用的自定义样式，相关的类名必须遵循 PREFIXTableXXX-NNN 格式，其中：

  • PREFIX 为 ms-rte（默认值），但可使用 RichHTML 字段控件的控件 PrefixStyleSheet() 属性替代该默认值。

  • XXX 为特定的表节，例如 EvenRow 或 OddRow。

  • NNN 为用于标识表样式的名称。

以下示例表示完整的一组表样式格式的类。

.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 包含一组默认表样式。但如果系统检测到不是源自默认 .css 文件的新样式，则它会删除默认组，并且在 HTML 编辑器对话框中仅显示这些新定义的样式。

拼写检查器

在 SharePoint Server 2010 中，HTML 编辑器包含一个拼写检查器，开发人员可使用 SpellCheckV4Action Web 控件和 SpellCheckToolbarButton Web 控件对其进行自定义。拼写检查器操作将在拼写检查过程中注册客户端文件和数据。它还包含一个用于获取控制台选项卡的方法，并将调用用户权限以验证当前用户是否有权对选定项执行拼写检查操作。拼写检查器操作将调用适当的 ECMAScript（JavaScript、JScript） 代码，并将有关可用拼写和用于请求的默认语言的信息发送给客户端。

请参阅

概念

如何：自定义样式

如何：自定义资产选取器