此插件会在编辑器中添加一个对话框,其中包含键盘无法直接输入的特殊 unicode 字符的映射表。该对话框可通过工具栏按钮 - charmap - 或添加为插入 > 特殊字符的专用菜单项来调用。
基本设置
tinymce.init({
selector: 'textarea', // 根据需要修改此值以匹配您的 HTML
plugins: 'charmap',
toolbar: 'charmap',
});如需了解使用模块打包工具捆绑此插件的信息,请参阅 Bundling TinyMCE - Overview。
选项
可通过以下选项覆盖或扩展默认的 unicode 字符映射表。
在内部,字符映射表通过数组的数组来定义,每个子数组代表一个字符。子数组中的第一项是字符代码,第二项是鼠标悬停在映射表中指定字符上时显示的标题。字符代码可以是十进制、八进制或十六进制(对于八进制或十六进制格式,代码应分别添加 0 和 0x 前缀)。选项应采用相同格式提供。
[ [160, 'no-break space'], [173, 'soft hyphen'], [34, 'quotation mark'], ... [8205, 'zero width joiner'], [8206, 'left-to-right mark'], [8207, 'right-to-left mark'] ];
charmap
使用此选项可以完全覆盖默认的字符映射表。它可以是数组或返回上述格式数组的函数。
类型: Array、Function
示例:使用 charmap
tinymce.init({
selector: 'textarea', // 根据需要修改此值以匹配您的 HTML
plugins: 'charmap',
toolbar: 'charmap',
charmap: [
[0x2615, 'morning coffee']
]
});charmap_append
此选项提供了一种将一些额外的字符附加到默认字符映射表的方法。它可以是数组或返回上述格式数组的函数。
类型: Array、Function
示例:使用 charmap_append
tinymce.init({
selector: 'textarea', // 根据需要修改此值以匹配您的 HTML
plugins: 'charmap',
toolbar: 'charmap',
charmap_append: [
[0x2600, 'sun'],
[0x2601, 'cloud']
]
});工具栏按钮
Character Map 插件提供了以下工具栏按钮:
| 工具栏按钮标识符 | 描述 |
|---|---|
| 将自定义字符插入编辑器。 |
可以使用以下方式将这些工具栏按钮添加到编辑器中:
toolbar配置选项。quickbars_insert_toolbar配置选项。
菜单项
Character Map 插件提供了以下菜单项:
| 菜单项标识符 | 默认菜单位置 | 描述 |
|---|---|---|
| 插入 | 打开字符映射对话框。 |
可以使用以下方式将这些菜单项添加到编辑器中:
menu配置选项。contextmenu配置选项。
命令
Character Map 插件提供了以下 TinyMCE 命令。
| 命令 | 描述 |
|---|---|
mceShowCharmap | 打开字符映射对话框。 |
tinymce.activeEditor.execCommand('mceShowCharmap');