如何：自定义 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 标题标记、超链接、图像、编号或项目符号列表、表或文本标记。

属性

说明

AllowExternalUrls

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

AllowFonts

内容可包含字体标记。

AllowReusableContent

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

AllowHeadings

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

AllowTextMarkup

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

AllowImages

内容可包含图像。

AllowLists

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

AllowTables

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

AllowHyperlinks

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

AllowHtmlSourceEditing

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

DisableBasicFormattingButtons

如果设置为 true，则会禁用大多数基本格式按钮。

预定义表格式

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

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

  • PREFIX is ms-rte by default, but you can override the default by using the control PrefixStyleSheet property of the RichHTML field control.

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

Office SharePoint Server 2007 附带了一组默认表样式。但是，如果系统检测到不是来自默认的 .css 文件的任何新样式，则它会移除默认组，并仅在 HTML 编辑器对话框中显示这些新定义的样式。

See Also

概念

如何：自定义样式