Dictionary Configuration

Used to configure commonly used dictionary-type data, including fonts, colors, line heights, special characters, emojis, page sizes, etc.

Default Configuration

{
  dicts: {
    fonts: [
      {
        label: { en_US: 'Default Font', zh_CN: '默认字体' },
        value: null,
      },
      {
        label: { en_US: 'Noto Sans SC', zh_CN: '思源黑体' },
        value: 'Noto Sans SC',
        url: 'https://fonts.gstatic.com/s/notosanssc/v40/k3kXo84MPvpLmixcA63oeALhLIiP-Q-87KaAaH7rzeAODp22mF0qmF4CSjmPC6A0Rg5g1igg1w.4.woff2',
        format: 'woff2',
      },
      {
        label: { en_US: 'Noto Serif SC', zh_CN: '思源宋体' },
        value: 'Noto Serif SC',
        url: 'https://fonts.gstatic.com/s/notoserifsc/v35/H4cyBXePl9DZ0Xe7gG9cyOj7uK2-n-D2rd4FY7SCqyWv.ttf',
        format: 'truetype',
      },
      {
        label: { en_US: 'Songti', zh_CN: '宋体' },
        value: 'SimSun',
      },
      {
        label: { en_US: 'Heiti', zh_CN: '黑体' },
        value: 'SimHei',
      },
      {
        label: { en_US: 'Kaiti', zh_CN: '楷体' },
        value: 'KaiTi',
      },
      {
        label: {
          en_US: 'Kaiti GB2312',
          zh_CN: '楷体_GB2312',
        },
        value: 'KaiTi_GB2312',
      },
      {
        label: { en_US: 'Fangsong', zh_CN: '仿宋' },
        value: 'FangSong',
      },
      {
        label: {
          en_US: 'Fangsong GB2312',
          zh_CN: '仿宋_GB2312',
        },
        value: 'FangSong_GB2312',
      },
      {
        label: { en_US: 'STSong', zh_CN: '华文宋体' },
        value: 'STSong',
      },
      {
        label: { en_US: 'STFangsong', zh_CN: '华文仿宋' },
        value: 'STFangsong',
      },
      {
        label: {
          en_US: 'FZ Fangsong Simplified',
          zh_CN: '方正仿宋简体',
        },
        value: 'FZFangSong-Z02S',
      },
      {
        label: {
          en_US: 'FZ Xiaobiao Song',
          zh_CN: '方正小标宋',
        },
        value: 'FZXiaoBiaoSong-B05S',
      },
      {
        label: {
          en_US: 'Microsoft Yahei',
          zh_CN: '微软雅黑',
        },
        value: 'Microsoft Yahei',
      },
      {
        label: { en_US: 'PingFang SC', zh_CN: '苹方' },
        value: 'PingFang SC',
      },
      {
        label: { en_US: 'Hiragino Sans GB', zh_CN: '冬青黑体简体中文' },
        value: 'Hiragino Sans GB',
      },
      {
        label: { en_US: 'DengXian', zh_CN: '等线' },
        value: 'DengXian',
      },
      {
        label: { en_US: 'DengXian Light', zh_CN: '等线 Light' },
        value: 'DengXian Light',
      },
      {
        label: { en_US: 'YouYuan', zh_CN: '幼圆' },
        value: 'YouYuan',
      },
      {
        label: { en_US: 'LiSu', zh_CN: '隶书' },
        value: 'LiSu',
      },
      {
        label: { en_US: 'NSimSun', zh_CN: '新宋体' },
        value: 'NSimSun',
      },
      { label: 'Arial', value: 'Arial' },
      { label: 'Times New Roman', value: 'Times New Roman' },
      { label: 'Verdana', value: 'Verdana' },
      { label: 'Helvetica', value: 'Helvetica' },
      { label: 'Calibri', value: 'Calibri' },
      { label: 'Cambria', value: 'Cambria' },
      { label: 'Tahoma', value: 'Tahoma' },
      { label: 'Georgia', value: 'Georgia' },
      { label: 'Comic Sans MS', value: 'Comic Sans MS' },
      { label: 'Impact', value: 'Impact' },
    ],
    colors: [
        "#FFF",
        "#000",
        "#4A5366",
        "#3B74EC",
        "#45A2EF",
        "#529867",
        "#CD4A3F",
        "#EA8D40",
        "#EEC543",
        "#8E45D0",
        "#F2F2F2",
        "#7F7F7F",
        "#F4F5F7",
        "#CBDCFC",
        "#E8F6FE",
        "#EDFAF2",
        "#FCEAE9",
        "#FDF3EC",
        "#FEF9E5",
        "#FAECFE",
        "#EEE",
        "#595959",
        "#C6CAD2",
        "#CEEBFD",
        "#CBDCFC",
        "#CBE9D7",
        "#F7CBC9",
        "#FADDC7",
        "#FDEEB5",
        "#EBCAFC",
        "#BFBFBF",
        "#3F3F3F",
        "#828B9D",
        "#A0BEFA",
        "#A7DCFC",
        "#A6D5B8",
        "#F2A19C",
        "#F5BC8C",
        "#FBE281",
        "#CB94F9",
        "#A5A5A5",
        "#262626",
        "#363B44",
        "#2452B2",
        "#3473A1",
        "#417A53",
        "#922B22",
        "#AD642A",
        "#9E8329",
        "#57297D",
        "#939393",
        "#0D0D0D",
        "#25272E",
        "#15316A",
        "#1C415A",
        "#284D34",
        "#511712",
        "#573213",
        "#635217",
        "#36194E",
      ],
    lineHeights: [
      {
        label: { en_US: 'Single', zh_CN: '单倍行距' },
        value: 1,
      },
      {
        label: {
          en_US: '1.5 Line Spacing',
          zh_CN: '1.5 倍行距',
        },
        value: 1.5,
      },
      {
        label: {
          en_US: '1.75 Line Spacing',
          zh_CN: '1.75 倍行距',
        },
        value: 1.75,
        default: true,
      },
      {
        label: { en_US: 'Double', zh_CN: '2 倍行距' },
        value: 2,
      },
      {
        label: {
          en_US: '2.5 Line Spacing',
          zh_CN: '2.5 倍行距',
        },
        value: 2.5,
      },
      {
        label: { en_US: 'Triple', zh_CN: '3 倍行距'  },
        value: 3,
      },
    ],
    symbols: [
      {
        label: {
          en_US: 'Plain Text',
          zh_CN: '普通文本',
        },
        items: '‹›«»‘’“”‚„¡¿‥…‡‰‱‼⁈⁉⁇©®™§¶⁋',
      },
      {
        label: {
          en_US: 'Currency Symbols',
          zh_CN: '货币符号',
        },
        items: '$€¥£¢₠₡₢₣₤¤₿₥₦₧₨₩₪₫₭₮₯₰₱₲₳₴₵₶₷₸₹₺₻₼₽',
      },
      {
        label: {
          en_US: 'Mathematical Symbols',
          zh_CN: '数学符号',
        },
        items: '<>≤≥–—¯‾°−±÷⁄×ƒ∫∑∞√∼≅≈≠≡∈∉∋∏∧∨¬∩∪∂∀∃∅∇∗∝∠¼½¾',
      },
      {
        label: { en_US: 'Arrows', zh_CN: '箭头' },
        items: '←→↑↓⇐⇒⇑⇓⇠⇢⇡⇣⇤⇥⤒⤓↨',
      },
      {
        label: {
          en_US: 'Latin Script',
          zh_CN: '拉丁语',
        },
        items:
          'ĀāĂăĄąĆćĈĉĊċČčĎďĐđĒēĔĕĖėĘęĚěĜĝĞğĠġĢģĤĥĦħĨĩĪīĬĭĮįİıĲĳĴĵĶķĸĹĺĻļĽľĿŀŁłŃńŅņŇňŉŊŋŌōŎŏŐőŒœŔŕŖŗŘřŚśŜŝŞşŠšŢţŤťŦŧŨũŪūŬŭŮůŰűŲųŴŵŶŷŸŹźŻżŽžſ',
      },
    ],
    emojis: [
      {
        label: {
          en_US: 'Emotions & People',
          zh_CN: '表情与角色',
        },
        items:
          '😀 😃 😄 😁 😆 😅 🤣 😂 🙂 🙃 😉 😊 😇 🥰 😍 🤩 😘 😗 😚 😙 😋 😛 😜 🤪 😝 🤑 🤗 🤭 🤫 🤔 🤐 🤨 😐 😑 😶 😶‍ 😏 😒 🙄 😬 😮‍ 🤥 😌 😔 😪 🤤 😴 😷 🤒 🤕 🤢 🤮 🤧 🥵 🥶 🥴 😵 😵‍💫 🤯 🤠 🥳 😎 🤓 🧐 😕 😟 🙁 ☹️ 😮 😯 😲 😳 🥺 😦 😧 😨 😰 😥 😢 😭 😱 😖 😣 😞 😓 😩 😫 🥱 😤 😡 😠 🤬 😈 👿 💀 ☠️ 💩 🤡 👹 👺 👻 👽 👾 🤖 👋 🤚 🖐️ ✋ 🖖 👌 🤏 ✌️ 🤞 🤟 🤘 🤙 👈 👉 👆 🖕 👇 ☝️ 👍 👎 ✊ 👊 🤛 🤜 👏 🙌 👐 🤲 🤝 🙏 ✍️ 💅 🤳 💪 🦾 🦿 🦵 🦶 👂 🦻',
      },
      {
        label: {
          en_US: 'Animals & Nature',
          zh_CN: '动物与自然',
        },
        items:
          '🐵 🐒 🦍 🦧 🐶 🐕 🦮 🐕‍🦺 🐩 🐺 🦊 🦝 🐱 🐈 🐈‍⬛ 🦁 🐯 🐅 🐆 🐴 🐎 🦄 🦓 🦌 🐮 🐂 🐃 🐄 🐷 🐖 🐗 🐽 🐏 🐑 🐐 🐪 🐫 🦙 🦒 🐘 🦏 🦛 🐭 🐁 🐀 🐹 🐰 🐇 🐿️ 🦔 🦇 🐻 🐻‍❄️ 🐨 🐼 🦥 🦦 🦨 🦘 🦡 🐾 🦃 🐔 🐓 🐣 🐤 🐥 🐦 🐧 🕊️ 🦅 🦆 🦢 🦉 🦩 🦚 🦜 🐸 🐊 🐢 🦎 🐍 🐲 🐉 🦕 🦖 🐳 🐋 🐬 🦭 🐟 🐠 🐡 🦈 🐙 🐚 🐌 🦋 🐛 🐜 🐝 🐞 🦗 🕷️ 🕸️ 🦂 🦟 🦠 💐 🌸 💮 🏵️ 🌹 🥀 🌺 🌻 🌼 🌷 🌱 🌲 🌳 🌴 🌵 🌾 🌿 ☘️ 🍀 🍁 🍂 🍃 🌒 🌓 🌔 🌕 🌖 🌗 🌘 🌙 🌚 🌛 🌜 ☀️ 🌝 🌞 🪐 🌟 🌠 🌌 ☁️ ⛅ ⛈️ 🌤️ 🌥️ 🌦️ 🌧️ 🌨️ 🌩️ 🌪️ 🌫️ 🌬️ 🌀 🌈 🌂 ☂️ ☔ ⛱️ ⚡ ❄️ ☃️ ⛄ ☄️ 🔥 💧 🌊',
      },
      {
        label: {
          en_US: 'Food & Drink',
          zh_CN: '食物与食品',
        },
        items:
          '🍇 🍉 🍊 🍋 🍌 🍍 🥭 🍎 🍏 🍐 🍑 🍒 🍓 🥝 🍅 🥥 🥑 🍆 🥔 🥕 🌽 🌶️ 🥬 🥦 🧄 🧅 🍄 🥜 🌰 🍞 🥐 🥖 🥨 🥯 🥞 🧇 🧀 🍖 🍗 🥩 🥓 🍔 🍟 🍕 🌭 🥪 🌮 🌯 🥙 🧆 🥚 🍳 🥘 🍲 🥣 🥗 🍿 🧈 🧂 🥫 🍱 🍘 🍙 🍚 🍛 🍜 🍝 🍠 🍢 🍣 🍤 🍥 🥮 🍡 🥟 🥠 🥡 🦀 🦞 🦐 🦑 🦪 🍦 🍧 🍨 🍩 🍪 🎂 🍰 🧁 🥧 🍫 🍬 🍭 🍮 🍯 🍼 🥛 ☕ 🍵 🍶 🍾 🍷 🍸 🍹 🍺 🍻 🥂 🥃 🥤 🧃 🧉 🧊 🥢 🍽️ 🍴 🥄 🔪 🏺',
      },
      {
        label: { en_US: 'Activities', zh_CN: '活动' },
        items:
          '🧧 🎁 🎄 🧨 ✨ 🎈 🎉 🏮 🎗️ 🎟️ 🎫 🎖️ 🏆 🏅 🥇 🥈 🥉 ⚽ ⚾ 🥎 🏀 🏐 🏈 🏉 🎾 🥏 🎳 🏏 🏑 🏒 🥍 🏓 🏸 🥊 🥋 🥅 ⛳ ⛸️ 🎣 🤿 🎽 🎿 🛷 🥌 🎯 🪀 🪁 🎱 🔮 🧿 🎮 🕹️ 🎰 🎲 🧩 🧸 ♟️ 🃏 🀄 🎴 🎭 🖼️ 🎨 🧵 🧶',
      },
      {
        label: {
          en_US: 'Travel & Places',
          zh_CN: '旅行与景点',
        },
        items:
          '🚈 🚉 🚊 🚝 🚞 🚋 🚌 🚍 🚎 🚐 🚑 🚒 🚓 🚔 🚕 🚖 🚗 🚘 🚙 🚚 🚛 🚜 🏎️ 🏍️ 🛵 🦽 🦼 🛺 🚲 🛴 🛹 🚏 🛣️ 🛤️ 🛢️ ⛽ 🚨 🚥 🚦 🛑 🚧 ⚓ ⛵ 🛶 🚤 🛳️ ⛴️ 🛥️ 🚢 ✈️ 🛩️ 🛫 🛬 🪂 💺 🚁 🚟 🚠 🚡 🛰️ 🚀 🛸 🛎️ 🧳 🧭 ⌚ ⏰ ⏱️ ⏲️ 🕰️ 🕛 🕧 🕐 🕜 🕑 🕝 🕒 🕞 🕓 🕟 🕔 🕠 🕕 🕡 🕖 🕢 🕗 🕣 🕘 🕤 🕙 🕥 🕚 🕦',
      },
      {
        label: { en_US: 'Objects', zh_CN: '物品' },
        items:
          '📔 📕 📖 📗 📘 📙 📚 📒 📃 📜 📄 📰 🗞️ 📑 🔖 🏷️ 💰 🔍 🔎 💴 💵 💶 💷 💸 💳 🧾 💹 ✉️ 📧 📨 📩 📤 📥 📦 📫 📪 📬 📭 📮 🗳️ ✏️ ✒️ 🖋️ 🖊️ 🖌️ 🖍️ 📝 💼 📁 📂 🗂️ 📅 📆 🗒️ 🗓️ 📇 📈 📉 📊 📋 📌 📍 📎 🖇️ 📏 📐 ✂️ 🗃️ 🗄️ 🗑️ 🔒 🔓 🔏 🔐 🔑 🗝️ 🔨 🪓 ⛏️ ⚒️ 🛠️ 🗡️ ⚔️ 🔫 🏹 🛡️ 🔧 🔩 ⚙️ 🗜️ ⚖️ 🦯 🔗 ⛓️ 🧰 🧲 ⚗️ 🧪 🧫 🧬 🔬 🔭 📡 💉 🩸 💊 🩹 🩺 🚪 🛏️ 🛋️ 🪑 🚽 🚿 🛁 🪒 🧴 🧷 🧹 🧺 🧻 🧼 🧽 🧯 🛒 🚬 ⚰️ ⚱️ 💎 🔇 🔈 🔉 🔊 🔔 🔕 🔋 🔌 💻 🖥️ 🖨️ ⌨️ 🖱️ 🖲️ 📷 🧱',
      },
      {
        label: { en_US: 'Symbols', zh_CN: '符号' },
        items:
          '💡 ✅ ☑️ ✔️ ❌ ❎ ❓ ❗ ❔ ❕ ⌛ ⏳ 💰 🆒 🆕 🆖 🅾️ 🆗 🆘 🈲 🉑 🈸 ⛔ 🚫 📵 ✳️ ✴️ ❇️ 🔟 🔠 🔡 🔢 🔣 🔤 🅰️ 🆎 🅱️ 🆑 🆒 🆓 ℹ️ 🆔 🆕 🆖 🅾️ 🆗 🅿️ 🆘 🆙 🆚 🈁 🈂️ 🔴 🟠 🟡 🟢 🔵 🟣 🟤 ⚫ ⚪ 🟥 🟧 🟨 🟩 🟦 🟪 🟫 🔶 🔷 🔸 🔹 🔺 🔻 💠 🔘 🔳 🔲 💌 💘 💝 💖 💗 💓 💞 💕 💟 ❣️ 💔 🤍 💯 💢 💥 💬 💤 ➰ ➿ 🔅 📴 ➡️ 🔃 🔄 🔙 🔚 🔛 🔝 🔀 🔁 🔂',
      },
      {
        label: { en_US: 'Flags', zh_CN: '旗帜' },
        items: '🏁 🚩 🏴 🏳️ 🏳️‍🌈‍',
      },
    ],
    pageSizes: [
      { label: 'A4', width: 21.0, height: 29.7, default: true },
      { label: 'A3', width: 29.7, height: 42.0 },
      { label: 'A5', width: 14.8, height: 21.0 },
      { label: 'B5', width: 17.6, height: 25.0 },
      {
        label: {
          en_US: 'No. 5 Envelope',
          zh_CN: '5号信封',
        },
        width: 10.9,
        height: 12.9,
      },
      {
        label: {
          en_US: 'No. 6 Envelope',
          zh_CN: '6号信封',
        },
        width: 11.9,
        height: 22.9,
      },
      {
        label: {
          en_US: 'No. 7 Envelope',
          zh_CN: '7号信封',
        },
        width: 16.1,
        height: 22.8,
      },
      {
        label: {
          en_US: 'No. 9 Envelope',
          zh_CN: '9号信封',
        },
        width: 22.8,
        height: 32.3,
      },
      {
        label: {
          en_US: 'Legal Paper',
          zh_CN: '法律用纸',
        },
        width: 21.5,
        height: 33.5,
      },
      {
        label: {
          en_US: 'Letter Paper',
          zh_CN: '信纸',
        },
        width: 21.5,
        height: 27.9,
      },
    ],
  },
}

