Default Configuration
The default configuration for Umo Editor allows you to modify and preview some settings online at https://demo.umodoc.com/editor.
All Configurations
const defaultOptions = {
editorKey: 'default',
locale: 'zh-CN',
theme: 'light',
height: '100%',
dicts: {
fonts: [
{ label: { en_US: 'Default Font', zh_CN: '默认字体' }, value: null },
{ 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: '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' },
],
// prettier-ignore
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,
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:
'ĀāĂ㥹ĆćĈĉĊċČčĎďĐđĒēĔĕĖėĘęĚěĜĝĞğĠġĢģĤĥĦħĨĩĪīĬĭĮįİıIJijĴĵĶķĸĹĺĻļĽľĿŀŁłŃńŅņŇňʼnŊŋŌōŎŏŐőŒœŔŕŖŗŘřŚśŜŝŞşŠšŢţŤťŦŧŨũŪūŬŭŮůŰűŲųŴŵŶŷŸŹźŻżŽžſ',
},
],
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:
'➰ ➿ 〽️ ✳️ ✴️ ❇️ ©️ ®️ ™️ #️⃣ *️⃣ 0️⃣ 1️⃣ 2️⃣ 3️⃣ 4️⃣ 5️⃣ 6️⃣ 7️⃣ 8️⃣ 9️⃣ 🔟 🔠 🔡 🔢 🔣 🔤 🅰️ 🆎 🅱️ 🆑 🆒 🆓 ℹ️ 🆔 Ⓜ️ 🆕 🆖 🅾️ 🆗 🅿️ 🆘 🆙 🆚 🈁 🈂️ 🔴 🟠 🟡 🟢 🔵 🟣 🟤 ⚫ ⚪ 🟥 🟧 🟨 🟩 🟦 🟪 🟫 ⬛ ⬜ ◼️ ◻️ ◾ ◽ ▪️ ▫️ 🔶 🔷 🔸 🔹 🔺 🔻 💠 🔘 🔳 🔲',
},
{
label: { en_US: 'Flags', zh_CN: '旗帜' },
items:
'🏁 🇨🇳 🎌 🇩🇪 🇪🇸 🇦🇨 🇦🇩 🇦🇪 🇦🇫 🇦🇬 🇦🇮 🇦🇱 🇦🇲 🇦🇴 🇦🇶 🇦🇷 🇦🇸 🇦🇹 🇦🇺 🇦🇼 🇦🇽 🇦🇿 🇧🇦 🇧🇧 🇧🇩 🇧🇪 🇧🇫 🇧🇬 🇧🇭 🇧🇮 🇧🇯 🇧🇱 🇧🇲 🇧🇳 🇧🇴 🇧🇶 🇧🇷 🇧🇸 🇧🇹 🇧🇻 🇧🇼 🇧🇾 🇧🇿 🇨🇦 🇨🇨 🇨🇩 🇨🇫 🇨🇬 🇨🇭 🇨🇮 🇨🇰 🇨🇱 🇨🇲 🇨🇴 🇨🇵 🇨🇷 🇨🇺 🇨🇻 🇨🇼 🇨🇽 🇨🇾 🇨🇿 🇩🇬 🇩🇯 🇩🇰 🇩🇲 🇩🇴 🇩🇿 🇪🇦 🇪🇨 🇪🇪 🇪🇬 🇪🇭 🏴 🇪🇷 🇪🇹 🇪🇺 🇫🇮 🇫🇯 🇫🇰 🇫🇲 🇫🇴 🇬🇦 🇬🇩 🇬🇪 🇬🇫 🇬🇬 🇬🇭 🇬🇮 🇬🇱 🇬🇲 🇬🇳 🇬🇵 🇬🇶 🇬🇷 🇬🇸 🇬🇹 🇬🇺 🇬🇼 🇬🇾 🇭🇰 🇭🇲 🇭🇳 🇭🇷 🇭🇹 🇭🇺 🇮🇨 🇮🇩 🇮🇪 🇮🇱 🇮🇲 🇮🇳 🇮🇴 🇮🇶 🇮🇷 🇮🇸 🇯🇪 🇯🇲 🇯🇴 🇰🇪 🇰🇬 🇰🇭 🇰🇮 🇰🇲 🇰🇳 🇰🇵 🇰🇼 🇰🇾 🇰🇿 🇱🇦 🇱🇧 🇱🇨 🇱🇮 🇱🇰 🇱🇷 🇱🇸 🇱🇹 🇱🇺 🇱🇻 🇱🇾 🇲🇦 🇲🇨 🇲🇩 🇲🇪 🇲🇫 🇲🇬 🇲🇭 🇲🇰 🇲🇱 🇲🇲 🇲🇳 🇲🇴 🇲🇵 🇲🇶 🇲🇷 🇲🇸 🇲🇹 🇲🇺 🇲🇻 🇲🇼 🇲🇽 🇲🇾 🇲🇿 🇳🇦 🇳🇨 🇳🇪 🇳🇫 🇳🇬 🇳🇮 🇳🇱 🇳🇴',
},
],
pageSizes: [
{ label: 'A4', width: 21.0, height: 29.4, 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,
},
],
},
toolbar: {
defaultMode: 'ribbon',
enableSourceEditor: false,
menus: ['base', 'insert', 'table', 'tools', 'page', 'export'],
disableMenuItems: [],
importWord: {
enabled: true,
options: {},
useCustomMethod: false,
},
},
page: {
defaultMargin: {
left: 3.18,
right: 3.18,
top: 2.54,
bottom: 2.54,
},
defaultOrientation: 'portrait',
defaultBackground: '#fff',
watermark: {
type: 'compact',
alpha: 0.2,
fontColor: '#000',
fontSize: 16,
fontFamily: 'SimSun',
fontWeight: 'normal',
text: '',
},
},
document: {
title: '',
content: '',
placeholder: {
en_US: 'Please enter the document content...',
zh_CN: '请输入文档内容...',
},
enableSpellcheck: true,
enableMarkdown: true,
enableBubbleMenu: true,
enableBlockMenu: true,
readOnly: false,
autofocus: true,
characterLimit: 0,
typographyRules: {},
// https://prosemirror.net/docs/ref/#view.EditorProps
editorProps: {},
// https://prosemirror.net/docs/ref/#model.ParseOptions
parseOptions: {
preserveWhitespace: 'full',
},
autoSave: {
enabled: true,
interval: 300000,
},
},
assistant: {
enabled: false,
maxlength: 100,
commands: [
{
label: { en_US: 'Continuation', zh_CN: '续写' },
value: { en_US: 'Continuation', zh_CN: '续写' },
},
{
label: { en_US: 'Rewrite', zh_CN: '重写' },
value: { en_US: 'Rewrite', zh_CN: '重写' },
},
{
label: { en_US: 'Abbreviation', zh_CN: '缩写' },
value: { en_US: 'Abbreviation', zh_CN: '缩写' },
},
{
label: { en_US: 'Expansion', zh_CN: '扩写' },
value: { en_US: 'Expansion', zh_CN: '扩写' },
},
{
label: { en_US: 'Polish', zh_CN: '润色' },
value: { en_US: 'Polish', zh_CN: '润色' },
},
{
label: { en_US: 'Proofread', zh_CN: '校阅' },
value: { en_US: 'Proofread', zh_CN: '校阅' },
},
{
label: { en_US: 'Translate', zh_CN: '翻译' },
value: { en_US: 'Translate to chinese', zh_CN: '翻译成英文' },
autoSend: false,
},
],
},
templates: [],
cdnUrl: 'https://unpkg.com/@umoteam/editor-external@latest',
shareUrl: location?.href || '',
diagrams: {
domain: 'https://embed.diagrams.net',
// https://www.drawio.com/doc/faq/supported-url-parameters
params: {},
},
file: {
allowedMimeTypes: [],
maxSize: 1024 * 1024 * 100, // 100M
},
extensions: [],
translations: {
en_US: {},
zh_CN: {},
},
async onSave(content, page, document) {
throw new Error('Key "onSave": Please set the save method')
},
async onFileUpload(file) {
if (!file) {
throw new Error('File not found')
}
throw new Error('Key "onFileUpload": Please set the upload method')
},
onFileDelete(id, src) {
console.error('The file has been deleted. Please configure the onFileDelete to completely delete the file from the server.')
},
async onAssistant(payload, content) {
throw new Error('Key "onAssistant": Please set the onAssistant method')
},
async onCustomImportWordMethod(file) {
throw new Error('Key "onCustomImportWordMethod": Please set the onAssistant method')
},
}
🚫
Starting from version v2.0.0, dicts
under label
and document.placeholder
support both String
and Object
types. The Object
type is mainly used for multi-language configuration information, formatted as { en_US: 'English', zh_CN: 'Chinese' }
.
Configuration Sections
The configuration items of Umo Editor are mainly divided into the following parts:
editorKey
: String, the key for the editor, used to distinguish different editor instances.locale
: String, the display language, defaults to Chinese.height
: String, the height of the editor.dicts
: Object, dictionary configuration, see Dictionaries Configuration.toolbar
: Object, toolbar configuration, see Toolbar Configuration.page
: Object, page configuration, see Page Configuration.document
: Object, document configuration, see Document Configuration.assistant
: Object, configuration for the AI Assistant, see AI Assistant for details. New in v3.0.0templates
: Array, preset page template configurations, see Template Configuration.cdnUrl
: String, the base path for static resources, must be a valid URL, see CDN Configuration.shareUrl
: String, share link configuration, must be a valid URL, see Share Configuration.diagrams
: Object, Diagrams chart configuration, see Diagrams Chart Configuration.file
: Object, file upload configuration, see File Upload Configuration.extensions
: Array see Custom Extensions. New in v1.4.0translations
: Object see Custom Localization Configuration. New in v2.0.0onSave(content, page, document)
: AsyncFunction, document save method, should return a Promise, see Methods.onFileUpload(file)
: AsyncFunction, file upload method, should return a Promise, see Methods.onFileDelete(id, url)
: Function, file delete method, see Methods.onAssistant(payload, content)
: AsyncFunction, the method for handling data returned by the AI Assistant, see AI Assistant for details. New in v3.0.0onCustomImportWordMethod(file)
: Async Function, a custom method for importing Word files. See Method Configuration for more details. New in v3.1.0