codeMirror配置

介绍

CodeMirror是一款在线的支持语法高亮的代码编辑器。官网：http://codemirror.net/

下载后，解压开到的文件夹中，lib下是放的是核心库和核心css，模式下放的是各种支持语言的语法定义，主题目录下是支持的主题样式。一般在开发中，添加lib下的引用和模式下的引用就够了。

使用示例

首先，要引用是lib目录下的codemirror.js，还有一个就是同目录下的codemirror.css文件

<script src="lib/codemirror.js"></script>
<link rel="stylesheet" href="/lib/codemirror.css">

接下来要引用的就是在mode目录下编辑器中要编辑的语言对应的js文件，下面以js文件为例：

<script src="mode/javascript/javascript.js"></script>

引用的文件用于支持对应语言的语法高亮。

然后，调用脚本以创建编辑器：

var myCodeMirror = CodeMirror(document.body);

这里的调用会在body中添加编辑器，这里因为直接在上面引用了javascript.js，所以这个编辑器会对javascript的关键字高亮显示。

想要高级一点，给编辑器添加一些元素，也可以通过传入配置参数来实现。

var myCodeMirror = CodeMirror(document.body,{lineNumbers:true});

这样，就给编辑器添加了行号。

上面说的是实现编辑器的最简单的方式，然后在实际项目中，一般都不会直接把body作为编辑器的容器。而最常用的，是使用textarea。

要把 textarea 实现成一个支持高亮的编辑器，CodeMirror 提供了非常简单的方法：

<textarea id="editor" name="editor"></textarea>

var myTextarea = document.getElementById('editor');var CodeMirrorEditor = CodeMirror.fromTextArea(myTextarea, {mode:"text/javascript",lineNumbers:true});

简单例子:

vartextarea = document.getElementById('code');
vareditor = newMirrorFrame(CodeMirror.replace(textarea), {height: "350px",//设置初始化高度content: textarea.value,//设置需要初始化的代码内容parserfile: ["tokenizejavascript.js", "parsejavascript.js"],stylesheet: "css/jscolors.css",path: "js/",autoMatchParens: true
});

例子2:

var textarea = document.getElementById('code'); 
var editor = new MirrorFrame(CodeMirror.replace(textarea), { height: "350px", content: textarea.value, parserfile: ["tokenizejavascript.js", "parsejavascript.js"], stylesheet: "css/jscolors.css", path: "js/", autoMatchParens: true 
});

配置说明

在使用CodeMirror的时候，不管是直接使用 CodeMirror() 还是使用 fromTextArea() ，都可以通过传递第二个参数来配置编辑器。
使用方法如下：

var myCodeMirror = CodeMirror(el, {//options...});

或者:

var myCodeMirror = CodeMirror.fromTextArea(el, {//options...});

options 可以使用的参数

CodeMirror函数和它的fromTextArea方法都可以使用一个配置对象作为第二个参数。

value: string | CodeMirror.Doc

编辑器的初始值（文本），可以是字符串或者CodeMirror文档对象(不同于HTML文档对象)。

mode: string | object

通用的或者在CodeMirror中使用的与mode相关联的mime，当不设置这个值的时候，会默认使用第一个载入的mode定义文件。一般地，会使用关联的mime类型来设置这个值；除此之外，也可以使用一个带有name属性的对象来作为值（如：{name: “JavaScript”, json: true}）。可以通过访问CodeMirror.modes和CodeMirror.mimeModes获取定义的mode和MIME。

lineSeparator: string|null

明确指定编辑器使用的行分割符（换行符）。默认（值为null）情况下，文档会被 CRLF(以及单独的CR, LF)分割，单独的LF会在所有的输出中用作换行符（如：getValue）。当指定了换行字符串，行就只会被指定的串分割。

theme: string

配置编辑器的主题样式。要使用主题，必须保证名称为 .cm-s-[name] (name是设置的theme的值)的样式是加载上了的。当然，你也可以一次加载多个主题样式，使用方法和html和使用类一样，如： theme: foo bar，那么此时需要cm-s-foo cm-s-bar这两个样式都已经被加载上了。

indentUnit: integer

缩进单位，值为空格数，默认为2 。

smartIndent: boolean

自动缩进，设置是否根据上下文自动缩进（和上一行相同的缩进量）。默认为true。

abSize: integer

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

indentWithTabs: boolean

在缩进时，是否需要把 n*tab宽度个空格替换成n个tab字符，默认为false 。

electricChars: boolean

在输入可能改变当前的缩进时，是否重新缩进，默认为true （仅在mode支持缩进时有效）。

specialChars: RegExp

需要被占位符(placeholder)替换的特殊字符的正则表达式。最常用的是非打印字符。默认为：/[\u0000-\u0019\u00ad\u200b-\u200f\u2028\u2029\ufeff]/。

specialCharPlaceholder: function(char) → Element

这是一个接收由specialChars选项指定的字符作为参数的函数，此函数会产生一个用来显示指定字符的DOM节点。默认情况下，显示一个红点（•），这个红点有一个带有前面特殊字符编码的提示框。

keyMap: string

配置快捷键。默认值为default，即 codemorrir.js 内部定义。其它在key map目录下。

extraKeys: object

给编辑器绑定与前面keyMap配置不同的快捷键。

lineWrapping: boolean

在长行时文字是换行(wrap)还是滚动(scroll)，默认为滚动(scroll)。

lineNumbers: boolean

是否在编辑器左侧显示行号。

firstLineNumber: integer

行号从哪个数开始计数，默认为1 。

lineNumberFormatter: function(line: integer) → string

使用一个函数设置行号。

gutters: array

用来添加额外的gutter（在行号gutter前或代替行号gutter）。值应该是CSS名称数组，每一项定义了用于绘制gutter背景的宽度（还有可选的背景）。为了能明确设置行号gutter的位置（默认在所有其它gutter的右边），也可以包含CodeMirror-linenumbers类。类名是用于传给setGutterMarker的键名(keys)。