Configuration Description

dicts.fonts

Description: Font list, used to provide selectable fonts for users.

Type: Array

Configuration:

item.label: String or Object, the display name of the font.
item.value: A valid CSS font-family value.
item.url: String, optional. Download URL for the font file (used to download and enable the font in the browser). Added in v10.1.0
item.format: String, optional. Font format for item.url, common values: woff2, truetype, opentype. Added in v10.1.0

Font Download Notes:

When a font is not installed locally and item.url is configured, users can trigger download and enable it in the current browser.
Downloaded fonts are recorded in local storage and reused on subsequent visits to avoid repeated downloads.
Downloaded fonts are only available in the current browser context. Due to browser security limits, they cannot be automatically installed into the operating system font library.
If you need the same font in other browsers or in exported files, provide an external download link and let users install it manually at the OS level.

Recommended Practices:

Use publicly distributable font URLs with CORS support. In intranet environments, self-host the font files to ensure accessibility.
Prefer woff2 for smaller size; use ttf/otf when woff2 is not available.
For commercial fonts, ensure you have proper licensing before distribution to avoid legal risks.

⚠️

You are responsible for validating font licensing and URL availability. Broken URLs, CORS restrictions, or slow responses will affect download and enablement experience.

Configuration Example:

{
  dicts: {
    fonts: [
      {
        label: { en_US: 'Noto Serif SC', zh_CN: '思源宋体' },
        value: 'Noto Serif SC',
        url: 'https://fonts.gstatic.com/s/notoserifsc/v35/H4cyBXePl9DZ0Xe7gG9cyOj7uK2-n-D2rd4FY7SCqyWv.ttf',
        format: 'truetype',
      },
      {
        label: { en_US: 'LXGW WenKai', zh_CN: '霞鹜文楷' },
        value: 'LXGW WenKai',
        url: 'https://raw.githubusercontent.com/lxgw/LxgwWenKai/master/fonts/TTF/LXGWWenKai-Regular.ttf',
        format: 'truetype',
      },
    ],
  },
}

