配置

无论是CodeMirror函数还是它的fromTextArea方法都接纳一个配置对象作为可选的第二参数。所有配置选项的默认值都来自CodeMirror.defaults中,因此你也可以直接修改这个对象。

需要注意的是,配置对象中的选项值是不会被检查合法性的,所以如果设置了非法的值可能会导致奇怪的错误。

以下是支持的选项:

value: string|CodeMirror.Doc

编辑器的起始内容。即可以是string,也可以是一个document object。

mode: string|object

编辑器所使用的mode。如果没有给出这个字段,则默认使用第一个加载的mode。

lineSeparator: string|null

换行符

theme: string

indentUnit: integer

缩进的单位格数,默认是2。

smartIndent: boolean

是否使用mode提供的缩进规则(还是说总是如上一行一样缩进)。默认为true。

tabSize: integer

tab字符的宽度。默认为4。

indentWithTabs: boolean 在缩进时,缩进的空间是使用空格还是使用tab字符。默认为false。

electricChars: boolean

配置编辑器是否要在键入一个新字符时判断是否需要重新缩进本行(前提是mode支持)。默认为true。

specialChars: RegEx

正则表达式,用于描述哪些特殊字符应该被替换为special placeholder。通常用于无法打印的特殊字符。默认为/[\u0000-\u001f\u007f\u00ad\u200b-\u200f\u2028\u2029\ufeff]/。

specialCharPlaceholder: function(char) → Element

当传入一个与specialChars匹配的字符时,返回一个用于替换的DOM节点。默认为一个红色的点(·),并且带有title tooltip来标明其字符代码。

rtlMoveVisually: boolean

决定光标在从右往左读的文字中的移动逻辑。

keymap: string

键位对应表。默认是”default”,定义在codemirror.js中。

extrakeymap: object

配合keycap使用,表示一些额外的快捷键。

lineWrapping: boolean

决定CodeMirror是否自动换行。默认为false,即滚动而不是换行。

firstLineNumber: integer

行数从多少开始算起。默认为1。

lineNumberFormatter: function(line: integer) → string

一个函数,当传入行数(第几行)时,返回一个字符串显示在gutter。

gutters: array

???

fixedGutter: boolean

决定gutter是否会随着水平滚动条一起滚动(false),抑或是固定不懂(true, the default)。

scrollbarStyle: string

选择滚动条的样式。默认样式叫”native”——显示原生的滚动条。核心库中还提供了”null”样式,即完全隐藏滚动条。可通过插件(Addons)实现不同的样式。

coverGutterNextToScrollbar: boolean

fixedGutter为true,且有水平滚动条时,gutter默认会出现在滚动条的左边。如果把这个选项设为true,gutter就会被一个class name为CodeMirror-gutter-filler的元素覆盖。

inputStyle: string ???

readOnly: boolean|string

禁用编辑器。如果设为特殊值”nocursor”,则连焦点都无法获取。

showCursorWhenSelecting: boolean

当有文本被选中时是否还显示光标。默认为false。

lineWiseCopyCut: boolean

当打开时(默认打开),如果用户没有选中文字就做复制/剪切操作,则会复制/剪切光标当前所在的这一行。

undoDepth: integer

编辑器储存的撤销操作次数。需要注意的是这包含了selection change events。默认为200.

historyEventDelay integer

当连续打字或删除时,停止多少毫秒才产生一个新的历史记录(用于撤销)。默认为1250。

tabindex: integer

赋予编辑器的tab index。若没有提供该值,CodeMirror不会赋值。

autofocus: boolean

results matching ""

    No results matching ""