project/static/js/lib/codemirror/codemirror.js

   1 /* CodeMirror main module
   2  *
   3  * Implements the CodeMirror constructor and prototype, which take care
   4  * of initializing the editor frame, and providing the outside interface.
   5  */
   6
   7 // The CodeMirrorConfig object is used to specify a default
   8 // configuration. If you specify such an object before loading this
   9 // file, the values you put into it will override the defaults given
  10 // below. You can also assign to it after loading.
  11 var CodeMirrorConfig = window.CodeMirrorConfig || {};
  12
  13 var CodeMirror = (function(){
  14   function setDefaults(object, defaults) {
  15     for (var option in defaults) {
  16       if (!object.hasOwnProperty(option))
  17         object[option] = defaults[option];
  18     }
  19   }
  20   function forEach(array, action) {
  21     for (var i = 0; i < array.length; i++)
  22       action(array[i]);
  23   }
  24
  25   // These default options can be overridden by passing a set of
  26   // options to a specific CodeMirror constructor. See manual.html for
  27   // their meaning.
  28   setDefaults(CodeMirrorConfig, {
  29     stylesheet: "",
  30     path: "",
  31     parserfile: [],
  32     basefiles: ["util.js", "stringstream.js", "select.js", "undo.js", "editor.js", "tokenize.js"],
  33     iframeClass: null,
  34     passDelay: 200,
  35     passTime: 50,
  36     continuousScanning: false,
  37     saveFunction: null,
  38     onChange: null,
  39     undoDepth: 50,
  40     undoDelay: 800,
  41     disableSpellcheck: true,
  42     textWrapping: true,
  43     readOnly: false,
  44     width: "100%",
  45     height: "300px",
  46     autoMatchParens: false,
  47     parserConfig: null,
  48     tabMode: "indent", // or "spaces", "default", "shift"
  49     reindentOnLoad: false,
  50     activeTokens: null,
  51     cursorActivity: null,
  52     lineNumbers: false,
  53     indentUnit: 2
  54   });
  55
  56   function wrapLineNumberDiv(place) {
  57     return function(node) {
  58       var container = document.createElement("DIV"),
  59           nums = document.createElement("DIV"),
  60           scroller = document.createElement("DIV");
  61       container.style.position = "relative";
  62       nums.style.position = "absolute";
  63       nums.style.height = "100%";
  64       if (nums.style.setExpression) {
  65         try {nums.style.setExpression("height", "this.previousSibling.offsetHeight + 'px'");}
  66         catch(e) {} // Seems to throw 'Not Implemented' on some IE8 versions
  67       }
  68       nums.style.top = "0px";
  69       nums.style.overflow = "hidden";
  70       place(container);
  71       container.appendChild(node);
  72       container.appendChild(nums);
  73       scroller.className = "CodeMirror-line-numbers";
  74       nums.appendChild(scroller);
  75     }
  76   }
  77
  78   function applyLineNumbers(frame) {
  79     var win = frame.contentWindow, doc = win.document,
  80         nums = frame.nextSibling, scroller = nums.firstChild;
  81
  82     var nextNum = 1, barWidth = null;
  83     function sizeBar() {
  84       for (var root = frame; root.parentNode; root = root.parentNode);
  85       if (root != document || !win.Editor) {
  86         clearInterval(sizeInterval);
  87         return;
  88       }
  89
  90       if (nums.offsetWidth != barWidth) {
  91         barWidth = nums.offsetWidth;
  92         nums.style.left = "-" + (frame.parentNode.style.marginLeft = barWidth + "px");
  93       }
  94     }
  95     function update() {
  96       var diff = 20 + Math.max(doc.body.offsetHeight, frame.offsetHeight) - scroller.offsetHeight;
  97       for (var n = Math.ceil(diff / 10); n > 0; n--) {
  98         var div = document.createElement("DIV");
  99         div.appendChild(document.createTextNode(nextNum++));
 100         scroller.appendChild(div);
 101       }
 102       nums.scrollTop = doc.body.scrollTop || doc.documentElement.scrollTop || 0;
 103     }
 104     sizeBar();
 105     update();
 106     win.addEventHandler(win, "scroll", update);
 107     win.addEventHandler(win, "resize", update);
 108     var sizeInterval = setInterval(sizeBar, 500);
 109   }
 110
 111   function CodeMirror(place, options) {
 112     // Backward compatibility for deprecated options.
 113     if (options.dumbTabs) options.tabMode = "spaces";
 114     else if (options.normalTab) options.tabMode = "default";
 115
 116     // Use passed options, if any, to override defaults.
 117     this.options = options = options || {};
 118     setDefaults(options, CodeMirrorConfig);
 119
 120     var frame = this.frame = document.createElement("IFRAME");
 121     if (options.iframeClass) frame.className = options.iframeClass;
 122     frame.frameBorder = 0;
 123     frame.src = "javascript:false;";
 124     frame.style.border = "0";
 125     frame.style.width = options.width;
 126     frame.style.height = options.height;
 127     // display: block occasionally suppresses some Firefox bugs, so we
 128     // always add it, redundant as it sounds.
 129     frame.style.display = "block";
 130
 131     if (place.appendChild) {
 132       var node = place;
 133       place = function(n){node.appendChild(n);};
 134     }
 135
 136     if (options.lineNumbers) place = wrapLineNumberDiv(place);
 137     place(frame);
 138
 139     // Link back to this object, so that the editor can fetch options
 140     // and add a reference to itself.
 141     frame.CodeMirror = this;
 142     this.win = frame.contentWindow;
 143
 144     if (typeof options.parserfile == "string")
 145       options.parserfile = [options.parserfile];
 146     if (typeof options.stylesheet == "string")
 147       options.stylesheet = [options.stylesheet];
 148
 149     var html = ["<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.0 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\"><html><head>"];
 150     // Hack to work around a bunch of IE8-specific problems.
 151     html.push("<meta http-equiv=\"X-UA-Compatible\" content=\"IE=EmulateIE7\"/>");
 152     forEach(options.stylesheet, function(file) {
 153       html.push("<link rel=\"stylesheet\" type=\"text/css\" href=\"" + file + "\"/>");
 154     });
 155     forEach(options.basefiles.concat(options.parserfile), function(file) {
 156       html.push("<script type=\"text/javascript\" src=\"" + options.path + file + "\"></script>");
 157     });
 158     html.push("</head><body style=\"border-width: 0;\" class=\"editbox\" spellcheck=\"" +
 159               (options.disableSpellcheck ? "false" : "true") + "\"></body></html>");
 160
 161     var doc = this.win.document;
 162     doc.open();
 163     doc.write(html.join(""));
 164     doc.close();
 165   }
 166
 167   CodeMirror.prototype = {
 168     init: function() {
 169       if (this.options.initCallback) this.options.initCallback(this);
 170       if (this.options.lineNumbers) applyLineNumbers(this.frame);
 171       if (this.options.reindentOnLoad) this.reindent();
 172     },
 173
 174     getCode: function() {return this.editor.getCode();},
 175     setCode: function(code) {this.editor.importCode(code);},
 176     selection: function() {this.focusIfIE(); return this.editor.selectedText();},
 177     reindent: function() {this.editor.reindent();},
 178     reindentSelection: function() {this.focusIfIE(); this.editor.reindentSelection(null);},
 179
 180     focusIfIE: function() {
 181       // in IE, a lot of selection-related functionality only works when the frame is focused
 182       if (this.win.select.ie_selection) this.focus();
 183     },
 184     focus: function() {
 185       this.win.focus();
 186       if (this.editor.selectionSnapshot) // IE hack
 187         this.win.select.selectCoords(this.win, this.editor.selectionSnapshot);
 188     },
 189     replaceSelection: function(text) {
 190       this.focus();
 191       this.editor.replaceSelection(text);
 192       return true;
 193     },
 194     replaceChars: function(text, start, end) {
 195       this.editor.replaceChars(text, start, end);
 196     },
 197     getSearchCursor: function(string, fromCursor) {
 198       return this.editor.getSearchCursor(string, fromCursor);
 199     },
 200
 201     undo: function() {this.editor.history.undo();},
 202     redo: function() {this.editor.history.redo();},
 203     historySize: function() {return this.editor.history.historySize();},
 204     clearHistory: function() {this.editor.history.clear();},
 205
 206     grabKeys: function(callback, filter) {this.editor.grabKeys(callback, filter);},
 207     ungrabKeys: function() {this.editor.ungrabKeys();},
 208
 209     setParser: function(name) {this.editor.setParser(name);},
 210
 211     cursorPosition: function(start) {this.focusIfIE(); return this.editor.cursorPosition(start);},
 212     firstLine: function() {return this.editor.firstLine();},
 213     lastLine: function() {return this.editor.lastLine();},
 214     nextLine: function(line) {return this.editor.nextLine(line);},
 215     prevLine: function(line) {return this.editor.prevLine(line);},
 216     lineContent: function(line) {return this.editor.lineContent(line);},
 217     setLineContent: function(line, content) {this.editor.setLineContent(line, content);},
 218     insertIntoLine: function(line, position, content) {this.editor.insertIntoLine(line, position, content);},
 219     selectLines: function(startLine, startOffset, endLine, endOffset) {
 220       this.win.focus();
 221       this.editor.selectLines(startLine, startOffset, endLine, endOffset);
 222     },
 223     nthLine: function(n) {
 224       var line = this.firstLine();
 225       for (; n > 1 && line !== false; n--)
 226         line = this.nextLine(line);
 227       return line;
 228     },
 229     lineNumber: function(line) {
 230       var num = 0;
 231       while (line !== false) {
 232         num++;
 233         line = this.prevLine(line);
 234       }
 235       return num;
 236     },
 237
 238     // Old number-based line interface
 239     jumpToLine: function(n) {
 240       this.selectLines(this.nthLine(n), 0);
 241       this.win.focus();
 242     },
 243     currentLine: function() {
 244       return this.lineNumber(this.cursorPosition().line);
 245     }
 246   };
 247
 248   CodeMirror.InvalidLineHandle = {toString: function(){return "CodeMirror.InvalidLineHandle";}};
 249
 250   CodeMirror.replace = function(element) {
 251     if (typeof element == "string")
 252       element = document.getElementById(element);
 253     return function(newElement) {
 254       element.parentNode.replaceChild(newElement, element);
 255     };
 256   };
 257
 258   CodeMirror.fromTextArea = function(area, options) {
 259     if (typeof area == "string")
 260       area = document.getElementById(area);
 261
 262     options = options || {};
 263     if (area.style.width && options.width == null)
 264       options.width = area.style.width;
 265     if (area.style.height && options.height == null)
 266       options.height = area.style.height;
 267     if (options.content == null) options.content = area.value;
 268
 269     if (area.form) {
 270       function updateField() {
 271         area.value = mirror.getCode();
 272       }
 273       if (typeof area.form.addEventListener == "function")
 274         area.form.addEventListener("submit", updateField, false);
 275       else
 276         area.form.attachEvent("onsubmit", updateField);
 277     }
 278
 279     function insert(frame) {
 280       if (area.nextSibling)
 281         area.parentNode.insertBefore(frame, area.nextSibling);
 282       else
 283         area.parentNode.appendChild(frame);
 284     }
 285
 286     area.style.display = "none";
 287     var mirror = new CodeMirror(insert, options);
 288     return mirror;
 289   };
 290
 291   CodeMirror.isProbablySupported = function() {
 292     // This is rather awful, but can be useful.
 293     var match;
 294     if (window.opera)
 295       return Number(window.opera.version()) >= 9.52;
 296     else if (/Apple Computers, Inc/.test(navigator.vendor) && (match = navigator.userAgent.match(/Version\/(\d+(?:\.\d+)?)\./)))
 297       return Number(match[1]) >= 3;
 298     else if (document.selection && window.ActiveXObject && (match = navigator.userAgent.match(/MSIE (\d+(?:\.\d*)?)\b/)))
 299       return Number(match[1]) >= 6;
 300     else if (match = navigator.userAgent.match(/gecko\/(\d{8})/i))
 301       return Number(match[1]) >= 20050901;
 302     else if (match = navigator.userAgent.match(/AppleWebKit\/(\d+)/))
 303       return Number(match[1]) >= 525;
 304     else
 305       return null;
 306   };
 307
 308   return CodeMirror;
 309 })();