此插件增加了分页符支持,允许用户在可编辑区域中插入分页符。这对于某些使用特殊分隔符将内容划分为页面的 CMS 来说非常有用。
它还添加了一个工具栏按钮,并在 Insert(插入)菜单下拉菜单中添加了一个菜单项 Page break(分页符)。
基本设置
tinymce.init({
selector: 'textarea', // change this value according to your html
plugins: 'pagebreak',
toolbar: 'pagebreak'
});有关使用模块打包工具捆绑此插件的信息,请参阅 Bundling TinyMCE - Overview(捆绑 TinyMCE - 概述)。
选项
这些设置会影响 pagebreak 插件的执行。它们允许您指定应在 HTML 源代码中如何生成分页符,并确定是否应将分页符元素包装在 <p> 标签中。
pagebreak_separator
类型:String
默认值:'<!-- pagebreak -->'
示例:使用 pagebreak_separator
tinymce.init({
selector: 'textarea', // change this value according to your HTML
plugins: 'pagebreak',
toolbar: 'pagebreak',
pagebreak_separator: '<!-- my page break -->'
});pagebreak_split_block
启用此选项后,使用分页符分割块级元素会变得更加容易。
类型:Boolean
默认值:false
可能的值:true、false
示例:使用 pagebreak_split_block
tinymce.init({
selector: 'textarea', // change this value according to your HTML
plugins: 'pagebreak',
toolbar: 'pagebreak',
pagebreak_split_block: true
});工具栏按钮
分页符插件提供了以下工具栏按钮:
| 工具栏按钮标识符 | 描述 |
|---|---|
| 在编辑器中插入分页符。 |
可以使用以下方式将这些工具栏按钮添加到编辑器中:
toolbar配置选项。quickbars_insert_toolbar配置选项。
菜单项
分页符插件提供了以下菜单项:
| 菜单项标识符 | 默认菜单位置 | 描述 |
|---|---|---|
| Insert | 在编辑器中插入分页符。 |
可以使用以下方式将这些菜单项添加到编辑器中:
menu配置选项。contextmenu配置选项。
命令
分页符插件提供了以下 TinyMCE 命令。
| 命令 | 描述 |
|---|---|
mcePageBreak | 在光标位置插入虚拟分页符( |
tinymce.activeEditor.execCommand('mcePageBreak');