设置默认内容语言

content_language

content_language选项通过在文档元素上应用lang属性来设置编辑器的默认内容语言。在经典(iframe)模式下,该属性会设置编辑器iframe内部的<html>元素。在内联模式下,该属性会设置编辑器selector选项指定的目标元素上。

设置此选项有助于满足WCAG成功准则3.1.1(页面语言)等无障碍标准,该标准要求网页的默认人类语言能够通过程序方式确定。

此选项与控制TinyMCE用户界面语言的language选项是分开的。content_language选项仅控制编辑器内容区域的语言属性。

当拼写检查器插件启用时,它会使用content_language作为其默认的校对语言。如果未设置content_language,拼写检查器将回退到spellchecker_language。

类型:String

默认值:未设置(undefined)

示例:使用content_language

tinymce.init({
  selector: 'textarea',  // change this value according to your HTML
  content_language: 'fr'
});

设置内容的语言

content_langs

此选项设置language工具栏按钮和language菜单项中显示的语言。该选项接受一个语言规范数组。每个语言规范是一个使用以下属性定义的JavaScript对象。

名称类型要求描述

title

String

required

界面中显示此语言的名称。

code

String

required

此语言的语言标签,根据语言标识标签(BCP47)定义。该语言标签会放置在使用此语言格式化的元素的lang属性中。

customCode

String

optional

一个替代的语言标签,不需要与BCP47兼容。如果定义了此字符串,它会放置在使用此语言格式化的元素的data-mce-lang属性中。

content_langs选项没有默认值。如果未指定值,则language工具栏按钮和菜单项不可用。拼写检查器插件为此选项提供了默认值。有关将content_langs选项与拼写检查器插件一起使用的信息,请参见:拼写检查器插件 - content_langs。

类型:Array

示例:使用content_langs

tinymce.init({
  selector: 'textarea', // change this according to your HTML
  toolbar: 'language',
  content_langs: [
    { title: 'English', code: 'en' },
    { title: 'Spanish', code: 'es' },
    { title: 'French', code: 'fr' },
    { title: 'German', code: 'de' },
    { title: 'Portuguese', code: 'pt' },
    { title: 'Chinese', code: 'zh' }
  ]
});

设置拼写检查器的语言选项

要设置拼写检查器插件的默认语言,请参见:拼写检查器插件 - spellchecker_language。

要自定义用户通过拼写检查器插件可用的拼写检查语言列表,请参见:拼写检查器插件 - spellchecker_languages。

更改内容的默认文本方向

directionality

此选项允许您设置编辑器中方向中立文本(即在Unicode中没有固有方向性的文本)的基本方向。这类似于单独使用content editable元素时使用'dir'属性。

类型:String

默认值:'ltr'

可能的值:'ltr','rtl'

示例:使用directionality

tinymce.init({
  selector: 'textarea',  // change this value according to your HTML
  directionality: 'ltr'
});

允许用户更改内容的文本方向

要允许用户根据需要更改内容的文本方向,请添加方向性插件提供的工具栏按钮。