此插件添加一个按钮,用于在当前光标位置(插入点)插入不换行空格实体 。它还在 Insert 菜单下拉菜单中添加一个菜单项 Nonbreaking space 和一个工具栏按钮。
基本设置
tinymce.init({
selector: 'textarea', // 根据需要修改此值以匹配您的 HTML
plugins: 'nonbreaking',
toolbar: 'nonbreaking'
});有关使用模块打包工具捆绑此插件的信息,请参阅 Bundling TinyMCE - Overview。
选项
nonbreaking_force_tab
此选项允许您在用户按下键盘 tab 键时强制 TinyMCE 插入三个 实体。
需要注意的是,这不会改变菜单和工具栏控件的行为,当 nonbreaking_force_tab 值为 true 时,它们将继续插入单个 实体。
但是,true 条件会捕获 Tab 键并将其限制在可编辑区域内,而当设置为默认状态 false 时,按下 Tab 键会将光标移动到下一个可编辑区域(例如当前页面的浏览器地址栏或表单字段)。
与table或lists插件一起使用时
nonbreaking_force_tab设置可能会破坏以下功能:
table插件使用 Tab 键在表格单元格之间导航。
lists插件使用 Tab 键进行项目缩进。
类型: Boolean
默认值: false
可能的值: true, false
示例:使用 nonbreaking_force_tab
tinymce.init({
selector: 'textarea', // 根据需要修改此值以匹配您的 HTML
plugins: 'nonbreaking',
toolbar: 'nonbreaking',
nonbreaking_force_tab: true
});nonbreaking_wrap
此选项允许您强制 TinyMCE 将插件插入的不换行空格字符包裹在 <span class="mce-nbsp-wrap"></span> 元素中。这将防止在输入额外的空格时,不换行空格被编辑器或浏览器替换。
类型: Boolean
默认值: true
可能的值: true, false
示例:使用 nonbreaking_wrap
tinymce.init({
selector: 'textarea', // 根据需要修改此值以匹配您的 HTML
plugins: 'nonbreaking',
toolbar: 'nonbreaking',
nonbreaking_wrap: false
});工具栏按钮
Nonbreaking Space 插件提供以下工具栏按钮:
| 工具栏按钮标识符 | 描述 |
|---|---|
| 在编辑器中插入不换行空格。 |
这些工具栏按钮可以通过以下方式添加到编辑器中:
toolbar配置选项。quickbars_insert_toolbar配置选项。
菜单项
Nonbreaking Space 插件提供以下菜单项:
| 菜单项标识符 | 默认菜单位置 | 描述 |
|---|---|---|
| Insert | 在编辑器中插入不换行空格。 |
这些菜单项可以通过以下方式添加到编辑器中:
menu配置选项。contextmenu配置选项。
命令
Nonbreaking Space 插件提供以下 TinyMCE 命令。
| 命令 | 描述 |
|---|---|
mceNonBreaking | 在光标位置插入不换行空格或覆盖当前选择。 |
tinymce.activeEditor.execCommand('mceNonBreaking');