此插件会在编辑器中添加一个对话框,其中包含键盘无法直接输入的特殊 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 插件提供了以下工具栏按钮:

工具栏按钮标识符描述

charmap

将自定义字符插入编辑器。

可以使用以下方式将这些工具栏按钮添加到编辑器中:

菜单项

Character Map 插件提供了以下菜单项:

菜单项标识符默认菜单位置描述

charmap

插入

打开字符映射对话框。

可以使用以下方式将这些菜单项添加到编辑器中:

命令

Character Map 插件提供了以下 TinyMCE 命令。

命令描述

mceShowCharmap

打开字符映射对话框。

示例
tinymce.activeEditor.execCommand('mceShowCharmap');