dicts.colors

Description: Color list, used to provide selectable colors for users, including font colors and background colors.

Type: Array

Configuration: Valid CSS color values.

dicts.lineHeights

Description: Line height list, used to provide selectable line heights for users.

Type: Array

Configuration:

item.label: String or Object, the display name of the line height.
item.value: A valid CSS line-height value.

dicts.symbols

Description: Special character list, used to provide selectable special characters for users. Before v2.0.0, it was dicts.specialCharacters.

Type: Array

Configuration:

item.label: String or Object, the group name of the special characters.
item.value: All special characters under this group.

dicts.emojis

⚠️

Note: The default emoji list was adjusted in v6.0.0.

Description: Emoji list, used to provide selectable emojis for users.

Type: Array

Configuration:

item.label: String or Object, the group name of the emojis.
item.value: All emojis under this group, separated by spaces.

Database Support: Emojis are essentially Unicode characters with a length of 4 bytes, requiring database support for storage. [How to get emojis in MySQL with utf8mb4]https://juejin.cn/post/7106906047670910989). You can also disable emoji insertion through the menu with the following configuration, but this does not prevent users from inserting emojis via copy-paste or input methods.

{
  toolbar:{
    disableMenuItems: ['emoji']
  }
}

dicts.pageSizes

Description: Page size list, used to provide selectable page sizes and default page size.

Type: Array

Configuration:

item.label: String or Object, the name of the page size.
item.width: Page width in centimeters (cm).
item.height: Page height in centimeters (cm).
item.default: Whether it is the default page size.

Default Toolbar