1 // CodeMirror, copyright (c) by Marijn Haverbeke and others
2 // Distributed under an MIT license: http://codemirror.net/LICENSE
4 // This is CodeMirror (http://codemirror.net), a code editor
5 // implemented in JavaScript on top of the browser's DOM.
7 // You can find some technical background for some of the code below
8 // at http://marijnhaverbeke.nl/blog/#cm-internals .
11 if (typeof exports
== "object" && typeof module
== "object") // CommonJS
12 module
.exports
= mod();
13 else if (typeof define
== "function" && define
.amd
) // AMD
14 return define([], mod
);
15 else // Plain browser env
16 this.CodeMirror
= mod();
22 // Kludges for bugs and behavior differences that can't be feature
23 // detected are enabled based on userAgent etc sniffing.
25 var gecko
= /gecko\/\d/i.test(navigator
.userAgent
);
26 // ie_uptoN means Internet Explorer version N or lower
27 var ie_upto10
= /MSIE \d/.test(navigator
.userAgent
);
28 var ie_11up
= /Trident\/(?:[7-9]|\d{2,})\..*rv:(\d+)/.exec(navigator
.userAgent
);
29 var ie
= ie_upto10
|| ie_11up
;
30 var ie_version
= ie
&& (ie_upto10
? document
.documentMode
|| 6 : ie_11up
[1]);
31 var webkit
= /WebKit\//.test(navigator
.userAgent
);
32 var qtwebkit
= webkit
&& /Qt\/\d+\.\d+/.test(navigator
.userAgent
);
33 var chrome
= /Chrome\//.test(navigator
.userAgent
);
34 var presto
= /Opera\//.test(navigator
.userAgent
);
35 var safari
= /Apple Computer/.test(navigator
.vendor
);
36 var khtml
= /KHTML\//.test(navigator
.userAgent
);
37 var mac_geMountainLion
= /Mac OS X 1\d\D([8-9]|\d\d)\D/.test(navigator
.userAgent
);
38 var phantom
= /PhantomJS/.test(navigator
.userAgent
);
40 var ios
= /AppleWebKit/.test(navigator
.userAgent
) && /Mobile\/\w+/.test(navigator
.userAgent
);
41 // This is woefully incomplete. Suggestions for alternative methods welcome.
42 var mobile
= ios
|| /Android|webOS|BlackBerry|Opera Mini|Opera Mobi|IEMobile/i.test(navigator
.userAgent
);
43 var mac
= ios
|| /Mac/.test(navigator
.platform
);
44 var windows
= /win/i.test(navigator
.platform
);
46 var presto_version
= presto
&& navigator
.userAgent
.match(/Version\/(\d*\.\d*)/);
47 if (presto_version
) presto_version
= Number(presto_version
[1]);
48 if (presto_version
&& presto_version
>= 15) { presto
= false; webkit
= true; }
49 // Some browsers use the wrong event properties to signal cmd/ctrl on OS X
50 var flipCtrlCmd
= mac
&& (qtwebkit
|| presto
&& (presto_version
== null || presto_version
< 12.11));
51 var captureRightClick
= gecko
|| (ie
&& ie_version
>= 9);
53 // Optimize some code when these features are not used.
54 var sawReadOnlySpans
= false, sawCollapsedSpans
= false;
58 // A CodeMirror instance represents an editor. This is the object
59 // that user code is usually dealing with.
61 function CodeMirror(place
, options
) {
62 if (!(this instanceof CodeMirror
)) return new CodeMirror(place
, options
);
64 this.options
= options
= options
? copyObj(options
) : {};
65 // Determine effective options based on given values and defaults.
66 copyObj(defaults
, options
, false);
67 setGuttersForLineNumbers(options
);
69 var doc
= options
.value
;
70 if (typeof doc
== "string") doc
= new Doc(doc
, options
.mode
);
73 var display
= this.display
= new Display(place
, doc
);
74 display
.wrapper
.CodeMirror
= this;
77 if (options
.lineWrapping
)
78 this.display
.wrapper
.className
+= " CodeMirror-wrap";
79 if (options
.autofocus
&& !mobile
) focusInput(this);
82 keyMaps
: [], // stores maps added by addKeyMap
83 overlays
: [], // highlighting overlays, as added by addOverlay
84 modeGen
: 0, // bumped when mode/overlay changes, used to invalidate highlighting info
85 overwrite
: false, focused
: false,
86 suppressEdits
: false, // used to disable editing during key handlers when in readOnly mode
87 pasteIncoming
: false, cutIncoming
: false, // help recognize paste/cut edits in readInput
89 highlight
: new Delayed(), // stores highlight worker timeout
90 keySeq
: null // Unfinished key sequence
93 // Override magic textarea content restore that IE sometimes does
94 // on our hidden textarea on reload
95 if (ie
&& ie_version
< 11) setTimeout(bind(resetInput
, this, true), 20);
97 registerEventHandlers(this);
98 ensureGlobalHandlers();
100 startOperation(this);
101 this.curOp
.forceUpdate
= true;
102 attachDoc(this, doc
);
104 if ((options
.autofocus
&& !mobile
) || activeElt() == display
.input
)
105 setTimeout(bind(onFocus
, this), 20);
109 for (var opt
in optionHandlers
) if (optionHandlers
.hasOwnProperty(opt
))
110 optionHandlers
[opt
](this, options
[opt
], Init
);
111 maybeUpdateLineNumberWidth(this);
112 for (var i
= 0; i
< initHooks
.length
; ++i
) initHooks
[i
](this);
116 // DISPLAY CONSTRUCTOR
118 // The display handles the DOM integration, both for input reading
119 // and content drawing. It holds references to DOM nodes and
120 // display-related state.
122 function Display(place
, doc
) {
125 // The semihidden textarea that is focused when the editor is
126 // focused, and receives input.
127 var input
= d
.input
= elt("textarea", null, null, "position: absolute; padding: 0; width: 1px; height: 1em; outline: none");
128 // The textarea is kept positioned near the cursor to prevent the
129 // fact that it'll be scrolled into view on input from scrolling
130 // our fake cursor out of view. On webkit, when wrap=off, paste is
131 // very slow. So make the area wide instead.
132 if (webkit
) input
.style
.width
= "1000px";
133 else input
.setAttribute("wrap", "off");
134 // If border: 0; -- iOS fails to open keyboard (issue #1287)
135 if (ios
) input
.style
.border
= "1px solid black";
136 input
.setAttribute("autocorrect", "off"); input
.setAttribute("autocapitalize", "off"); input
.setAttribute("spellcheck", "false");
138 // Wraps and hides input textarea
139 d
.inputDiv
= elt("div", [input
], null, "overflow: hidden; position: relative; width: 3px; height: 0px;");
140 // The fake scrollbar elements.
141 d
.scrollbarH
= elt("div", [elt("div", null, null, "height: 100%; min-height: 1px")], "CodeMirror-hscrollbar");
142 d
.scrollbarV
= elt("div", [elt("div", null, null, "min-width: 1px")], "CodeMirror-vscrollbar");
143 // Covers bottom-right square when both scrollbars are present.
144 d
.scrollbarFiller
= elt("div", null, "CodeMirror-scrollbar-filler");
145 // Covers bottom of gutter when coverGutterNextToScrollbar is on
146 // and h scrollbar is present.
147 d
.gutterFiller
= elt("div", null, "CodeMirror-gutter-filler");
148 // Will contain the actual code, positioned to cover the viewport.
149 d
.lineDiv
= elt("div", null, "CodeMirror-code");
150 // Elements are added to these to represent selection and cursors.
151 d
.selectionDiv
= elt("div", null, null, "position: relative; z-index: 1");
152 d
.cursorDiv
= elt("div", null, "CodeMirror-cursors");
153 // A visibility: hidden element used to find the size of things.
154 d
.measure
= elt("div", null, "CodeMirror-measure");
155 // When lines outside of the viewport are measured, they are drawn in this.
156 d
.lineMeasure
= elt("div", null, "CodeMirror-measure");
157 // Wraps everything that needs to exist inside the vertically-padded coordinate system
158 d
.lineSpace
= elt("div", [d
.measure
, d
.lineMeasure
, d
.selectionDiv
, d
.cursorDiv
, d
.lineDiv
],
159 null, "position: relative; outline: none");
160 // Moved around its parent to cover visible view.
161 d
.mover
= elt("div", [elt("div", [d
.lineSpace
], "CodeMirror-lines")], null, "position: relative");
162 // Set to the height of the document, allowing scrolling.
163 d
.sizer
= elt("div", [d
.mover
], "CodeMirror-sizer");
164 // Behavior of elts with overflow: auto and padding is
165 // inconsistent across browsers. This is used to ensure the
166 // scrollable area is big enough.
167 d
.heightForcer
= elt("div", null, null, "position: absolute; height: " + scrollerCutOff
+ "px; width: 1px;");
168 // Will contain the gutters, if any.
169 d
.gutters
= elt("div", null, "CodeMirror-gutters");
171 // Actual scrollable element.
172 d
.scroller
= elt("div", [d
.sizer
, d
.heightForcer
, d
.gutters
], "CodeMirror-scroll");
173 d
.scroller
.setAttribute("tabIndex", "-1");
174 // The element in which the editor lives.
175 d
.wrapper
= elt("div", [d
.inputDiv
, d
.scrollbarH
, d
.scrollbarV
,
176 d
.scrollbarFiller
, d
.gutterFiller
, d
.scroller
], "CodeMirror");
178 // Work around IE7 z-index bug (not perfect, hence IE7 not really being supported)
179 if (ie
&& ie_version
< 8) { d
.gutters
.style
.zIndex
= -1; d
.scroller
.style
.paddingRight
= 0; }
180 // Needed to hide big blue blinking cursor on Mobile Safari
181 if (ios
) input
.style
.width
= "0px";
182 if (!webkit
) d
.scroller
.draggable
= true;
183 // Needed to handle Tab key in KHTML
184 if (khtml
) { d
.inputDiv
.style
.height
= "1px"; d
.inputDiv
.style
.position
= "absolute"; }
185 // Need to set a minimum width to see the scrollbar on IE7 (but must not set it on IE8).
186 if (ie
&& ie_version
< 8) d
.scrollbarH
.style
.minHeight
= d
.scrollbarV
.style
.minWidth
= "18px";
189 if (place
.appendChild
) place
.appendChild(d
.wrapper
);
190 else place(d
.wrapper
);
193 // Current rendered range (may be bigger than the view window).
194 d
.viewFrom
= d
.viewTo
= doc
.first
;
195 // Information about the rendered lines.
197 // Holds info about a single rendered line when it was rendered
198 // for measurement, while not in view.
199 d
.externalMeasured
= null;
200 // Empty space (in pixels) above the view
202 d
.lastWrapHeight
= d
.lastWrapWidth
= 0;
203 d
.updateLineNumbers
= null;
205 // Used to only resize the line number gutter when necessary (when
206 // the amount of lines crosses a boundary that makes its width change)
207 d
.lineNumWidth
= d
.lineNumInnerWidth
= d
.lineNumChars
= null;
208 // See readInput and resetInput
210 // Set to true when a non-horizontal-scrolling line widget is
211 // added. As an optimization, line widget aligning is skipped when
213 d
.alignWidgets
= false;
214 // Flag that indicates whether we expect input to appear real soon
215 // now (after some event like 'keypress' or 'input') and are
216 // polling intensively.
217 d
.pollingFast
= false;
218 // Self-resetting timeout for the poller
219 d
.poll
= new Delayed();
221 d
.cachedCharWidth
= d
.cachedTextHeight
= d
.cachedPaddingH
= null;
223 // Tracks when resetInput has punted to just putting a short
224 // string into the textarea instead of the full selection.
225 d
.inaccurateSelection
= false;
227 // Tracks the maximum line length so that the horizontal scrollbar
228 // can be kept static when scrolling.
231 d
.maxLineChanged
= false;
233 // Used for measuring wheel scrolling granularity
234 d
.wheelDX
= d
.wheelDY
= d
.wheelStartX
= d
.wheelStartY
= null;
236 // True when shift is held down.
239 // Used to track whether anything happened since the context menu
241 d
.selForContextMenu
= null;
246 // Used to get the editor into a consistent state again when options change.
248 function loadMode(cm
) {
249 cm
.doc
.mode
= CodeMirror
.getMode(cm
.options
, cm
.doc
.modeOption
);
253 function resetModeState(cm
) {
254 cm
.doc
.iter(function(line
) {
255 if (line
.stateAfter
) line
.stateAfter
= null;
256 if (line
.styles
) line
.styles
= null;
258 cm
.doc
.frontier
= cm
.doc
.first
;
259 startWorker(cm
, 100);
261 if (cm
.curOp
) regChange(cm
);
264 function wrappingChanged(cm
) {
265 if (cm
.options
.lineWrapping
) {
266 addClass(cm
.display
.wrapper
, "CodeMirror-wrap");
267 cm
.display
.sizer
.style
.minWidth
= "";
269 rmClass(cm
.display
.wrapper
, "CodeMirror-wrap");
272 estimateLineHeights(cm
);
275 setTimeout(function(){updateScrollbars(cm
);}, 100);
278 // Returns a function that estimates the height of a line, to use as
279 // first approximation until the line becomes visible (and is thus
280 // properly measurable).
281 function estimateHeight(cm
) {
282 var th
= textHeight(cm
.display
), wrapping
= cm
.options
.lineWrapping
;
283 var perLine
= wrapping
&& Math
.max(5, cm
.display
.scroller
.clientWidth
/ charWidth(cm
.display
) - 3);
284 return function(line
) {
285 if (lineIsHidden(cm
.doc
, line
)) return 0;
287 var widgetsHeight
= 0;
288 if (line
.widgets
) for (var i
= 0; i
< line
.widgets
.length
; i
++) {
289 if (line
.widgets
[i
].height
) widgetsHeight
+= line
.widgets
[i
].height
;
293 return widgetsHeight
+ (Math
.ceil(line
.text
.length
/ perLine
) || 1) * th
;
295 return widgetsHeight
+ th
;
299 function estimateLineHeights(cm
) {
300 var doc
= cm
.doc
, est
= estimateHeight(cm
);
301 doc
.iter(function(line
) {
302 var estHeight
= est(line
);
303 if (estHeight
!= line
.height
) updateLineHeight(line
, estHeight
);
307 function themeChanged(cm
) {
308 cm
.display
.wrapper
.className
= cm
.display
.wrapper
.className
.replace(/\s*cm-s-\S+/g, "") +
309 cm
.options
.theme
.replace(/(^|\s)\s*/g, " cm-s-");
313 function guttersChanged(cm
) {
316 setTimeout(function(){alignHorizontally(cm
);}, 20);
319 // Rebuild the gutter elements, ensure the margin to the left of the
320 // code matches their width.
321 function updateGutters(cm
) {
322 var gutters
= cm
.display
.gutters
, specs
= cm
.options
.gutters
;
323 removeChildren(gutters
);
324 for (var i
= 0; i
< specs
.length
; ++i
) {
325 var gutterClass
= specs
[i
];
326 var gElt
= gutters
.appendChild(elt("div", null, "CodeMirror-gutter " + gutterClass
));
327 if (gutterClass
== "CodeMirror-linenumbers") {
328 cm
.display
.lineGutter
= gElt
;
329 gElt
.style
.width
= (cm
.display
.lineNumWidth
|| 1) + "px";
332 gutters
.style
.display
= i
? "" : "none";
333 updateGutterSpace(cm
);
336 function updateGutterSpace(cm
) {
337 var width
= cm
.display
.gutters
.offsetWidth
;
338 cm
.display
.sizer
.style
.marginLeft
= width
+ "px";
339 cm
.display
.scrollbarH
.style
.left
= cm
.options
.fixedGutter
? width
+ "px" : 0;
342 // Compute the character length of a line, taking into account
343 // collapsed ranges (see markText) that might hide parts, and join
344 // other lines onto it.
345 function lineLength(line
) {
346 if (line
.height
== 0) return 0;
347 var len
= line
.text
.length
, merged
, cur
= line
;
348 while (merged
= collapsedSpanAtStart(cur
)) {
349 var found
= merged
.find(0, true);
350 cur
= found
.from.line
;
351 len
+= found
.from.ch
- found
.to
.ch
;
354 while (merged
= collapsedSpanAtEnd(cur
)) {
355 var found
= merged
.find(0, true);
356 len
-= cur
.text
.length
- found
.from.ch
;
358 len
+= cur
.text
.length
- found
.to
.ch
;
363 // Find the longest line in the document.
364 function findMaxLine(cm
) {
365 var d
= cm
.display
, doc
= cm
.doc
;
366 d
.maxLine
= getLine(doc
, doc
.first
);
367 d
.maxLineLength
= lineLength(d
.maxLine
);
368 d
.maxLineChanged
= true;
369 doc
.iter(function(line
) {
370 var len
= lineLength(line
);
371 if (len
> d
.maxLineLength
) {
372 d
.maxLineLength
= len
;
378 // Make sure the gutters options contains the element
379 // "CodeMirror-linenumbers" when the lineNumbers option is true.
380 function setGuttersForLineNumbers(options
) {
381 var found
= indexOf(options
.gutters
, "CodeMirror-linenumbers");
382 if (found
== -1 && options
.lineNumbers
) {
383 options
.gutters
= options
.gutters
.concat(["CodeMirror-linenumbers"]);
384 } else if (found
> -1 && !options
.lineNumbers
) {
385 options
.gutters
= options
.gutters
.slice(0);
386 options
.gutters
.splice(found
, 1);
392 function hScrollbarTakesSpace(cm
) {
393 return cm
.display
.scroller
.clientHeight
- cm
.display
.wrapper
.clientHeight
< scrollerCutOff
- 3;
396 // Prepare DOM reads needed to update the scrollbars. Done in one
397 // shot to minimize update/measure roundtrips.
398 function measureForScrollbars(cm
) {
399 var scroll
= cm
.display
.scroller
;
401 clientHeight
: scroll
.clientHeight
,
402 barHeight
: cm
.display
.scrollbarV
.clientHeight
,
403 scrollWidth
: scroll
.scrollWidth
, clientWidth
: scroll
.clientWidth
,
404 hScrollbarTakesSpace
: hScrollbarTakesSpace(cm
),
405 barWidth
: cm
.display
.scrollbarH
.clientWidth
,
406 docHeight
: Math
.round(cm
.doc
.height
+ paddingVert(cm
.display
))
410 // Re-synchronize the fake scrollbars with the actual size of the
412 function updateScrollbars(cm
, measure
) {
413 if (!measure
) measure
= measureForScrollbars(cm
);
414 var d
= cm
.display
, sWidth
= scrollbarWidth(d
.measure
);
415 var scrollHeight
= measure
.docHeight
+ scrollerCutOff
;
416 var needsH
= measure
.scrollWidth
> measure
.clientWidth
;
417 if (needsH
&& measure
.scrollWidth
<= measure
.clientWidth
+ 1 &&
418 sWidth
> 0 && !measure
.hScrollbarTakesSpace
)
419 needsH
= false; // (Issue #2562)
420 var needsV
= scrollHeight
> measure
.clientHeight
;
423 d
.scrollbarV
.style
.display
= "block";
424 d
.scrollbarV
.style
.bottom
= needsH
? sWidth
+ "px" : "0";
425 // A bug in IE8 can cause this value to be negative, so guard it.
426 d
.scrollbarV
.firstChild
.style
.height
=
427 Math
.max(0, scrollHeight
- measure
.clientHeight
+ (measure
.barHeight
|| d
.scrollbarV
.clientHeight
)) + "px";
429 d
.scrollbarV
.style
.display
= "";
430 d
.scrollbarV
.firstChild
.style
.height
= "0";
433 d
.scrollbarH
.style
.display
= "block";
434 d
.scrollbarH
.style
.right
= needsV
? sWidth
+ "px" : "0";
435 d
.scrollbarH
.firstChild
.style
.width
=
436 (measure
.scrollWidth
- measure
.clientWidth
+ (measure
.barWidth
|| d
.scrollbarH
.clientWidth
)) + "px";
438 d
.scrollbarH
.style
.display
= "";
439 d
.scrollbarH
.firstChild
.style
.width
= "0";
441 if (needsH
&& needsV
) {
442 d
.scrollbarFiller
.style
.display
= "block";
443 d
.scrollbarFiller
.style
.height
= d
.scrollbarFiller
.style
.width
= sWidth
+ "px";
444 } else d
.scrollbarFiller
.style
.display
= "";
445 if (needsH
&& cm
.options
.coverGutterNextToScrollbar
&& cm
.options
.fixedGutter
) {
446 d
.gutterFiller
.style
.display
= "block";
447 d
.gutterFiller
.style
.height
= sWidth
+ "px";
448 d
.gutterFiller
.style
.width
= d
.gutters
.offsetWidth
+ "px";
449 } else d
.gutterFiller
.style
.display
= "";
451 if (!cm
.state
.checkedOverlayScrollbar
&& measure
.clientHeight
> 0) {
453 var w
= mac
&& !mac_geMountainLion
? "12px" : "18px";
454 d
.scrollbarV
.style
.minWidth
= d
.scrollbarH
.style
.minHeight
= w
;
455 var barMouseDown = function(e
) {
456 if (e_target(e
) != d
.scrollbarV
&& e_target(e
) != d
.scrollbarH
)
457 operation(cm
, onMouseDown
)(e
);
459 on(d
.scrollbarV
, "mousedown", barMouseDown
);
460 on(d
.scrollbarH
, "mousedown", barMouseDown
);
462 cm
.state
.checkedOverlayScrollbar
= true;
466 // Compute the lines that are visible in a given viewport (defaults
467 // the the current scroll position). viewport may contain top,
468 // height, and ensure (see op.scrollToPos) properties.
469 function visibleLines(display
, doc
, viewport
) {
470 var top
= viewport
&& viewport
.top
!= null ? Math
.max(0, viewport
.top
) : display
.scroller
.scrollTop
;
471 top
= Math
.floor(top
- paddingTop(display
));
472 var bottom
= viewport
&& viewport
.bottom
!= null ? viewport
.bottom
: top
+ display
.wrapper
.clientHeight
;
474 var from = lineAtHeight(doc
, top
), to
= lineAtHeight(doc
, bottom
);
475 // Ensure is a {from: {line, ch}, to: {line, ch}} object, and
476 // forces those lines into the viewport (if possible).
477 if (viewport
&& viewport
.ensure
) {
478 var ensureFrom
= viewport
.ensure
.from.line
, ensureTo
= viewport
.ensure
.to
.line
;
479 if (ensureFrom
< from)
480 return {from: ensureFrom
,
481 to
: lineAtHeight(doc
, heightAtLine(getLine(doc
, ensureFrom
)) + display
.wrapper
.clientHeight
)};
482 if (Math
.min(ensureTo
, doc
.lastLine()) >= to
)
483 return {from: lineAtHeight(doc
, heightAtLine(getLine(doc
, ensureTo
)) - display
.wrapper
.clientHeight
),
486 return {from: from, to
: Math
.max(to
, from + 1)};
491 // Re-align line numbers and gutter marks to compensate for
492 // horizontal scrolling.
493 function alignHorizontally(cm
) {
494 var display
= cm
.display
, view
= display
.view
;
495 if (!display
.alignWidgets
&& (!display
.gutters
.firstChild
|| !cm
.options
.fixedGutter
)) return;
496 var comp
= compensateForHScroll(display
) - display
.scroller
.scrollLeft
+ cm
.doc
.scrollLeft
;
497 var gutterW
= display
.gutters
.offsetWidth
, left
= comp
+ "px";
498 for (var i
= 0; i
< view
.length
; i
++) if (!view
[i
].hidden
) {
499 if (cm
.options
.fixedGutter
&& view
[i
].gutter
)
500 view
[i
].gutter
.style
.left
= left
;
501 var align
= view
[i
].alignable
;
502 if (align
) for (var j
= 0; j
< align
.length
; j
++)
503 align
[j
].style
.left
= left
;
505 if (cm
.options
.fixedGutter
)
506 display
.gutters
.style
.left
= (comp
+ gutterW
) + "px";
509 // Used to ensure that the line number gutter is still the right
510 // size for the current document size. Returns true when an update
512 function maybeUpdateLineNumberWidth(cm
) {
513 if (!cm
.options
.lineNumbers
) return false;
514 var doc
= cm
.doc
, last
= lineNumberFor(cm
.options
, doc
.first
+ doc
.size
- 1), display
= cm
.display
;
515 if (last
.length
!= display
.lineNumChars
) {
516 var test
= display
.measure
.appendChild(elt("div", [elt("div", last
)],
517 "CodeMirror-linenumber CodeMirror-gutter-elt"));
518 var innerW
= test
.firstChild
.offsetWidth
, padding
= test
.offsetWidth
- innerW
;
519 display
.lineGutter
.style
.width
= "";
520 display
.lineNumInnerWidth
= Math
.max(innerW
, display
.lineGutter
.offsetWidth
- padding
);
521 display
.lineNumWidth
= display
.lineNumInnerWidth
+ padding
;
522 display
.lineNumChars
= display
.lineNumInnerWidth
? last
.length
: -1;
523 display
.lineGutter
.style
.width
= display
.lineNumWidth
+ "px";
524 updateGutterSpace(cm
);
530 function lineNumberFor(options
, i
) {
531 return String(options
.lineNumberFormatter(i
+ options
.firstLineNumber
));
534 // Computes display.scroller.scrollLeft + display.gutters.offsetWidth,
535 // but using getBoundingClientRect to get a sub-pixel-accurate
537 function compensateForHScroll(display
) {
538 return display
.scroller
.getBoundingClientRect().left
- display
.sizer
.getBoundingClientRect().left
;
543 function DisplayUpdate(cm
, viewport
, force
) {
544 var display
= cm
.display
;
546 this.viewport
= viewport
;
547 // Store some values that we'll need later (but don't want to force a relayout for)
548 this.visible
= visibleLines(display
, cm
.doc
, viewport
);
549 this.editorIsHidden
= !display
.wrapper
.offsetWidth
;
550 this.wrapperHeight
= display
.wrapper
.clientHeight
;
551 this.wrapperWidth
= display
.wrapper
.clientWidth
;
552 this.oldViewFrom
= display
.viewFrom
; this.oldViewTo
= display
.viewTo
;
553 this.oldScrollerWidth
= display
.scroller
.clientWidth
;
555 this.dims
= getDimensions(cm
);
558 // Does the actual updating of the line display. Bails out
559 // (returning false) when there is nothing to be done and forced is
561 function updateDisplayIfNeeded(cm
, update
) {
562 var display
= cm
.display
, doc
= cm
.doc
;
563 if (update
.editorIsHidden
) {
568 // Bail out if the visible area is already rendered and nothing changed.
570 update
.visible
.from >= display
.viewFrom
&& update
.visible
.to
<= display
.viewTo
&&
571 (display
.updateLineNumbers
== null || display
.updateLineNumbers
>= display
.viewTo
) &&
572 countDirtyView(cm
) == 0)
575 if (maybeUpdateLineNumberWidth(cm
)) {
577 update
.dims
= getDimensions(cm
);
580 // Compute a suitable new viewport (from & to)
581 var end
= doc
.first
+ doc
.size
;
582 var from = Math
.max(update
.visible
.from - cm
.options
.viewportMargin
, doc
.first
);
583 var to
= Math
.min(end
, update
.visible
.to
+ cm
.options
.viewportMargin
);
584 if (display
.viewFrom
< from && from - display
.viewFrom
< 20) from = Math
.max(doc
.first
, display
.viewFrom
);
585 if (display
.viewTo
> to
&& display
.viewTo
- to
< 20) to
= Math
.min(end
, display
.viewTo
);
586 if (sawCollapsedSpans
) {
587 from = visualLineNo(cm
.doc
, from);
588 to
= visualLineEndNo(cm
.doc
, to
);
591 var different
= from != display
.viewFrom
|| to
!= display
.viewTo
||
592 display
.lastWrapHeight
!= update
.wrapperHeight
|| display
.lastWrapWidth
!= update
.wrapperWidth
;
593 adjustView(cm
, from, to
);
595 display
.viewOffset
= heightAtLine(getLine(cm
.doc
, display
.viewFrom
));
596 // Position the mover div to align with the current scroll position
597 cm
.display
.mover
.style
.top
= display
.viewOffset
+ "px";
599 var toUpdate
= countDirtyView(cm
);
600 if (!different
&& toUpdate
== 0 && !update
.force
&&
601 (display
.updateLineNumbers
== null || display
.updateLineNumbers
>= display
.viewTo
))
604 // For big changes, we hide the enclosing element during the
605 // update, since that speeds up the operations on most browsers.
606 var focused
= activeElt();
607 if (toUpdate
> 4) display
.lineDiv
.style
.display
= "none";
608 patchDisplay(cm
, display
.updateLineNumbers
, update
.dims
);
609 if (toUpdate
> 4) display
.lineDiv
.style
.display
= "";
610 // There might have been a widget with a focused element that got
611 // hidden or updated, if so re-focus it.
612 if (focused
&& activeElt() != focused
&& focused
.offsetHeight
) focused
.focus();
614 // Prevent selection and cursors from interfering with the scroll
616 removeChildren(display
.cursorDiv
);
617 removeChildren(display
.selectionDiv
);
620 display
.lastWrapHeight
= update
.wrapperHeight
;
621 display
.lastWrapWidth
= update
.wrapperWidth
;
622 startWorker(cm
, 400);
625 display
.updateLineNumbers
= null;
630 function postUpdateDisplay(cm
, update
) {
631 var force
= update
.force
, viewport
= update
.viewport
;
632 for (var first
= true;; first
= false) {
633 if (first
&& cm
.options
.lineWrapping
&& update
.oldScrollerWidth
!= cm
.display
.scroller
.clientWidth
) {
637 // Clip forced viewport to actual scrollable area.
638 if (viewport
&& viewport
.top
!= null)
639 viewport
= {top
: Math
.min(cm
.doc
.height
+ paddingVert(cm
.display
) - scrollerCutOff
-
640 cm
.display
.scroller
.clientHeight
, viewport
.top
)};
641 // Updated line heights might result in the drawn area not
642 // actually covering the viewport. Keep looping until it does.
643 update
.visible
= visibleLines(cm
.display
, cm
.doc
, viewport
);
644 if (update
.visible
.from >= cm
.display
.viewFrom
&& update
.visible
.to
<= cm
.display
.viewTo
)
647 if (!updateDisplayIfNeeded(cm
, update
)) break;
648 updateHeightsInViewport(cm
);
649 var barMeasure
= measureForScrollbars(cm
);
651 setDocumentHeight(cm
, barMeasure
);
652 updateScrollbars(cm
, barMeasure
);
655 signalLater(cm
, "update", cm
);
656 if (cm
.display
.viewFrom
!= update
.oldViewFrom
|| cm
.display
.viewTo
!= update
.oldViewTo
)
657 signalLater(cm
, "viewportChange", cm
, cm
.display
.viewFrom
, cm
.display
.viewTo
);
660 function updateDisplaySimple(cm
, viewport
) {
661 var update
= new DisplayUpdate(cm
, viewport
);
662 if (updateDisplayIfNeeded(cm
, update
)) {
663 updateHeightsInViewport(cm
);
664 postUpdateDisplay(cm
, update
);
665 var barMeasure
= measureForScrollbars(cm
);
667 setDocumentHeight(cm
, barMeasure
);
668 updateScrollbars(cm
, barMeasure
);
672 function setDocumentHeight(cm
, measure
) {
673 cm
.display
.sizer
.style
.minHeight
= cm
.display
.heightForcer
.style
.top
= measure
.docHeight
+ "px";
674 cm
.display
.gutters
.style
.height
= Math
.max(measure
.docHeight
, measure
.clientHeight
- scrollerCutOff
) + "px";
677 function checkForWebkitWidthBug(cm
, measure
) {
678 // Work around Webkit bug where it sometimes reserves space for a
679 // non-existing phantom scrollbar in the scroller (Issue #2420)
680 if (cm
.display
.sizer
.offsetWidth
+ cm
.display
.gutters
.offsetWidth
< cm
.display
.scroller
.clientWidth
- 1) {
681 cm
.display
.sizer
.style
.minHeight
= cm
.display
.heightForcer
.style
.top
= "0px";
682 cm
.display
.gutters
.style
.height
= measure
.docHeight
+ "px";
686 // Read the actual heights of the rendered lines, and update their
687 // stored heights to match.
688 function updateHeightsInViewport(cm
) {
689 var display
= cm
.display
;
690 var prevBottom
= display
.lineDiv
.offsetTop
;
691 for (var i
= 0; i
< display
.view
.length
; i
++) {
692 var cur
= display
.view
[i
], height
;
693 if (cur
.hidden
) continue;
694 if (ie
&& ie_version
< 8) {
695 var bot
= cur
.node
.offsetTop
+ cur
.node
.offsetHeight
;
696 height
= bot
- prevBottom
;
699 var box
= cur
.node
.getBoundingClientRect();
700 height
= box
.bottom
- box
.top
;
702 var diff
= cur
.line
.height
- height
;
703 if (height
< 2) height
= textHeight(display
);
704 if (diff
> .001 || diff
< -.001) {
705 updateLineHeight(cur
.line
, height
);
706 updateWidgetHeight(cur
.line
);
707 if (cur
.rest
) for (var j
= 0; j
< cur
.rest
.length
; j
++)
708 updateWidgetHeight(cur
.rest
[j
]);
713 // Read and store the height of line widgets associated with the
715 function updateWidgetHeight(line
) {
716 if (line
.widgets
) for (var i
= 0; i
< line
.widgets
.length
; ++i
)
717 line
.widgets
[i
].height
= line
.widgets
[i
].node
.offsetHeight
;
720 // Do a bulk-read of the DOM positions and sizes needed to draw the
721 // view, so that we don't interleave reading and writing to the DOM.
722 function getDimensions(cm
) {
723 var d
= cm
.display
, left
= {}, width
= {};
724 var gutterLeft
= d
.gutters
.clientLeft
;
725 for (var n
= d
.gutters
.firstChild
, i
= 0; n
; n
= n
.nextSibling
, ++i
) {
726 left
[cm
.options
.gutters
[i
]] = n
.offsetLeft
+ n
.clientLeft
+ gutterLeft
;
727 width
[cm
.options
.gutters
[i
]] = n
.clientWidth
;
729 return {fixedPos
: compensateForHScroll(d
),
730 gutterTotalWidth
: d
.gutters
.offsetWidth
,
733 wrapperWidth
: d
.wrapper
.clientWidth
};
736 // Sync the actual display DOM structure with display.view, removing
737 // nodes for lines that are no longer in view, and creating the ones
738 // that are not there yet, and updating the ones that are out of
740 function patchDisplay(cm
, updateNumbersFrom
, dims
) {
741 var display
= cm
.display
, lineNumbers
= cm
.options
.lineNumbers
;
742 var container
= display
.lineDiv
, cur
= container
.firstChild
;
745 var next
= node
.nextSibling
;
746 // Works around a throw-scroll bug in OS X Webkit
747 if (webkit
&& mac
&& cm
.display
.currentWheelTarget
== node
)
748 node
.style
.display
= "none";
750 node
.parentNode
.removeChild(node
);
754 var view
= display
.view
, lineN
= display
.viewFrom
;
755 // Loop over the elements in the view, syncing cur (the DOM nodes
756 // in display.lineDiv) with the view as we go.
757 for (var i
= 0; i
< view
.length
; i
++) {
758 var lineView
= view
[i
];
759 if (lineView
.hidden
) {
760 } else if (!lineView
.node
) { // Not drawn yet
761 var node
= buildLineElement(cm
, lineView
, lineN
, dims
);
762 container
.insertBefore(node
, cur
);
763 } else { // Already drawn
764 while (cur
!= lineView
.node
) cur
= rm(cur
);
765 var updateNumber
= lineNumbers
&& updateNumbersFrom
!= null &&
766 updateNumbersFrom
<= lineN
&& lineView
.lineNumber
;
767 if (lineView
.changes
) {
768 if (indexOf(lineView
.changes
, "gutter") > -1) updateNumber
= false;
769 updateLineForChanges(cm
, lineView
, lineN
, dims
);
772 removeChildren(lineView
.lineNumber
);
773 lineView
.lineNumber
.appendChild(document
.createTextNode(lineNumberFor(cm
.options
, lineN
)));
775 cur
= lineView
.node
.nextSibling
;
777 lineN
+= lineView
.size
;
779 while (cur
) cur
= rm(cur
);
782 // When an aspect of a line changes, a string is added to
783 // lineView.changes. This updates the relevant part of the line's
785 function updateLineForChanges(cm
, lineView
, lineN
, dims
) {
786 for (var j
= 0; j
< lineView
.changes
.length
; j
++) {
787 var type
= lineView
.changes
[j
];
788 if (type
== "text") updateLineText(cm
, lineView
);
789 else if (type
== "gutter") updateLineGutter(cm
, lineView
, lineN
, dims
);
790 else if (type
== "class") updateLineClasses(lineView
);
791 else if (type
== "widget") updateLineWidgets(lineView
, dims
);
793 lineView
.changes
= null;
796 // Lines with gutter elements, widgets or a background class need to
797 // be wrapped, and have the extra elements added to the wrapper div
798 function ensureLineWrapped(lineView
) {
799 if (lineView
.node
== lineView
.text
) {
800 lineView
.node
= elt("div", null, null, "position: relative");
801 if (lineView
.text
.parentNode
)
802 lineView
.text
.parentNode
.replaceChild(lineView
.node
, lineView
.text
);
803 lineView
.node
.appendChild(lineView
.text
);
804 if (ie
&& ie_version
< 8) lineView
.node
.style
.zIndex
= 2;
806 return lineView
.node
;
809 function updateLineBackground(lineView
) {
810 var cls
= lineView
.bgClass
? lineView
.bgClass
+ " " + (lineView
.line
.bgClass
|| "") : lineView
.line
.bgClass
;
811 if (cls
) cls
+= " CodeMirror-linebackground";
812 if (lineView
.background
) {
813 if (cls
) lineView
.background
.className
= cls
;
814 else { lineView
.background
.parentNode
.removeChild(lineView
.background
); lineView
.background
= null; }
816 var wrap
= ensureLineWrapped(lineView
);
817 lineView
.background
= wrap
.insertBefore(elt("div", null, cls
), wrap
.firstChild
);
821 // Wrapper around buildLineContent which will reuse the structure
822 // in display.externalMeasured when possible.
823 function getLineContent(cm
, lineView
) {
824 var ext
= cm
.display
.externalMeasured
;
825 if (ext
&& ext
.line
== lineView
.line
) {
826 cm
.display
.externalMeasured
= null;
827 lineView
.measure
= ext
.measure
;
830 return buildLineContent(cm
, lineView
);
833 // Redraw the line's text. Interacts with the background and text
834 // classes because the mode may output tokens that influence these
836 function updateLineText(cm
, lineView
) {
837 var cls
= lineView
.text
.className
;
838 var built
= getLineContent(cm
, lineView
);
839 if (lineView
.text
== lineView
.node
) lineView
.node
= built
.pre
;
840 lineView
.text
.parentNode
.replaceChild(built
.pre
, lineView
.text
);
841 lineView
.text
= built
.pre
;
842 if (built
.bgClass
!= lineView
.bgClass
|| built
.textClass
!= lineView
.textClass
) {
843 lineView
.bgClass
= built
.bgClass
;
844 lineView
.textClass
= built
.textClass
;
845 updateLineClasses(lineView
);
847 lineView
.text
.className
= cls
;
851 function updateLineClasses(lineView
) {
852 updateLineBackground(lineView
);
853 if (lineView
.line
.wrapClass
)
854 ensureLineWrapped(lineView
).className
= lineView
.line
.wrapClass
;
855 else if (lineView
.node
!= lineView
.text
)
856 lineView
.node
.className
= "";
857 var textClass
= lineView
.textClass
? lineView
.textClass
+ " " + (lineView
.line
.textClass
|| "") : lineView
.line
.textClass
;
858 lineView
.text
.className
= textClass
|| "";
861 function updateLineGutter(cm
, lineView
, lineN
, dims
) {
862 if (lineView
.gutter
) {
863 lineView
.node
.removeChild(lineView
.gutter
);
864 lineView
.gutter
= null;
866 var markers
= lineView
.line
.gutterMarkers
;
867 if (cm
.options
.lineNumbers
|| markers
) {
868 var wrap
= ensureLineWrapped(lineView
);
869 var gutterWrap
= lineView
.gutter
=
870 wrap
.insertBefore(elt("div", null, "CodeMirror-gutter-wrapper", "left: " +
871 (cm
.options
.fixedGutter
? dims
.fixedPos
: -dims
.gutterTotalWidth
) +
872 "px; width: " + dims
.gutterTotalWidth
+ "px"),
874 if (lineView
.line
.gutterClass
)
875 gutterWrap
.className
+= " " + lineView
.line
.gutterClass
;
876 if (cm
.options
.lineNumbers
&& (!markers
|| !markers
["CodeMirror-linenumbers"]))
877 lineView
.lineNumber
= gutterWrap
.appendChild(
878 elt("div", lineNumberFor(cm
.options
, lineN
),
879 "CodeMirror-linenumber CodeMirror-gutter-elt",
880 "left: " + dims
.gutterLeft
["CodeMirror-linenumbers"] + "px; width: "
881 + cm
.display
.lineNumInnerWidth
+ "px"));
882 if (markers
) for (var k
= 0; k
< cm
.options
.gutters
.length
; ++k
) {
883 var id
= cm
.options
.gutters
[k
], found
= markers
.hasOwnProperty(id
) && markers
[id
];
885 gutterWrap
.appendChild(elt("div", [found
], "CodeMirror-gutter-elt", "left: " +
886 dims
.gutterLeft
[id
] + "px; width: " + dims
.gutterWidth
[id
] + "px"));
891 function updateLineWidgets(lineView
, dims
) {
892 if (lineView
.alignable
) lineView
.alignable
= null;
893 for (var node
= lineView
.node
.firstChild
, next
; node
; node
= next
) {
894 var next
= node
.nextSibling
;
895 if (node
.className
== "CodeMirror-linewidget")
896 lineView
.node
.removeChild(node
);
898 insertLineWidgets(lineView
, dims
);
901 // Build a line's DOM representation from scratch
902 function buildLineElement(cm
, lineView
, lineN
, dims
) {
903 var built
= getLineContent(cm
, lineView
);
904 lineView
.text
= lineView
.node
= built
.pre
;
905 if (built
.bgClass
) lineView
.bgClass
= built
.bgClass
;
906 if (built
.textClass
) lineView
.textClass
= built
.textClass
;
908 updateLineClasses(lineView
);
909 updateLineGutter(cm
, lineView
, lineN
, dims
);
910 insertLineWidgets(lineView
, dims
);
911 return lineView
.node
;
914 // A lineView may contain multiple logical lines (when merged by
915 // collapsed spans). The widgets for all of them need to be drawn.
916 function insertLineWidgets(lineView
, dims
) {
917 insertLineWidgetsFor(lineView
.line
, lineView
, dims
, true);
918 if (lineView
.rest
) for (var i
= 0; i
< lineView
.rest
.length
; i
++)
919 insertLineWidgetsFor(lineView
.rest
[i
], lineView
, dims
, false);
922 function insertLineWidgetsFor(line
, lineView
, dims
, allowAbove
) {
923 if (!line
.widgets
) return;
924 var wrap
= ensureLineWrapped(lineView
);
925 for (var i
= 0, ws
= line
.widgets
; i
< ws
.length
; ++i
) {
926 var widget
= ws
[i
], node
= elt("div", [widget
.node
], "CodeMirror-linewidget");
927 if (!widget
.handleMouseEvents
) node
.ignoreEvents
= true;
928 positionLineWidget(widget
, node
, lineView
, dims
);
929 if (allowAbove
&& widget
.above
)
930 wrap
.insertBefore(node
, lineView
.gutter
|| lineView
.text
);
932 wrap
.appendChild(node
);
933 signalLater(widget
, "redraw");
937 function positionLineWidget(widget
, node
, lineView
, dims
) {
938 if (widget
.noHScroll
) {
939 (lineView
.alignable
|| (lineView
.alignable
= [])).push(node
);
940 var width
= dims
.wrapperWidth
;
941 node
.style
.left
= dims
.fixedPos
+ "px";
942 if (!widget
.coverGutter
) {
943 width
-= dims
.gutterTotalWidth
;
944 node
.style
.paddingLeft
= dims
.gutterTotalWidth
+ "px";
946 node
.style
.width
= width
+ "px";
948 if (widget
.coverGutter
) {
949 node
.style
.zIndex
= 5;
950 node
.style
.position
= "relative";
951 if (!widget
.noHScroll
) node
.style
.marginLeft
= -dims
.gutterTotalWidth
+ "px";
957 // A Pos instance represents a position within the text.
958 var Pos
= CodeMirror
.Pos = function(line
, ch
) {
959 if (!(this instanceof Pos
)) return new Pos(line
, ch
);
960 this.line
= line
; this.ch
= ch
;
963 // Compare two positions, return 0 if they are the same, a negative
964 // number when a is less, and a positive number otherwise.
965 var cmp
= CodeMirror
.cmpPos = function(a
, b
) { return a
.line
- b
.line
|| a
.ch
- b
.ch
; };
967 function copyPos(x
) {return Pos(x
.line
, x
.ch
);}
968 function maxPos(a
, b
) { return cmp(a
, b
) < 0 ? b
: a
; }
969 function minPos(a
, b
) { return cmp(a
, b
) < 0 ? a
: b
; }
971 // SELECTION / CURSOR
973 // Selection objects are immutable. A new one is created every time
974 // the selection changes. A selection is one or more non-overlapping
975 // (and non-touching) ranges, sorted, and an integer that indicates
976 // which one is the primary selection (the one that's scrolled into
977 // view, that getCursor returns, etc).
978 function Selection(ranges
, primIndex
) {
979 this.ranges
= ranges
;
980 this.primIndex
= primIndex
;
983 Selection
.prototype = {
984 primary: function() { return this.ranges
[this.primIndex
]; },
985 equals: function(other
) {
986 if (other
== this) return true;
987 if (other
.primIndex
!= this.primIndex
|| other
.ranges
.length
!= this.ranges
.length
) return false;
988 for (var i
= 0; i
< this.ranges
.length
; i
++) {
989 var here
= this.ranges
[i
], there
= other
.ranges
[i
];
990 if (cmp(here
.anchor
, there
.anchor
) != 0 || cmp(here
.head
, there
.head
) != 0) return false;
994 deepCopy: function() {
995 for (var out
= [], i
= 0; i
< this.ranges
.length
; i
++)
996 out
[i
] = new Range(copyPos(this.ranges
[i
].anchor
), copyPos(this.ranges
[i
].head
));
997 return new Selection(out
, this.primIndex
);
999 somethingSelected: function() {
1000 for (var i
= 0; i
< this.ranges
.length
; i
++)
1001 if (!this.ranges
[i
].empty()) return true;
1004 contains: function(pos
, end
) {
1005 if (!end
) end
= pos
;
1006 for (var i
= 0; i
< this.ranges
.length
; i
++) {
1007 var range
= this.ranges
[i
];
1008 if (cmp(end
, range
.from()) >= 0 && cmp(pos
, range
.to()) <= 0)
1015 function Range(anchor
, head
) {
1016 this.anchor
= anchor
; this.head
= head
;
1020 from: function() { return minPos(this.anchor
, this.head
); },
1021 to: function() { return maxPos(this.anchor
, this.head
); },
1023 return this.head
.line
== this.anchor
.line
&& this.head
.ch
== this.anchor
.ch
;
1027 // Take an unsorted, potentially overlapping set of ranges, and
1028 // build a selection out of it. 'Consumes' ranges array (modifying
1030 function normalizeSelection(ranges
, primIndex
) {
1031 var prim
= ranges
[primIndex
];
1032 ranges
.sort(function(a
, b
) { return cmp(a
.from(), b
.from()); });
1033 primIndex
= indexOf(ranges
, prim
);
1034 for (var i
= 1; i
< ranges
.length
; i
++) {
1035 var cur
= ranges
[i
], prev
= ranges
[i
- 1];
1036 if (cmp(prev
.to(), cur
.from()) >= 0) {
1037 var from = minPos(prev
.from(), cur
.from()), to
= maxPos(prev
.to(), cur
.to());
1038 var inv
= prev
.empty() ? cur
.from() == cur
.head
: prev
.from() == prev
.head
;
1039 if (i
<= primIndex
) --primIndex
;
1040 ranges
.splice(--i
, 2, new Range(inv
? to
: from, inv
? from : to
));
1043 return new Selection(ranges
, primIndex
);
1046 function simpleSelection(anchor
, head
) {
1047 return new Selection([new Range(anchor
, head
|| anchor
)], 0);
1050 // Most of the external API clips given positions to make sure they
1051 // actually exist within the document.
1052 function clipLine(doc
, n
) {return Math
.max(doc
.first
, Math
.min(n
, doc
.first
+ doc
.size
- 1));}
1053 function clipPos(doc
, pos
) {
1054 if (pos
.line
< doc
.first
) return Pos(doc
.first
, 0);
1055 var last
= doc
.first
+ doc
.size
- 1;
1056 if (pos
.line
> last
) return Pos(last
, getLine(doc
, last
).text
.length
);
1057 return clipToLen(pos
, getLine(doc
, pos
.line
).text
.length
);
1059 function clipToLen(pos
, linelen
) {
1061 if (ch
== null || ch
> linelen
) return Pos(pos
.line
, linelen
);
1062 else if (ch
< 0) return Pos(pos
.line
, 0);
1065 function isLine(doc
, l
) {return l
>= doc
.first
&& l
< doc
.first
+ doc
.size
;}
1066 function clipPosArray(doc
, array
) {
1067 for (var out
= [], i
= 0; i
< array
.length
; i
++) out
[i
] = clipPos(doc
, array
[i
]);
1071 // SELECTION UPDATES
1073 // The 'scroll' parameter given to many of these indicated whether
1074 // the new cursor position should be scrolled into view after
1075 // modifying the selection.
1077 // If shift is held or the extend flag is set, extends a range to
1078 // include a given position (and optionally a second position).
1079 // Otherwise, simply returns the range between the given positions.
1080 // Used for cursor motion and such.
1081 function extendRange(doc
, range
, head
, other
) {
1082 if (doc
.cm
&& doc
.cm
.display
.shift
|| doc
.extend
) {
1083 var anchor
= range
.anchor
;
1085 var posBefore
= cmp(head
, anchor
) < 0;
1086 if (posBefore
!= (cmp(other
, anchor
) < 0)) {
1089 } else if (posBefore
!= (cmp(head
, other
) < 0)) {
1093 return new Range(anchor
, head
);
1095 return new Range(other
|| head
, head
);
1099 // Extend the primary selection range, discard the rest.
1100 function extendSelection(doc
, head
, other
, options
) {
1101 setSelection(doc
, new Selection([extendRange(doc
, doc
.sel
.primary(), head
, other
)], 0), options
);
1104 // Extend all selections (pos is an array of selections with length
1105 // equal the number of selections)
1106 function extendSelections(doc
, heads
, options
) {
1107 for (var out
= [], i
= 0; i
< doc
.sel
.ranges
.length
; i
++)
1108 out
[i
] = extendRange(doc
, doc
.sel
.ranges
[i
], heads
[i
], null);
1109 var newSel
= normalizeSelection(out
, doc
.sel
.primIndex
);
1110 setSelection(doc
, newSel
, options
);
1113 // Updates a single range in the selection.
1114 function replaceOneSelection(doc
, i
, range
, options
) {
1115 var ranges
= doc
.sel
.ranges
.slice(0);
1117 setSelection(doc
, normalizeSelection(ranges
, doc
.sel
.primIndex
), options
);
1120 // Reset the selection to a single range.
1121 function setSimpleSelection(doc
, anchor
, head
, options
) {
1122 setSelection(doc
, simpleSelection(anchor
, head
), options
);
1125 // Give beforeSelectionChange handlers a change to influence a
1126 // selection update.
1127 function filterSelectionChange(doc
, sel
) {
1130 update: function(ranges
) {
1132 for (var i
= 0; i
< ranges
.length
; i
++)
1133 this.ranges
[i
] = new Range(clipPos(doc
, ranges
[i
].anchor
),
1134 clipPos(doc
, ranges
[i
].head
));
1137 signal(doc
, "beforeSelectionChange", doc
, obj
);
1138 if (doc
.cm
) signal(doc
.cm
, "beforeSelectionChange", doc
.cm
, obj
);
1139 if (obj
.ranges
!= sel
.ranges
) return normalizeSelection(obj
.ranges
, obj
.ranges
.length
- 1);
1143 function setSelectionReplaceHistory(doc
, sel
, options
) {
1144 var done
= doc
.history
.done
, last
= lst(done
);
1145 if (last
&& last
.ranges
) {
1146 done
[done
.length
- 1] = sel
;
1147 setSelectionNoUndo(doc
, sel
, options
);
1149 setSelection(doc
, sel
, options
);
1153 // Set a new selection.
1154 function setSelection(doc
, sel
, options
) {
1155 setSelectionNoUndo(doc
, sel
, options
);
1156 addSelectionToHistory(doc
, doc
.sel
, doc
.cm
? doc
.cm
.curOp
.id
: NaN
, options
);
1159 function setSelectionNoUndo(doc
, sel
, options
) {
1160 if (hasHandler(doc
, "beforeSelectionChange") || doc
.cm
&& hasHandler(doc
.cm
, "beforeSelectionChange"))
1161 sel
= filterSelectionChange(doc
, sel
);
1163 var bias
= options
&& options
.bias
||
1164 (cmp(sel
.primary().head
, doc
.sel
.primary().head
) < 0 ? -1 : 1);
1165 setSelectionInner(doc
, skipAtomicInSelection(doc
, sel
, bias
, true));
1167 if (!(options
&& options
.scroll
=== false) && doc
.cm
)
1168 ensureCursorVisible(doc
.cm
);
1171 function setSelectionInner(doc
, sel
) {
1172 if (sel
.equals(doc
.sel
)) return;
1177 doc
.cm
.curOp
.updateInput
= doc
.cm
.curOp
.selectionChanged
= true;
1178 signalCursorActivity(doc
.cm
);
1180 signalLater(doc
, "cursorActivity", doc
);
1183 // Verify that the selection does not partially select any atomic
1185 function reCheckSelection(doc
) {
1186 setSelectionInner(doc
, skipAtomicInSelection(doc
, doc
.sel
, null, false), sel_dontScroll
);
1189 // Return a selection that does not partially select any atomic
1191 function skipAtomicInSelection(doc
, sel
, bias
, mayClear
) {
1193 for (var i
= 0; i
< sel
.ranges
.length
; i
++) {
1194 var range
= sel
.ranges
[i
];
1195 var newAnchor
= skipAtomic(doc
, range
.anchor
, bias
, mayClear
);
1196 var newHead
= skipAtomic(doc
, range
.head
, bias
, mayClear
);
1197 if (out
|| newAnchor
!= range
.anchor
|| newHead
!= range
.head
) {
1198 if (!out
) out
= sel
.ranges
.slice(0, i
);
1199 out
[i
] = new Range(newAnchor
, newHead
);
1202 return out
? normalizeSelection(out
, sel
.primIndex
) : sel
;
1205 // Ensure a given position is not inside an atomic range.
1206 function skipAtomic(doc
, pos
, bias
, mayClear
) {
1207 var flipped
= false, curPos
= pos
;
1208 var dir
= bias
|| 1;
1209 doc
.cantEdit
= false;
1211 var line
= getLine(doc
, curPos
.line
);
1212 if (line
.markedSpans
) {
1213 for (var i
= 0; i
< line
.markedSpans
.length
; ++i
) {
1214 var sp
= line
.markedSpans
[i
], m
= sp
.marker
;
1215 if ((sp
.from == null || (m
.inclusiveLeft
? sp
.from <= curPos
.ch
: sp
.from < curPos
.ch
)) &&
1216 (sp
.to
== null || (m
.inclusiveRight
? sp
.to
>= curPos
.ch
: sp
.to
> curPos
.ch
))) {
1218 signal(m
, "beforeCursorEnter");
1219 if (m
.explicitlyCleared
) {
1220 if (!line
.markedSpans
) break;
1221 else {--i
; continue;}
1224 if (!m
.atomic
) continue;
1225 var newPos
= m
.find(dir
< 0 ? -1 : 1);
1226 if (cmp(newPos
, curPos
) == 0) {
1228 if (newPos
.ch
< 0) {
1229 if (newPos
.line
> doc
.first
) newPos
= clipPos(doc
, Pos(newPos
.line
- 1));
1231 } else if (newPos
.ch
> line
.text
.length
) {
1232 if (newPos
.line
< doc
.first
+ doc
.size
- 1) newPos
= Pos(newPos
.line
+ 1, 0);
1237 // Driven in a corner -- no valid cursor position found at all
1238 // -- try again *with* clearing, if we didn't already
1239 if (!mayClear
) return skipAtomic(doc
, pos
, bias
, true);
1240 // Otherwise, turn off editing until further notice, and return the start of the doc
1241 doc
.cantEdit
= true;
1242 return Pos(doc
.first
, 0);
1244 flipped
= true; newPos
= pos
; dir
= -dir
;
1256 // SELECTION DRAWING
1258 // Redraw the selection and/or cursor
1259 function drawSelection(cm
) {
1260 var display
= cm
.display
, doc
= cm
.doc
, result
= {};
1261 var curFragment
= result
.cursors
= document
.createDocumentFragment();
1262 var selFragment
= result
.selection
= document
.createDocumentFragment();
1264 for (var i
= 0; i
< doc
.sel
.ranges
.length
; i
++) {
1265 var range
= doc
.sel
.ranges
[i
];
1266 var collapsed
= range
.empty();
1267 if (collapsed
|| cm
.options
.showCursorWhenSelecting
)
1268 drawSelectionCursor(cm
, range
, curFragment
);
1270 drawSelectionRange(cm
, range
, selFragment
);
1273 // Move the hidden textarea near the cursor to prevent scrolling artifacts
1274 if (cm
.options
.moveInputWithCursor
) {
1275 var headPos
= cursorCoords(cm
, doc
.sel
.primary().head
, "div");
1276 var wrapOff
= display
.wrapper
.getBoundingClientRect(), lineOff
= display
.lineDiv
.getBoundingClientRect();
1277 result
.teTop
= Math
.max(0, Math
.min(display
.wrapper
.clientHeight
- 10,
1278 headPos
.top
+ lineOff
.top
- wrapOff
.top
));
1279 result
.teLeft
= Math
.max(0, Math
.min(display
.wrapper
.clientWidth
- 10,
1280 headPos
.left
+ lineOff
.left
- wrapOff
.left
));
1286 function showSelection(cm
, drawn
) {
1287 removeChildrenAndAdd(cm
.display
.cursorDiv
, drawn
.cursors
);
1288 removeChildrenAndAdd(cm
.display
.selectionDiv
, drawn
.selection
);
1289 if (drawn
.teTop
!= null) {
1290 cm
.display
.inputDiv
.style
.top
= drawn
.teTop
+ "px";
1291 cm
.display
.inputDiv
.style
.left
= drawn
.teLeft
+ "px";
1295 function updateSelection(cm
) {
1296 showSelection(cm
, drawSelection(cm
));
1299 // Draws a cursor for the given range
1300 function drawSelectionCursor(cm
, range
, output
) {
1301 var pos
= cursorCoords(cm
, range
.head
, "div", null, null, !cm
.options
.singleCursorHeightPerLine
);
1303 var cursor
= output
.appendChild(elt("div", "\u00a0", "CodeMirror-cursor"));
1304 cursor
.style
.left
= pos
.left
+ "px";
1305 cursor
.style
.top
= pos
.top
+ "px";
1306 cursor
.style
.height
= Math
.max(0, pos
.bottom
- pos
.top
) * cm
.options
.cursorHeight
+ "px";
1309 // Secondary cursor, shown when on a 'jump' in bi-directional text
1310 var otherCursor
= output
.appendChild(elt("div", "\u00a0", "CodeMirror-cursor CodeMirror-secondarycursor"));
1311 otherCursor
.style
.display
= "";
1312 otherCursor
.style
.left
= pos
.other
.left
+ "px";
1313 otherCursor
.style
.top
= pos
.other
.top
+ "px";
1314 otherCursor
.style
.height
= (pos
.other
.bottom
- pos
.other
.top
) * .85 + "px";
1318 // Draws the given range as a highlighted selection
1319 function drawSelectionRange(cm
, range
, output
) {
1320 var display
= cm
.display
, doc
= cm
.doc
;
1321 var fragment
= document
.createDocumentFragment();
1322 var padding
= paddingH(cm
.display
), leftSide
= padding
.left
, rightSide
= display
.lineSpace
.offsetWidth
- padding
.right
;
1324 function add(left
, top
, width
, bottom
) {
1325 if (top
< 0) top
= 0;
1326 top
= Math
.round(top
);
1327 bottom
= Math
.round(bottom
);
1328 fragment
.appendChild(elt("div", null, "CodeMirror-selected", "position: absolute; left: " + left
+
1329 "px; top: " + top
+ "px; width: " + (width
== null ? rightSide
- left
: width
) +
1330 "px; height: " + (bottom
- top
) + "px"));
1333 function drawForLine(line
, fromArg
, toArg
) {
1334 var lineObj
= getLine(doc
, line
);
1335 var lineLen
= lineObj
.text
.length
;
1337 function coords(ch
, bias
) {
1338 return charCoords(cm
, Pos(line
, ch
), "div", lineObj
, bias
);
1341 iterateBidiSections(getOrder(lineObj
), fromArg
|| 0, toArg
== null ? lineLen
: toArg
, function(from, to
, dir
) {
1342 var leftPos
= coords(from, "left"), rightPos
, left
, right
;
1345 left
= right
= leftPos
.left
;
1347 rightPos
= coords(to
- 1, "right");
1348 if (dir
== "rtl") { var tmp
= leftPos
; leftPos
= rightPos
; rightPos
= tmp
; }
1349 left
= leftPos
.left
;
1350 right
= rightPos
.right
;
1352 if (fromArg
== null && from == 0) left
= leftSide
;
1353 if (rightPos
.top
- leftPos
.top
> 3) { // Different lines, draw top part
1354 add(left
, leftPos
.top
, null, leftPos
.bottom
);
1356 if (leftPos
.bottom
< rightPos
.top
) add(left
, leftPos
.bottom
, null, rightPos
.top
);
1358 if (toArg
== null && to
== lineLen
) right
= rightSide
;
1359 if (!start
|| leftPos
.top
< start
.top
|| leftPos
.top
== start
.top
&& leftPos
.left
< start
.left
)
1361 if (!end
|| rightPos
.bottom
> end
.bottom
|| rightPos
.bottom
== end
.bottom
&& rightPos
.right
> end
.right
)
1363 if (left
< leftSide
+ 1) left
= leftSide
;
1364 add(left
, rightPos
.top
, right
- left
, rightPos
.bottom
);
1366 return {start
: start
, end
: end
};
1369 var sFrom
= range
.from(), sTo
= range
.to();
1370 if (sFrom
.line
== sTo
.line
) {
1371 drawForLine(sFrom
.line
, sFrom
.ch
, sTo
.ch
);
1373 var fromLine
= getLine(doc
, sFrom
.line
), toLine
= getLine(doc
, sTo
.line
);
1374 var singleVLine
= visualLine(fromLine
) == visualLine(toLine
);
1375 var leftEnd
= drawForLine(sFrom
.line
, sFrom
.ch
, singleVLine
? fromLine
.text
.length
+ 1 : null).end
;
1376 var rightStart
= drawForLine(sTo
.line
, singleVLine
? 0 : null, sTo
.ch
).start
;
1378 if (leftEnd
.top
< rightStart
.top
- 2) {
1379 add(leftEnd
.right
, leftEnd
.top
, null, leftEnd
.bottom
);
1380 add(leftSide
, rightStart
.top
, rightStart
.left
, rightStart
.bottom
);
1382 add(leftEnd
.right
, leftEnd
.top
, rightStart
.left
- leftEnd
.right
, leftEnd
.bottom
);
1385 if (leftEnd
.bottom
< rightStart
.top
)
1386 add(leftSide
, leftEnd
.bottom
, null, rightStart
.top
);
1389 output
.appendChild(fragment
);
1393 function restartBlink(cm
) {
1394 if (!cm
.state
.focused
) return;
1395 var display
= cm
.display
;
1396 clearInterval(display
.blinker
);
1398 display
.cursorDiv
.style
.visibility
= "";
1399 if (cm
.options
.cursorBlinkRate
> 0)
1400 display
.blinker
= setInterval(function() {
1401 display
.cursorDiv
.style
.visibility
= (on
= !on
) ? "" : "hidden";
1402 }, cm
.options
.cursorBlinkRate
);
1403 else if (cm
.options
.cursorBlinkRate
< 0)
1404 display
.cursorDiv
.style
.visibility
= "hidden";
1409 function startWorker(cm
, time
) {
1410 if (cm
.doc
.mode
.startState
&& cm
.doc
.frontier
< cm
.display
.viewTo
)
1411 cm
.state
.highlight
.set(time
, bind(highlightWorker
, cm
));
1414 function highlightWorker(cm
) {
1416 if (doc
.frontier
< doc
.first
) doc
.frontier
= doc
.first
;
1417 if (doc
.frontier
>= cm
.display
.viewTo
) return;
1418 var end
= +new Date
+ cm
.options
.workTime
;
1419 var state
= copyState(doc
.mode
, getStateBefore(cm
, doc
.frontier
));
1420 var changedLines
= [];
1422 doc
.iter(doc
.frontier
, Math
.min(doc
.first
+ doc
.size
, cm
.display
.viewTo
+ 500), function(line
) {
1423 if (doc
.frontier
>= cm
.display
.viewFrom
) { // Visible
1424 var oldStyles
= line
.styles
;
1425 var highlighted
= highlightLine(cm
, line
, state
, true);
1426 line
.styles
= highlighted
.styles
;
1427 var oldCls
= line
.styleClasses
, newCls
= highlighted
.classes
;
1428 if (newCls
) line
.styleClasses
= newCls
;
1429 else if (oldCls
) line
.styleClasses
= null;
1430 var ischange
= !oldStyles
|| oldStyles
.length
!= line
.styles
.length
||
1431 oldCls
!= newCls
&& (!oldCls
|| !newCls
|| oldCls
.bgClass
!= newCls
.bgClass
|| oldCls
.textClass
!= newCls
.textClass
);
1432 for (var i
= 0; !ischange
&& i
< oldStyles
.length
; ++i
) ischange
= oldStyles
[i
] != line
.styles
[i
];
1433 if (ischange
) changedLines
.push(doc
.frontier
);
1434 line
.stateAfter
= copyState(doc
.mode
, state
);
1436 processLine(cm
, line
.text
, state
);
1437 line
.stateAfter
= doc
.frontier
% 5 == 0 ? copyState(doc
.mode
, state
) : null;
1440 if (+new Date
> end
) {
1441 startWorker(cm
, cm
.options
.workDelay
);
1445 if (changedLines
.length
) runInOp(cm
, function() {
1446 for (var i
= 0; i
< changedLines
.length
; i
++)
1447 regLineChange(cm
, changedLines
[i
], "text");
1451 // Finds the line to start with when starting a parse. Tries to
1452 // find a line with a stateAfter, so that it can start with a
1453 // valid state. If that fails, it returns the line with the
1454 // smallest indentation, which tends to need the least context to
1456 function findStartLine(cm
, n
, precise
) {
1457 var minindent
, minline
, doc
= cm
.doc
;
1458 var lim
= precise
? -1 : n
- (cm
.doc
.mode
.innerMode
? 1000 : 100);
1459 for (var search
= n
; search
> lim
; --search
) {
1460 if (search
<= doc
.first
) return doc
.first
;
1461 var line
= getLine(doc
, search
- 1);
1462 if (line
.stateAfter
&& (!precise
|| search
<= doc
.frontier
)) return search
;
1463 var indented
= countColumn(line
.text
, null, cm
.options
.tabSize
);
1464 if (minline
== null || minindent
> indented
) {
1465 minline
= search
- 1;
1466 minindent
= indented
;
1472 function getStateBefore(cm
, n
, precise
) {
1473 var doc
= cm
.doc
, display
= cm
.display
;
1474 if (!doc
.mode
.startState
) return true;
1475 var pos
= findStartLine(cm
, n
, precise
), state
= pos
> doc
.first
&& getLine(doc
, pos
-1).stateAfter
;
1476 if (!state
) state
= startState(doc
.mode
);
1477 else state
= copyState(doc
.mode
, state
);
1478 doc
.iter(pos
, n
, function(line
) {
1479 processLine(cm
, line
.text
, state
);
1480 var save
= pos
== n
- 1 || pos
% 5 == 0 || pos
>= display
.viewFrom
&& pos
< display
.viewTo
;
1481 line
.stateAfter
= save
? copyState(doc
.mode
, state
) : null;
1484 if (precise
) doc
.frontier
= pos
;
1488 // POSITION MEASUREMENT
1490 function paddingTop(display
) {return display
.lineSpace
.offsetTop
;}
1491 function paddingVert(display
) {return display
.mover
.offsetHeight
- display
.lineSpace
.offsetHeight
;}
1492 function paddingH(display
) {
1493 if (display
.cachedPaddingH
) return display
.cachedPaddingH
;
1494 var e
= removeChildrenAndAdd(display
.measure
, elt("pre", "x"));
1495 var style
= window
.getComputedStyle
? window
.getComputedStyle(e
) : e
.currentStyle
;
1496 var data
= {left
: parseInt(style
.paddingLeft
), right
: parseInt(style
.paddingRight
)};
1497 if (!isNaN(data
.left
) && !isNaN(data
.right
)) display
.cachedPaddingH
= data
;
1501 // Ensure the lineView.wrapping.heights array is populated. This is
1502 // an array of bottom offsets for the lines that make up a drawn
1503 // line. When lineWrapping is on, there might be more than one
1505 function ensureLineHeights(cm
, lineView
, rect
) {
1506 var wrapping
= cm
.options
.lineWrapping
;
1507 var curWidth
= wrapping
&& cm
.display
.scroller
.clientWidth
;
1508 if (!lineView
.measure
.heights
|| wrapping
&& lineView
.measure
.width
!= curWidth
) {
1509 var heights
= lineView
.measure
.heights
= [];
1511 lineView
.measure
.width
= curWidth
;
1512 var rects
= lineView
.text
.firstChild
.getClientRects();
1513 for (var i
= 0; i
< rects
.length
- 1; i
++) {
1514 var cur
= rects
[i
], next
= rects
[i
+ 1];
1515 if (Math
.abs(cur
.bottom
- next
.bottom
) > 2)
1516 heights
.push((cur
.bottom
+ next
.top
) / 2 - rect
.top
);
1519 heights
.push(rect
.bottom
- rect
.top
);
1523 // Find a line map (mapping character offsets to text nodes) and a
1524 // measurement cache for the given line number. (A line view might
1525 // contain multiple lines when collapsed ranges are present.)
1526 function mapFromLineView(lineView
, line
, lineN
) {
1527 if (lineView
.line
== line
)
1528 return {map
: lineView
.measure
.map
, cache
: lineView
.measure
.cache
};
1529 for (var i
= 0; i
< lineView
.rest
.length
; i
++)
1530 if (lineView
.rest
[i
] == line
)
1531 return {map
: lineView
.measure
.maps
[i
], cache
: lineView
.measure
.caches
[i
]};
1532 for (var i
= 0; i
< lineView
.rest
.length
; i
++)
1533 if (lineNo(lineView
.rest
[i
]) > lineN
)
1534 return {map
: lineView
.measure
.maps
[i
], cache
: lineView
.measure
.caches
[i
], before
: true};
1537 // Render a line into the hidden node display.externalMeasured. Used
1538 // when measurement is needed for a line that's not in the viewport.
1539 function updateExternalMeasurement(cm
, line
) {
1540 line
= visualLine(line
);
1541 var lineN
= lineNo(line
);
1542 var view
= cm
.display
.externalMeasured
= new LineView(cm
.doc
, line
, lineN
);
1544 var built
= view
.built
= buildLineContent(cm
, view
);
1545 view
.text
= built
.pre
;
1546 removeChildrenAndAdd(cm
.display
.lineMeasure
, built
.pre
);
1550 // Get a {top, bottom, left, right} box (in line-local coordinates)
1551 // for a given character.
1552 function measureChar(cm
, line
, ch
, bias
) {
1553 return measureCharPrepared(cm
, prepareMeasureForLine(cm
, line
), ch
, bias
);
1556 // Find a line view that corresponds to the given line number.
1557 function findViewForLine(cm
, lineN
) {
1558 if (lineN
>= cm
.display
.viewFrom
&& lineN
< cm
.display
.viewTo
)
1559 return cm
.display
.view
[findViewIndex(cm
, lineN
)];
1560 var ext
= cm
.display
.externalMeasured
;
1561 if (ext
&& lineN
>= ext
.lineN
&& lineN
< ext
.lineN
+ ext
.size
)
1565 // Measurement can be split in two steps, the set-up work that
1566 // applies to the whole line, and the measurement of the actual
1567 // character. Functions like coordsChar, that need to do a lot of
1568 // measurements in a row, can thus ensure that the set-up work is
1570 function prepareMeasureForLine(cm
, line
) {
1571 var lineN
= lineNo(line
);
1572 var view
= findViewForLine(cm
, lineN
);
1573 if (view
&& !view
.text
)
1575 else if (view
&& view
.changes
)
1576 updateLineForChanges(cm
, view
, lineN
, getDimensions(cm
));
1578 view
= updateExternalMeasurement(cm
, line
);
1580 var info
= mapFromLineView(view
, line
, lineN
);
1582 line
: line
, view
: view
, rect
: null,
1583 map
: info
.map
, cache
: info
.cache
, before
: info
.before
,
1588 // Given a prepared measurement object, measures the position of an
1589 // actual character (or fetches it from the cache).
1590 function measureCharPrepared(cm
, prepared
, ch
, bias
, varHeight
) {
1591 if (prepared
.before
) ch
= -1;
1592 var key
= ch
+ (bias
|| ""), found
;
1593 if (prepared
.cache
.hasOwnProperty(key
)) {
1594 found
= prepared
.cache
[key
];
1597 prepared
.rect
= prepared
.view
.text
.getBoundingClientRect();
1598 if (!prepared
.hasHeights
) {
1599 ensureLineHeights(cm
, prepared
.view
, prepared
.rect
);
1600 prepared
.hasHeights
= true;
1602 found
= measureCharInner(cm
, prepared
, ch
, bias
);
1603 if (!found
.bogus
) prepared
.cache
[key
] = found
;
1605 return {left
: found
.left
, right
: found
.right
,
1606 top
: varHeight
? found
.rtop
: found
.top
,
1607 bottom
: varHeight
? found
.rbottom
: found
.bottom
};
1610 var nullRect
= {left
: 0, right
: 0, top
: 0, bottom
: 0};
1612 function measureCharInner(cm
, prepared
, ch
, bias
) {
1613 var map
= prepared
.map
;
1615 var node
, start
, end
, collapse
;
1616 // First, search the line map for the text node corresponding to,
1617 // or closest to, the target character.
1618 for (var i
= 0; i
< map
.length
; i
+= 3) {
1619 var mStart
= map
[i
], mEnd
= map
[i
+ 1];
1623 } else if (ch
< mEnd
) {
1624 start
= ch
- mStart
;
1626 } else if (i
== map
.length
- 3 || ch
== mEnd
&& map
[i
+ 3] > ch
) {
1627 end
= mEnd
- mStart
;
1629 if (ch
>= mEnd
) collapse
= "right";
1631 if (start
!= null) {
1633 if (mStart
== mEnd
&& bias
== (node
.insertLeft
? "left" : "right"))
1635 if (bias
== "left" && start
== 0)
1636 while (i
&& map
[i
- 2] == map
[i
- 3] && map
[i
- 1].insertLeft
) {
1637 node
= map
[(i
-= 3) + 2];
1640 if (bias
== "right" && start
== mEnd
- mStart
)
1641 while (i
< map
.length
- 3 && map
[i
+ 3] == map
[i
+ 4] && !map
[i
+ 5].insertLeft
) {
1642 node
= map
[(i
+= 3) + 2];
1650 if (node
.nodeType
== 3) { // If it is a text node, use a range to retrieve the coordinates.
1651 for (var i
= 0; i
< 4; i
++) { // Retry a maximum of 4 times when nonsense rectangles are returned
1652 while (start
&& isExtendingChar(prepared
.line
.text
.charAt(mStart
+ start
))) --start
;
1653 while (mStart
+ end
< mEnd
&& isExtendingChar(prepared
.line
.text
.charAt(mStart
+ end
))) ++end
;
1654 if (ie
&& ie_version
< 9 && start
== 0 && end
== mEnd
- mStart
) {
1655 rect
= node
.parentNode
.getBoundingClientRect();
1656 } else if (ie
&& cm
.options
.lineWrapping
) {
1657 var rects
= range(node
, start
, end
).getClientRects();
1659 rect
= rects
[bias
== "right" ? rects
.length
- 1 : 0];
1663 rect
= range(node
, start
, end
).getBoundingClientRect() || nullRect
;
1665 if (rect
.left
|| rect
.right
|| start
== 0) break;
1670 if (ie
&& ie_version
< 11) rect
= maybeUpdateRectForZooming(cm
.display
.measure
, rect
);
1671 } else { // If it is a widget, simply get the box for the whole widget.
1672 if (start
> 0) collapse
= bias
= "right";
1674 if (cm
.options
.lineWrapping
&& (rects
= node
.getClientRects()).length
> 1)
1675 rect
= rects
[bias
== "right" ? rects
.length
- 1 : 0];
1677 rect
= node
.getBoundingClientRect();
1679 if (ie
&& ie_version
< 9 && !start
&& (!rect
|| !rect
.left
&& !rect
.right
)) {
1680 var rSpan
= node
.parentNode
.getClientRects()[0];
1682 rect
= {left
: rSpan
.left
, right
: rSpan
.left
+ charWidth(cm
.display
), top
: rSpan
.top
, bottom
: rSpan
.bottom
};
1687 var rtop
= rect
.top
- prepared
.rect
.top
, rbot
= rect
.bottom
- prepared
.rect
.top
;
1688 var mid
= (rtop
+ rbot
) / 2;
1689 var heights
= prepared
.view
.measure
.heights
;
1690 for (var i
= 0; i
< heights
.length
- 1; i
++)
1691 if (mid
< heights
[i
]) break;
1692 var top
= i
? heights
[i
- 1] : 0, bot
= heights
[i
];
1693 var result
= {left
: (collapse
== "right" ? rect
.right
: rect
.left
) - prepared
.rect
.left
,
1694 right
: (collapse
== "left" ? rect
.left
: rect
.right
) - prepared
.rect
.left
,
1695 top
: top
, bottom
: bot
};
1696 if (!rect
.left
&& !rect
.right
) result
.bogus
= true;
1697 if (!cm
.options
.singleCursorHeightPerLine
) { result
.rtop
= rtop
; result
.rbottom
= rbot
; }
1702 // Work around problem with bounding client rects on ranges being
1703 // returned incorrectly when zoomed on IE10 and below.
1704 function maybeUpdateRectForZooming(measure
, rect
) {
1705 if (!window
.screen
|| screen
.logicalXDPI
== null ||
1706 screen
.logicalXDPI
== screen
.deviceXDPI
|| !hasBadZoomedRects(measure
))
1708 var scaleX
= screen
.logicalXDPI
/ screen
.deviceXDPI
;
1709 var scaleY
= screen
.logicalYDPI
/ screen
.deviceYDPI
;
1710 return {left
: rect
.left
* scaleX
, right
: rect
.right
* scaleX
,
1711 top
: rect
.top
* scaleY
, bottom
: rect
.bottom
* scaleY
};
1714 function clearLineMeasurementCacheFor(lineView
) {
1715 if (lineView
.measure
) {
1716 lineView
.measure
.cache
= {};
1717 lineView
.measure
.heights
= null;
1718 if (lineView
.rest
) for (var i
= 0; i
< lineView
.rest
.length
; i
++)
1719 lineView
.measure
.caches
[i
] = {};
1723 function clearLineMeasurementCache(cm
) {
1724 cm
.display
.externalMeasure
= null;
1725 removeChildren(cm
.display
.lineMeasure
);
1726 for (var i
= 0; i
< cm
.display
.view
.length
; i
++)
1727 clearLineMeasurementCacheFor(cm
.display
.view
[i
]);
1730 function clearCaches(cm
) {
1731 clearLineMeasurementCache(cm
);
1732 cm
.display
.cachedCharWidth
= cm
.display
.cachedTextHeight
= cm
.display
.cachedPaddingH
= null;
1733 if (!cm
.options
.lineWrapping
) cm
.display
.maxLineChanged
= true;
1734 cm
.display
.lineNumChars
= null;
1737 function pageScrollX() { return window
.pageXOffset
|| (document
.documentElement
|| document
.body
).scrollLeft
; }
1738 function pageScrollY() { return window
.pageYOffset
|| (document
.documentElement
|| document
.body
).scrollTop
; }
1740 // Converts a {top, bottom, left, right} box from line-local
1741 // coordinates into another coordinate system. Context may be one of
1742 // "line", "div" (display.lineDiv), "local"/null (editor), or "page".
1743 function intoCoordSystem(cm
, lineObj
, rect
, context
) {
1744 if (lineObj
.widgets
) for (var i
= 0; i
< lineObj
.widgets
.length
; ++i
) if (lineObj
.widgets
[i
].above
) {
1745 var size
= widgetHeight(lineObj
.widgets
[i
]);
1746 rect
.top
+= size
; rect
.bottom
+= size
;
1748 if (context
== "line") return rect
;
1749 if (!context
) context
= "local";
1750 var yOff
= heightAtLine(lineObj
);
1751 if (context
== "local") yOff
+= paddingTop(cm
.display
);
1752 else yOff
-= cm
.display
.viewOffset
;
1753 if (context
== "page" || context
== "window") {
1754 var lOff
= cm
.display
.lineSpace
.getBoundingClientRect();
1755 yOff
+= lOff
.top
+ (context
== "window" ? 0 : pageScrollY());
1756 var xOff
= lOff
.left
+ (context
== "window" ? 0 : pageScrollX());
1757 rect
.left
+= xOff
; rect
.right
+= xOff
;
1759 rect
.top
+= yOff
; rect
.bottom
+= yOff
;
1763 // Coverts a box from "div" coords to another coordinate system.
1764 // Context may be "window", "page", "div", or "local"/null.
1765 function fromCoordSystem(cm
, coords
, context
) {
1766 if (context
== "div") return coords
;
1767 var left
= coords
.left
, top
= coords
.top
;
1768 // First move into "page" coordinate system
1769 if (context
== "page") {
1770 left
-= pageScrollX();
1771 top
-= pageScrollY();
1772 } else if (context
== "local" || !context
) {
1773 var localBox
= cm
.display
.sizer
.getBoundingClientRect();
1774 left
+= localBox
.left
;
1775 top
+= localBox
.top
;
1778 var lineSpaceBox
= cm
.display
.lineSpace
.getBoundingClientRect();
1779 return {left
: left
- lineSpaceBox
.left
, top
: top
- lineSpaceBox
.top
};
1782 function charCoords(cm
, pos
, context
, lineObj
, bias
) {
1783 if (!lineObj
) lineObj
= getLine(cm
.doc
, pos
.line
);
1784 return intoCoordSystem(cm
, lineObj
, measureChar(cm
, lineObj
, pos
.ch
, bias
), context
);
1787 // Returns a box for a given cursor position, which may have an
1788 // 'other' property containing the position of the secondary cursor
1789 // on a bidi boundary.
1790 function cursorCoords(cm
, pos
, context
, lineObj
, preparedMeasure
, varHeight
) {
1791 lineObj
= lineObj
|| getLine(cm
.doc
, pos
.line
);
1792 if (!preparedMeasure
) preparedMeasure
= prepareMeasureForLine(cm
, lineObj
);
1793 function get(ch
, right
) {
1794 var m
= measureCharPrepared(cm
, preparedMeasure
, ch
, right
? "right" : "left", varHeight
);
1795 if (right
) m
.left
= m
.right
; else m
.right
= m
.left
;
1796 return intoCoordSystem(cm
, lineObj
, m
, context
);
1798 function getBidi(ch
, partPos
) {
1799 var part
= order
[partPos
], right
= part
.level
% 2;
1800 if (ch
== bidiLeft(part
) && partPos
&& part
.level
< order
[partPos
- 1].level
) {
1801 part
= order
[--partPos
];
1802 ch
= bidiRight(part
) - (part
.level
% 2 ? 0 : 1);
1804 } else if (ch
== bidiRight(part
) && partPos
< order
.length
- 1 && part
.level
< order
[partPos
+ 1].level
) {
1805 part
= order
[++partPos
];
1806 ch
= bidiLeft(part
) - part
.level
% 2;
1809 if (right
&& ch
== part
.to
&& ch
> part
.from) return get(ch
- 1);
1810 return get(ch
, right
);
1812 var order
= getOrder(lineObj
), ch
= pos
.ch
;
1813 if (!order
) return get(ch
);
1814 var partPos
= getBidiPartAt(order
, ch
);
1815 var val
= getBidi(ch
, partPos
);
1816 if (bidiOther
!= null) val
.other
= getBidi(ch
, bidiOther
);
1820 // Used to cheaply estimate the coordinates for a position. Used for
1821 // intermediate scroll updates.
1822 function estimateCoords(cm
, pos
) {
1823 var left
= 0, pos
= clipPos(cm
.doc
, pos
);
1824 if (!cm
.options
.lineWrapping
) left
= charWidth(cm
.display
) * pos
.ch
;
1825 var lineObj
= getLine(cm
.doc
, pos
.line
);
1826 var top
= heightAtLine(lineObj
) + paddingTop(cm
.display
);
1827 return {left
: left
, right
: left
, top
: top
, bottom
: top
+ lineObj
.height
};
1830 // Positions returned by coordsChar contain some extra information.
1831 // xRel is the relative x position of the input coordinates compared
1832 // to the found position (so xRel > 0 means the coordinates are to
1833 // the right of the character position, for example). When outside
1834 // is true, that means the coordinates lie outside the line's
1836 function PosWithInfo(line
, ch
, outside
, xRel
) {
1837 var pos
= Pos(line
, ch
);
1839 if (outside
) pos
.outside
= true;
1843 // Compute the character position closest to the given coordinates.
1844 // Input must be lineSpace-local ("div" coordinate system).
1845 function coordsChar(cm
, x
, y
) {
1847 y
+= cm
.display
.viewOffset
;
1848 if (y
< 0) return PosWithInfo(doc
.first
, 0, true, -1);
1849 var lineN
= lineAtHeight(doc
, y
), last
= doc
.first
+ doc
.size
- 1;
1851 return PosWithInfo(doc
.first
+ doc
.size
- 1, getLine(doc
, last
).text
.length
, true, 1);
1854 var lineObj
= getLine(doc
, lineN
);
1856 var found
= coordsCharInner(cm
, lineObj
, lineN
, x
, y
);
1857 var merged
= collapsedSpanAtEnd(lineObj
);
1858 var mergedPos
= merged
&& merged
.find(0, true);
1859 if (merged
&& (found
.ch
> mergedPos
.from.ch
|| found
.ch
== mergedPos
.from.ch
&& found
.xRel
> 0))
1860 lineN
= lineNo(lineObj
= mergedPos
.to
.line
);
1866 function coordsCharInner(cm
, lineObj
, lineNo
, x
, y
) {
1867 var innerOff
= y
- heightAtLine(lineObj
);
1868 var wrongLine
= false, adjust
= 2 * cm
.display
.wrapper
.clientWidth
;
1869 var preparedMeasure
= prepareMeasureForLine(cm
, lineObj
);
1872 var sp
= cursorCoords(cm
, Pos(lineNo
, ch
), "line", lineObj
, preparedMeasure
);
1874 if (innerOff
> sp
.bottom
) return sp
.left
- adjust
;
1875 else if (innerOff
< sp
.top
) return sp
.left
+ adjust
;
1876 else wrongLine
= false;
1880 var bidi
= getOrder(lineObj
), dist
= lineObj
.text
.length
;
1881 var from = lineLeft(lineObj
), to
= lineRight(lineObj
);
1882 var fromX
= getX(from), fromOutside
= wrongLine
, toX
= getX(to
), toOutside
= wrongLine
;
1884 if (x
> toX
) return PosWithInfo(lineNo
, to
, toOutside
, 1);
1885 // Do a binary search between these bounds.
1887 if (bidi
? to
== from || to
== moveVisually(lineObj
, from, 1) : to
- from <= 1) {
1888 var ch
= x
< fromX
|| x
- fromX
<= toX
- x
? from : to
;
1889 var xDiff
= x
- (ch
== from ? fromX
: toX
);
1890 while (isExtendingChar(lineObj
.text
.charAt(ch
))) ++ch
;
1891 var pos
= PosWithInfo(lineNo
, ch
, ch
== from ? fromOutside
: toOutside
,
1892 xDiff
< -1 ? -1 : xDiff
> 1 ? 1 : 0);
1895 var step
= Math
.ceil(dist
/ 2), middle
= from + step
;
1898 for (var i
= 0; i
< step
; ++i
) middle
= moveVisually(lineObj
, middle
, 1);
1900 var middleX
= getX(middle
);
1901 if (middleX
> x
) {to
= middle
; toX
= middleX
; if (toOutside
= wrongLine
) toX
+= 1000; dist
= step
;}
1902 else {from = middle
; fromX
= middleX
; fromOutside
= wrongLine
; dist
-= step
;}
1907 // Compute the default text height.
1908 function textHeight(display
) {
1909 if (display
.cachedTextHeight
!= null) return display
.cachedTextHeight
;
1910 if (measureText
== null) {
1911 measureText
= elt("pre");
1912 // Measure a bunch of lines, for browsers that compute
1913 // fractional heights.
1914 for (var i
= 0; i
< 49; ++i
) {
1915 measureText
.appendChild(document
.createTextNode("x"));
1916 measureText
.appendChild(elt("br"));
1918 measureText
.appendChild(document
.createTextNode("x"));
1920 removeChildrenAndAdd(display
.measure
, measureText
);
1921 var height
= measureText
.offsetHeight
/ 50;
1922 if (height
> 3) display
.cachedTextHeight
= height
;
1923 removeChildren(display
.measure
);
1927 // Compute the default character width.
1928 function charWidth(display
) {
1929 if (display
.cachedCharWidth
!= null) return display
.cachedCharWidth
;
1930 var anchor
= elt("span", "xxxxxxxxxx");
1931 var pre
= elt("pre", [anchor
]);
1932 removeChildrenAndAdd(display
.measure
, pre
);
1933 var rect
= anchor
.getBoundingClientRect(), width
= (rect
.right
- rect
.left
) / 10;
1934 if (width
> 2) display
.cachedCharWidth
= width
;
1940 // Operations are used to wrap a series of changes to the editor
1941 // state in such a way that each change won't have to update the
1942 // cursor and display (which would be awkward, slow, and
1943 // error-prone). Instead, display updates are batched and then all
1944 // combined and executed at once.
1946 var operationGroup
= null;
1949 // Start a new operation.
1950 function startOperation(cm
) {
1953 viewChanged
: false, // Flag that indicates that lines might need to be redrawn
1954 startHeight
: cm
.doc
.height
, // Used to detect need to update scrollbar
1955 forceUpdate
: false, // Used to force a redraw
1956 updateInput
: null, // Whether to reset the input textarea
1957 typing
: false, // Whether this reset should be careful to leave existing text (for compositing)
1958 changeObjs
: null, // Accumulated changes, for firing change events
1959 cursorActivityHandlers
: null, // Set of handlers to fire cursorActivity on
1960 cursorActivityCalled
: 0, // Tracks which cursorActivity handlers have been called already
1961 selectionChanged
: false, // Whether the selection needs to be redrawn
1962 updateMaxLine
: false, // Set when the widest line needs to be determined anew
1963 scrollLeft
: null, scrollTop
: null, // Intermediate scroll position, not pushed to DOM yet
1964 scrollToPos
: null, // Used to scroll to a specific position
1965 id
: ++nextOpId
// Unique ID
1967 if (operationGroup
) {
1968 operationGroup
.ops
.push(cm
.curOp
);
1970 cm
.curOp
.ownsGroup
= operationGroup
= {
1972 delayedCallbacks
: []
1977 function fireCallbacksForOps(group
) {
1978 // Calls delayed callbacks and cursorActivity handlers until no
1980 var callbacks
= group
.delayedCallbacks
, i
= 0;
1982 for (; i
< callbacks
.length
; i
++)
1984 for (var j
= 0; j
< group
.ops
.length
; j
++) {
1985 var op
= group
.ops
[j
];
1986 if (op
.cursorActivityHandlers
)
1987 while (op
.cursorActivityCalled
< op
.cursorActivityHandlers
.length
)
1988 op
.cursorActivityHandlers
[op
.cursorActivityCalled
++](op
.cm
);
1990 } while (i
< callbacks
.length
);
1993 // Finish an operation, updating the display and signalling delayed events
1994 function endOperation(cm
) {
1995 var op
= cm
.curOp
, group
= op
.ownsGroup
;
1998 try { fireCallbacksForOps(group
); }
2000 operationGroup
= null;
2001 for (var i
= 0; i
< group
.ops
.length
; i
++)
2002 group
.ops
[i
].cm
.curOp
= null;
2003 endOperations(group
);
2007 // The DOM updates done when an operation finishes are batched so
2008 // that the minimum number of relayouts are required.
2009 function endOperations(group
) {
2010 var ops
= group
.ops
;
2011 for (var i
= 0; i
< ops
.length
; i
++) // Read DOM
2012 endOperation_R1(ops
[i
]);
2013 for (var i
= 0; i
< ops
.length
; i
++) // Write DOM (maybe)
2014 endOperation_W1(ops
[i
]);
2015 for (var i
= 0; i
< ops
.length
; i
++) // Read DOM
2016 endOperation_R2(ops
[i
]);
2017 for (var i
= 0; i
< ops
.length
; i
++) // Write DOM (maybe)
2018 endOperation_W2(ops
[i
]);
2019 for (var i
= 0; i
< ops
.length
; i
++) // Read DOM
2020 endOperation_finish(ops
[i
]);
2023 function endOperation_R1(op
) {
2024 var cm
= op
.cm
, display
= cm
.display
;
2025 if (op
.updateMaxLine
) findMaxLine(cm
);
2027 op
.mustUpdate
= op
.viewChanged
|| op
.forceUpdate
|| op
.scrollTop
!= null ||
2028 op
.scrollToPos
&& (op
.scrollToPos
.from.line
< display
.viewFrom
||
2029 op
.scrollToPos
.to
.line
>= display
.viewTo
) ||
2030 display
.maxLineChanged
&& cm
.options
.lineWrapping
;
2031 op
.update
= op
.mustUpdate
&&
2032 new DisplayUpdate(cm
, op
.mustUpdate
&& {top
: op
.scrollTop
, ensure
: op
.scrollToPos
}, op
.forceUpdate
);
2035 function endOperation_W1(op
) {
2036 op
.updatedDisplay
= op
.mustUpdate
&& updateDisplayIfNeeded(op
.cm
, op
.update
);
2039 function endOperation_R2(op
) {
2040 var cm
= op
.cm
, display
= cm
.display
;
2041 if (op
.updatedDisplay
) updateHeightsInViewport(cm
);
2043 op
.barMeasure
= measureForScrollbars(cm
);
2045 // If the max line changed since it was last measured, measure it,
2046 // and ensure the document's width matches it.
2047 // updateDisplay_W2 will use these properties to do the actual resizing
2048 if (display
.maxLineChanged
&& !cm
.options
.lineWrapping
) {
2049 op
.adjustWidthTo
= measureChar(cm
, display
.maxLine
, display
.maxLine
.text
.length
).left
+ 3;
2050 op
.maxScrollLeft
= Math
.max(0, display
.sizer
.offsetLeft
+ op
.adjustWidthTo
+
2051 scrollerCutOff
- display
.scroller
.clientWidth
);
2054 if (op
.updatedDisplay
|| op
.selectionChanged
)
2055 op
.newSelectionNodes
= drawSelection(cm
);
2058 function endOperation_W2(op
) {
2061 if (op
.adjustWidthTo
!= null) {
2062 cm
.display
.sizer
.style
.minWidth
= op
.adjustWidthTo
+ "px";
2063 if (op
.maxScrollLeft
< cm
.doc
.scrollLeft
)
2064 setScrollLeft(cm
, Math
.min(cm
.display
.scroller
.scrollLeft
, op
.maxScrollLeft
), true);
2065 cm
.display
.maxLineChanged
= false;
2068 if (op
.newSelectionNodes
)
2069 showSelection(cm
, op
.newSelectionNodes
);
2070 if (op
.updatedDisplay
)
2071 setDocumentHeight(cm
, op
.barMeasure
);
2072 if (op
.updatedDisplay
|| op
.startHeight
!= cm
.doc
.height
)
2073 updateScrollbars(cm
, op
.barMeasure
);
2075 if (op
.selectionChanged
) restartBlink(cm
);
2077 if (cm
.state
.focused
&& op
.updateInput
)
2078 resetInput(cm
, op
.typing
);
2081 function endOperation_finish(op
) {
2082 var cm
= op
.cm
, display
= cm
.display
, doc
= cm
.doc
;
2084 if (op
.adjustWidthTo
!= null && Math
.abs(op
.barMeasure
.scrollWidth
- cm
.display
.scroller
.scrollWidth
) > 1)
2085 updateScrollbars(cm
);
2087 if (op
.updatedDisplay
) postUpdateDisplay(cm
, op
.update
);
2089 // Abort mouse wheel delta measurement, when scrolling explicitly
2090 if (display
.wheelStartX
!= null && (op
.scrollTop
!= null || op
.scrollLeft
!= null || op
.scrollToPos
))
2091 display
.wheelStartX
= display
.wheelStartY
= null;
2093 // Propagate the scroll position to the actual DOM scroller
2094 if (op
.scrollTop
!= null && (display
.scroller
.scrollTop
!= op
.scrollTop
|| op
.forceScroll
)) {
2095 var top
= Math
.max(0, Math
.min(display
.scroller
.scrollHeight
- display
.scroller
.clientHeight
, op
.scrollTop
));
2096 display
.scroller
.scrollTop
= display
.scrollbarV
.scrollTop
= doc
.scrollTop
= top
;
2098 if (op
.scrollLeft
!= null && (display
.scroller
.scrollLeft
!= op
.scrollLeft
|| op
.forceScroll
)) {
2099 var left
= Math
.max(0, Math
.min(display
.scroller
.scrollWidth
- display
.scroller
.clientWidth
, op
.scrollLeft
));
2100 display
.scroller
.scrollLeft
= display
.scrollbarH
.scrollLeft
= doc
.scrollLeft
= left
;
2101 alignHorizontally(cm
);
2103 // If we need to scroll a specific position into view, do so.
2104 if (op
.scrollToPos
) {
2105 var coords
= scrollPosIntoView(cm
, clipPos(doc
, op
.scrollToPos
.from),
2106 clipPos(doc
, op
.scrollToPos
.to
), op
.scrollToPos
.margin
);
2107 if (op
.scrollToPos
.isCursor
&& cm
.state
.focused
) maybeScrollWindow(cm
, coords
);
2110 // Fire events for markers that are hidden/unidden by editing or
2112 var hidden
= op
.maybeHiddenMarkers
, unhidden
= op
.maybeUnhiddenMarkers
;
2113 if (hidden
) for (var i
= 0; i
< hidden
.length
; ++i
)
2114 if (!hidden
[i
].lines
.length
) signal(hidden
[i
], "hide");
2115 if (unhidden
) for (var i
= 0; i
< unhidden
.length
; ++i
)
2116 if (unhidden
[i
].lines
.length
) signal(unhidden
[i
], "unhide");
2118 if (display
.wrapper
.offsetHeight
)
2119 doc
.scrollTop
= cm
.display
.scroller
.scrollTop
;
2121 // Apply workaround for two webkit bugs
2122 if (op
.updatedDisplay
&& webkit
) {
2123 if (cm
.options
.lineWrapping
)
2124 checkForWebkitWidthBug(cm
, op
.barMeasure
); // (Issue #2420)
2125 if (op
.barMeasure
.scrollWidth
> op
.barMeasure
.clientWidth
&&
2126 op
.barMeasure
.scrollWidth
< op
.barMeasure
.clientWidth
+ 1 &&
2127 !hScrollbarTakesSpace(cm
))
2128 updateScrollbars(cm
); // (Issue #2562)
2131 // Fire change events, and delayed event handlers
2133 signal(cm
, "changes", cm
, op
.changeObjs
);
2136 // Run the given function in an operation
2137 function runInOp(cm
, f
) {
2138 if (cm
.curOp
) return f();
2141 finally { endOperation(cm
); }
2143 // Wraps a function in an operation. Returns the wrapped function.
2144 function operation(cm
, f
) {
2146 if (cm
.curOp
) return f
.apply(cm
, arguments
);
2148 try { return f
.apply(cm
, arguments
); }
2149 finally { endOperation(cm
); }
2152 // Used to add methods to editor and doc instances, wrapping them in
2154 function methodOp(f
) {
2156 if (this.curOp
) return f
.apply(this, arguments
);
2157 startOperation(this);
2158 try { return f
.apply(this, arguments
); }
2159 finally { endOperation(this); }
2162 function docMethodOp(f
) {
2165 if (!cm
|| cm
.curOp
) return f
.apply(this, arguments
);
2167 try { return f
.apply(this, arguments
); }
2168 finally { endOperation(cm
); }
2174 // These objects are used to represent the visible (currently drawn)
2175 // part of the document. A LineView may correspond to multiple
2176 // logical lines, if those are connected by collapsed ranges.
2177 function LineView(doc
, line
, lineN
) {
2178 // The starting line
2180 // Continuing lines, if any
2181 this.rest
= visualLineContinued(line
);
2182 // Number of logical lines in this visual line
2183 this.size
= this.rest
? lineNo(lst(this.rest
)) - lineN
+ 1 : 1;
2184 this.node
= this.text
= null;
2185 this.hidden
= lineIsHidden(doc
, line
);
2188 // Create a range of LineView objects for the given lines.
2189 function buildViewArray(cm
, from, to
) {
2190 var array
= [], nextPos
;
2191 for (var pos
= from; pos
< to
; pos
= nextPos
) {
2192 var view
= new LineView(cm
.doc
, getLine(cm
.doc
, pos
), pos
);
2193 nextPos
= pos
+ view
.size
;
2199 // Updates the display.view data structure for a given change to the
2200 // document. From and to are in pre-change coordinates. Lendiff is
2201 // the amount of lines added or subtracted by the change. This is
2202 // used for changes that span multiple lines, or change the way
2203 // lines are divided into visual lines. regLineChange (below)
2204 // registers single-line changes.
2205 function regChange(cm
, from, to
, lendiff
) {
2206 if (from == null) from = cm
.doc
.first
;
2207 if (to
== null) to
= cm
.doc
.first
+ cm
.doc
.size
;
2208 if (!lendiff
) lendiff
= 0;
2210 var display
= cm
.display
;
2211 if (lendiff
&& to
< display
.viewTo
&&
2212 (display
.updateLineNumbers
== null || display
.updateLineNumbers
> from))
2213 display
.updateLineNumbers
= from;
2215 cm
.curOp
.viewChanged
= true;
2217 if (from >= display
.viewTo
) { // Change after
2218 if (sawCollapsedSpans
&& visualLineNo(cm
.doc
, from) < display
.viewTo
)
2220 } else if (to
<= display
.viewFrom
) { // Change before
2221 if (sawCollapsedSpans
&& visualLineEndNo(cm
.doc
, to
+ lendiff
) > display
.viewFrom
) {
2224 display
.viewFrom
+= lendiff
;
2225 display
.viewTo
+= lendiff
;
2227 } else if (from <= display
.viewFrom
&& to
>= display
.viewTo
) { // Full overlap
2229 } else if (from <= display
.viewFrom
) { // Top overlap
2230 var cut
= viewCuttingPoint(cm
, to
, to
+ lendiff
, 1);
2232 display
.view
= display
.view
.slice(cut
.index
);
2233 display
.viewFrom
= cut
.lineN
;
2234 display
.viewTo
+= lendiff
;
2238 } else if (to
>= display
.viewTo
) { // Bottom overlap
2239 var cut
= viewCuttingPoint(cm
, from, from, -1);
2241 display
.view
= display
.view
.slice(0, cut
.index
);
2242 display
.viewTo
= cut
.lineN
;
2246 } else { // Gap in the middle
2247 var cutTop
= viewCuttingPoint(cm
, from, from, -1);
2248 var cutBot
= viewCuttingPoint(cm
, to
, to
+ lendiff
, 1);
2249 if (cutTop
&& cutBot
) {
2250 display
.view
= display
.view
.slice(0, cutTop
.index
)
2251 .concat(buildViewArray(cm
, cutTop
.lineN
, cutBot
.lineN
))
2252 .concat(display
.view
.slice(cutBot
.index
));
2253 display
.viewTo
+= lendiff
;
2259 var ext
= display
.externalMeasured
;
2262 ext
.lineN
+= lendiff
;
2263 else if (from < ext
.lineN
+ ext
.size
)
2264 display
.externalMeasured
= null;
2268 // Register a change to a single line. Type must be one of "text",
2269 // "gutter", "class", "widget"
2270 function regLineChange(cm
, line
, type
) {
2271 cm
.curOp
.viewChanged
= true;
2272 var display
= cm
.display
, ext
= cm
.display
.externalMeasured
;
2273 if (ext
&& line
>= ext
.lineN
&& line
< ext
.lineN
+ ext
.size
)
2274 display
.externalMeasured
= null;
2276 if (line
< display
.viewFrom
|| line
>= display
.viewTo
) return;
2277 var lineView
= display
.view
[findViewIndex(cm
, line
)];
2278 if (lineView
.node
== null) return;
2279 var arr
= lineView
.changes
|| (lineView
.changes
= []);
2280 if (indexOf(arr
, type
) == -1) arr
.push(type
);
2284 function resetView(cm
) {
2285 cm
.display
.viewFrom
= cm
.display
.viewTo
= cm
.doc
.first
;
2286 cm
.display
.view
= [];
2287 cm
.display
.viewOffset
= 0;
2290 // Find the view element corresponding to a given line. Return null
2291 // when the line isn't visible.
2292 function findViewIndex(cm
, n
) {
2293 if (n
>= cm
.display
.viewTo
) return null;
2294 n
-= cm
.display
.viewFrom
;
2295 if (n
< 0) return null;
2296 var view
= cm
.display
.view
;
2297 for (var i
= 0; i
< view
.length
; i
++) {
2299 if (n
< 0) return i
;
2303 function viewCuttingPoint(cm
, oldN
, newN
, dir
) {
2304 var index
= findViewIndex(cm
, oldN
), diff
, view
= cm
.display
.view
;
2305 if (!sawCollapsedSpans
|| newN
== cm
.doc
.first
+ cm
.doc
.size
)
2306 return {index
: index
, lineN
: newN
};
2307 for (var i
= 0, n
= cm
.display
.viewFrom
; i
< index
; i
++)
2311 if (index
== view
.length
- 1) return null;
2312 diff
= (n
+ view
[index
].size
) - oldN
;
2317 oldN
+= diff
; newN
+= diff
;
2319 while (visualLineNo(cm
.doc
, newN
) != newN
) {
2320 if (index
== (dir
< 0 ? 0 : view
.length
- 1)) return null;
2321 newN
+= dir
* view
[index
- (dir
< 0 ? 1 : 0)].size
;
2324 return {index
: index
, lineN
: newN
};
2327 // Force the view to cover a given range, adding empty view element
2328 // or clipping off existing ones as needed.
2329 function adjustView(cm
, from, to
) {
2330 var display
= cm
.display
, view
= display
.view
;
2331 if (view
.length
== 0 || from >= display
.viewTo
|| to
<= display
.viewFrom
) {
2332 display
.view
= buildViewArray(cm
, from, to
);
2333 display
.viewFrom
= from;
2335 if (display
.viewFrom
> from)
2336 display
.view
= buildViewArray(cm
, from, display
.viewFrom
).concat(display
.view
);
2337 else if (display
.viewFrom
< from)
2338 display
.view
= display
.view
.slice(findViewIndex(cm
, from));
2339 display
.viewFrom
= from;
2340 if (display
.viewTo
< to
)
2341 display
.view
= display
.view
.concat(buildViewArray(cm
, display
.viewTo
, to
));
2342 else if (display
.viewTo
> to
)
2343 display
.view
= display
.view
.slice(0, findViewIndex(cm
, to
));
2345 display
.viewTo
= to
;
2348 // Count the number of lines in the view whose DOM representation is
2349 // out of date (or nonexistent).
2350 function countDirtyView(cm
) {
2351 var view
= cm
.display
.view
, dirty
= 0;
2352 for (var i
= 0; i
< view
.length
; i
++) {
2353 var lineView
= view
[i
];
2354 if (!lineView
.hidden
&& (!lineView
.node
|| lineView
.changes
)) ++dirty
;
2361 // Poll for input changes, using the normal rate of polling. This
2362 // runs as long as the editor is focused.
2363 function slowPoll(cm
) {
2364 if (cm
.display
.pollingFast
) return;
2365 cm
.display
.poll
.set(cm
.options
.pollInterval
, function() {
2367 if (cm
.state
.focused
) slowPoll(cm
);
2371 // When an event has just come in that is likely to add or change
2372 // something in the input textarea, we poll faster, to ensure that
2373 // the change appears on the screen quickly.
2374 function fastPoll(cm
) {
2376 cm
.display
.pollingFast
= true;
2378 var changed
= readInput(cm
);
2379 if (!changed
&& !missed
) {missed
= true; cm
.display
.poll
.set(60, p
);}
2380 else {cm
.display
.pollingFast
= false; slowPoll(cm
);}
2382 cm
.display
.poll
.set(20, p
);
2385 // This will be set to an array of strings when copying, so that,
2386 // when pasting, we know what kind of selections the copied text
2388 var lastCopied
= null;
2390 // Read input from the textarea, and update the document to match.
2391 // When something is selected, it is present in the textarea, and
2392 // selected (unless it is huge, in which case a placeholder is
2393 // used). When nothing is selected, the cursor sits after previously
2394 // seen text (can be empty), which is stored in prevInput (we must
2395 // not reset the textarea when typing, because that breaks IME).
2396 function readInput(cm
) {
2397 var input
= cm
.display
.input
, prevInput
= cm
.display
.prevInput
, doc
= cm
.doc
;
2398 // Since this is called a *lot*, try to bail out as cheaply as
2399 // possible when it is clear that nothing happened. hasSelection
2400 // will be the case when there is a lot of text in the textarea,
2401 // in which case reading its value would be expensive.
2402 if (!cm
.state
.focused
|| (hasSelection(input
) && !prevInput
) || isReadOnly(cm
) || cm
.options
.disableInput
|| cm
.state
.keySeq
)
2404 // See paste handler for more on the fakedLastChar kludge
2405 if (cm
.state
.pasteIncoming
&& cm
.state
.fakedLastChar
) {
2406 input
.value
= input
.value
.substring(0, input
.value
.length
- 1);
2407 cm
.state
.fakedLastChar
= false;
2409 var text
= input
.value
;
2410 // If nothing changed, bail.
2411 if (text
== prevInput
&& !cm
.somethingSelected()) return false;
2412 // Work around nonsensical selection resetting in IE9/10, and
2413 // inexplicable appearance of private area unicode characters on
2414 // some key combos in Mac (#2689).
2415 if (ie
&& ie_version
>= 9 && cm
.display
.inputHasSelection
=== text
||
2416 mac
&& /[\uf700-\uf7ff]/.test(text
)) {
2421 var withOp
= !cm
.curOp
;
2422 if (withOp
) startOperation(cm
);
2423 cm
.display
.shift
= false;
2425 if (text
.charCodeAt(0) == 0x200b && doc
.sel
== cm
.display
.selForContextMenu
&& !prevInput
)
2426 prevInput
= "\u200b";
2427 // Find the part of the input that is actually new
2428 var same
= 0, l
= Math
.min(prevInput
.length
, text
.length
);
2429 while (same
< l
&& prevInput
.charCodeAt(same
) == text
.charCodeAt(same
)) ++same
;
2430 var inserted
= text
.slice(same
), textLines
= splitLines(inserted
);
2432 // When pasing N lines into N selections, insert one line per selection
2433 var multiPaste
= null;
2434 if (cm
.state
.pasteIncoming
&& doc
.sel
.ranges
.length
> 1) {
2435 if (lastCopied
&& lastCopied
.join("\n") == inserted
)
2436 multiPaste
= doc
.sel
.ranges
.length
% lastCopied
.length
== 0 && map(lastCopied
, splitLines
);
2437 else if (textLines
.length
== doc
.sel
.ranges
.length
)
2438 multiPaste
= map(textLines
, function(l
) { return [l
]; });
2441 // Normal behavior is to insert the new text into every selection
2442 for (var i
= doc
.sel
.ranges
.length
- 1; i
>= 0; i
--) {
2443 var range
= doc
.sel
.ranges
[i
];
2444 var from = range
.from(), to
= range
.to();
2446 if (same
< prevInput
.length
)
2447 from = Pos(from.line
, from.ch
- (prevInput
.length
- same
));
2449 else if (cm
.state
.overwrite
&& range
.empty() && !cm
.state
.pasteIncoming
)
2450 to
= Pos(to
.line
, Math
.min(getLine(doc
, to
.line
).text
.length
, to
.ch
+ lst(textLines
).length
));
2451 var updateInput
= cm
.curOp
.updateInput
;
2452 var changeEvent
= {from: from, to
: to
, text
: multiPaste
? multiPaste
[i
% multiPaste
.length
] : textLines
,
2453 origin
: cm
.state
.pasteIncoming
? "paste" : cm
.state
.cutIncoming
? "cut" : "+input"};
2454 makeChange(cm
.doc
, changeEvent
);
2455 signalLater(cm
, "inputRead", cm
, changeEvent
);
2456 // When an 'electric' character is inserted, immediately trigger a reindent
2457 if (inserted
&& !cm
.state
.pasteIncoming
&& cm
.options
.electricChars
&&
2458 cm
.options
.smartIndent
&& range
.head
.ch
< 100 &&
2459 (!i
|| doc
.sel
.ranges
[i
- 1].head
.line
!= range
.head
.line
)) {
2460 var mode
= cm
.getModeAt(range
.head
);
2461 var end
= changeEnd(changeEvent
);
2462 if (mode
.electricChars
) {
2463 for (var j
= 0; j
< mode
.electricChars
.length
; j
++)
2464 if (inserted
.indexOf(mode
.electricChars
.charAt(j
)) > -1) {
2465 indentLine(cm
, end
.line
, "smart");
2468 } else if (mode
.electricInput
) {
2469 if (mode
.electricInput
.test(getLine(doc
, end
.line
).text
.slice(0, end
.ch
)))
2470 indentLine(cm
, end
.line
, "smart");
2474 ensureCursorVisible(cm
);
2475 cm
.curOp
.updateInput
= updateInput
;
2476 cm
.curOp
.typing
= true;
2478 // Don't leave long text in the textarea, since it makes further polling slow
2479 if (text
.length
> 1000 || text
.indexOf("\n") > -1) input
.value
= cm
.display
.prevInput
= "";
2480 else cm
.display
.prevInput
= text
;
2481 if (withOp
) endOperation(cm
);
2482 cm
.state
.pasteIncoming
= cm
.state
.cutIncoming
= false;
2486 // Reset the input to correspond to the selection (or to be empty,
2487 // when not typing and nothing is selected)
2488 function resetInput(cm
, typing
) {
2489 var minimal
, selected
, doc
= cm
.doc
;
2490 if (cm
.somethingSelected()) {
2491 cm
.display
.prevInput
= "";
2492 var range
= doc
.sel
.primary();
2493 minimal
= hasCopyEvent
&&
2494 (range
.to().line
- range
.from().line
> 100 || (selected
= cm
.getSelection()).length
> 1000);
2495 var content
= minimal
? "-" : selected
|| cm
.getSelection();
2496 cm
.display
.input
.value
= content
;
2497 if (cm
.state
.focused
) selectInput(cm
.display
.input
);
2498 if (ie
&& ie_version
>= 9) cm
.display
.inputHasSelection
= content
;
2499 } else if (!typing
) {
2500 cm
.display
.prevInput
= cm
.display
.input
.value
= "";
2501 if (ie
&& ie_version
>= 9) cm
.display
.inputHasSelection
= null;
2503 cm
.display
.inaccurateSelection
= minimal
;
2506 function focusInput(cm
) {
2507 if (cm
.options
.readOnly
!= "nocursor" && (!mobile
|| activeElt() != cm
.display
.input
))
2508 cm
.display
.input
.focus();
2511 function ensureFocus(cm
) {
2512 if (!cm
.state
.focused
) { focusInput(cm
); onFocus(cm
); }
2515 function isReadOnly(cm
) {
2516 return cm
.options
.readOnly
|| cm
.doc
.cantEdit
;
2521 // Attach the necessary event handlers when initializing the editor
2522 function registerEventHandlers(cm
) {
2524 on(d
.scroller
, "mousedown", operation(cm
, onMouseDown
));
2525 // Older IE's will not fire a second mousedown for a double click
2526 if (ie
&& ie_version
< 11)
2527 on(d
.scroller
, "dblclick", operation(cm
, function(e
) {
2528 if (signalDOMEvent(cm
, e
)) return;
2529 var pos
= posFromMouse(cm
, e
);
2530 if (!pos
|| clickInGutter(cm
, e
) || eventInWidget(cm
.display
, e
)) return;
2531 e_preventDefault(e
);
2532 var word
= cm
.findWordAt(pos
);
2533 extendSelection(cm
.doc
, word
.anchor
, word
.head
);
2536 on(d
.scroller
, "dblclick", function(e
) { signalDOMEvent(cm
, e
) || e_preventDefault(e
); });
2537 // Prevent normal selection in the editor (we handle our own)
2538 on(d
.lineSpace
, "selectstart", function(e
) {
2539 if (!eventInWidget(d
, e
)) e_preventDefault(e
);
2541 // Some browsers fire contextmenu *after* opening the menu, at
2542 // which point we can't mess with it anymore. Context menu is
2543 // handled in onMouseDown for these browsers.
2544 if (!captureRightClick
) on(d
.scroller
, "contextmenu", function(e
) {onContextMenu(cm
, e
);});
2546 // Sync scrolling between fake scrollbars and real scrollable
2547 // area, ensure viewport is updated when scrolling.
2548 on(d
.scroller
, "scroll", function() {
2549 if (d
.scroller
.clientHeight
) {
2550 setScrollTop(cm
, d
.scroller
.scrollTop
);
2551 setScrollLeft(cm
, d
.scroller
.scrollLeft
, true);
2552 signal(cm
, "scroll", cm
);
2555 on(d
.scrollbarV
, "scroll", function() {
2556 if (d
.scroller
.clientHeight
) setScrollTop(cm
, d
.scrollbarV
.scrollTop
);
2558 on(d
.scrollbarH
, "scroll", function() {
2559 if (d
.scroller
.clientHeight
) setScrollLeft(cm
, d
.scrollbarH
.scrollLeft
);
2562 // Listen to wheel events in order to try and update the viewport on time.
2563 on(d
.scroller
, "mousewheel", function(e
){onScrollWheel(cm
, e
);});
2564 on(d
.scroller
, "DOMMouseScroll", function(e
){onScrollWheel(cm
, e
);});
2566 // Prevent clicks in the scrollbars from killing focus
2567 function reFocus() { if (cm
.state
.focused
) setTimeout(bind(focusInput
, cm
), 0); }
2568 on(d
.scrollbarH
, "mousedown", reFocus
);
2569 on(d
.scrollbarV
, "mousedown", reFocus
);
2570 // Prevent wrapper from ever scrolling
2571 on(d
.wrapper
, "scroll", function() { d
.wrapper
.scrollTop
= d
.wrapper
.scrollLeft
= 0; });
2573 on(d
.input
, "keyup", function(e
) { onKeyUp
.call(cm
, e
); });
2574 on(d
.input
, "input", function() {
2575 if (ie
&& ie_version
>= 9 && cm
.display
.inputHasSelection
) cm
.display
.inputHasSelection
= null;
2578 on(d
.input
, "keydown", operation(cm
, onKeyDown
));
2579 on(d
.input
, "keypress", operation(cm
, onKeyPress
));
2580 on(d
.input
, "focus", bind(onFocus
, cm
));
2581 on(d
.input
, "blur", bind(onBlur
, cm
));
2584 if (!signalDOMEvent(cm
, e
)) e_stop(e
);
2586 if (cm
.options
.dragDrop
) {
2587 on(d
.scroller
, "dragstart", function(e
){onDragStart(cm
, e
);});
2588 on(d
.scroller
, "dragenter", drag_
);
2589 on(d
.scroller
, "dragover", drag_
);
2590 on(d
.scroller
, "drop", operation(cm
, onDrop
));
2592 on(d
.scroller
, "paste", function(e
) {
2593 if (eventInWidget(d
, e
)) return;
2594 cm
.state
.pasteIncoming
= true;
2598 on(d
.input
, "paste", function() {
2599 // Workaround for webkit bug https://bugs.webkit.org/show_bug.cgi?id=90206
2600 // Add a char to the end of textarea before paste occur so that
2601 // selection doesn't span to the end of textarea.
2602 if (webkit
&& !cm
.state
.fakedLastChar
&& !(new Date
- cm
.state
.lastMiddleDown
< 200)) {
2603 var start
= d
.input
.selectionStart
, end
= d
.input
.selectionEnd
;
2604 d
.input
.value
+= "$";
2605 // The selection end needs to be set before the start, otherwise there
2606 // can be an intermediate non-empty selection between the two, which
2607 // can override the middle-click paste buffer on linux and cause the
2608 // wrong thing to get pasted.
2609 d
.input
.selectionEnd
= end
;
2610 d
.input
.selectionStart
= start
;
2611 cm
.state
.fakedLastChar
= true;
2613 cm
.state
.pasteIncoming
= true;
2617 function prepareCopyCut(e
) {
2618 if (cm
.somethingSelected()) {
2619 lastCopied
= cm
.getSelections();
2620 if (d
.inaccurateSelection
) {
2622 d
.inaccurateSelection
= false;
2623 d
.input
.value
= lastCopied
.join("\n");
2624 selectInput(d
.input
);
2627 var text
= [], ranges
= [];
2628 for (var i
= 0; i
< cm
.doc
.sel
.ranges
.length
; i
++) {
2629 var line
= cm
.doc
.sel
.ranges
[i
].head
.line
;
2630 var lineRange
= {anchor
: Pos(line
, 0), head
: Pos(line
+ 1, 0)};
2631 ranges
.push(lineRange
);
2632 text
.push(cm
.getRange(lineRange
.anchor
, lineRange
.head
));
2634 if (e
.type
== "cut") {
2635 cm
.setSelections(ranges
, null, sel_dontScroll
);
2638 d
.input
.value
= text
.join("\n");
2639 selectInput(d
.input
);
2643 if (e
.type
== "cut") cm
.state
.cutIncoming
= true;
2645 on(d
.input
, "cut", prepareCopyCut
);
2646 on(d
.input
, "copy", prepareCopyCut
);
2648 // Needed to handle Tab key in KHTML
2649 if (khtml
) on(d
.sizer
, "mouseup", function() {
2650 if (activeElt() == d
.input
) d
.input
.blur();
2655 // Called when the window resizes
2656 function onResize(cm
) {
2658 if (d
.lastWrapHeight
== d
.wrapper
.clientHeight
&& d
.lastWrapWidth
== d
.wrapper
.clientWidth
)
2660 // Might be a text scaling operation, clear size caches.
2661 d
.cachedCharWidth
= d
.cachedTextHeight
= d
.cachedPaddingH
= null;
2667 // Return true when the given mouse event happened in a widget
2668 function eventInWidget(display
, e
) {
2669 for (var n
= e_target(e
); n
!= display
.wrapper
; n
= n
.parentNode
) {
2670 if (!n
|| n
.ignoreEvents
|| n
.parentNode
== display
.sizer
&& n
!= display
.mover
) return true;
2674 // Given a mouse event, find the corresponding position. If liberal
2675 // is false, it checks whether a gutter or scrollbar was clicked,
2676 // and returns null if it was. forRect is used by rectangular
2677 // selections, and tries to estimate a character position even for
2678 // coordinates beyond the right of the text.
2679 function posFromMouse(cm
, e
, liberal
, forRect
) {
2680 var display
= cm
.display
;
2682 var target
= e_target(e
);
2683 if (target
== display
.scrollbarH
|| target
== display
.scrollbarV
||
2684 target
== display
.scrollbarFiller
|| target
== display
.gutterFiller
) return null;
2686 var x
, y
, space
= display
.lineSpace
.getBoundingClientRect();
2687 // Fails unpredictably on IE[67] when mouse is dragged around quickly.
2688 try { x
= e
.clientX
- space
.left
; y
= e
.clientY
- space
.top
; }
2689 catch (e
) { return null; }
2690 var coords
= coordsChar(cm
, x
, y
), line
;
2691 if (forRect
&& coords
.xRel
== 1 && (line
= getLine(cm
.doc
, coords
.line
).text
).length
== coords
.ch
) {
2692 var colDiff
= countColumn(line
, line
.length
, cm
.options
.tabSize
) - line
.length
;
2693 coords
= Pos(coords
.line
, Math
.max(0, Math
.round((x
- paddingH(cm
.display
).left
) / charWidth(cm
.display
)) - colDiff
));
2698 // A mouse down can be a single click, double click, triple click,
2699 // start of selection drag, start of text drag, new cursor
2700 // (ctrl-click), rectangle drag (alt-drag), or xwin
2701 // middle-click-paste. Or it might be a click on something we should
2702 // not interfere with, such as a scrollbar or widget.
2703 function onMouseDown(e
) {
2704 if (signalDOMEvent(this, e
)) return;
2705 var cm
= this, display
= cm
.display
;
2706 display
.shift
= e
.shiftKey
;
2708 if (eventInWidget(display
, e
)) {
2710 // Briefly turn off draggability, to allow widgets to do
2711 // normal dragging things.
2712 display
.scroller
.draggable
= false;
2713 setTimeout(function(){display
.scroller
.draggable
= true;}, 100);
2717 if (clickInGutter(cm
, e
)) return;
2718 var start
= posFromMouse(cm
, e
);
2721 switch (e_button(e
)) {
2724 leftButtonDown(cm
, e
, start
);
2725 else if (e_target(e
) == display
.scroller
)
2726 e_preventDefault(e
);
2729 if (webkit
) cm
.state
.lastMiddleDown
= +new Date
;
2730 if (start
) extendSelection(cm
.doc
, start
);
2731 setTimeout(bind(focusInput
, cm
), 20);
2732 e_preventDefault(e
);
2735 if (captureRightClick
) onContextMenu(cm
, e
);
2740 var lastClick
, lastDoubleClick
;
2741 function leftButtonDown(cm
, e
, start
) {
2742 setTimeout(bind(ensureFocus
, cm
), 0);
2744 var now
= +new Date
, type
;
2745 if (lastDoubleClick
&& lastDoubleClick
.time
> now
- 400 && cmp(lastDoubleClick
.pos
, start
) == 0) {
2747 } else if (lastClick
&& lastClick
.time
> now
- 400 && cmp(lastClick
.pos
, start
) == 0) {
2749 lastDoubleClick
= {time
: now
, pos
: start
};
2752 lastClick
= {time
: now
, pos
: start
};
2755 var sel
= cm
.doc
.sel
, modifier
= mac
? e
.metaKey
: e
.ctrlKey
;
2756 if (cm
.options
.dragDrop
&& dragAndDrop
&& !isReadOnly(cm
) &&
2757 type
== "single" && sel
.contains(start
) > -1 && sel
.somethingSelected())
2758 leftButtonStartDrag(cm
, e
, start
, modifier
);
2760 leftButtonSelect(cm
, e
, start
, type
, modifier
);
2763 // Start a text drag. When it ends, see if any dragging actually
2764 // happen, and treat as a click if it didn't.
2765 function leftButtonStartDrag(cm
, e
, start
, modifier
) {
2766 var display
= cm
.display
;
2767 var dragEnd
= operation(cm
, function(e2
) {
2768 if (webkit
) display
.scroller
.draggable
= false;
2769 cm
.state
.draggingText
= false;
2770 off(document
, "mouseup", dragEnd
);
2771 off(display
.scroller
, "drop", dragEnd
);
2772 if (Math
.abs(e
.clientX
- e2
.clientX
) + Math
.abs(e
.clientY
- e2
.clientY
) < 10) {
2773 e_preventDefault(e2
);
2775 extendSelection(cm
.doc
, start
);
2777 // Work around unexplainable focus problem in IE9 (#2127)
2778 if (ie
&& ie_version
== 9)
2779 setTimeout(function() {document
.body
.focus(); focusInput(cm
);}, 20);
2782 // Let the drag handler handle this.
2783 if (webkit
) display
.scroller
.draggable
= true;
2784 cm
.state
.draggingText
= dragEnd
;
2785 // IE's approach to draggable
2786 if (display
.scroller
.dragDrop
) display
.scroller
.dragDrop();
2787 on(document
, "mouseup", dragEnd
);
2788 on(display
.scroller
, "drop", dragEnd
);
2791 // Normal selection, as opposed to text dragging.
2792 function leftButtonSelect(cm
, e
, start
, type
, addNew
) {
2793 var display
= cm
.display
, doc
= cm
.doc
;
2794 e_preventDefault(e
);
2796 var ourRange
, ourIndex
, startSel
= doc
.sel
;
2797 if (addNew
&& !e
.shiftKey
) {
2798 ourIndex
= doc
.sel
.contains(start
);
2800 ourRange
= doc
.sel
.ranges
[ourIndex
];
2802 ourRange
= new Range(start
, start
);
2804 ourRange
= doc
.sel
.primary();
2809 if (!addNew
) ourRange
= new Range(start
, start
);
2810 start
= posFromMouse(cm
, e
, true, true);
2812 } else if (type
== "double") {
2813 var word
= cm
.findWordAt(start
);
2814 if (cm
.display
.shift
|| doc
.extend
)
2815 ourRange
= extendRange(doc
, ourRange
, word
.anchor
, word
.head
);
2818 } else if (type
== "triple") {
2819 var line
= new Range(Pos(start
.line
, 0), clipPos(doc
, Pos(start
.line
+ 1, 0)));
2820 if (cm
.display
.shift
|| doc
.extend
)
2821 ourRange
= extendRange(doc
, ourRange
, line
.anchor
, line
.head
);
2825 ourRange
= extendRange(doc
, ourRange
, start
);
2830 setSelection(doc
, new Selection([ourRange
], 0), sel_mouse
);
2832 } else if (ourIndex
> -1) {
2833 replaceOneSelection(doc
, ourIndex
, ourRange
, sel_mouse
);
2835 ourIndex
= doc
.sel
.ranges
.length
;
2836 setSelection(doc
, normalizeSelection(doc
.sel
.ranges
.concat([ourRange
]), ourIndex
),
2837 {scroll
: false, origin
: "*mouse"});
2840 var lastPos
= start
;
2841 function extendTo(pos
) {
2842 if (cmp(lastPos
, pos
) == 0) return;
2845 if (type
== "rect") {
2846 var ranges
= [], tabSize
= cm
.options
.tabSize
;
2847 var startCol
= countColumn(getLine(doc
, start
.line
).text
, start
.ch
, tabSize
);
2848 var posCol
= countColumn(getLine(doc
, pos
.line
).text
, pos
.ch
, tabSize
);
2849 var left
= Math
.min(startCol
, posCol
), right
= Math
.max(startCol
, posCol
);
2850 for (var line
= Math
.min(start
.line
, pos
.line
), end
= Math
.min(cm
.lastLine(), Math
.max(start
.line
, pos
.line
));
2851 line
<= end
; line
++) {
2852 var text
= getLine(doc
, line
).text
, leftPos
= findColumn(text
, left
, tabSize
);
2854 ranges
.push(new Range(Pos(line
, leftPos
), Pos(line
, leftPos
)));
2855 else if (text
.length
> leftPos
)
2856 ranges
.push(new Range(Pos(line
, leftPos
), Pos(line
, findColumn(text
, right
, tabSize
))));
2858 if (!ranges
.length
) ranges
.push(new Range(start
, start
));
2859 setSelection(doc
, normalizeSelection(startSel
.ranges
.slice(0, ourIndex
).concat(ranges
), ourIndex
),
2860 {origin
: "*mouse", scroll
: false});
2861 cm
.scrollIntoView(pos
);
2863 var oldRange
= ourRange
;
2864 var anchor
= oldRange
.anchor
, head
= pos
;
2865 if (type
!= "single") {
2866 if (type
== "double")
2867 var range
= cm
.findWordAt(pos
);
2869 var range
= new Range(Pos(pos
.line
, 0), clipPos(doc
, Pos(pos
.line
+ 1, 0)));
2870 if (cmp(range
.anchor
, anchor
) > 0) {
2872 anchor
= minPos(oldRange
.from(), range
.anchor
);
2874 head
= range
.anchor
;
2875 anchor
= maxPos(oldRange
.to(), range
.head
);
2878 var ranges
= startSel
.ranges
.slice(0);
2879 ranges
[ourIndex
] = new Range(clipPos(doc
, anchor
), head
);
2880 setSelection(doc
, normalizeSelection(ranges
, ourIndex
), sel_mouse
);
2884 var editorSize
= display
.wrapper
.getBoundingClientRect();
2885 // Used to ensure timeout re-tries don't fire when another extend
2886 // happened in the meantime (clearTimeout isn't reliable -- at
2887 // least on Chrome, the timeouts still happen even when cleared,
2888 // if the clear happens after their scheduled firing time).
2891 function extend(e
) {
2892 var curCount
= ++counter
;
2893 var cur
= posFromMouse(cm
, e
, true, type
== "rect");
2895 if (cmp(cur
, lastPos
) != 0) {
2898 var visible
= visibleLines(display
, doc
);
2899 if (cur
.line
>= visible
.to
|| cur
.line
< visible
.from)
2900 setTimeout(operation(cm
, function(){if (counter
== curCount
) extend(e
);}), 150);
2902 var outside
= e
.clientY
< editorSize
.top
? -20 : e
.clientY
> editorSize
.bottom
? 20 : 0;
2903 if (outside
) setTimeout(operation(cm
, function() {
2904 if (counter
!= curCount
) return;
2905 display
.scroller
.scrollTop
+= outside
;
2913 e_preventDefault(e
);
2915 off(document
, "mousemove", move);
2916 off(document
, "mouseup", up
);
2917 doc
.history
.lastSelOrigin
= null;
2920 var move = operation(cm
, function(e
) {
2921 if (!e_button(e
)) done(e
);
2924 var up
= operation(cm
, done
);
2925 on(document
, "mousemove", move);
2926 on(document
, "mouseup", up
);
2929 // Determines whether an event happened in the gutter, and fires the
2930 // handlers for the corresponding event.
2931 function gutterEvent(cm
, e
, type
, prevent
, signalfn
) {
2932 try { var mX
= e
.clientX
, mY
= e
.clientY
; }
2933 catch(e
) { return false; }
2934 if (mX
>= Math
.floor(cm
.display
.gutters
.getBoundingClientRect().right
)) return false;
2935 if (prevent
) e_preventDefault(e
);
2937 var display
= cm
.display
;
2938 var lineBox
= display
.lineDiv
.getBoundingClientRect();
2940 if (mY
> lineBox
.bottom
|| !hasHandler(cm
, type
)) return e_defaultPrevented(e
);
2941 mY
-= lineBox
.top
- display
.viewOffset
;
2943 for (var i
= 0; i
< cm
.options
.gutters
.length
; ++i
) {
2944 var g
= display
.gutters
.childNodes
[i
];
2945 if (g
&& g
.getBoundingClientRect().right
>= mX
) {
2946 var line
= lineAtHeight(cm
.doc
, mY
);
2947 var gutter
= cm
.options
.gutters
[i
];
2948 signalfn(cm
, type
, cm
, line
, gutter
, e
);
2949 return e_defaultPrevented(e
);
2954 function clickInGutter(cm
, e
) {
2955 return gutterEvent(cm
, e
, "gutterClick", true, signalLater
);
2958 // Kludge to work around strange IE behavior where it'll sometimes
2959 // re-fire a series of drag-related events right after the drop (#1551)
2962 function onDrop(e
) {
2964 if (signalDOMEvent(cm
, e
) || eventInWidget(cm
.display
, e
))
2966 e_preventDefault(e
);
2967 if (ie
) lastDrop
= +new Date
;
2968 var pos
= posFromMouse(cm
, e
, true), files
= e
.dataTransfer
.files
;
2969 if (!pos
|| isReadOnly(cm
)) return;
2970 // Might be a file drop, in which case we simply extract the text
2972 if (files
&& files
.length
&& window
.FileReader
&& window
.File
) {
2973 var n
= files
.length
, text
= Array(n
), read
= 0;
2974 var loadFile = function(file
, i
) {
2975 var reader
= new FileReader
;
2976 reader
.onload
= operation(cm
, function() {
2977 text
[i
] = reader
.result
;
2979 pos
= clipPos(cm
.doc
, pos
);
2980 var change
= {from: pos
, to
: pos
, text
: splitLines(text
.join("\n")), origin
: "paste"};
2981 makeChange(cm
.doc
, change
);
2982 setSelectionReplaceHistory(cm
.doc
, simpleSelection(pos
, changeEnd(change
)));
2985 reader
.readAsText(file
);
2987 for (var i
= 0; i
< n
; ++i
) loadFile(files
[i
], i
);
2988 } else { // Normal drop
2989 // Don't do a replace if the drop happened inside of the selected text.
2990 if (cm
.state
.draggingText
&& cm
.doc
.sel
.contains(pos
) > -1) {
2991 cm
.state
.draggingText(e
);
2992 // Ensure the editor is re-focused
2993 setTimeout(bind(focusInput
, cm
), 20);
2997 var text
= e
.dataTransfer
.getData("Text");
2999 if (cm
.state
.draggingText
&& !(mac
? e
.metaKey
: e
.ctrlKey
))
3000 var selected
= cm
.listSelections();
3001 setSelectionNoUndo(cm
.doc
, simpleSelection(pos
, pos
));
3002 if (selected
) for (var i
= 0; i
< selected
.length
; ++i
)
3003 replaceRange(cm
.doc
, "", selected
[i
].anchor
, selected
[i
].head
, "drag");
3004 cm
.replaceSelection(text
, "around", "paste");
3012 function onDragStart(cm
, e
) {
3013 if (ie
&& (!cm
.state
.draggingText
|| +new Date
- lastDrop
< 100)) { e_stop(e
); return; }
3014 if (signalDOMEvent(cm
, e
) || eventInWidget(cm
.display
, e
)) return;
3016 e
.dataTransfer
.setData("Text", cm
.getSelection());
3018 // Use dummy image instead of default browsers image.
3019 // Recent Safari (~6.0.2) have a tendency to segfault when this happens, so we don't do it there.
3020 if (e
.dataTransfer
.setDragImage
&& !safari
) {
3021 var img
= elt("img", null, null, "position: fixed; left: 0; top: 0;");
3022 img
.src
= "data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==";
3024 img
.width
= img
.height
= 1;
3025 cm
.display
.wrapper
.appendChild(img
);
3026 // Force a relayout, or Opera won't use our image for some obscure reason
3027 img
._top
= img
.offsetTop
;
3029 e
.dataTransfer
.setDragImage(img
, 0, 0);
3030 if (presto
) img
.parentNode
.removeChild(img
);
3036 // Sync the scrollable area and scrollbars, ensure the viewport
3037 // covers the visible area.
3038 function setScrollTop(cm
, val
) {
3039 if (Math
.abs(cm
.doc
.scrollTop
- val
) < 2) return;
3040 cm
.doc
.scrollTop
= val
;
3041 if (!gecko
) updateDisplaySimple(cm
, {top
: val
});
3042 if (cm
.display
.scroller
.scrollTop
!= val
) cm
.display
.scroller
.scrollTop
= val
;
3043 if (cm
.display
.scrollbarV
.scrollTop
!= val
) cm
.display
.scrollbarV
.scrollTop
= val
;
3044 if (gecko
) updateDisplaySimple(cm
);
3045 startWorker(cm
, 100);
3047 // Sync scroller and scrollbar, ensure the gutter elements are
3049 function setScrollLeft(cm
, val
, isScroller
) {
3050 if (isScroller
? val
== cm
.doc
.scrollLeft
: Math
.abs(cm
.doc
.scrollLeft
- val
) < 2) return;
3051 val
= Math
.min(val
, cm
.display
.scroller
.scrollWidth
- cm
.display
.scroller
.clientWidth
);
3052 cm
.doc
.scrollLeft
= val
;
3053 alignHorizontally(cm
);
3054 if (cm
.display
.scroller
.scrollLeft
!= val
) cm
.display
.scroller
.scrollLeft
= val
;
3055 if (cm
.display
.scrollbarH
.scrollLeft
!= val
) cm
.display
.scrollbarH
.scrollLeft
= val
;
3058 // Since the delta values reported on mouse wheel events are
3059 // unstandardized between browsers and even browser versions, and
3060 // generally horribly unpredictable, this code starts by measuring
3061 // the scroll effect that the first few mouse wheel events have,
3062 // and, from that, detects the way it can convert deltas to pixel
3063 // offsets afterwards.
3065 // The reason we want to know the amount a wheel event will scroll
3066 // is that it gives us a chance to update the display before the
3067 // actual scrolling happens, reducing flickering.
3069 var wheelSamples
= 0, wheelPixelsPerUnit
= null;
3070 // Fill in a browser-detected starting value on browsers where we
3071 // know one. These don't have to be accurate -- the result of them
3072 // being wrong would just be a slight flicker on the first wheel
3073 // scroll (if it is large enough).
3074 if (ie
) wheelPixelsPerUnit
= -.53;
3075 else if (gecko
) wheelPixelsPerUnit
= 15;
3076 else if (chrome
) wheelPixelsPerUnit
= -.7;
3077 else if (safari
) wheelPixelsPerUnit
= -1/3;
3079 function onScrollWheel(cm
, e
) {
3080 var dx
= e
.wheelDeltaX
, dy
= e
.wheelDeltaY
;
3081 if (dx
== null && e
.detail
&& e
.axis
== e
.HORIZONTAL_AXIS
) dx
= e
.detail
;
3082 if (dy
== null && e
.detail
&& e
.axis
== e
.VERTICAL_AXIS
) dy
= e
.detail
;
3083 else if (dy
== null) dy
= e
.wheelDelta
;
3085 var display
= cm
.display
, scroll
= display
.scroller
;
3086 // Quit if there's nothing to scroll here
3087 if (!(dx
&& scroll
.scrollWidth
> scroll
.clientWidth
||
3088 dy
&& scroll
.scrollHeight
> scroll
.clientHeight
)) return;
3090 // Webkit browsers on OS X abort momentum scrolls when the target
3091 // of the scroll event is removed from the scrollable element.
3092 // This hack (see related code in patchDisplay) makes sure the
3093 // element is kept around.
3094 if (dy
&& mac
&& webkit
) {
3095 outer
: for (var cur
= e
.target
, view
= display
.view
; cur
!= scroll
; cur
= cur
.parentNode
) {
3096 for (var i
= 0; i
< view
.length
; i
++) {
3097 if (view
[i
].node
== cur
) {
3098 cm
.display
.currentWheelTarget
= cur
;
3105 // On some browsers, horizontal scrolling will cause redraws to
3106 // happen before the gutter has been realigned, causing it to
3107 // wriggle around in a most unseemly way. When we have an
3108 // estimated pixels/delta value, we just handle horizontal
3109 // scrolling entirely here. It'll be slightly off from native, but
3110 // better than glitching out.
3111 if (dx
&& !gecko
&& !presto
&& wheelPixelsPerUnit
!= null) {
3113 setScrollTop(cm
, Math
.max(0, Math
.min(scroll
.scrollTop
+ dy
* wheelPixelsPerUnit
, scroll
.scrollHeight
- scroll
.clientHeight
)));
3114 setScrollLeft(cm
, Math
.max(0, Math
.min(scroll
.scrollLeft
+ dx
* wheelPixelsPerUnit
, scroll
.scrollWidth
- scroll
.clientWidth
)));
3115 e_preventDefault(e
);
3116 display
.wheelStartX
= null; // Abort measurement, if in progress
3120 // 'Project' the visible viewport to cover the area that is being
3121 // scrolled into view (if we know enough to estimate it).
3122 if (dy
&& wheelPixelsPerUnit
!= null) {
3123 var pixels
= dy
* wheelPixelsPerUnit
;
3124 var top
= cm
.doc
.scrollTop
, bot
= top
+ display
.wrapper
.clientHeight
;
3125 if (pixels
< 0) top
= Math
.max(0, top
+ pixels
- 50);
3126 else bot
= Math
.min(cm
.doc
.height
, bot
+ pixels
+ 50);
3127 updateDisplaySimple(cm
, {top
: top
, bottom
: bot
});
3130 if (wheelSamples
< 20) {
3131 if (display
.wheelStartX
== null) {
3132 display
.wheelStartX
= scroll
.scrollLeft
; display
.wheelStartY
= scroll
.scrollTop
;
3133 display
.wheelDX
= dx
; display
.wheelDY
= dy
;
3134 setTimeout(function() {
3135 if (display
.wheelStartX
== null) return;
3136 var movedX
= scroll
.scrollLeft
- display
.wheelStartX
;
3137 var movedY
= scroll
.scrollTop
- display
.wheelStartY
;
3138 var sample
= (movedY
&& display
.wheelDY
&& movedY
/ display
.wheelDY
) ||
3139 (movedX
&& display
.wheelDX
&& movedX
/ display
.wheelDX
);
3140 display
.wheelStartX
= display
.wheelStartY
= null;
3141 if (!sample
) return;
3142 wheelPixelsPerUnit
= (wheelPixelsPerUnit
* wheelSamples
+ sample
) / (wheelSamples
+ 1);
3146 display
.wheelDX
+= dx
; display
.wheelDY
+= dy
;
3153 // Run a handler that was bound to a key.
3154 function doHandleBinding(cm
, bound
, dropShift
) {
3155 if (typeof bound
== "string") {
3156 bound
= commands
[bound
];
3157 if (!bound
) return false;
3159 // Ensure previous input has been read, so that the handler sees a
3160 // consistent view of the document
3161 if (cm
.display
.pollingFast
&& readInput(cm
)) cm
.display
.pollingFast
= false;
3162 var prevShift
= cm
.display
.shift
, done
= false;
3164 if (isReadOnly(cm
)) cm
.state
.suppressEdits
= true;
3165 if (dropShift
) cm
.display
.shift
= false;
3166 done
= bound(cm
) != Pass
;
3168 cm
.display
.shift
= prevShift
;
3169 cm
.state
.suppressEdits
= false;
3174 function lookupKeyForEditor(cm
, name
, handle
) {
3175 for (var i
= 0; i
< cm
.state
.keyMaps
.length
; i
++) {
3176 var result
= lookupKey(name
, cm
.state
.keyMaps
[i
], handle
);
3177 if (result
) return result
;
3179 return (cm
.options
.extraKeys
&& lookupKey(name
, cm
.options
.extraKeys
, handle
))
3180 || lookupKey(name
, cm
.options
.keyMap
, handle
);
3183 var stopSeq
= new Delayed
;
3184 function dispatchKey(cm
, name
, e
, handle
) {
3185 var seq
= cm
.state
.keySeq
;
3187 if (isModifierKey(name
)) return "handled";
3188 stopSeq
.set(50, function() {
3189 if (cm
.state
.keySeq
== seq
) {
3190 cm
.state
.keySeq
= null;
3194 name
= seq
+ " " + name
;
3196 var result
= lookupKeyForEditor(cm
, name
, handle
);
3198 if (result
== "multi")
3199 cm
.state
.keySeq
= name
;
3200 if (result
== "handled")
3201 signalLater(cm
, "keyHandled", cm
, name
, e
);
3203 if (result
== "handled" || result
== "multi") {
3204 e_preventDefault(e
);
3208 if (seq
&& !result
&& /\'$/.test(name
)) {
3209 e_preventDefault(e
);
3215 // Handle a key from the keydown event.
3216 function handleKeyBinding(cm
, e
) {
3217 var name
= keyName(e
, true);
3218 if (!name
) return false;
3220 if (e
.shiftKey
&& !cm
.state
.keySeq
) {
3221 // First try to resolve full name (including 'Shift-'). Failing
3222 // that, see if there is a cursor-motion command (starting with
3223 // 'go') bound to the keyname without 'Shift-'.
3224 return dispatchKey(cm
, "Shift-" + name
, e
, function(b
) {return doHandleBinding(cm
, b
, true);})
3225 || dispatchKey(cm
, name
, e
, function(b
) {
3226 if (typeof b
== "string" ? /^go[A-Z]/.test(b
) : b
.motion
)
3227 return doHandleBinding(cm
, b
);
3230 return dispatchKey(cm
, name
, e
, function(b
) { return doHandleBinding(cm
, b
); });
3234 // Handle a key from the keypress event
3235 function handleCharBinding(cm
, e
, ch
) {
3236 return dispatchKey(cm
, "'" + ch
+ "'", e
,
3237 function(b
) { return doHandleBinding(cm
, b
, true); });
3240 var lastStoppedKey
= null;
3241 function onKeyDown(e
) {
3244 if (signalDOMEvent(cm
, e
)) return;
3245 // IE does strange things with escape.
3246 if (ie
&& ie_version
< 11 && e
.keyCode
== 27) e
.returnValue
= false;
3247 var code
= e
.keyCode
;
3248 cm
.display
.shift
= code
== 16 || e
.shiftKey
;
3249 var handled
= handleKeyBinding(cm
, e
);
3251 lastStoppedKey
= handled
? code
: null;
3252 // Opera has no cut event... we try to at least catch the key combo
3253 if (!handled
&& code
== 88 && !hasCopyEvent
&& (mac
? e
.metaKey
: e
.ctrlKey
))
3254 cm
.replaceSelection("", null, "cut");
3257 // Turn mouse into crosshair when Alt is held on Mac.
3258 if (code
== 18 && !/\bCodeMirror-crosshair\b/.test(cm
.display
.lineDiv
.className
))
3262 function showCrossHair(cm
) {
3263 var lineDiv
= cm
.display
.lineDiv
;
3264 addClass(lineDiv
, "CodeMirror-crosshair");
3267 if (e
.keyCode
== 18 || !e
.altKey
) {
3268 rmClass(lineDiv
, "CodeMirror-crosshair");
3269 off(document
, "keyup", up
);
3270 off(document
, "mouseover", up
);
3273 on(document
, "keyup", up
);
3274 on(document
, "mouseover", up
);
3277 function onKeyUp(e
) {
3278 if (e
.keyCode
== 16) this.doc
.sel
.shift
= false;
3279 signalDOMEvent(this, e
);
3282 function onKeyPress(e
) {
3284 if (signalDOMEvent(cm
, e
) || e
.ctrlKey
&& !e
.altKey
|| mac
&& e
.metaKey
) return;
3285 var keyCode
= e
.keyCode
, charCode
= e
.charCode
;
3286 if (presto
&& keyCode
== lastStoppedKey
) {lastStoppedKey
= null; e_preventDefault(e
); return;}
3287 if (((presto
&& (!e
.which
|| e
.which
< 10)) || khtml
) && handleKeyBinding(cm
, e
)) return;
3288 var ch
= String
.fromCharCode(charCode
== null ? keyCode
: charCode
);
3289 if (handleCharBinding(cm
, e
, ch
)) return;
3290 if (ie
&& ie_version
>= 9) cm
.display
.inputHasSelection
= null;
3294 // FOCUS/BLUR EVENTS
3296 function onFocus(cm
) {
3297 if (cm
.options
.readOnly
== "nocursor") return;
3298 if (!cm
.state
.focused
) {
3299 signal(cm
, "focus", cm
);
3300 cm
.state
.focused
= true;
3301 addClass(cm
.display
.wrapper
, "CodeMirror-focused");
3302 // The prevInput test prevents this from firing when a context
3303 // menu is closed (since the resetInput would kill the
3304 // select-all detection hack)
3305 if (!cm
.curOp
&& cm
.display
.selForContextMenu
!= cm
.doc
.sel
) {
3307 if (webkit
) setTimeout(bind(resetInput
, cm
, true), 0); // Issue #1730
3313 function onBlur(cm
) {
3314 if (cm
.state
.focused
) {
3315 signal(cm
, "blur", cm
);
3316 cm
.state
.focused
= false;
3317 rmClass(cm
.display
.wrapper
, "CodeMirror-focused");
3319 clearInterval(cm
.display
.blinker
);
3320 setTimeout(function() {if (!cm
.state
.focused
) cm
.display
.shift
= false;}, 150);
3323 // CONTEXT MENU HANDLING
3325 // To make the context menu work, we need to briefly unhide the
3326 // textarea (making it as unobtrusive as possible) to let the
3327 // right-click take effect on it.
3328 function onContextMenu(cm
, e
) {
3329 if (signalDOMEvent(cm
, e
, "contextmenu")) return;
3330 var display
= cm
.display
;
3331 if (eventInWidget(display
, e
) || contextMenuInGutter(cm
, e
)) return;
3333 var pos
= posFromMouse(cm
, e
), scrollPos
= display
.scroller
.scrollTop
;
3334 if (!pos
|| presto
) return; // Opera is difficult.
3336 // Reset the current text selection only if the click is done outside of the selection
3337 // and 'resetSelectionOnContextMenu' option is true.
3338 var reset
= cm
.options
.resetSelectionOnContextMenu
;
3339 if (reset
&& cm
.doc
.sel
.contains(pos
) == -1)
3340 operation(cm
, setSelection
)(cm
.doc
, simpleSelection(pos
), sel_dontScroll
);
3342 var oldCSS
= display
.input
.style
.cssText
;
3343 display
.inputDiv
.style
.position
= "absolute";
3344 display
.input
.style
.cssText
= "position: fixed; width: 30px; height: 30px; top: " + (e
.clientY
- 5) +
3345 "px; left: " + (e
.clientX
- 5) + "px; z-index: 1000; background: " +
3346 (ie
? "rgba(255, 255, 255, .05)" : "transparent") +
3347 "; outline: none; border-width: 0; outline: none; overflow: hidden; opacity: .05; filter: alpha(opacity=5);";
3348 if (webkit
) var oldScrollY
= window
.scrollY
; // Work around Chrome issue (#2712)
3350 if (webkit
) window
.scrollTo(null, oldScrollY
);
3352 // Adds "Select all" to context menu in FF
3353 if (!cm
.somethingSelected()) display
.input
.value
= display
.prevInput
= " ";
3354 display
.selForContextMenu
= cm
.doc
.sel
;
3355 clearTimeout(display
.detectingSelectAll
);
3357 // Select-all will be greyed out if there's nothing to select, so
3358 // this adds a zero-width space so that we can later check whether
3360 function prepareSelectAllHack() {
3361 if (display
.input
.selectionStart
!= null) {
3362 var selected
= cm
.somethingSelected();
3363 var extval
= display
.input
.value
= "\u200b" + (selected
? display
.input
.value
: "");
3364 display
.prevInput
= selected
? "" : "\u200b";
3365 display
.input
.selectionStart
= 1; display
.input
.selectionEnd
= extval
.length
;
3366 // Re-set this, in case some other handler touched the
3367 // selection in the meantime.
3368 display
.selForContextMenu
= cm
.doc
.sel
;
3372 display
.inputDiv
.style
.position
= "relative";
3373 display
.input
.style
.cssText
= oldCSS
;
3374 if (ie
&& ie_version
< 9) display
.scrollbarV
.scrollTop
= display
.scroller
.scrollTop
= scrollPos
;
3377 // Try to detect the user choosing select-all
3378 if (display
.input
.selectionStart
!= null) {
3379 if (!ie
|| (ie
&& ie_version
< 9)) prepareSelectAllHack();
3380 var i
= 0, poll = function() {
3381 if (display
.selForContextMenu
== cm
.doc
.sel
&& display
.input
.selectionStart
== 0)
3382 operation(cm
, commands
.selectAll
)(cm
);
3383 else if (i
++ < 10) display
.detectingSelectAll
= setTimeout(poll
, 500);
3384 else resetInput(cm
);
3386 display
.detectingSelectAll
= setTimeout(poll
, 200);
3390 if (ie
&& ie_version
>= 9) prepareSelectAllHack();
3391 if (captureRightClick
) {
3393 var mouseup = function() {
3394 off(window
, "mouseup", mouseup
);
3395 setTimeout(rehide
, 20);
3397 on(window
, "mouseup", mouseup
);
3399 setTimeout(rehide
, 50);
3403 function contextMenuInGutter(cm
, e
) {
3404 if (!hasHandler(cm
, "gutterContextMenu")) return false;
3405 return gutterEvent(cm
, e
, "gutterContextMenu", false, signal
);
3410 // Compute the position of the end of a change (its 'to' property
3411 // refers to the pre-change end).
3412 var changeEnd
= CodeMirror
.changeEnd = function(change
) {
3413 if (!change
.text
) return change
.to
;
3414 return Pos(change
.from.line
+ change
.text
.length
- 1,
3415 lst(change
.text
).length
+ (change
.text
.length
== 1 ? change
.from.ch
: 0));
3418 // Adjust a position to refer to the post-change position of the
3419 // same text, or the end of the change if the change covers it.
3420 function adjustForChange(pos
, change
) {
3421 if (cmp(pos
, change
.from) < 0) return pos
;
3422 if (cmp(pos
, change
.to
) <= 0) return changeEnd(change
);
3424 var line
= pos
.line
+ change
.text
.length
- (change
.to
.line
- change
.from.line
) - 1, ch
= pos
.ch
;
3425 if (pos
.line
== change
.to
.line
) ch
+= changeEnd(change
).ch
- change
.to
.ch
;
3426 return Pos(line
, ch
);
3429 function computeSelAfterChange(doc
, change
) {
3431 for (var i
= 0; i
< doc
.sel
.ranges
.length
; i
++) {
3432 var range
= doc
.sel
.ranges
[i
];
3433 out
.push(new Range(adjustForChange(range
.anchor
, change
),
3434 adjustForChange(range
.head
, change
)));
3436 return normalizeSelection(out
, doc
.sel
.primIndex
);
3439 function offsetPos(pos
, old
, nw
) {
3440 if (pos
.line
== old
.line
)
3441 return Pos(nw
.line
, pos
.ch
- old
.ch
+ nw
.ch
);
3443 return Pos(nw
.line
+ (pos
.line
- old
.line
), pos
.ch
);
3446 // Used by replaceSelections to allow moving the selection to the
3447 // start or around the replaced test. Hint may be "start" or "around".
3448 function computeReplacedSel(doc
, changes
, hint
) {
3450 var oldPrev
= Pos(doc
.first
, 0), newPrev
= oldPrev
;
3451 for (var i
= 0; i
< changes
.length
; i
++) {
3452 var change
= changes
[i
];
3453 var from = offsetPos(change
.from, oldPrev
, newPrev
);
3454 var to
= offsetPos(changeEnd(change
), oldPrev
, newPrev
);
3455 oldPrev
= change
.to
;
3457 if (hint
== "around") {
3458 var range
= doc
.sel
.ranges
[i
], inv
= cmp(range
.head
, range
.anchor
) < 0;
3459 out
[i
] = new Range(inv
? to
: from, inv
? from : to
);
3461 out
[i
] = new Range(from, from);
3464 return new Selection(out
, doc
.sel
.primIndex
);
3467 // Allow "beforeChange" event handlers to influence a change
3468 function filterChange(doc
, change
, update
) {
3474 origin
: change
.origin
,
3475 cancel: function() { this.canceled
= true; }
3477 if (update
) obj
.update = function(from, to
, text
, origin
) {
3478 if (from) this.from = clipPos(doc
, from);
3479 if (to
) this.to
= clipPos(doc
, to
);
3480 if (text
) this.text
= text
;
3481 if (origin
!== undefined) this.origin
= origin
;
3483 signal(doc
, "beforeChange", doc
, obj
);
3484 if (doc
.cm
) signal(doc
.cm
, "beforeChange", doc
.cm
, obj
);
3486 if (obj
.canceled
) return null;
3487 return {from: obj
.from, to
: obj
.to
, text
: obj
.text
, origin
: obj
.origin
};
3490 // Apply a change to a document, and add it to the document's
3491 // history, and propagating it to all linked documents.
3492 function makeChange(doc
, change
, ignoreReadOnly
) {
3494 if (!doc
.cm
.curOp
) return operation(doc
.cm
, makeChange
)(doc
, change
, ignoreReadOnly
);
3495 if (doc
.cm
.state
.suppressEdits
) return;
3498 if (hasHandler(doc
, "beforeChange") || doc
.cm
&& hasHandler(doc
.cm
, "beforeChange")) {
3499 change
= filterChange(doc
, change
, true);
3500 if (!change
) return;
3503 // Possibly split or suppress the update based on the presence
3504 // of read-only spans in its range.
3505 var split
= sawReadOnlySpans
&& !ignoreReadOnly
&& removeReadOnlyRanges(doc
, change
.from, change
.to
);
3507 for (var i
= split
.length
- 1; i
>= 0; --i
)
3508 makeChangeInner(doc
, {from: split
[i
].from, to
: split
[i
].to
, text
: i
? [""] : change
.text
});
3510 makeChangeInner(doc
, change
);
3514 function makeChangeInner(doc
, change
) {
3515 if (change
.text
.length
== 1 && change
.text
[0] == "" && cmp(change
.from, change
.to
) == 0) return;
3516 var selAfter
= computeSelAfterChange(doc
, change
);
3517 addChangeToHistory(doc
, change
, selAfter
, doc
.cm
? doc
.cm
.curOp
.id
: NaN
);
3519 makeChangeSingleDoc(doc
, change
, selAfter
, stretchSpansOverChange(doc
, change
));
3522 linkedDocs(doc
, function(doc
, sharedHist
) {
3523 if (!sharedHist
&& indexOf(rebased
, doc
.history
) == -1) {
3524 rebaseHist(doc
.history
, change
);
3525 rebased
.push(doc
.history
);
3527 makeChangeSingleDoc(doc
, change
, null, stretchSpansOverChange(doc
, change
));
3531 // Revert a change stored in a document's history.
3532 function makeChangeFromHistory(doc
, type
, allowSelectionOnly
) {
3533 if (doc
.cm
&& doc
.cm
.state
.suppressEdits
) return;
3535 var hist
= doc
.history
, event
, selAfter
= doc
.sel
;
3536 var source
= type
== "undo" ? hist
.done
: hist
.undone
, dest
= type
== "undo" ? hist
.undone
: hist
.done
;
3538 // Verify that there is a useable event (so that ctrl-z won't
3539 // needlessly clear selection events)
3540 for (var i
= 0; i
< source
.length
; i
++) {
3542 if (allowSelectionOnly
? event
.ranges
&& !event
.equals(doc
.sel
) : !event
.ranges
)
3545 if (i
== source
.length
) return;
3546 hist
.lastOrigin
= hist
.lastSelOrigin
= null;
3549 event
= source
.pop();
3551 pushSelectionToHistory(event
, dest
);
3552 if (allowSelectionOnly
&& !event
.equals(doc
.sel
)) {
3553 setSelection(doc
, event
, {clearRedo
: false});
3561 // Build up a reverse change object to add to the opposite history
3562 // stack (redo when undoing, and vice versa).
3563 var antiChanges
= [];
3564 pushSelectionToHistory(selAfter
, dest
);
3565 dest
.push({changes
: antiChanges
, generation
: hist
.generation
});
3566 hist
.generation
= event
.generation
|| ++hist
.maxGeneration
;
3568 var filter
= hasHandler(doc
, "beforeChange") || doc
.cm
&& hasHandler(doc
.cm
, "beforeChange");
3570 for (var i
= event
.changes
.length
- 1; i
>= 0; --i
) {
3571 var change
= event
.changes
[i
];
3572 change
.origin
= type
;
3573 if (filter
&& !filterChange(doc
, change
, false)) {
3578 antiChanges
.push(historyChangeFromChange(doc
, change
));
3580 var after
= i
? computeSelAfterChange(doc
, change
) : lst(source
);
3581 makeChangeSingleDoc(doc
, change
, after
, mergeOldSpans(doc
, change
));
3582 if (!i
&& doc
.cm
) doc
.cm
.scrollIntoView({from: change
.from, to
: changeEnd(change
)});
3585 // Propagate to the linked documents
3586 linkedDocs(doc
, function(doc
, sharedHist
) {
3587 if (!sharedHist
&& indexOf(rebased
, doc
.history
) == -1) {
3588 rebaseHist(doc
.history
, change
);
3589 rebased
.push(doc
.history
);
3591 makeChangeSingleDoc(doc
, change
, null, mergeOldSpans(doc
, change
));
3596 // Sub-views need their line numbers shifted when text is added
3597 // above or below them in the parent document.
3598 function shiftDoc(doc
, distance
) {
3599 if (distance
== 0) return;
3600 doc
.first
+= distance
;
3601 doc
.sel
= new Selection(map(doc
.sel
.ranges
, function(range
) {
3602 return new Range(Pos(range
.anchor
.line
+ distance
, range
.anchor
.ch
),
3603 Pos(range
.head
.line
+ distance
, range
.head
.ch
));
3604 }), doc
.sel
.primIndex
);
3606 regChange(doc
.cm
, doc
.first
, doc
.first
- distance
, distance
);
3607 for (var d
= doc
.cm
.display
, l
= d
.viewFrom
; l
< d
.viewTo
; l
++)
3608 regLineChange(doc
.cm
, l
, "gutter");
3612 // More lower-level change function, handling only a single document
3613 // (not linked ones).
3614 function makeChangeSingleDoc(doc
, change
, selAfter
, spans
) {
3615 if (doc
.cm
&& !doc
.cm
.curOp
)
3616 return operation(doc
.cm
, makeChangeSingleDoc
)(doc
, change
, selAfter
, spans
);
3618 if (change
.to
.line
< doc
.first
) {
3619 shiftDoc(doc
, change
.text
.length
- 1 - (change
.to
.line
- change
.from.line
));
3622 if (change
.from.line
> doc
.lastLine()) return;
3624 // Clip the change to the size of this doc
3625 if (change
.from.line
< doc
.first
) {
3626 var shift
= change
.text
.length
- 1 - (doc
.first
- change
.from.line
);
3627 shiftDoc(doc
, shift
);
3628 change
= {from: Pos(doc
.first
, 0), to
: Pos(change
.to
.line
+ shift
, change
.to
.ch
),
3629 text
: [lst(change
.text
)], origin
: change
.origin
};
3631 var last
= doc
.lastLine();
3632 if (change
.to
.line
> last
) {
3633 change
= {from: change
.from, to
: Pos(last
, getLine(doc
, last
).text
.length
),
3634 text
: [change
.text
[0]], origin
: change
.origin
};
3637 change
.removed
= getBetween(doc
, change
.from, change
.to
);
3639 if (!selAfter
) selAfter
= computeSelAfterChange(doc
, change
);
3640 if (doc
.cm
) makeChangeSingleDocInEditor(doc
.cm
, change
, spans
);
3641 else updateDoc(doc
, change
, spans
);
3642 setSelectionNoUndo(doc
, selAfter
, sel_dontScroll
);
3645 // Handle the interaction of a change to a document with the editor
3646 // that this document is part of.
3647 function makeChangeSingleDocInEditor(cm
, change
, spans
) {
3648 var doc
= cm
.doc
, display
= cm
.display
, from = change
.from, to
= change
.to
;
3650 var recomputeMaxLength
= false, checkWidthStart
= from.line
;
3651 if (!cm
.options
.lineWrapping
) {
3652 checkWidthStart
= lineNo(visualLine(getLine(doc
, from.line
)));
3653 doc
.iter(checkWidthStart
, to
.line
+ 1, function(line
) {
3654 if (line
== display
.maxLine
) {
3655 recomputeMaxLength
= true;
3661 if (doc
.sel
.contains(change
.from, change
.to
) > -1)
3662 signalCursorActivity(cm
);
3664 updateDoc(doc
, change
, spans
, estimateHeight(cm
));
3666 if (!cm
.options
.lineWrapping
) {
3667 doc
.iter(checkWidthStart
, from.line
+ change
.text
.length
, function(line
) {
3668 var len
= lineLength(line
);
3669 if (len
> display
.maxLineLength
) {
3670 display
.maxLine
= line
;
3671 display
.maxLineLength
= len
;
3672 display
.maxLineChanged
= true;
3673 recomputeMaxLength
= false;
3676 if (recomputeMaxLength
) cm
.curOp
.updateMaxLine
= true;
3679 // Adjust frontier, schedule worker
3680 doc
.frontier
= Math
.min(doc
.frontier
, from.line
);
3681 startWorker(cm
, 400);
3683 var lendiff
= change
.text
.length
- (to
.line
- from.line
) - 1;
3684 // Remember that these lines changed, for updating the display
3685 if (from.line
== to
.line
&& change
.text
.length
== 1 && !isWholeLineUpdate(cm
.doc
, change
))
3686 regLineChange(cm
, from.line
, "text");
3688 regChange(cm
, from.line
, to
.line
+ 1, lendiff
);
3690 var changesHandler
= hasHandler(cm
, "changes"), changeHandler
= hasHandler(cm
, "change");
3691 if (changeHandler
|| changesHandler
) {
3695 removed
: change
.removed
,
3696 origin
: change
.origin
3698 if (changeHandler
) signalLater(cm
, "change", cm
, obj
);
3699 if (changesHandler
) (cm
.curOp
.changeObjs
|| (cm
.curOp
.changeObjs
= [])).push(obj
);
3701 cm
.display
.selForContextMenu
= null;
3704 function replaceRange(doc
, code
, from, to
, origin
) {
3706 if (cmp(to
, from) < 0) { var tmp
= to
; to
= from; from = tmp
; }
3707 if (typeof code
== "string") code
= splitLines(code
);
3708 makeChange(doc
, {from: from, to
: to
, text
: code
, origin
: origin
});
3711 // SCROLLING THINGS INTO VIEW
3713 // If an editor sits on the top or bottom of the window, partially
3714 // scrolled out of view, this ensures that the cursor is visible.
3715 function maybeScrollWindow(cm
, coords
) {
3716 if (signalDOMEvent(cm
, "scrollCursorIntoView")) return;
3718 var display
= cm
.display
, box
= display
.sizer
.getBoundingClientRect(), doScroll
= null;
3719 if (coords
.top
+ box
.top
< 0) doScroll
= true;
3720 else if (coords
.bottom
+ box
.top
> (window
.innerHeight
|| document
.documentElement
.clientHeight
)) doScroll
= false;
3721 if (doScroll
!= null && !phantom
) {
3722 var scrollNode
= elt("div", "\u200b", null, "position: absolute; top: " +
3723 (coords
.top
- display
.viewOffset
- paddingTop(cm
.display
)) + "px; height: " +
3724 (coords
.bottom
- coords
.top
+ scrollerCutOff
) + "px; left: " +
3725 coords
.left
+ "px; width: 2px;");
3726 cm
.display
.lineSpace
.appendChild(scrollNode
);
3727 scrollNode
.scrollIntoView(doScroll
);
3728 cm
.display
.lineSpace
.removeChild(scrollNode
);
3732 // Scroll a given position into view (immediately), verifying that
3733 // it actually became visible (as line heights are accurately
3734 // measured, the position of something may 'drift' during drawing).
3735 function scrollPosIntoView(cm
, pos
, end
, margin
) {
3736 if (margin
== null) margin
= 0;
3737 for (var limit
= 0; limit
< 5; limit
++) {
3738 var changed
= false, coords
= cursorCoords(cm
, pos
);
3739 var endCoords
= !end
|| end
== pos
? coords
: cursorCoords(cm
, end
);
3740 var scrollPos
= calculateScrollPos(cm
, Math
.min(coords
.left
, endCoords
.left
),
3741 Math
.min(coords
.top
, endCoords
.top
) - margin
,
3742 Math
.max(coords
.left
, endCoords
.left
),
3743 Math
.max(coords
.bottom
, endCoords
.bottom
) + margin
);
3744 var startTop
= cm
.doc
.scrollTop
, startLeft
= cm
.doc
.scrollLeft
;
3745 if (scrollPos
.scrollTop
!= null) {
3746 setScrollTop(cm
, scrollPos
.scrollTop
);
3747 if (Math
.abs(cm
.doc
.scrollTop
- startTop
) > 1) changed
= true;
3749 if (scrollPos
.scrollLeft
!= null) {
3750 setScrollLeft(cm
, scrollPos
.scrollLeft
);
3751 if (Math
.abs(cm
.doc
.scrollLeft
- startLeft
) > 1) changed
= true;
3753 if (!changed
) return coords
;
3757 // Scroll a given set of coordinates into view (immediately).
3758 function scrollIntoView(cm
, x1
, y1
, x2
, y2
) {
3759 var scrollPos
= calculateScrollPos(cm
, x1
, y1
, x2
, y2
);
3760 if (scrollPos
.scrollTop
!= null) setScrollTop(cm
, scrollPos
.scrollTop
);
3761 if (scrollPos
.scrollLeft
!= null) setScrollLeft(cm
, scrollPos
.scrollLeft
);
3764 // Calculate a new scroll position needed to scroll the given
3765 // rectangle into view. Returns an object with scrollTop and
3766 // scrollLeft properties. When these are undefined, the
3767 // vertical/horizontal position does not need to be adjusted.
3768 function calculateScrollPos(cm
, x1
, y1
, x2
, y2
) {
3769 var display
= cm
.display
, snapMargin
= textHeight(cm
.display
);
3771 var screentop
= cm
.curOp
&& cm
.curOp
.scrollTop
!= null ? cm
.curOp
.scrollTop
: display
.scroller
.scrollTop
;
3772 var screen
= display
.scroller
.clientHeight
- scrollerCutOff
, result
= {};
3773 if (y2
- y1
> screen
) y2
= y1
+ screen
;
3774 var docBottom
= cm
.doc
.height
+ paddingVert(display
);
3775 var atTop
= y1
< snapMargin
, atBottom
= y2
> docBottom
- snapMargin
;
3776 if (y1
< screentop
) {
3777 result
.scrollTop
= atTop
? 0 : y1
;
3778 } else if (y2
> screentop
+ screen
) {
3779 var newTop
= Math
.min(y1
, (atBottom
? docBottom
: y2
) - screen
);
3780 if (newTop
!= screentop
) result
.scrollTop
= newTop
;
3783 var screenleft
= cm
.curOp
&& cm
.curOp
.scrollLeft
!= null ? cm
.curOp
.scrollLeft
: display
.scroller
.scrollLeft
;
3784 var screenw
= display
.scroller
.clientWidth
- scrollerCutOff
- display
.gutters
.offsetWidth
;
3785 var tooWide
= x2
- x1
> screenw
;
3786 if (tooWide
) x2
= x1
+ screenw
;
3788 result
.scrollLeft
= 0;
3789 else if (x1
< screenleft
)
3790 result
.scrollLeft
= Math
.max(0, x1
- (tooWide
? 0 : 10));
3791 else if (x2
> screenw
+ screenleft
- 3)
3792 result
.scrollLeft
= x2
+ (tooWide
? 0 : 10) - screenw
;
3797 // Store a relative adjustment to the scroll position in the current
3798 // operation (to be applied when the operation finishes).
3799 function addToScrollPos(cm
, left
, top
) {
3800 if (left
!= null || top
!= null) resolveScrollToPos(cm
);
3802 cm
.curOp
.scrollLeft
= (cm
.curOp
.scrollLeft
== null ? cm
.doc
.scrollLeft
: cm
.curOp
.scrollLeft
) + left
;
3804 cm
.curOp
.scrollTop
= (cm
.curOp
.scrollTop
== null ? cm
.doc
.scrollTop
: cm
.curOp
.scrollTop
) + top
;
3807 // Make sure that at the end of the operation the current cursor is
3809 function ensureCursorVisible(cm
) {
3810 resolveScrollToPos(cm
);
3811 var cur
= cm
.getCursor(), from = cur
, to
= cur
;
3812 if (!cm
.options
.lineWrapping
) {
3813 from = cur
.ch
? Pos(cur
.line
, cur
.ch
- 1) : cur
;
3814 to
= Pos(cur
.line
, cur
.ch
+ 1);
3816 cm
.curOp
.scrollToPos
= {from: from, to
: to
, margin
: cm
.options
.cursorScrollMargin
, isCursor
: true};
3819 // When an operation has its scrollToPos property set, and another
3820 // scroll action is applied before the end of the operation, this
3821 // 'simulates' scrolling that position into view in a cheap way, so
3822 // that the effect of intermediate scroll commands is not ignored.
3823 function resolveScrollToPos(cm
) {
3824 var range
= cm
.curOp
.scrollToPos
;
3826 cm
.curOp
.scrollToPos
= null;
3827 var from = estimateCoords(cm
, range
.from), to
= estimateCoords(cm
, range
.to
);
3828 var sPos
= calculateScrollPos(cm
, Math
.min(from.left
, to
.left
),
3829 Math
.min(from.top
, to
.top
) - range
.margin
,
3830 Math
.max(from.right
, to
.right
),
3831 Math
.max(from.bottom
, to
.bottom
) + range
.margin
);
3832 cm
.scrollTo(sPos
.scrollLeft
, sPos
.scrollTop
);
3838 // Indent the given line. The how parameter can be "smart",
3839 // "add"/null, "subtract", or "prev". When aggressive is false
3840 // (typically set to true for forced single-line indents), empty
3841 // lines are not indented, and places where the mode returns Pass
3843 function indentLine(cm
, n
, how
, aggressive
) {
3844 var doc
= cm
.doc
, state
;
3845 if (how
== null) how
= "add";
3846 if (how
== "smart") {
3847 // Fall back to "prev" when the mode doesn't have an indentation
3849 if (!doc
.mode
.indent
) how
= "prev";
3850 else state
= getStateBefore(cm
, n
);
3853 var tabSize
= cm
.options
.tabSize
;
3854 var line
= getLine(doc
, n
), curSpace
= countColumn(line
.text
, null, tabSize
);
3855 if (line
.stateAfter
) line
.stateAfter
= null;
3856 var curSpaceString
= line
.text
.match(/^\s*/)[0], indentation
;
3857 if (!aggressive
&& !/\S/.test(line
.text
)) {
3860 } else if (how
== "smart") {
3861 indentation
= doc
.mode
.indent(state
, line
.text
.slice(curSpaceString
.length
), line
.text
);
3862 if (indentation
== Pass
|| indentation
> 150) {
3863 if (!aggressive
) return;
3867 if (how
== "prev") {
3868 if (n
> doc
.first
) indentation
= countColumn(getLine(doc
, n
-1).text
, null, tabSize
);
3869 else indentation
= 0;
3870 } else if (how
== "add") {
3871 indentation
= curSpace
+ cm
.options
.indentUnit
;
3872 } else if (how
== "subtract") {
3873 indentation
= curSpace
- cm
.options
.indentUnit
;
3874 } else if (typeof how
== "number") {
3875 indentation
= curSpace
+ how
;
3877 indentation
= Math
.max(0, indentation
);
3879 var indentString
= "", pos
= 0;
3880 if (cm
.options
.indentWithTabs
)
3881 for (var i
= Math
.floor(indentation
/ tabSize
); i
; --i
) {pos
+= tabSize
; indentString
+= "\t";}
3882 if (pos
< indentation
) indentString
+= spaceStr(indentation
- pos
);
3884 if (indentString
!= curSpaceString
) {
3885 replaceRange(doc
, indentString
, Pos(n
, 0), Pos(n
, curSpaceString
.length
), "+input");
3887 // Ensure that, if the cursor was in the whitespace at the start
3888 // of the line, it is moved to the end of that space.
3889 for (var i
= 0; i
< doc
.sel
.ranges
.length
; i
++) {
3890 var range
= doc
.sel
.ranges
[i
];
3891 if (range
.head
.line
== n
&& range
.head
.ch
< curSpaceString
.length
) {
3892 var pos
= Pos(n
, curSpaceString
.length
);
3893 replaceOneSelection(doc
, i
, new Range(pos
, pos
));
3898 line
.stateAfter
= null;
3901 // Utility for applying a change to a line by handle or number,
3902 // returning the number and optionally registering the line as
3904 function changeLine(doc
, handle
, changeType
, op
) {
3905 var no
= handle
, line
= handle
;
3906 if (typeof handle
== "number") line
= getLine(doc
, clipLine(doc
, handle
));
3907 else no
= lineNo(handle
);
3908 if (no
== null) return null;
3909 if (op(line
, no
) && doc
.cm
) regLineChange(doc
.cm
, no
, changeType
);
3913 // Helper for deleting text near the selection(s), used to implement
3914 // backspace, delete, and similar functionality.
3915 function deleteNearSelection(cm
, compute
) {
3916 var ranges
= cm
.doc
.sel
.ranges
, kill
= [];
3917 // Build up a set of ranges to kill first, merging overlapping
3919 for (var i
= 0; i
< ranges
.length
; i
++) {
3920 var toKill
= compute(ranges
[i
]);
3921 while (kill
.length
&& cmp(toKill
.from, lst(kill
).to
) <= 0) {
3922 var replaced
= kill
.pop();
3923 if (cmp(replaced
.from, toKill
.from) < 0) {
3924 toKill
.from = replaced
.from;
3930 // Next, remove those actual ranges.
3931 runInOp(cm
, function() {
3932 for (var i
= kill
.length
- 1; i
>= 0; i
--)
3933 replaceRange(cm
.doc
, "", kill
[i
].from, kill
[i
].to
, "+delete");
3934 ensureCursorVisible(cm
);
3938 // Used for horizontal relative motion. Dir is -1 or 1 (left or
3939 // right), unit can be "char", "column" (like char, but doesn't
3940 // cross line boundaries), "word" (across next word), or "group" (to
3941 // the start of next group of word or non-word-non-whitespace
3942 // chars). The visually param controls whether, in right-to-left
3943 // text, direction 1 means to move towards the next index in the
3944 // string, or towards the character to the right of the current
3945 // position. The resulting position will have a hitSide=true
3946 // property if it reached the end of the document.
3947 function findPosH(doc
, pos
, dir
, unit
, visually
) {
3948 var line
= pos
.line
, ch
= pos
.ch
, origDir
= dir
;
3949 var lineObj
= getLine(doc
, line
);
3950 var possible
= true;
3951 function findNextLine() {
3953 if (l
< doc
.first
|| l
>= doc
.first
+ doc
.size
) return (possible
= false);
3955 return lineObj
= getLine(doc
, l
);
3957 function moveOnce(boundToLine
) {
3958 var next
= (visually
? moveVisually
: moveLogically
)(lineObj
, ch
, dir
, true);
3960 if (!boundToLine
&& findNextLine()) {
3961 if (visually
) ch
= (dir
< 0 ? lineRight
: lineLeft
)(lineObj
);
3962 else ch
= dir
< 0 ? lineObj
.text
.length
: 0;
3963 } else return (possible
= false);
3968 if (unit
== "char") moveOnce();
3969 else if (unit
== "column") moveOnce(true);
3970 else if (unit
== "word" || unit
== "group") {
3971 var sawType
= null, group
= unit
== "group";
3972 var helper
= doc
.cm
&& doc
.cm
.getHelper(pos
, "wordChars");
3973 for (var first
= true;; first
= false) {
3974 if (dir
< 0 && !moveOnce(!first
)) break;
3975 var cur
= lineObj
.text
.charAt(ch
) || "\n";
3976 var type
= isWordChar(cur
, helper
) ? "w"
3977 : group
&& cur
== "\n" ? "n"
3978 : !group
|| /\s/.test(cur
) ? null
3980 if (group
&& !first
&& !type
) type
= "s";
3981 if (sawType
&& sawType
!= type
) {
3982 if (dir
< 0) {dir
= 1; moveOnce();}
3986 if (type
) sawType
= type
;
3987 if (dir
> 0 && !moveOnce(!first
)) break;
3990 var result
= skipAtomic(doc
, Pos(line
, ch
), origDir
, true);
3991 if (!possible
) result
.hitSide
= true;
3995 // For relative vertical movement. Dir may be -1 or 1. Unit can be
3996 // "page" or "line". The resulting position will have a hitSide=true
3997 // property if it reached the end of the document.
3998 function findPosV(cm
, pos
, dir
, unit
) {
3999 var doc
= cm
.doc
, x
= pos
.left
, y
;
4000 if (unit
== "page") {
4001 var pageSize
= Math
.min(cm
.display
.wrapper
.clientHeight
, window
.innerHeight
|| document
.documentElement
.clientHeight
);
4002 y
= pos
.top
+ dir
* (pageSize
- (dir
< 0 ? 1.5 : .5) * textHeight(cm
.display
));
4003 } else if (unit
== "line") {
4004 y
= dir
> 0 ? pos
.bottom
+ 3 : pos
.top
- 3;
4007 var target
= coordsChar(cm
, x
, y
);
4008 if (!target
.outside
) break;
4009 if (dir
< 0 ? y
<= 0 : y
>= doc
.height
) { target
.hitSide
= true; break; }
4017 // The publicly visible API. Note that methodOp(f) means
4018 // 'wrap f in an operation, performed on its `this` parameter'.
4020 // This is not the complete set of editor methods. Most of the
4021 // methods defined on the Doc type are also injected into
4022 // CodeMirror.prototype, for backwards compatibility and
4025 CodeMirror
.prototype = {
4026 constructor: CodeMirror
,
4027 focus: function(){window
.focus(); focusInput(this); fastPoll(this);},
4029 setOption: function(option
, value
) {
4030 var options
= this.options
, old
= options
[option
];
4031 if (options
[option
] == value
&& option
!= "mode") return;
4032 options
[option
] = value
;
4033 if (optionHandlers
.hasOwnProperty(option
))
4034 operation(this, optionHandlers
[option
])(this, value
, old
);
4037 getOption: function(option
) {return this.options
[option
];},
4038 getDoc: function() {return this.doc
;},
4040 addKeyMap: function(map
, bottom
) {
4041 this.state
.keyMaps
[bottom
? "push" : "unshift"](getKeyMap(map
));
4043 removeKeyMap: function(map
) {
4044 var maps
= this.state
.keyMaps
;
4045 for (var i
= 0; i
< maps
.length
; ++i
)
4046 if (maps
[i
] == map
|| maps
[i
].name
== map
) {
4052 addOverlay
: methodOp(function(spec
, options
) {
4053 var mode
= spec
.token
? spec
: CodeMirror
.getMode(this.options
, spec
);
4054 if (mode
.startState
) throw new Error("Overlays may not be stateful.");
4055 this.state
.overlays
.push({mode
: mode
, modeSpec
: spec
, opaque
: options
&& options
.opaque
});
4056 this.state
.modeGen
++;
4059 removeOverlay
: methodOp(function(spec
) {
4060 var overlays
= this.state
.overlays
;
4061 for (var i
= 0; i
< overlays
.length
; ++i
) {
4062 var cur
= overlays
[i
].modeSpec
;
4063 if (cur
== spec
|| typeof spec
== "string" && cur
.name
== spec
) {
4064 overlays
.splice(i
, 1);
4065 this.state
.modeGen
++;
4072 indentLine
: methodOp(function(n
, dir
, aggressive
) {
4073 if (typeof dir
!= "string" && typeof dir
!= "number") {
4074 if (dir
== null) dir
= this.options
.smartIndent
? "smart" : "prev";
4075 else dir
= dir
? "add" : "subtract";
4077 if (isLine(this.doc
, n
)) indentLine(this, n
, dir
, aggressive
);
4079 indentSelection
: methodOp(function(how
) {
4080 var ranges
= this.doc
.sel
.ranges
, end
= -1;
4081 for (var i
= 0; i
< ranges
.length
; i
++) {
4082 var range
= ranges
[i
];
4083 if (!range
.empty()) {
4084 var from = range
.from(), to
= range
.to();
4085 var start
= Math
.max(end
, from.line
);
4086 end
= Math
.min(this.lastLine(), to
.line
- (to
.ch
? 0 : 1)) + 1;
4087 for (var j
= start
; j
< end
; ++j
)
4088 indentLine(this, j
, how
);
4089 var newRanges
= this.doc
.sel
.ranges
;
4090 if (from.ch
== 0 && ranges
.length
== newRanges
.length
&& newRanges
[i
].from().ch
> 0)
4091 replaceOneSelection(this.doc
, i
, new Range(from, newRanges
[i
].to()), sel_dontScroll
);
4092 } else if (range
.head
.line
> end
) {
4093 indentLine(this, range
.head
.line
, how
, true);
4094 end
= range
.head
.line
;
4095 if (i
== this.doc
.sel
.primIndex
) ensureCursorVisible(this);
4100 // Fetch the parser token for a given character. Useful for hacks
4101 // that want to inspect the mode state (say, for completion).
4102 getTokenAt: function(pos
, precise
) {
4103 return takeToken(this, pos
, precise
);
4106 getLineTokens: function(line
, precise
) {
4107 return takeToken(this, Pos(line
), precise
, true);
4110 getTokenTypeAt: function(pos
) {
4111 pos
= clipPos(this.doc
, pos
);
4112 var styles
= getLineStyles(this, getLine(this.doc
, pos
.line
));
4113 var before
= 0, after
= (styles
.length
- 1) / 2, ch
= pos
.ch
;
4115 if (ch
== 0) type
= styles
[2];
4117 var mid
= (before
+ after
) >> 1;
4118 if ((mid
? styles
[mid
* 2 - 1] : 0) >= ch
) after
= mid
;
4119 else if (styles
[mid
* 2 + 1] < ch
) before
= mid
+ 1;
4120 else { type
= styles
[mid
* 2 + 2]; break; }
4122 var cut
= type
? type
.indexOf("cm-overlay ") : -1;
4123 return cut
< 0 ? type
: cut
== 0 ? null : type
.slice(0, cut
- 1);
4126 getModeAt: function(pos
) {
4127 var mode
= this.doc
.mode
;
4128 if (!mode
.innerMode
) return mode
;
4129 return CodeMirror
.innerMode(mode
, this.getTokenAt(pos
).state
).mode
;
4132 getHelper: function(pos
, type
) {
4133 return this.getHelpers(pos
, type
)[0];
4136 getHelpers: function(pos
, type
) {
4138 if (!helpers
.hasOwnProperty(type
)) return helpers
;
4139 var help
= helpers
[type
], mode
= this.getModeAt(pos
);
4140 if (typeof mode
[type
] == "string") {
4141 if (help
[mode
[type
]]) found
.push(help
[mode
[type
]]);
4142 } else if (mode
[type
]) {
4143 for (var i
= 0; i
< mode
[type
].length
; i
++) {
4144 var val
= help
[mode
[type
][i
]];
4145 if (val
) found
.push(val
);
4147 } else if (mode
.helperType
&& help
[mode
.helperType
]) {
4148 found
.push(help
[mode
.helperType
]);
4149 } else if (help
[mode
.name
]) {
4150 found
.push(help
[mode
.name
]);
4152 for (var i
= 0; i
< help
._global
.length
; i
++) {
4153 var cur
= help
._global
[i
];
4154 if (cur
.pred(mode
, this) && indexOf(found
, cur
.val
) == -1)
4155 found
.push(cur
.val
);
4160 getStateAfter: function(line
, precise
) {
4162 line
= clipLine(doc
, line
== null ? doc
.first
+ doc
.size
- 1: line
);
4163 return getStateBefore(this, line
+ 1, precise
);
4166 cursorCoords: function(start
, mode
) {
4167 var pos
, range
= this.doc
.sel
.primary();
4168 if (start
== null) pos
= range
.head
;
4169 else if (typeof start
== "object") pos
= clipPos(this.doc
, start
);
4170 else pos
= start
? range
.from() : range
.to();
4171 return cursorCoords(this, pos
, mode
|| "page");
4174 charCoords: function(pos
, mode
) {
4175 return charCoords(this, clipPos(this.doc
, pos
), mode
|| "page");
4178 coordsChar: function(coords
, mode
) {
4179 coords
= fromCoordSystem(this, coords
, mode
|| "page");
4180 return coordsChar(this, coords
.left
, coords
.top
);
4183 lineAtHeight: function(height
, mode
) {
4184 height
= fromCoordSystem(this, {top
: height
, left
: 0}, mode
|| "page").top
;
4185 return lineAtHeight(this.doc
, height
+ this.display
.viewOffset
);
4187 heightAtLine: function(line
, mode
) {
4188 var end
= false, last
= this.doc
.first
+ this.doc
.size
- 1;
4189 if (line
< this.doc
.first
) line
= this.doc
.first
;
4190 else if (line
> last
) { line
= last
; end
= true; }
4191 var lineObj
= getLine(this.doc
, line
);
4192 return intoCoordSystem(this, lineObj
, {top
: 0, left
: 0}, mode
|| "page").top
+
4193 (end
? this.doc
.height
- heightAtLine(lineObj
) : 0);
4196 defaultTextHeight: function() { return textHeight(this.display
); },
4197 defaultCharWidth: function() { return charWidth(this.display
); },
4199 setGutterMarker
: methodOp(function(line
, gutterID
, value
) {
4200 return changeLine(this.doc
, line
, "gutter", function(line
) {
4201 var markers
= line
.gutterMarkers
|| (line
.gutterMarkers
= {});
4202 markers
[gutterID
] = value
;
4203 if (!value
&& isEmpty(markers
)) line
.gutterMarkers
= null;
4208 clearGutter
: methodOp(function(gutterID
) {
4209 var cm
= this, doc
= cm
.doc
, i
= doc
.first
;
4210 doc
.iter(function(line
) {
4211 if (line
.gutterMarkers
&& line
.gutterMarkers
[gutterID
]) {
4212 line
.gutterMarkers
[gutterID
] = null;
4213 regLineChange(cm
, i
, "gutter");
4214 if (isEmpty(line
.gutterMarkers
)) line
.gutterMarkers
= null;
4220 addLineWidget
: methodOp(function(handle
, node
, options
) {
4221 return addLineWidget(this, handle
, node
, options
);
4224 removeLineWidget: function(widget
) { widget
.clear(); },
4226 lineInfo: function(line
) {
4227 if (typeof line
== "number") {
4228 if (!isLine(this.doc
, line
)) return null;
4230 line
= getLine(this.doc
, line
);
4231 if (!line
) return null;
4233 var n
= lineNo(line
);
4234 if (n
== null) return null;
4236 return {line
: n
, handle
: line
, text
: line
.text
, gutterMarkers
: line
.gutterMarkers
,
4237 textClass
: line
.textClass
, bgClass
: line
.bgClass
, wrapClass
: line
.wrapClass
,
4238 widgets
: line
.widgets
};
4241 getViewport: function() { return {from: this.display
.viewFrom
, to
: this.display
.viewTo
};},
4243 addWidget: function(pos
, node
, scroll
, vert
, horiz
) {
4244 var display
= this.display
;
4245 pos
= cursorCoords(this, clipPos(this.doc
, pos
));
4246 var top
= pos
.bottom
, left
= pos
.left
;
4247 node
.style
.position
= "absolute";
4248 display
.sizer
.appendChild(node
);
4249 if (vert
== "over") {
4251 } else if (vert
== "above" || vert
== "near") {
4252 var vspace
= Math
.max(display
.wrapper
.clientHeight
, this.doc
.height
),
4253 hspace
= Math
.max(display
.sizer
.clientWidth
, display
.lineSpace
.clientWidth
);
4254 // Default to positioning above (if specified and possible); otherwise default to positioning below
4255 if ((vert
== 'above' || pos
.bottom
+ node
.offsetHeight
> vspace
) && pos
.top
> node
.offsetHeight
)
4256 top
= pos
.top
- node
.offsetHeight
;
4257 else if (pos
.bottom
+ node
.offsetHeight
<= vspace
)
4259 if (left
+ node
.offsetWidth
> hspace
)
4260 left
= hspace
- node
.offsetWidth
;
4262 node
.style
.top
= top
+ "px";
4263 node
.style
.left
= node
.style
.right
= "";
4264 if (horiz
== "right") {
4265 left
= display
.sizer
.clientWidth
- node
.offsetWidth
;
4266 node
.style
.right
= "0px";
4268 if (horiz
== "left") left
= 0;
4269 else if (horiz
== "middle") left
= (display
.sizer
.clientWidth
- node
.offsetWidth
) / 2;
4270 node
.style
.left
= left
+ "px";
4273 scrollIntoView(this, left
, top
, left
+ node
.offsetWidth
, top
+ node
.offsetHeight
);
4276 triggerOnKeyDown
: methodOp(onKeyDown
),
4277 triggerOnKeyPress
: methodOp(onKeyPress
),
4278 triggerOnKeyUp
: onKeyUp
,
4280 execCommand: function(cmd
) {
4281 if (commands
.hasOwnProperty(cmd
))
4282 return commands
[cmd
](this);
4285 findPosH: function(from, amount
, unit
, visually
) {
4287 if (amount
< 0) { dir
= -1; amount
= -amount
; }
4288 for (var i
= 0, cur
= clipPos(this.doc
, from); i
< amount
; ++i
) {
4289 cur
= findPosH(this.doc
, cur
, dir
, unit
, visually
);
4290 if (cur
.hitSide
) break;
4295 moveH
: methodOp(function(dir
, unit
) {
4297 cm
.extendSelectionsBy(function(range
) {
4298 if (cm
.display
.shift
|| cm
.doc
.extend
|| range
.empty())
4299 return findPosH(cm
.doc
, range
.head
, dir
, unit
, cm
.options
.rtlMoveVisually
);
4301 return dir
< 0 ? range
.from() : range
.to();
4305 deleteH
: methodOp(function(dir
, unit
) {
4306 var sel
= this.doc
.sel
, doc
= this.doc
;
4307 if (sel
.somethingSelected())
4308 doc
.replaceSelection("", null, "+delete");
4310 deleteNearSelection(this, function(range
) {
4311 var other
= findPosH(doc
, range
.head
, dir
, unit
, false);
4312 return dir
< 0 ? {from: other
, to
: range
.head
} : {from: range
.head
, to
: other
};
4316 findPosV: function(from, amount
, unit
, goalColumn
) {
4317 var dir
= 1, x
= goalColumn
;
4318 if (amount
< 0) { dir
= -1; amount
= -amount
; }
4319 for (var i
= 0, cur
= clipPos(this.doc
, from); i
< amount
; ++i
) {
4320 var coords
= cursorCoords(this, cur
, "div");
4321 if (x
== null) x
= coords
.left
;
4322 else coords
.left
= x
;
4323 cur
= findPosV(this, coords
, dir
, unit
);
4324 if (cur
.hitSide
) break;
4329 moveV
: methodOp(function(dir
, unit
) {
4330 var cm
= this, doc
= this.doc
, goals
= [];
4331 var collapse
= !cm
.display
.shift
&& !doc
.extend
&& doc
.sel
.somethingSelected();
4332 doc
.extendSelectionsBy(function(range
) {
4334 return dir
< 0 ? range
.from() : range
.to();
4335 var headPos
= cursorCoords(cm
, range
.head
, "div");
4336 if (range
.goalColumn
!= null) headPos
.left
= range
.goalColumn
;
4337 goals
.push(headPos
.left
);
4338 var pos
= findPosV(cm
, headPos
, dir
, unit
);
4339 if (unit
== "page" && range
== doc
.sel
.primary())
4340 addToScrollPos(cm
, null, charCoords(cm
, pos
, "div").top
- headPos
.top
);
4343 if (goals
.length
) for (var i
= 0; i
< doc
.sel
.ranges
.length
; i
++)
4344 doc
.sel
.ranges
[i
].goalColumn
= goals
[i
];
4347 // Find the word at the given position (as returned by coordsChar).
4348 findWordAt: function(pos
) {
4349 var doc
= this.doc
, line
= getLine(doc
, pos
.line
).text
;
4350 var start
= pos
.ch
, end
= pos
.ch
;
4352 var helper
= this.getHelper(pos
, "wordChars");
4353 if ((pos
.xRel
< 0 || end
== line
.length
) && start
) --start
; else ++end
;
4354 var startChar
= line
.charAt(start
);
4355 var check
= isWordChar(startChar
, helper
)
4356 ? function(ch
) { return isWordChar(ch
, helper
); }
4357 : /\s/.test(startChar
) ? function(ch
) {return /\s/.test(ch
);}
4358 : function(ch
) {return !/\s/.test(ch
) && !isWordChar(ch
);};
4359 while (start
> 0 && check(line
.charAt(start
- 1))) --start
;
4360 while (end
< line
.length
&& check(line
.charAt(end
))) ++end
;
4362 return new Range(Pos(pos
.line
, start
), Pos(pos
.line
, end
));
4365 toggleOverwrite: function(value
) {
4366 if (value
!= null && value
== this.state
.overwrite
) return;
4367 if (this.state
.overwrite
= !this.state
.overwrite
)
4368 addClass(this.display
.cursorDiv
, "CodeMirror-overwrite");
4370 rmClass(this.display
.cursorDiv
, "CodeMirror-overwrite");
4372 signal(this, "overwriteToggle", this, this.state
.overwrite
);
4374 hasFocus: function() { return activeElt() == this.display
.input
; },
4376 scrollTo
: methodOp(function(x
, y
) {
4377 if (x
!= null || y
!= null) resolveScrollToPos(this);
4378 if (x
!= null) this.curOp
.scrollLeft
= x
;
4379 if (y
!= null) this.curOp
.scrollTop
= y
;
4381 getScrollInfo: function() {
4382 var scroller
= this.display
.scroller
, co
= scrollerCutOff
;
4383 return {left
: scroller
.scrollLeft
, top
: scroller
.scrollTop
,
4384 height
: scroller
.scrollHeight
- co
, width
: scroller
.scrollWidth
- co
,
4385 clientHeight
: scroller
.clientHeight
- co
, clientWidth
: scroller
.clientWidth
- co
};
4388 scrollIntoView
: methodOp(function(range
, margin
) {
4389 if (range
== null) {
4390 range
= {from: this.doc
.sel
.primary().head
, to
: null};
4391 if (margin
== null) margin
= this.options
.cursorScrollMargin
;
4392 } else if (typeof range
== "number") {
4393 range
= {from: Pos(range
, 0), to
: null};
4394 } else if (range
.from == null) {
4395 range
= {from: range
, to
: null};
4397 if (!range
.to
) range
.to
= range
.from;
4398 range
.margin
= margin
|| 0;
4400 if (range
.from.line
!= null) {
4401 resolveScrollToPos(this);
4402 this.curOp
.scrollToPos
= range
;
4404 var sPos
= calculateScrollPos(this, Math
.min(range
.from.left
, range
.to
.left
),
4405 Math
.min(range
.from.top
, range
.to
.top
) - range
.margin
,
4406 Math
.max(range
.from.right
, range
.to
.right
),
4407 Math
.max(range
.from.bottom
, range
.to
.bottom
) + range
.margin
);
4408 this.scrollTo(sPos
.scrollLeft
, sPos
.scrollTop
);
4412 setSize
: methodOp(function(width
, height
) {
4414 function interpret(val
) {
4415 return typeof val
== "number" || /^\d+$/.test(String(val
)) ? val
+ "px" : val
;
4417 if (width
!= null) cm
.display
.wrapper
.style
.width
= interpret(width
);
4418 if (height
!= null) cm
.display
.wrapper
.style
.height
= interpret(height
);
4419 if (cm
.options
.lineWrapping
) clearLineMeasurementCache(this);
4420 var lineNo
= cm
.display
.viewFrom
;
4421 cm
.doc
.iter(lineNo
, cm
.display
.viewTo
, function(line
) {
4422 if (line
.widgets
) for (var i
= 0; i
< line
.widgets
.length
; i
++)
4423 if (line
.widgets
[i
].noHScroll
) { regLineChange(cm
, lineNo
, "widget"); break; }
4426 cm
.curOp
.forceUpdate
= true;
4427 signal(cm
, "refresh", this);
4430 operation: function(f
){return runInOp(this, f
);},
4432 refresh
: methodOp(function() {
4433 var oldHeight
= this.display
.cachedTextHeight
;
4435 this.curOp
.forceUpdate
= true;
4437 this.scrollTo(this.doc
.scrollLeft
, this.doc
.scrollTop
);
4438 updateGutterSpace(this);
4439 if (oldHeight
== null || Math
.abs(oldHeight
- textHeight(this.display
)) > .5)
4440 estimateLineHeights(this);
4441 signal(this, "refresh", this);
4444 swapDoc
: methodOp(function(doc
) {
4447 attachDoc(this, doc
);
4450 this.scrollTo(doc
.scrollLeft
, doc
.scrollTop
);
4451 this.curOp
.forceScroll
= true;
4452 signalLater(this, "swapDoc", this, old
);
4456 getInputField: function(){return this.display
.input
;},
4457 getWrapperElement: function(){return this.display
.wrapper
;},
4458 getScrollerElement: function(){return this.display
.scroller
;},
4459 getGutterElement: function(){return this.display
.gutters
;}
4461 eventMixin(CodeMirror
);
4465 // The default configuration options.
4466 var defaults
= CodeMirror
.defaults
= {};
4467 // Functions to run when options are changed.
4468 var optionHandlers
= CodeMirror
.optionHandlers
= {};
4470 function option(name
, deflt
, handle
, notOnInit
) {
4471 CodeMirror
.defaults
[name
] = deflt
;
4472 if (handle
) optionHandlers
[name
] =
4473 notOnInit
? function(cm
, val
, old
) {if (old
!= Init
) handle(cm
, val
, old
);} : handle
;
4476 // Passed to option handlers when there is no old value.
4477 var Init
= CodeMirror
.Init
= {toString: function(){return "CodeMirror.Init";}};
4479 // These two are, on init, called from the constructor because they
4480 // have to be initialized before the editor can start at all.
4481 option("value", "", function(cm
, val
) {
4484 option("mode", null, function(cm
, val
) {
4485 cm
.doc
.modeOption
= val
;
4489 option("indentUnit", 2, loadMode
, true);
4490 option("indentWithTabs", false);
4491 option("smartIndent", true);
4492 option("tabSize", 4, function(cm
) {
4497 option("specialChars", /[\t\u0000-\u0019\u00ad\u200b-\u200f\u2028\u2029\ufeff]/g, function(cm
, val
) {
4498 cm
.options
.specialChars
= new RegExp(val
.source
+ (val
.test("\t") ? "" : "|\t"), "g");
4501 option("specialCharPlaceholder", defaultSpecialCharPlaceholder
, function(cm
) {cm
.refresh();}, true);
4502 option("electricChars", true);
4503 option("rtlMoveVisually", !windows
);
4504 option("wholeLineUpdateBefore", true);
4506 option("theme", "default", function(cm
) {
4510 option("keyMap", "default", function(cm
, val
, old
) {
4511 var next
= getKeyMap(val
);
4512 var prev
= old
!= CodeMirror
.Init
&& getKeyMap(old
);
4513 if (prev
&& prev
.detach
) prev
.detach(cm
, next
);
4514 if (next
.attach
) next
.attach(cm
, prev
|| null);
4516 option("extraKeys", null);
4518 option("lineWrapping", false, wrappingChanged
, true);
4519 option("gutters", [], function(cm
) {
4520 setGuttersForLineNumbers(cm
.options
);
4523 option("fixedGutter", true, function(cm
, val
) {
4524 cm
.display
.gutters
.style
.left
= val
? compensateForHScroll(cm
.display
) + "px" : "0";
4527 option("coverGutterNextToScrollbar", false, updateScrollbars
, true);
4528 option("lineNumbers", false, function(cm
) {
4529 setGuttersForLineNumbers(cm
.options
);
4532 option("firstLineNumber", 1, guttersChanged
, true);
4533 option("lineNumberFormatter", function(integer
) {return integer
;}, guttersChanged
, true);
4534 option("showCursorWhenSelecting", false, updateSelection
, true);
4536 option("resetSelectionOnContextMenu", true);
4538 option("readOnly", false, function(cm
, val
) {
4539 if (val
== "nocursor") {
4541 cm
.display
.input
.blur();
4542 cm
.display
.disabled
= true;
4544 cm
.display
.disabled
= false;
4545 if (!val
) resetInput(cm
);
4548 option("disableInput", false, function(cm
, val
) {if (!val
) resetInput(cm
);}, true);
4549 option("dragDrop", true);
4551 option("cursorBlinkRate", 530);
4552 option("cursorScrollMargin", 0);
4553 option("cursorHeight", 1, updateSelection
, true);
4554 option("singleCursorHeightPerLine", true, updateSelection
, true);
4555 option("workTime", 100);
4556 option("workDelay", 100);
4557 option("flattenSpans", true, resetModeState
, true);
4558 option("addModeClass", false, resetModeState
, true);
4559 option("pollInterval", 100);
4560 option("undoDepth", 200, function(cm
, val
){cm
.doc
.history
.undoDepth
= val
;});
4561 option("historyEventDelay", 1250);
4562 option("viewportMargin", 10, function(cm
){cm
.refresh();}, true);
4563 option("maxHighlightLength", 10000, resetModeState
, true);
4564 option("moveInputWithCursor", true, function(cm
, val
) {
4565 if (!val
) cm
.display
.inputDiv
.style
.top
= cm
.display
.inputDiv
.style
.left
= 0;
4568 option("tabindex", null, function(cm
, val
) {
4569 cm
.display
.input
.tabIndex
= val
|| "";
4571 option("autofocus", null);
4573 // MODE DEFINITION AND QUERYING
4575 // Known modes, by name and by MIME
4576 var modes
= CodeMirror
.modes
= {}, mimeModes
= CodeMirror
.mimeModes
= {};
4578 // Extra arguments are stored as the mode's dependencies, which is
4579 // used by (legacy) mechanisms like loadmode.js to automatically
4580 // load a mode. (Preferred mechanism is the require/define calls.)
4581 CodeMirror
.defineMode = function(name
, mode
) {
4582 if (!CodeMirror
.defaults
.mode
&& name
!= "null") CodeMirror
.defaults
.mode
= name
;
4583 if (arguments
.length
> 2)
4584 mode
.dependencies
= Array
.prototype.slice
.call(arguments
, 2);
4588 CodeMirror
.defineMIME = function(mime
, spec
) {
4589 mimeModes
[mime
] = spec
;
4592 // Given a MIME type, a {name, ...options} config object, or a name
4593 // string, return a mode config object.
4594 CodeMirror
.resolveMode = function(spec
) {
4595 if (typeof spec
== "string" && mimeModes
.hasOwnProperty(spec
)) {
4596 spec
= mimeModes
[spec
];
4597 } else if (spec
&& typeof spec
.name
== "string" && mimeModes
.hasOwnProperty(spec
.name
)) {
4598 var found
= mimeModes
[spec
.name
];
4599 if (typeof found
== "string") found
= {name
: found
};
4600 spec
= createObj(found
, spec
);
4601 spec
.name
= found
.name
;
4602 } else if (typeof spec
== "string" && /^[\w\-]+\/[\w\-]+\+xml$/.test(spec
)) {
4603 return CodeMirror
.resolveMode("application/xml");
4605 if (typeof spec
== "string") return {name
: spec
};
4606 else return spec
|| {name
: "null"};
4609 // Given a mode spec (anything that resolveMode accepts), find and
4610 // initialize an actual mode object.
4611 CodeMirror
.getMode = function(options
, spec
) {
4612 var spec
= CodeMirror
.resolveMode(spec
);
4613 var mfactory
= modes
[spec
.name
];
4614 if (!mfactory
) return CodeMirror
.getMode(options
, "text/plain");
4615 var modeObj
= mfactory(options
, spec
);
4616 if (modeExtensions
.hasOwnProperty(spec
.name
)) {
4617 var exts
= modeExtensions
[spec
.name
];
4618 for (var prop
in exts
) {
4619 if (!exts
.hasOwnProperty(prop
)) continue;
4620 if (modeObj
.hasOwnProperty(prop
)) modeObj
["_" + prop
] = modeObj
[prop
];
4621 modeObj
[prop
] = exts
[prop
];
4624 modeObj
.name
= spec
.name
;
4625 if (spec
.helperType
) modeObj
.helperType
= spec
.helperType
;
4626 if (spec
.modeProps
) for (var prop
in spec
.modeProps
)
4627 modeObj
[prop
] = spec
.modeProps
[prop
];
4632 // Minimal default mode.
4633 CodeMirror
.defineMode("null", function() {
4634 return {token: function(stream
) {stream
.skipToEnd();}};
4636 CodeMirror
.defineMIME("text/plain", "null");
4638 // This can be used to attach properties to mode objects from
4639 // outside the actual mode definition.
4640 var modeExtensions
= CodeMirror
.modeExtensions
= {};
4641 CodeMirror
.extendMode = function(mode
, properties
) {
4642 var exts
= modeExtensions
.hasOwnProperty(mode
) ? modeExtensions
[mode
] : (modeExtensions
[mode
] = {});
4643 copyObj(properties
, exts
);
4648 CodeMirror
.defineExtension = function(name
, func
) {
4649 CodeMirror
.prototype[name
] = func
;
4651 CodeMirror
.defineDocExtension = function(name
, func
) {
4652 Doc
.prototype[name
] = func
;
4654 CodeMirror
.defineOption
= option
;
4657 CodeMirror
.defineInitHook = function(f
) {initHooks
.push(f
);};
4659 var helpers
= CodeMirror
.helpers
= {};
4660 CodeMirror
.registerHelper = function(type
, name
, value
) {
4661 if (!helpers
.hasOwnProperty(type
)) helpers
[type
] = CodeMirror
[type
] = {_global
: []};
4662 helpers
[type
][name
] = value
;
4664 CodeMirror
.registerGlobalHelper = function(type
, name
, predicate
, value
) {
4665 CodeMirror
.registerHelper(type
, name
, value
);
4666 helpers
[type
]._global
.push({pred
: predicate
, val
: value
});
4669 // MODE STATE HANDLING
4671 // Utility functions for working with state. Exported because nested
4672 // modes need to do this for their inner modes.
4674 var copyState
= CodeMirror
.copyState = function(mode
, state
) {
4675 if (state
=== true) return state
;
4676 if (mode
.copyState
) return mode
.copyState(state
);
4678 for (var n
in state
) {
4680 if (val
instanceof Array
) val
= val
.concat([]);
4686 var startState
= CodeMirror
.startState = function(mode
, a1
, a2
) {
4687 return mode
.startState
? mode
.startState(a1
, a2
) : true;
4690 // Given a mode and a state (for that mode), find the inner mode and
4691 // state at the position that the state refers to.
4692 CodeMirror
.innerMode = function(mode
, state
) {
4693 while (mode
.innerMode
) {
4694 var info
= mode
.innerMode(state
);
4695 if (!info
|| info
.mode
== mode
) break;
4699 return info
|| {mode
: mode
, state
: state
};
4702 // STANDARD COMMANDS
4704 // Commands are parameter-less actions that can be performed on an
4705 // editor, mostly used for keybindings.
4706 var commands
= CodeMirror
.commands
= {
4707 selectAll: function(cm
) {cm
.setSelection(Pos(cm
.firstLine(), 0), Pos(cm
.lastLine()), sel_dontScroll
);},
4708 singleSelection: function(cm
) {
4709 cm
.setSelection(cm
.getCursor("anchor"), cm
.getCursor("head"), sel_dontScroll
);
4711 killLine: function(cm
) {
4712 deleteNearSelection(cm
, function(range
) {
4713 if (range
.empty()) {
4714 var len
= getLine(cm
.doc
, range
.head
.line
).text
.length
;
4715 if (range
.head
.ch
== len
&& range
.head
.line
< cm
.lastLine())
4716 return {from: range
.head
, to
: Pos(range
.head
.line
+ 1, 0)};
4718 return {from: range
.head
, to
: Pos(range
.head
.line
, len
)};
4720 return {from: range
.from(), to
: range
.to()};
4724 deleteLine: function(cm
) {
4725 deleteNearSelection(cm
, function(range
) {
4726 return {from: Pos(range
.from().line
, 0),
4727 to
: clipPos(cm
.doc
, Pos(range
.to().line
+ 1, 0))};
4730 delLineLeft: function(cm
) {
4731 deleteNearSelection(cm
, function(range
) {
4732 return {from: Pos(range
.from().line
, 0), to
: range
.from()};
4735 delWrappedLineLeft: function(cm
) {
4736 deleteNearSelection(cm
, function(range
) {
4737 var top
= cm
.charCoords(range
.head
, "div").top
+ 5;
4738 var leftPos
= cm
.coordsChar({left
: 0, top
: top
}, "div");
4739 return {from: leftPos
, to
: range
.from()};
4742 delWrappedLineRight: function(cm
) {
4743 deleteNearSelection(cm
, function(range
) {
4744 var top
= cm
.charCoords(range
.head
, "div").top
+ 5;
4745 var rightPos
= cm
.coordsChar({left
: cm
.display
.lineDiv
.offsetWidth
+ 100, top
: top
}, "div");
4746 return {from: range
.from(), to
: rightPos
};
4749 undo: function(cm
) {cm
.undo();},
4750 redo: function(cm
) {cm
.redo();},
4751 undoSelection: function(cm
) {cm
.undoSelection();},
4752 redoSelection: function(cm
) {cm
.redoSelection();},
4753 goDocStart: function(cm
) {cm
.extendSelection(Pos(cm
.firstLine(), 0));},
4754 goDocEnd: function(cm
) {cm
.extendSelection(Pos(cm
.lastLine()));},
4755 goLineStart: function(cm
) {
4756 cm
.extendSelectionsBy(function(range
) { return lineStart(cm
, range
.head
.line
); },
4757 {origin
: "+move", bias
: 1});
4759 goLineStartSmart: function(cm
) {
4760 cm
.extendSelectionsBy(function(range
) {
4761 return lineStartSmart(cm
, range
.head
);
4762 }, {origin
: "+move", bias
: 1});
4764 goLineEnd: function(cm
) {
4765 cm
.extendSelectionsBy(function(range
) { return lineEnd(cm
, range
.head
.line
); },
4766 {origin
: "+move", bias
: -1});
4768 goLineRight: function(cm
) {
4769 cm
.extendSelectionsBy(function(range
) {
4770 var top
= cm
.charCoords(range
.head
, "div").top
+ 5;
4771 return cm
.coordsChar({left
: cm
.display
.lineDiv
.offsetWidth
+ 100, top
: top
}, "div");
4774 goLineLeft: function(cm
) {
4775 cm
.extendSelectionsBy(function(range
) {
4776 var top
= cm
.charCoords(range
.head
, "div").top
+ 5;
4777 return cm
.coordsChar({left
: 0, top
: top
}, "div");
4780 goLineLeftSmart: function(cm
) {
4781 cm
.extendSelectionsBy(function(range
) {
4782 var top
= cm
.charCoords(range
.head
, "div").top
+ 5;
4783 var pos
= cm
.coordsChar({left
: 0, top
: top
}, "div");
4784 if (pos
.ch
< cm
.getLine(pos
.line
).search(/\S/)) return lineStartSmart(cm
, range
.head
);
4788 goLineUp: function(cm
) {cm
.moveV(-1, "line");},
4789 goLineDown: function(cm
) {cm
.moveV(1, "line");},
4790 goPageUp: function(cm
) {cm
.moveV(-1, "page");},
4791 goPageDown: function(cm
) {cm
.moveV(1, "page");},
4792 goCharLeft: function(cm
) {cm
.moveH(-1, "char");},
4793 goCharRight: function(cm
) {cm
.moveH(1, "char");},
4794 goColumnLeft: function(cm
) {cm
.moveH(-1, "column");},
4795 goColumnRight: function(cm
) {cm
.moveH(1, "column");},
4796 goWordLeft: function(cm
) {cm
.moveH(-1, "word");},
4797 goGroupRight: function(cm
) {cm
.moveH(1, "group");},
4798 goGroupLeft: function(cm
) {cm
.moveH(-1, "group");},
4799 goWordRight: function(cm
) {cm
.moveH(1, "word");},
4800 delCharBefore: function(cm
) {cm
.deleteH(-1, "char");},
4801 delCharAfter: function(cm
) {cm
.deleteH(1, "char");},
4802 delWordBefore: function(cm
) {cm
.deleteH(-1, "word");},
4803 delWordAfter: function(cm
) {cm
.deleteH(1, "word");},
4804 delGroupBefore: function(cm
) {cm
.deleteH(-1, "group");},
4805 delGroupAfter: function(cm
) {cm
.deleteH(1, "group");},
4806 indentAuto: function(cm
) {cm
.indentSelection("smart");},
4807 indentMore: function(cm
) {cm
.indentSelection("add");},
4808 indentLess: function(cm
) {cm
.indentSelection("subtract");},
4809 insertTab: function(cm
) {cm
.replaceSelection("\t");},
4810 insertSoftTab: function(cm
) {
4811 var spaces
= [], ranges
= cm
.listSelections(), tabSize
= cm
.options
.tabSize
;
4812 for (var i
= 0; i
< ranges
.length
; i
++) {
4813 var pos
= ranges
[i
].from();
4814 var col
= countColumn(cm
.getLine(pos
.line
), pos
.ch
, tabSize
);
4815 spaces
.push(new Array(tabSize
- col
% tabSize
+ 1).join(" "));
4817 cm
.replaceSelections(spaces
);
4819 defaultTab: function(cm
) {
4820 if (cm
.somethingSelected()) cm
.indentSelection("add");
4821 else cm
.execCommand("insertTab");
4823 transposeChars: function(cm
) {
4824 runInOp(cm
, function() {
4825 var ranges
= cm
.listSelections(), newSel
= [];
4826 for (var i
= 0; i
< ranges
.length
; i
++) {
4827 var cur
= ranges
[i
].head
, line
= getLine(cm
.doc
, cur
.line
).text
;
4829 if (cur
.ch
== line
.length
) cur
= new Pos(cur
.line
, cur
.ch
- 1);
4831 cur
= new Pos(cur
.line
, cur
.ch
+ 1);
4832 cm
.replaceRange(line
.charAt(cur
.ch
- 1) + line
.charAt(cur
.ch
- 2),
4833 Pos(cur
.line
, cur
.ch
- 2), cur
, "+transpose");
4834 } else if (cur
.line
> cm
.doc
.first
) {
4835 var prev
= getLine(cm
.doc
, cur
.line
- 1).text
;
4837 cm
.replaceRange(line
.charAt(0) + "\n" + prev
.charAt(prev
.length
- 1),
4838 Pos(cur
.line
- 1, prev
.length
- 1), Pos(cur
.line
, 1), "+transpose");
4841 newSel
.push(new Range(cur
, cur
));
4843 cm
.setSelections(newSel
);
4846 newlineAndIndent: function(cm
) {
4847 runInOp(cm
, function() {
4848 var len
= cm
.listSelections().length
;
4849 for (var i
= 0; i
< len
; i
++) {
4850 var range
= cm
.listSelections()[i
];
4851 cm
.replaceRange("\n", range
.anchor
, range
.head
, "+input");
4852 cm
.indentLine(range
.from().line
+ 1, null, true);
4853 ensureCursorVisible(cm
);
4857 toggleOverwrite: function(cm
) {cm
.toggleOverwrite();}
4863 var keyMap
= CodeMirror
.keyMap
= {};
4866 "Left": "goCharLeft", "Right": "goCharRight", "Up": "goLineUp", "Down": "goLineDown",
4867 "End": "goLineEnd", "Home": "goLineStartSmart", "PageUp": "goPageUp", "PageDown": "goPageDown",
4868 "Delete": "delCharAfter", "Backspace": "delCharBefore", "Shift-Backspace": "delCharBefore",
4869 "Tab": "defaultTab", "Shift-Tab": "indentAuto",
4870 "Enter": "newlineAndIndent", "Insert": "toggleOverwrite",
4871 "Esc": "singleSelection"
4873 // Note that the save and find-related commands aren't defined by
4874 // default. User code or addons can define them. Unknown commands
4875 // are simply ignored.
4876 keyMap
.pcDefault
= {
4877 "Ctrl-A": "selectAll", "Ctrl-D": "deleteLine", "Ctrl-Z": "undo", "Shift-Ctrl-Z": "redo", "Ctrl-Y": "redo",
4878 "Ctrl-Home": "goDocStart", "Ctrl-End": "goDocEnd", "Ctrl-Up": "goLineUp", "Ctrl-Down": "goLineDown",
4879 "Ctrl-Left": "goGroupLeft", "Ctrl-Right": "goGroupRight", "Alt-Left": "goLineStart", "Alt-Right": "goLineEnd",
4880 "Ctrl-Backspace": "delGroupBefore", "Ctrl-Delete": "delGroupAfter", "Ctrl-S": "save", "Ctrl-F": "find",
4881 "Ctrl-G": "findNext", "Shift-Ctrl-G": "findPrev", "Shift-Ctrl-F": "replace", "Shift-Ctrl-R": "replaceAll",
4882 "Ctrl-[": "indentLess", "Ctrl-]": "indentMore",
4883 "Ctrl-U": "undoSelection", "Shift-Ctrl-U": "redoSelection", "Alt-U": "redoSelection",
4884 fallthrough
: "basic"
4886 // Very basic readline/emacs-style bindings, which are standard on Mac.
4888 "Ctrl-F": "goCharRight", "Ctrl-B": "goCharLeft", "Ctrl-P": "goLineUp", "Ctrl-N": "goLineDown",
4889 "Alt-F": "goWordRight", "Alt-B": "goWordLeft", "Ctrl-A": "goLineStart", "Ctrl-E": "goLineEnd",
4890 "Ctrl-V": "goPageDown", "Shift-Ctrl-V": "goPageUp", "Ctrl-D": "delCharAfter", "Ctrl-H": "delCharBefore",
4891 "Alt-D": "delWordAfter", "Alt-Backspace": "delWordBefore", "Ctrl-K": "killLine", "Ctrl-T": "transposeChars"
4893 keyMap
.macDefault
= {
4894 "Cmd-A": "selectAll", "Cmd-D": "deleteLine", "Cmd-Z": "undo", "Shift-Cmd-Z": "redo", "Cmd-Y": "redo",
4895 "Cmd-Home": "goDocStart", "Cmd-Up": "goDocStart", "Cmd-End": "goDocEnd", "Cmd-Down": "goDocEnd", "Alt-Left": "goGroupLeft",
4896 "Alt-Right": "goGroupRight", "Cmd-Left": "goLineLeft", "Cmd-Right": "goLineRight", "Alt-Backspace": "delGroupBefore",
4897 "Ctrl-Alt-Backspace": "delGroupAfter", "Alt-Delete": "delGroupAfter", "Cmd-S": "save", "Cmd-F": "find",
4898 "Cmd-G": "findNext", "Shift-Cmd-G": "findPrev", "Cmd-Alt-F": "replace", "Shift-Cmd-Alt-F": "replaceAll",
4899 "Cmd-[": "indentLess", "Cmd-]": "indentMore", "Cmd-Backspace": "delWrappedLineLeft", "Cmd-Delete": "delWrappedLineRight",
4900 "Cmd-U": "undoSelection", "Shift-Cmd-U": "redoSelection", "Ctrl-Up": "goDocStart", "Ctrl-Down": "goDocEnd",
4901 fallthrough
: ["basic", "emacsy"]
4903 keyMap
["default"] = mac
? keyMap
.macDefault
: keyMap
.pcDefault
;
4907 function normalizeKeyName(name
) {
4908 var parts
= name
.split(/-(?!$)/), name
= parts
[parts
.length
- 1];
4909 var alt
, ctrl
, shift
, cmd
;
4910 for (var i
= 0; i
< parts
.length
- 1; i
++) {
4912 if (/^(cmd|meta|m)$/i.test(mod
)) cmd
= true;
4913 else if (/^a(lt)?$/i.test(mod
)) alt
= true;
4914 else if (/^(c|ctrl|control)$/i.test(mod
)) ctrl
= true;
4915 else if (/^s(hift)$/i.test(mod
)) shift
= true;
4916 else throw new Error("Unrecognized modifier name: " + mod
);
4918 if (alt
) name
= "Alt-" + name
;
4919 if (ctrl
) name
= "Ctrl-" + name
;
4920 if (cmd
) name
= "Cmd-" + name
;
4921 if (shift
) name
= "Shift-" + name
;
4925 // This is a kludge to keep keymaps mostly working as raw objects
4926 // (backwards compatibility) while at the same time support features
4927 // like normalization and multi-stroke key bindings. It compiles a
4928 // new normalized keymap, and then updates the old object to reflect
4930 CodeMirror
.normalizeKeyMap = function(keymap
) {
4932 for (var keyname
in keymap
) if (keymap
.hasOwnProperty(keyname
)) {
4933 var value
= keymap
[keyname
];
4934 if (/^(name|fallthrough|(de|at)tach)$/.test(keyname
)) continue;
4935 if (value
== "...") { delete keymap
[keyname
]; continue; }
4937 var keys
= map(keyname
.split(" "), normalizeKeyName
);
4938 for (var i
= 0; i
< keys
.length
; i
++) {
4940 if (i
== keys
.length
- 1) {
4944 name
= keys
.slice(0, i
+ 1).join(" ");
4947 var prev
= copy
[name
];
4948 if (!prev
) copy
[name
] = val
;
4949 else if (prev
!= val
) throw new Error("Inconsistent bindings for " + name
);
4951 delete keymap
[keyname
];
4953 for (var prop
in copy
) keymap
[prop
] = copy
[prop
];
4957 var lookupKey
= CodeMirror
.lookupKey = function(key
, map
, handle
) {
4958 map
= getKeyMap(map
);
4959 var found
= map
.call
? map
.call(key
) : map
[key
];
4960 if (found
=== false) return "nothing";
4961 if (found
=== "...") return "multi";
4962 if (found
!= null && handle(found
)) return "handled";
4964 if (map
.fallthrough
) {
4965 if (Object
.prototype.toString
.call(map
.fallthrough
) != "[object Array]")
4966 return lookupKey(key
, map
.fallthrough
, handle
);
4967 for (var i
= 0; i
< map
.fallthrough
.length
; i
++) {
4968 var result
= lookupKey(key
, map
.fallthrough
[i
], handle
);
4969 if (result
) return result
;
4974 // Modifier key presses don't count as 'real' key presses for the
4975 // purpose of keymap fallthrough.
4976 var isModifierKey
= CodeMirror
.isModifierKey = function(value
) {
4977 var name
= typeof value
== "string" ? value
: keyNames
[value
.keyCode
];
4978 return name
== "Ctrl" || name
== "Alt" || name
== "Shift" || name
== "Mod";
4981 // Look up the name of a key as indicated by an event object.
4982 var keyName
= CodeMirror
.keyName = function(event
, noShift
) {
4983 if (presto
&& event
.keyCode
== 34 && event
["char"]) return false;
4984 var base
= keyNames
[event
.keyCode
], name
= base
;
4985 if (name
== null || event
.altGraphKey
) return false;
4986 if (event
.altKey
&& base
!= "Alt") name
= "Alt-" + name
;
4987 if ((flipCtrlCmd
? event
.metaKey
: event
.ctrlKey
) && base
!= "Ctrl") name
= "Ctrl-" + name
;
4988 if ((flipCtrlCmd
? event
.ctrlKey
: event
.metaKey
) && base
!= "Cmd") name
= "Cmd-" + name
;
4989 if (!noShift
&& event
.shiftKey
&& base
!= "Shift") name
= "Shift-" + name
;
4993 function getKeyMap(val
) {
4994 return typeof val
== "string" ? keyMap
[val
] : val
;
4999 CodeMirror
.fromTextArea = function(textarea
, options
) {
5000 if (!options
) options
= {};
5001 options
.value
= textarea
.value
;
5002 if (!options
.tabindex
&& textarea
.tabindex
)
5003 options
.tabindex
= textarea
.tabindex
;
5004 if (!options
.placeholder
&& textarea
.placeholder
)
5005 options
.placeholder
= textarea
.placeholder
;
5006 // Set autofocus to true if this textarea is focused, or if it has
5007 // autofocus and no other element is focused.
5008 if (options
.autofocus
== null) {
5009 var hasFocus
= activeElt();
5010 options
.autofocus
= hasFocus
== textarea
||
5011 textarea
.getAttribute("autofocus") != null && hasFocus
== document
.body
;
5014 function save() {textarea
.value
= cm
.getValue();}
5015 if (textarea
.form
) {
5016 on(textarea
.form
, "submit", save
);
5017 // Deplorable hack to make the submit method do the right thing.
5018 if (!options
.leaveSubmitMethodAlone
) {
5019 var form
= textarea
.form
, realSubmit
= form
.submit
;
5021 var wrappedSubmit
= form
.submit = function() {
5023 form
.submit
= realSubmit
;
5025 form
.submit
= wrappedSubmit
;
5031 textarea
.style
.display
= "none";
5032 var cm
= CodeMirror(function(node
) {
5033 textarea
.parentNode
.insertBefore(node
, textarea
.nextSibling
);
5036 cm
.getTextArea = function() { return textarea
; };
5037 cm
.toTextArea = function() {
5038 cm
.toTextArea
= isNaN
; // Prevent this from being ran twice
5040 textarea
.parentNode
.removeChild(cm
.getWrapperElement());
5041 textarea
.style
.display
= "";
5042 if (textarea
.form
) {
5043 off(textarea
.form
, "submit", save
);
5044 if (typeof textarea
.form
.submit
== "function")
5045 textarea
.form
.submit
= realSubmit
;
5053 // Fed to the mode parsers, provides helper functions to make
5054 // parsers more succinct.
5056 var StringStream
= CodeMirror
.StringStream = function(string
, tabSize
) {
5057 this.pos
= this.start
= 0;
5058 this.string
= string
;
5059 this.tabSize
= tabSize
|| 8;
5060 this.lastColumnPos
= this.lastColumnValue
= 0;
5064 StringStream
.prototype = {
5065 eol: function() {return this.pos
>= this.string
.length
;},
5066 sol: function() {return this.pos
== this.lineStart
;},
5067 peek: function() {return this.string
.charAt(this.pos
) || undefined;},
5069 if (this.pos
< this.string
.length
)
5070 return this.string
.charAt(this.pos
++);
5072 eat: function(match
) {
5073 var ch
= this.string
.charAt(this.pos
);
5074 if (typeof match
== "string") var ok
= ch
== match
;
5075 else var ok
= ch
&& (match
.test
? match
.test(ch
) : match(ch
));
5076 if (ok
) {++this.pos
; return ch
;}
5078 eatWhile: function(match
) {
5079 var start
= this.pos
;
5080 while (this.eat(match
)){}
5081 return this.pos
> start
;
5083 eatSpace: function() {
5084 var start
= this.pos
;
5085 while (/[\s\u00a0]/.test(this.string
.charAt(this.pos
))) ++this.pos
;
5086 return this.pos
> start
;
5088 skipToEnd: function() {this.pos
= this.string
.length
;},
5089 skipTo: function(ch
) {
5090 var found
= this.string
.indexOf(ch
, this.pos
);
5091 if (found
> -1) {this.pos
= found
; return true;}
5093 backUp: function(n
) {this.pos
-= n
;},
5094 column: function() {
5095 if (this.lastColumnPos
< this.start
) {
5096 this.lastColumnValue
= countColumn(this.string
, this.start
, this.tabSize
, this.lastColumnPos
, this.lastColumnValue
);
5097 this.lastColumnPos
= this.start
;
5099 return this.lastColumnValue
- (this.lineStart
? countColumn(this.string
, this.lineStart
, this.tabSize
) : 0);
5101 indentation: function() {
5102 return countColumn(this.string
, null, this.tabSize
) -
5103 (this.lineStart
? countColumn(this.string
, this.lineStart
, this.tabSize
) : 0);
5105 match: function(pattern
, consume
, caseInsensitive
) {
5106 if (typeof pattern
== "string") {
5107 var cased = function(str
) {return caseInsensitive
? str
.toLowerCase() : str
;};
5108 var substr
= this.string
.substr(this.pos
, pattern
.length
);
5109 if (cased(substr
) == cased(pattern
)) {
5110 if (consume
!== false) this.pos
+= pattern
.length
;
5114 var match
= this.string
.slice(this.pos
).match(pattern
);
5115 if (match
&& match
.index
> 0) return null;
5116 if (match
&& consume
!== false) this.pos
+= match
[0].length
;
5120 current: function(){return this.string
.slice(this.start
, this.pos
);},
5121 hideFirstChars: function(n
, inner
) {
5122 this.lineStart
+= n
;
5123 try { return inner(); }
5124 finally { this.lineStart
-= n
; }
5130 // Created with markText and setBookmark methods. A TextMarker is a
5131 // handle that can be used to clear or find a marked position in the
5132 // document. Line objects hold arrays (markedSpans) containing
5133 // {from, to, marker} object pointing to such marker objects, and
5134 // indicating that such a marker is present on that line. Multiple
5135 // lines may point to the same marker when it spans across lines.
5136 // The spans will have null for their from/to properties when the
5137 // marker continues beyond the start/end of the line. Markers have
5138 // links back to the lines they currently touch.
5140 var TextMarker
= CodeMirror
.TextMarker = function(doc
, type
) {
5145 eventMixin(TextMarker
);
5147 // Clear the marker.
5148 TextMarker
.prototype.clear = function() {
5149 if (this.explicitlyCleared
) return;
5150 var cm
= this.doc
.cm
, withOp
= cm
&& !cm
.curOp
;
5151 if (withOp
) startOperation(cm
);
5152 if (hasHandler(this, "clear")) {
5153 var found
= this.find();
5154 if (found
) signalLater(this, "clear", found
.from, found
.to
);
5156 var min
= null, max
= null;
5157 for (var i
= 0; i
< this.lines
.length
; ++i
) {
5158 var line
= this.lines
[i
];
5159 var span
= getMarkedSpanFor(line
.markedSpans
, this);
5160 if (cm
&& !this.collapsed
) regLineChange(cm
, lineNo(line
), "text");
5162 if (span
.to
!= null) max
= lineNo(line
);
5163 if (span
.from != null) min
= lineNo(line
);
5165 line
.markedSpans
= removeMarkedSpan(line
.markedSpans
, span
);
5166 if (span
.from == null && this.collapsed
&& !lineIsHidden(this.doc
, line
) && cm
)
5167 updateLineHeight(line
, textHeight(cm
.display
));
5169 if (cm
&& this.collapsed
&& !cm
.options
.lineWrapping
) for (var i
= 0; i
< this.lines
.length
; ++i
) {
5170 var visual
= visualLine(this.lines
[i
]), len
= lineLength(visual
);
5171 if (len
> cm
.display
.maxLineLength
) {
5172 cm
.display
.maxLine
= visual
;
5173 cm
.display
.maxLineLength
= len
;
5174 cm
.display
.maxLineChanged
= true;
5178 if (min
!= null && cm
&& this.collapsed
) regChange(cm
, min
, max
+ 1);
5179 this.lines
.length
= 0;
5180 this.explicitlyCleared
= true;
5181 if (this.atomic
&& this.doc
.cantEdit
) {
5182 this.doc
.cantEdit
= false;
5183 if (cm
) reCheckSelection(cm
.doc
);
5185 if (cm
) signalLater(cm
, "markerCleared", cm
, this);
5186 if (withOp
) endOperation(cm
);
5187 if (this.parent
) this.parent
.clear();
5190 // Find the position of the marker in the document. Returns a {from,
5191 // to} object by default. Side can be passed to get a specific side
5192 // -- 0 (both), -1 (left), or 1 (right). When lineObj is true, the
5193 // Pos objects returned contain a line object, rather than a line
5194 // number (used to prevent looking up the same line twice).
5195 TextMarker
.prototype.find = function(side
, lineObj
) {
5196 if (side
== null && this.type
== "bookmark") side
= 1;
5198 for (var i
= 0; i
< this.lines
.length
; ++i
) {
5199 var line
= this.lines
[i
];
5200 var span
= getMarkedSpanFor(line
.markedSpans
, this);
5201 if (span
.from != null) {
5202 from = Pos(lineObj
? line
: lineNo(line
), span
.from);
5203 if (side
== -1) return from;
5205 if (span
.to
!= null) {
5206 to
= Pos(lineObj
? line
: lineNo(line
), span
.to
);
5207 if (side
== 1) return to
;
5210 return from && {from: from, to
: to
};
5213 // Signals that the marker's widget changed, and surrounding layout
5214 // should be recomputed.
5215 TextMarker
.prototype.changed = function() {
5216 var pos
= this.find(-1, true), widget
= this, cm
= this.doc
.cm
;
5217 if (!pos
|| !cm
) return;
5218 runInOp(cm
, function() {
5219 var line
= pos
.line
, lineN
= lineNo(pos
.line
);
5220 var view
= findViewForLine(cm
, lineN
);
5222 clearLineMeasurementCacheFor(view
);
5223 cm
.curOp
.selectionChanged
= cm
.curOp
.forceUpdate
= true;
5225 cm
.curOp
.updateMaxLine
= true;
5226 if (!lineIsHidden(widget
.doc
, line
) && widget
.height
!= null) {
5227 var oldHeight
= widget
.height
;
5228 widget
.height
= null;
5229 var dHeight
= widgetHeight(widget
) - oldHeight
;
5231 updateLineHeight(line
, line
.height
+ dHeight
);
5236 TextMarker
.prototype.attachLine = function(line
) {
5237 if (!this.lines
.length
&& this.doc
.cm
) {
5238 var op
= this.doc
.cm
.curOp
;
5239 if (!op
.maybeHiddenMarkers
|| indexOf(op
.maybeHiddenMarkers
, this) == -1)
5240 (op
.maybeUnhiddenMarkers
|| (op
.maybeUnhiddenMarkers
= [])).push(this);
5242 this.lines
.push(line
);
5244 TextMarker
.prototype.detachLine = function(line
) {
5245 this.lines
.splice(indexOf(this.lines
, line
), 1);
5246 if (!this.lines
.length
&& this.doc
.cm
) {
5247 var op
= this.doc
.cm
.curOp
;
5248 (op
.maybeHiddenMarkers
|| (op
.maybeHiddenMarkers
= [])).push(this);
5252 // Collapsed markers have unique ids, in order to be able to order
5253 // them, which is needed for uniquely determining an outer marker
5254 // when they overlap (they may nest, but not partially overlap).
5255 var nextMarkerId
= 0;
5257 // Create a marker, wire it up to the right lines, and
5258 function markText(doc
, from, to
, options
, type
) {
5259 // Shared markers (across linked documents) are handled separately
5260 // (markTextShared will call out to this again, once per
5262 if (options
&& options
.shared
) return markTextShared(doc
, from, to
, options
, type
);
5263 // Ensure we are in an operation.
5264 if (doc
.cm
&& !doc
.cm
.curOp
) return operation(doc
.cm
, markText
)(doc
, from, to
, options
, type
);
5266 var marker
= new TextMarker(doc
, type
), diff
= cmp(from, to
);
5267 if (options
) copyObj(options
, marker
, false);
5268 // Don't connect empty markers unless clearWhenEmpty is false
5269 if (diff
> 0 || diff
== 0 && marker
.clearWhenEmpty
!== false)
5271 if (marker
.replacedWith
) {
5272 // Showing up as a widget implies collapsed (widget replaces text)
5273 marker
.collapsed
= true;
5274 marker
.widgetNode
= elt("span", [marker
.replacedWith
], "CodeMirror-widget");
5275 if (!options
.handleMouseEvents
) marker
.widgetNode
.ignoreEvents
= true;
5276 if (options
.insertLeft
) marker
.widgetNode
.insertLeft
= true;
5278 if (marker
.collapsed
) {
5279 if (conflictingCollapsedRange(doc
, from.line
, from, to
, marker
) ||
5280 from.line
!= to
.line
&& conflictingCollapsedRange(doc
, to
.line
, from, to
, marker
))
5281 throw new Error("Inserting collapsed marker partially overlapping an existing one");
5282 sawCollapsedSpans
= true;
5285 if (marker
.addToHistory
)
5286 addChangeToHistory(doc
, {from: from, to
: to
, origin
: "markText"}, doc
.sel
, NaN
);
5288 var curLine
= from.line
, cm
= doc
.cm
, updateMaxLine
;
5289 doc
.iter(curLine
, to
.line
+ 1, function(line
) {
5290 if (cm
&& marker
.collapsed
&& !cm
.options
.lineWrapping
&& visualLine(line
) == cm
.display
.maxLine
)
5291 updateMaxLine
= true;
5292 if (marker
.collapsed
&& curLine
!= from.line
) updateLineHeight(line
, 0);
5293 addMarkedSpan(line
, new MarkedSpan(marker
,
5294 curLine
== from.line
? from.ch
: null,
5295 curLine
== to
.line
? to
.ch
: null));
5298 // lineIsHidden depends on the presence of the spans, so needs a second pass
5299 if (marker
.collapsed
) doc
.iter(from.line
, to
.line
+ 1, function(line
) {
5300 if (lineIsHidden(doc
, line
)) updateLineHeight(line
, 0);
5303 if (marker
.clearOnEnter
) on(marker
, "beforeCursorEnter", function() { marker
.clear(); });
5305 if (marker
.readOnly
) {
5306 sawReadOnlySpans
= true;
5307 if (doc
.history
.done
.length
|| doc
.history
.undone
.length
)
5310 if (marker
.collapsed
) {
5311 marker
.id
= ++nextMarkerId
;
5312 marker
.atomic
= true;
5315 // Sync editor state
5316 if (updateMaxLine
) cm
.curOp
.updateMaxLine
= true;
5317 if (marker
.collapsed
)
5318 regChange(cm
, from.line
, to
.line
+ 1);
5319 else if (marker
.className
|| marker
.title
|| marker
.startStyle
|| marker
.endStyle
)
5320 for (var i
= from.line
; i
<= to
.line
; i
++) regLineChange(cm
, i
, "text");
5321 if (marker
.atomic
) reCheckSelection(cm
.doc
);
5322 signalLater(cm
, "markerAdded", cm
, marker
);
5327 // SHARED TEXTMARKERS
5329 // A shared marker spans multiple linked documents. It is
5330 // implemented as a meta-marker-object controlling multiple normal
5332 var SharedTextMarker
= CodeMirror
.SharedTextMarker = function(markers
, primary
) {
5333 this.markers
= markers
;
5334 this.primary
= primary
;
5335 for (var i
= 0; i
< markers
.length
; ++i
)
5336 markers
[i
].parent
= this;
5338 eventMixin(SharedTextMarker
);
5340 SharedTextMarker
.prototype.clear = function() {
5341 if (this.explicitlyCleared
) return;
5342 this.explicitlyCleared
= true;
5343 for (var i
= 0; i
< this.markers
.length
; ++i
)
5344 this.markers
[i
].clear();
5345 signalLater(this, "clear");
5347 SharedTextMarker
.prototype.find = function(side
, lineObj
) {
5348 return this.primary
.find(side
, lineObj
);
5351 function markTextShared(doc
, from, to
, options
, type
) {
5352 options
= copyObj(options
);
5353 options
.shared
= false;
5354 var markers
= [markText(doc
, from, to
, options
, type
)], primary
= markers
[0];
5355 var widget
= options
.widgetNode
;
5356 linkedDocs(doc
, function(doc
) {
5357 if (widget
) options
.widgetNode
= widget
.cloneNode(true);
5358 markers
.push(markText(doc
, clipPos(doc
, from), clipPos(doc
, to
), options
, type
));
5359 for (var i
= 0; i
< doc
.linked
.length
; ++i
)
5360 if (doc
.linked
[i
].isParent
) return;
5361 primary
= lst(markers
);
5363 return new SharedTextMarker(markers
, primary
);
5366 function findSharedMarkers(doc
) {
5367 return doc
.findMarks(Pos(doc
.first
, 0), doc
.clipPos(Pos(doc
.lastLine())),
5368 function(m
) { return m
.parent
; });
5371 function copySharedMarkers(doc
, markers
) {
5372 for (var i
= 0; i
< markers
.length
; i
++) {
5373 var marker
= markers
[i
], pos
= marker
.find();
5374 var mFrom
= doc
.clipPos(pos
.from), mTo
= doc
.clipPos(pos
.to
);
5375 if (cmp(mFrom
, mTo
)) {
5376 var subMark
= markText(doc
, mFrom
, mTo
, marker
.primary
, marker
.primary
.type
);
5377 marker
.markers
.push(subMark
);
5378 subMark
.parent
= marker
;
5383 function detachSharedMarkers(markers
) {
5384 for (var i
= 0; i
< markers
.length
; i
++) {
5385 var marker
= markers
[i
], linked
= [marker
.primary
.doc
];;
5386 linkedDocs(marker
.primary
.doc
, function(d
) { linked
.push(d
); });
5387 for (var j
= 0; j
< marker
.markers
.length
; j
++) {
5388 var subMarker
= marker
.markers
[j
];
5389 if (indexOf(linked
, subMarker
.doc
) == -1) {
5390 subMarker
.parent
= null;
5391 marker
.markers
.splice(j
--, 1);
5399 function MarkedSpan(marker
, from, to
) {
5400 this.marker
= marker
;
5401 this.from = from; this.to
= to
;
5404 // Search an array of spans for a span matching the given marker.
5405 function getMarkedSpanFor(spans
, marker
) {
5406 if (spans
) for (var i
= 0; i
< spans
.length
; ++i
) {
5407 var span
= spans
[i
];
5408 if (span
.marker
== marker
) return span
;
5411 // Remove a span from an array, returning undefined if no spans are
5412 // left (we don't store arrays for lines without spans).
5413 function removeMarkedSpan(spans
, span
) {
5414 for (var r
, i
= 0; i
< spans
.length
; ++i
)
5415 if (spans
[i
] != span
) (r
|| (r
= [])).push(spans
[i
]);
5418 // Add a span to a line.
5419 function addMarkedSpan(line
, span
) {
5420 line
.markedSpans
= line
.markedSpans
? line
.markedSpans
.concat([span
]) : [span
];
5421 span
.marker
.attachLine(line
);
5424 // Used for the algorithm that adjusts markers for a change in the
5425 // document. These functions cut an array of spans at a given
5426 // character position, returning an array of remaining chunks (or
5427 // undefined if nothing remains).
5428 function markedSpansBefore(old
, startCh
, isInsert
) {
5429 if (old
) for (var i
= 0, nw
; i
< old
.length
; ++i
) {
5430 var span
= old
[i
], marker
= span
.marker
;
5431 var startsBefore
= span
.from == null || (marker
.inclusiveLeft
? span
.from <= startCh
: span
.from < startCh
);
5432 if (startsBefore
|| span
.from == startCh
&& marker
.type
== "bookmark" && (!isInsert
|| !span
.marker
.insertLeft
)) {
5433 var endsAfter
= span
.to
== null || (marker
.inclusiveRight
? span
.to
>= startCh
: span
.to
> startCh
);
5434 (nw
|| (nw
= [])).push(new MarkedSpan(marker
, span
.from, endsAfter
? null : span
.to
));
5439 function markedSpansAfter(old
, endCh
, isInsert
) {
5440 if (old
) for (var i
= 0, nw
; i
< old
.length
; ++i
) {
5441 var span
= old
[i
], marker
= span
.marker
;
5442 var endsAfter
= span
.to
== null || (marker
.inclusiveRight
? span
.to
>= endCh
: span
.to
> endCh
);
5443 if (endsAfter
|| span
.from == endCh
&& marker
.type
== "bookmark" && (!isInsert
|| span
.marker
.insertLeft
)) {
5444 var startsBefore
= span
.from == null || (marker
.inclusiveLeft
? span
.from <= endCh
: span
.from < endCh
);
5445 (nw
|| (nw
= [])).push(new MarkedSpan(marker
, startsBefore
? null : span
.from - endCh
,
5446 span
.to
== null ? null : span
.to
- endCh
));
5452 // Given a change object, compute the new set of marker spans that
5453 // cover the line in which the change took place. Removes spans
5454 // entirely within the change, reconnects spans belonging to the
5455 // same marker that appear on both sides of the change, and cuts off
5456 // spans partially within the change. Returns an array of span
5457 // arrays with one element for each line in (after) the change.
5458 function stretchSpansOverChange(doc
, change
) {
5459 var oldFirst
= isLine(doc
, change
.from.line
) && getLine(doc
, change
.from.line
).markedSpans
;
5460 var oldLast
= isLine(doc
, change
.to
.line
) && getLine(doc
, change
.to
.line
).markedSpans
;
5461 if (!oldFirst
&& !oldLast
) return null;
5463 var startCh
= change
.from.ch
, endCh
= change
.to
.ch
, isInsert
= cmp(change
.from, change
.to
) == 0;
5464 // Get the spans that 'stick out' on both sides
5465 var first
= markedSpansBefore(oldFirst
, startCh
, isInsert
);
5466 var last
= markedSpansAfter(oldLast
, endCh
, isInsert
);
5468 // Next, merge those two ends
5469 var sameLine
= change
.text
.length
== 1, offset
= lst(change
.text
).length
+ (sameLine
? startCh
: 0);
5471 // Fix up .to properties of first
5472 for (var i
= 0; i
< first
.length
; ++i
) {
5473 var span
= first
[i
];
5474 if (span
.to
== null) {
5475 var found
= getMarkedSpanFor(last
, span
.marker
);
5476 if (!found
) span
.to
= startCh
;
5477 else if (sameLine
) span
.to
= found
.to
== null ? null : found
.to
+ offset
;
5482 // Fix up .from in last (or move them into first in case of sameLine)
5483 for (var i
= 0; i
< last
.length
; ++i
) {
5485 if (span
.to
!= null) span
.to
+= offset
;
5486 if (span
.from == null) {
5487 var found
= getMarkedSpanFor(first
, span
.marker
);
5490 if (sameLine
) (first
|| (first
= [])).push(span
);
5493 span
.from += offset
;
5494 if (sameLine
) (first
|| (first
= [])).push(span
);
5498 // Make sure we didn't create any zero-length spans
5499 if (first
) first
= clearEmptySpans(first
);
5500 if (last
&& last
!= first
) last
= clearEmptySpans(last
);
5502 var newMarkers
= [first
];
5504 // Fill gap with whole-line-spans
5505 var gap
= change
.text
.length
- 2, gapMarkers
;
5506 if (gap
> 0 && first
)
5507 for (var i
= 0; i
< first
.length
; ++i
)
5508 if (first
[i
].to
== null)
5509 (gapMarkers
|| (gapMarkers
= [])).push(new MarkedSpan(first
[i
].marker
, null, null));
5510 for (var i
= 0; i
< gap
; ++i
)
5511 newMarkers
.push(gapMarkers
);
5512 newMarkers
.push(last
);
5517 // Remove spans that are empty and don't have a clearWhenEmpty
5519 function clearEmptySpans(spans
) {
5520 for (var i
= 0; i
< spans
.length
; ++i
) {
5521 var span
= spans
[i
];
5522 if (span
.from != null && span
.from == span
.to
&& span
.marker
.clearWhenEmpty
!== false)
5523 spans
.splice(i
--, 1);
5525 if (!spans
.length
) return null;
5529 // Used for un/re-doing changes from the history. Combines the
5530 // result of computing the existing spans with the set of spans that
5531 // existed in the history (so that deleting around a span and then
5532 // undoing brings back the span).
5533 function mergeOldSpans(doc
, change
) {
5534 var old
= getOldSpans(doc
, change
);
5535 var stretched
= stretchSpansOverChange(doc
, change
);
5536 if (!old
) return stretched
;
5537 if (!stretched
) return old
;
5539 for (var i
= 0; i
< old
.length
; ++i
) {
5540 var oldCur
= old
[i
], stretchCur
= stretched
[i
];
5541 if (oldCur
&& stretchCur
) {
5542 spans
: for (var j
= 0; j
< stretchCur
.length
; ++j
) {
5543 var span
= stretchCur
[j
];
5544 for (var k
= 0; k
< oldCur
.length
; ++k
)
5545 if (oldCur
[k
].marker
== span
.marker
) continue spans
;
5548 } else if (stretchCur
) {
5549 old
[i
] = stretchCur
;
5555 // Used to 'clip' out readOnly ranges when making a change.
5556 function removeReadOnlyRanges(doc
, from, to
) {
5558 doc
.iter(from.line
, to
.line
+ 1, function(line
) {
5559 if (line
.markedSpans
) for (var i
= 0; i
< line
.markedSpans
.length
; ++i
) {
5560 var mark
= line
.markedSpans
[i
].marker
;
5561 if (mark
.readOnly
&& (!markers
|| indexOf(markers
, mark
) == -1))
5562 (markers
|| (markers
= [])).push(mark
);
5565 if (!markers
) return null;
5566 var parts
= [{from: from, to
: to
}];
5567 for (var i
= 0; i
< markers
.length
; ++i
) {
5568 var mk
= markers
[i
], m
= mk
.find(0);
5569 for (var j
= 0; j
< parts
.length
; ++j
) {
5571 if (cmp(p
.to
, m
.from) < 0 || cmp(p
.from, m
.to
) > 0) continue;
5572 var newParts
= [j
, 1], dfrom
= cmp(p
.from, m
.from), dto
= cmp(p
.to
, m
.to
);
5573 if (dfrom
< 0 || !mk
.inclusiveLeft
&& !dfrom
)
5574 newParts
.push({from: p
.from, to
: m
.from});
5575 if (dto
> 0 || !mk
.inclusiveRight
&& !dto
)
5576 newParts
.push({from: m
.to
, to
: p
.to
});
5577 parts
.splice
.apply(parts
, newParts
);
5578 j
+= newParts
.length
- 1;
5584 // Connect or disconnect spans from a line.
5585 function detachMarkedSpans(line
) {
5586 var spans
= line
.markedSpans
;
5588 for (var i
= 0; i
< spans
.length
; ++i
)
5589 spans
[i
].marker
.detachLine(line
);
5590 line
.markedSpans
= null;
5592 function attachMarkedSpans(line
, spans
) {
5594 for (var i
= 0; i
< spans
.length
; ++i
)
5595 spans
[i
].marker
.attachLine(line
);
5596 line
.markedSpans
= spans
;
5599 // Helpers used when computing which overlapping collapsed span
5600 // counts as the larger one.
5601 function extraLeft(marker
) { return marker
.inclusiveLeft
? -1 : 0; }
5602 function extraRight(marker
) { return marker
.inclusiveRight
? 1 : 0; }
5604 // Returns a number indicating which of two overlapping collapsed
5605 // spans is larger (and thus includes the other). Falls back to
5606 // comparing ids when the spans cover exactly the same range.
5607 function compareCollapsedMarkers(a
, b
) {
5608 var lenDiff
= a
.lines
.length
- b
.lines
.length
;
5609 if (lenDiff
!= 0) return lenDiff
;
5610 var aPos
= a
.find(), bPos
= b
.find();
5611 var fromCmp
= cmp(aPos
.from, bPos
.from) || extraLeft(a
) - extraLeft(b
);
5612 if (fromCmp
) return -fromCmp
;
5613 var toCmp
= cmp(aPos
.to
, bPos
.to
) || extraRight(a
) - extraRight(b
);
5614 if (toCmp
) return toCmp
;
5618 // Find out whether a line ends or starts in a collapsed span. If
5619 // so, return the marker for that span.
5620 function collapsedSpanAtSide(line
, start
) {
5621 var sps
= sawCollapsedSpans
&& line
.markedSpans
, found
;
5622 if (sps
) for (var sp
, i
= 0; i
< sps
.length
; ++i
) {
5624 if (sp
.marker
.collapsed
&& (start
? sp
.from : sp
.to
) == null &&
5625 (!found
|| compareCollapsedMarkers(found
, sp
.marker
) < 0))
5630 function collapsedSpanAtStart(line
) { return collapsedSpanAtSide(line
, true); }
5631 function collapsedSpanAtEnd(line
) { return collapsedSpanAtSide(line
, false); }
5633 // Test whether there exists a collapsed span that partially
5634 // overlaps (covers the start or end, but not both) of a new span.
5635 // Such overlap is not allowed.
5636 function conflictingCollapsedRange(doc
, lineNo
, from, to
, marker
) {
5637 var line
= getLine(doc
, lineNo
);
5638 var sps
= sawCollapsedSpans
&& line
.markedSpans
;
5639 if (sps
) for (var i
= 0; i
< sps
.length
; ++i
) {
5641 if (!sp
.marker
.collapsed
) continue;
5642 var found
= sp
.marker
.find(0);
5643 var fromCmp
= cmp(found
.from, from) || extraLeft(sp
.marker
) - extraLeft(marker
);
5644 var toCmp
= cmp(found
.to
, to
) || extraRight(sp
.marker
) - extraRight(marker
);
5645 if (fromCmp
>= 0 && toCmp
<= 0 || fromCmp
<= 0 && toCmp
>= 0) continue;
5646 if (fromCmp
<= 0 && (cmp(found
.to
, from) > 0 || (sp
.marker
.inclusiveRight
&& marker
.inclusiveLeft
)) ||
5647 fromCmp
>= 0 && (cmp(found
.from, to
) < 0 || (sp
.marker
.inclusiveLeft
&& marker
.inclusiveRight
)))
5652 // A visual line is a line as drawn on the screen. Folding, for
5653 // example, can cause multiple logical lines to appear on the same
5654 // visual line. This finds the start of the visual line that the
5655 // given line is part of (usually that is the line itself).
5656 function visualLine(line
) {
5658 while (merged
= collapsedSpanAtStart(line
))
5659 line
= merged
.find(-1, true).line
;
5663 // Returns an array of logical lines that continue the visual line
5664 // started by the argument, or undefined if there are no such lines.
5665 function visualLineContinued(line
) {
5667 while (merged
= collapsedSpanAtEnd(line
)) {
5668 line
= merged
.find(1, true).line
;
5669 (lines
|| (lines
= [])).push(line
);
5674 // Get the line number of the start of the visual line that the
5675 // given line number is part of.
5676 function visualLineNo(doc
, lineN
) {
5677 var line
= getLine(doc
, lineN
), vis
= visualLine(line
);
5678 if (line
== vis
) return lineN
;
5681 // Get the line number of the start of the next visual line after
5683 function visualLineEndNo(doc
, lineN
) {
5684 if (lineN
> doc
.lastLine()) return lineN
;
5685 var line
= getLine(doc
, lineN
), merged
;
5686 if (!lineIsHidden(doc
, line
)) return lineN
;
5687 while (merged
= collapsedSpanAtEnd(line
))
5688 line
= merged
.find(1, true).line
;
5689 return lineNo(line
) + 1;
5692 // Compute whether a line is hidden. Lines count as hidden when they
5693 // are part of a visual line that starts with another line, or when
5694 // they are entirely covered by collapsed, non-widget span.
5695 function lineIsHidden(doc
, line
) {
5696 var sps
= sawCollapsedSpans
&& line
.markedSpans
;
5697 if (sps
) for (var sp
, i
= 0; i
< sps
.length
; ++i
) {
5699 if (!sp
.marker
.collapsed
) continue;
5700 if (sp
.from == null) return true;
5701 if (sp
.marker
.widgetNode
) continue;
5702 if (sp
.from == 0 && sp
.marker
.inclusiveLeft
&& lineIsHiddenInner(doc
, line
, sp
))
5706 function lineIsHiddenInner(doc
, line
, span
) {
5707 if (span
.to
== null) {
5708 var end
= span
.marker
.find(1, true);
5709 return lineIsHiddenInner(doc
, end
.line
, getMarkedSpanFor(end
.line
.markedSpans
, span
.marker
));
5711 if (span
.marker
.inclusiveRight
&& span
.to
== line
.text
.length
)
5713 for (var sp
, i
= 0; i
< line
.markedSpans
.length
; ++i
) {
5714 sp
= line
.markedSpans
[i
];
5715 if (sp
.marker
.collapsed
&& !sp
.marker
.widgetNode
&& sp
.from == span
.to
&&
5716 (sp
.to
== null || sp
.to
!= span
.from) &&
5717 (sp
.marker
.inclusiveLeft
|| span
.marker
.inclusiveRight
) &&
5718 lineIsHiddenInner(doc
, line
, sp
)) return true;
5724 // Line widgets are block elements displayed above or below a line.
5726 var LineWidget
= CodeMirror
.LineWidget = function(cm
, node
, options
) {
5727 if (options
) for (var opt
in options
) if (options
.hasOwnProperty(opt
))
5728 this[opt
] = options
[opt
];
5732 eventMixin(LineWidget
);
5734 function adjustScrollWhenAboveVisible(cm
, line
, diff
) {
5735 if (heightAtLine(line
) < ((cm
.curOp
&& cm
.curOp
.scrollTop
) || cm
.doc
.scrollTop
))
5736 addToScrollPos(cm
, null, diff
);
5739 LineWidget
.prototype.clear = function() {
5740 var cm
= this.cm
, ws
= this.line
.widgets
, line
= this.line
, no
= lineNo(line
);
5741 if (no
== null || !ws
) return;
5742 for (var i
= 0; i
< ws
.length
; ++i
) if (ws
[i
] == this) ws
.splice(i
--, 1);
5743 if (!ws
.length
) line
.widgets
= null;
5744 var height
= widgetHeight(this);
5745 runInOp(cm
, function() {
5746 adjustScrollWhenAboveVisible(cm
, line
, -height
);
5747 regLineChange(cm
, no
, "widget");
5748 updateLineHeight(line
, Math
.max(0, line
.height
- height
));
5751 LineWidget
.prototype.changed = function() {
5752 var oldH
= this.height
, cm
= this.cm
, line
= this.line
;
5754 var diff
= widgetHeight(this) - oldH
;
5756 runInOp(cm
, function() {
5757 cm
.curOp
.forceUpdate
= true;
5758 adjustScrollWhenAboveVisible(cm
, line
, diff
);
5759 updateLineHeight(line
, line
.height
+ diff
);
5763 function widgetHeight(widget
) {
5764 if (widget
.height
!= null) return widget
.height
;
5765 if (!contains(document
.body
, widget
.node
)) {
5766 var parentStyle
= "position: relative;";
5767 if (widget
.coverGutter
)
5768 parentStyle
+= "margin-left: -" + widget
.cm
.getGutterElement().offsetWidth
+ "px;";
5769 removeChildrenAndAdd(widget
.cm
.display
.measure
, elt("div", [widget
.node
], null, parentStyle
));
5771 return widget
.height
= widget
.node
.offsetHeight
;
5774 function addLineWidget(cm
, handle
, node
, options
) {
5775 var widget
= new LineWidget(cm
, node
, options
);
5776 if (widget
.noHScroll
) cm
.display
.alignWidgets
= true;
5777 changeLine(cm
.doc
, handle
, "widget", function(line
) {
5778 var widgets
= line
.widgets
|| (line
.widgets
= []);
5779 if (widget
.insertAt
== null) widgets
.push(widget
);
5780 else widgets
.splice(Math
.min(widgets
.length
- 1, Math
.max(0, widget
.insertAt
)), 0, widget
);
5782 if (!lineIsHidden(cm
.doc
, line
)) {
5783 var aboveVisible
= heightAtLine(line
) < cm
.doc
.scrollTop
;
5784 updateLineHeight(line
, line
.height
+ widgetHeight(widget
));
5785 if (aboveVisible
) addToScrollPos(cm
, null, widget
.height
);
5786 cm
.curOp
.forceUpdate
= true;
5793 // LINE DATA STRUCTURE
5795 // Line objects. These hold state related to a line, including
5796 // highlighting info (the styles array).
5797 var Line
= CodeMirror
.Line = function(text
, markedSpans
, estimateHeight
) {
5799 attachMarkedSpans(this, markedSpans
);
5800 this.height
= estimateHeight
? estimateHeight(this) : 1;
5803 Line
.prototype.lineNo = function() { return lineNo(this); };
5805 // Change the content (text, markers) of a line. Automatically
5806 // invalidates cached information and tries to re-estimate the
5808 function updateLine(line
, text
, markedSpans
, estimateHeight
) {
5810 if (line
.stateAfter
) line
.stateAfter
= null;
5811 if (line
.styles
) line
.styles
= null;
5812 if (line
.order
!= null) line
.order
= null;
5813 detachMarkedSpans(line
);
5814 attachMarkedSpans(line
, markedSpans
);
5815 var estHeight
= estimateHeight
? estimateHeight(line
) : 1;
5816 if (estHeight
!= line
.height
) updateLineHeight(line
, estHeight
);
5819 // Detach a line from the document tree and its markers.
5820 function cleanUpLine(line
) {
5822 detachMarkedSpans(line
);
5825 function extractLineClasses(type
, output
) {
5826 if (type
) for (;;) {
5827 var lineClass
= type
.match(/(?:^|\s+)line-(background-)?(\S+)/);
5828 if (!lineClass
) break;
5829 type
= type
.slice(0, lineClass
.index
) + type
.slice(lineClass
.index
+ lineClass
[0].length
);
5830 var prop
= lineClass
[1] ? "bgClass" : "textClass";
5831 if (output
[prop
] == null)
5832 output
[prop
] = lineClass
[2];
5833 else if (!(new RegExp("(?:^|\s)" + lineClass
[2] + "(?:$|\s)")).test(output
[prop
]))
5834 output
[prop
] += " " + lineClass
[2];
5839 function callBlankLine(mode
, state
) {
5840 if (mode
.blankLine
) return mode
.blankLine(state
);
5841 if (!mode
.innerMode
) return;
5842 var inner
= CodeMirror
.innerMode(mode
, state
);
5843 if (inner
.mode
.blankLine
) return inner
.mode
.blankLine(inner
.state
);
5846 function readToken(mode
, stream
, state
, inner
) {
5847 for (var i
= 0; i
< 10; i
++) {
5848 if (inner
) inner
[0] = CodeMirror
.innerMode(mode
, state
).mode
;
5849 var style
= mode
.token(stream
, state
);
5850 if (stream
.pos
> stream
.start
) return style
;
5852 throw new Error("Mode " + mode
.name
+ " failed to advance stream.");
5855 // Utility for getTokenAt and getLineTokens
5856 function takeToken(cm
, pos
, precise
, asArray
) {
5857 function getObj(copy
) {
5858 return {start
: stream
.start
, end
: stream
.pos
,
5859 string
: stream
.current(),
5860 type
: style
|| null,
5861 state
: copy
? copyState(doc
.mode
, state
) : state
};
5864 var doc
= cm
.doc
, mode
= doc
.mode
, style
;
5865 pos
= clipPos(doc
, pos
);
5866 var line
= getLine(doc
, pos
.line
), state
= getStateBefore(cm
, pos
.line
, precise
);
5867 var stream
= new StringStream(line
.text
, cm
.options
.tabSize
), tokens
;
5868 if (asArray
) tokens
= [];
5869 while ((asArray
|| stream
.pos
< pos
.ch
) && !stream
.eol()) {
5870 stream
.start
= stream
.pos
;
5871 style
= readToken(mode
, stream
, state
);
5872 if (asArray
) tokens
.push(getObj(true));
5874 return asArray
? tokens
: getObj();
5877 // Run the given mode's parser over a line, calling f for each token.
5878 function runMode(cm
, text
, mode
, state
, f
, lineClasses
, forceToEnd
) {
5879 var flattenSpans
= mode
.flattenSpans
;
5880 if (flattenSpans
== null) flattenSpans
= cm
.options
.flattenSpans
;
5881 var curStart
= 0, curStyle
= null;
5882 var stream
= new StringStream(text
, cm
.options
.tabSize
), style
;
5883 var inner
= cm
.options
.addModeClass
&& [null];
5884 if (text
== "") extractLineClasses(callBlankLine(mode
, state
), lineClasses
);
5885 while (!stream
.eol()) {
5886 if (stream
.pos
> cm
.options
.maxHighlightLength
) {
5887 flattenSpans
= false;
5888 if (forceToEnd
) processLine(cm
, text
, state
, stream
.pos
);
5889 stream
.pos
= text
.length
;
5892 style
= extractLineClasses(readToken(mode
, stream
, state
, inner
), lineClasses
);
5895 var mName
= inner
[0].name
;
5896 if (mName
) style
= "m-" + (style
? mName
+ " " + style
: mName
);
5898 if (!flattenSpans
|| curStyle
!= style
) {
5899 if (curStart
< stream
.start
) f(stream
.start
, curStyle
);
5900 curStart
= stream
.start
; curStyle
= style
;
5902 stream
.start
= stream
.pos
;
5904 while (curStart
< stream
.pos
) {
5905 // Webkit seems to refuse to render text nodes longer than 57444 characters
5906 var pos
= Math
.min(stream
.pos
, curStart
+ 50000);
5912 // Compute a style array (an array starting with a mode generation
5913 // -- for invalidation -- followed by pairs of end positions and
5914 // style strings), which is used to highlight the tokens on the
5916 function highlightLine(cm
, line
, state
, forceToEnd
) {
5917 // A styles array always starts with a number identifying the
5918 // mode/overlays that it is based on (for easy invalidation).
5919 var st
= [cm
.state
.modeGen
], lineClasses
= {};
5920 // Compute the base array of styles
5921 runMode(cm
, line
.text
, cm
.doc
.mode
, state
, function(end
, style
) {
5922 st
.push(end
, style
);
5923 }, lineClasses
, forceToEnd
);
5925 // Run overlays, adjust style array.
5926 for (var o
= 0; o
< cm
.state
.overlays
.length
; ++o
) {
5927 var overlay
= cm
.state
.overlays
[o
], i
= 1, at
= 0;
5928 runMode(cm
, line
.text
, overlay
.mode
, true, function(end
, style
) {
5930 // Ensure there's a token end at the current position, and that i points at it
5934 st
.splice(i
, 1, end
, st
[i
+1], i_end
);
5936 at
= Math
.min(end
, i_end
);
5939 if (overlay
.opaque
) {
5940 st
.splice(start
, i
- start
, end
, "cm-overlay " + style
);
5943 for (; start
< i
; start
+= 2) {
5944 var cur
= st
[start
+1];
5945 st
[start
+1] = (cur
? cur
+ " " : "") + "cm-overlay " + style
;
5951 return {styles
: st
, classes
: lineClasses
.bgClass
|| lineClasses
.textClass
? lineClasses
: null};
5954 function getLineStyles(cm
, line
, updateFrontier
) {
5955 if (!line
.styles
|| line
.styles
[0] != cm
.state
.modeGen
) {
5956 var result
= highlightLine(cm
, line
, line
.stateAfter
= getStateBefore(cm
, lineNo(line
)));
5957 line
.styles
= result
.styles
;
5958 if (result
.classes
) line
.styleClasses
= result
.classes
;
5959 else if (line
.styleClasses
) line
.styleClasses
= null;
5960 if (updateFrontier
=== cm
.doc
.frontier
) cm
.doc
.frontier
++;
5965 // Lightweight form of highlight -- proceed over this line and
5966 // update state, but don't save a style array. Used for lines that
5967 // aren't currently visible.
5968 function processLine(cm
, text
, state
, startAt
) {
5969 var mode
= cm
.doc
.mode
;
5970 var stream
= new StringStream(text
, cm
.options
.tabSize
);
5971 stream
.start
= stream
.pos
= startAt
|| 0;
5972 if (text
== "") callBlankLine(mode
, state
);
5973 while (!stream
.eol() && stream
.pos
<= cm
.options
.maxHighlightLength
) {
5974 readToken(mode
, stream
, state
);
5975 stream
.start
= stream
.pos
;
5979 // Convert a style as returned by a mode (either null, or a string
5980 // containing one or more styles) to a CSS style. This is cached,
5981 // and also looks for line-wide styles.
5982 var styleToClassCache
= {}, styleToClassCacheWithMode
= {};
5983 function interpretTokenStyle(style
, options
) {
5984 if (!style
|| /^\s*$/.test(style
)) return null;
5985 var cache
= options
.addModeClass
? styleToClassCacheWithMode
: styleToClassCache
;
5986 return cache
[style
] ||
5987 (cache
[style
] = style
.replace(/\S+/g, "cm-$&"));
5990 // Render the DOM representation of the text of a line. Also builds
5991 // up a 'line map', which points at the DOM nodes that represent
5992 // specific stretches of text, and is used by the measuring code.
5993 // The returned object contains the DOM node, this map, and
5994 // information about line-wide styles that were set by the mode.
5995 function buildLineContent(cm
, lineView
) {
5996 // The padding-right forces the element to have a 'border', which
5997 // is needed on Webkit to be able to get line-level bounding
5998 // rectangles for it (in measureChar).
5999 var content
= elt("span", null, null, webkit
? "padding-right: .1px" : null);
6000 var builder
= {pre
: elt("pre", [content
]), content
: content
, col
: 0, pos
: 0, cm
: cm
};
6001 lineView
.measure
= {};
6003 // Iterate over the logical lines that make up this visual line.
6004 for (var i
= 0; i
<= (lineView
.rest
? lineView
.rest
.length
: 0); i
++) {
6005 var line
= i
? lineView
.rest
[i
- 1] : lineView
.line
, order
;
6007 builder
.addToken
= buildToken
;
6008 // Optionally wire in some hacks into the token-rendering
6009 // algorithm, to deal with browser quirks.
6010 if ((ie
|| webkit
) && cm
.getOption("lineWrapping"))
6011 builder
.addToken
= buildTokenSplitSpaces(builder
.addToken
);
6012 if (hasBadBidiRects(cm
.display
.measure
) && (order
= getOrder(line
)))
6013 builder
.addToken
= buildTokenBadBidi(builder
.addToken
, order
);
6015 var allowFrontierUpdate
= lineView
!= cm
.display
.externalMeasured
&& lineNo(line
);
6016 insertLineContent(line
, builder
, getLineStyles(cm
, line
, allowFrontierUpdate
));
6017 if (line
.styleClasses
) {
6018 if (line
.styleClasses
.bgClass
)
6019 builder
.bgClass
= joinClasses(line
.styleClasses
.bgClass
, builder
.bgClass
|| "");
6020 if (line
.styleClasses
.textClass
)
6021 builder
.textClass
= joinClasses(line
.styleClasses
.textClass
, builder
.textClass
|| "");
6024 // Ensure at least a single node is present, for measuring.
6025 if (builder
.map
.length
== 0)
6026 builder
.map
.push(0, 0, builder
.content
.appendChild(zeroWidthElement(cm
.display
.measure
)));
6028 // Store the map and a cache object for the current logical line
6030 lineView
.measure
.map
= builder
.map
;
6031 lineView
.measure
.cache
= {};
6033 (lineView
.measure
.maps
|| (lineView
.measure
.maps
= [])).push(builder
.map
);
6034 (lineView
.measure
.caches
|| (lineView
.measure
.caches
= [])).push({});
6039 if (webkit
&& /\bcm-tab\b/.test(builder
.content
.lastChild
.className
))
6040 builder
.content
.className
= "cm-tab-wrap-hack";
6042 signal(cm
, "renderLine", cm
, lineView
.line
, builder
.pre
);
6043 if (builder
.pre
.className
)
6044 builder
.textClass
= joinClasses(builder
.pre
.className
, builder
.textClass
|| "");
6049 function defaultSpecialCharPlaceholder(ch
) {
6050 var token
= elt("span", "\u2022", "cm-invalidchar");
6051 token
.title
= "\\u" + ch
.charCodeAt(0).toString(16);
6055 // Build up the DOM representation for a single token, and add it to
6056 // the line map. Takes care to render special characters separately.
6057 function buildToken(builder
, text
, style
, startStyle
, endStyle
, title
) {
6059 var special
= builder
.cm
.options
.specialChars
, mustWrap
= false;
6060 if (!special
.test(text
)) {
6061 builder
.col
+= text
.length
;
6062 var content
= document
.createTextNode(text
);
6063 builder
.map
.push(builder
.pos
, builder
.pos
+ text
.length
, content
);
6064 if (ie
&& ie_version
< 9) mustWrap
= true;
6065 builder
.pos
+= text
.length
;
6067 var content
= document
.createDocumentFragment(), pos
= 0;
6069 special
.lastIndex
= pos
;
6070 var m
= special
.exec(text
);
6071 var skipped
= m
? m
.index
- pos
: text
.length
- pos
;
6073 var txt
= document
.createTextNode(text
.slice(pos
, pos
+ skipped
));
6074 if (ie
&& ie_version
< 9) content
.appendChild(elt("span", [txt
]));
6075 else content
.appendChild(txt
);
6076 builder
.map
.push(builder
.pos
, builder
.pos
+ skipped
, txt
);
6077 builder
.col
+= skipped
;
6078 builder
.pos
+= skipped
;
6083 var tabSize
= builder
.cm
.options
.tabSize
, tabWidth
= tabSize
- builder
.col
% tabSize
;
6084 var txt
= content
.appendChild(elt("span", spaceStr(tabWidth
), "cm-tab"));
6085 builder
.col
+= tabWidth
;
6087 var txt
= builder
.cm
.options
.specialCharPlaceholder(m
[0]);
6088 if (ie
&& ie_version
< 9) content
.appendChild(elt("span", [txt
]));
6089 else content
.appendChild(txt
);
6092 builder
.map
.push(builder
.pos
, builder
.pos
+ 1, txt
);
6096 if (style
|| startStyle
|| endStyle
|| mustWrap
) {
6097 var fullStyle
= style
|| "";
6098 if (startStyle
) fullStyle
+= startStyle
;
6099 if (endStyle
) fullStyle
+= endStyle
;
6100 var token
= elt("span", [content
], fullStyle
);
6101 if (title
) token
.title
= title
;
6102 return builder
.content
.appendChild(token
);
6104 builder
.content
.appendChild(content
);
6107 function buildTokenSplitSpaces(inner
) {
6108 function split(old
) {
6110 for (var i
= 0; i
< old
.length
- 2; ++i
) out
+= i
% 2 ? " " : "\u00a0";
6114 return function(builder
, text
, style
, startStyle
, endStyle
, title
) {
6115 inner(builder
, text
.replace(/ {3,}/g
, split
), style
, startStyle
, endStyle
, title
);
6119 // Work around nonsense dimensions being reported for stretches of
6120 // right-to-left text.
6121 function buildTokenBadBidi(inner
, order
) {
6122 return function(builder
, text
, style
, startStyle
, endStyle
, title
) {
6123 style
= style
? style
+ " cm-force-border" : "cm-force-border";
6124 var start
= builder
.pos
, end
= start
+ text
.length
;
6126 // Find the part that overlaps with the start of this text
6127 for (var i
= 0; i
< order
.length
; i
++) {
6128 var part
= order
[i
];
6129 if (part
.to
> start
&& part
.from <= start
) break;
6131 if (part
.to
>= end
) return inner(builder
, text
, style
, startStyle
, endStyle
, title
);
6132 inner(builder
, text
.slice(0, part
.to
- start
), style
, startStyle
, null, title
);
6134 text
= text
.slice(part
.to
- start
);
6140 function buildCollapsedSpan(builder
, size
, marker
, ignoreWidget
) {
6141 var widget
= !ignoreWidget
&& marker
.widgetNode
;
6143 builder
.map
.push(builder
.pos
, builder
.pos
+ size
, widget
);
6144 builder
.content
.appendChild(widget
);
6146 builder
.pos
+= size
;
6149 // Outputs a number of spans to make up a line, taking highlighting
6150 // and marked text into account.
6151 function insertLineContent(line
, builder
, styles
) {
6152 var spans
= line
.markedSpans
, allText
= line
.text
, at
= 0;
6154 for (var i
= 1; i
< styles
.length
; i
+=2)
6155 builder
.addToken(builder
, allText
.slice(at
, at
= styles
[i
]), interpretTokenStyle(styles
[i
+1], builder
.cm
.options
));
6159 var len
= allText
.length
, pos
= 0, i
= 1, text
= "", style
;
6160 var nextChange
= 0, spanStyle
, spanEndStyle
, spanStartStyle
, title
, collapsed
;
6162 if (nextChange
== pos
) { // Update current marker set
6163 spanStyle
= spanEndStyle
= spanStartStyle
= title
= "";
6164 collapsed
= null; nextChange
= Infinity
;
6165 var foundBookmarks
= [];
6166 for (var j
= 0; j
< spans
.length
; ++j
) {
6167 var sp
= spans
[j
], m
= sp
.marker
;
6168 if (sp
.from <= pos
&& (sp
.to
== null || sp
.to
> pos
)) {
6169 if (sp
.to
!= null && nextChange
> sp
.to
) { nextChange
= sp
.to
; spanEndStyle
= ""; }
6170 if (m
.className
) spanStyle
+= " " + m
.className
;
6171 if (m
.startStyle
&& sp
.from == pos
) spanStartStyle
+= " " + m
.startStyle
;
6172 if (m
.endStyle
&& sp
.to
== nextChange
) spanEndStyle
+= " " + m
.endStyle
;
6173 if (m
.title
&& !title
) title
= m
.title
;
6174 if (m
.collapsed
&& (!collapsed
|| compareCollapsedMarkers(collapsed
.marker
, m
) < 0))
6176 } else if (sp
.from > pos
&& nextChange
> sp
.from) {
6177 nextChange
= sp
.from;
6179 if (m
.type
== "bookmark" && sp
.from == pos
&& m
.widgetNode
) foundBookmarks
.push(m
);
6181 if (collapsed
&& (collapsed
.from || 0) == pos
) {
6182 buildCollapsedSpan(builder
, (collapsed
.to
== null ? len
+ 1 : collapsed
.to
) - pos
,
6183 collapsed
.marker
, collapsed
.from == null);
6184 if (collapsed
.to
== null) return;
6186 if (!collapsed
&& foundBookmarks
.length
) for (var j
= 0; j
< foundBookmarks
.length
; ++j
)
6187 buildCollapsedSpan(builder
, 0, foundBookmarks
[j
]);
6189 if (pos
>= len
) break;
6191 var upto
= Math
.min(len
, nextChange
);
6194 var end
= pos
+ text
.length
;
6196 var tokenText
= end
> upto
? text
.slice(0, upto
- pos
) : text
;
6197 builder
.addToken(builder
, tokenText
, style
? style
+ spanStyle
: spanStyle
,
6198 spanStartStyle
, pos
+ tokenText
.length
== nextChange
? spanEndStyle
: "", title
);
6200 if (end
>= upto
) {text
= text
.slice(upto
- pos
); pos
= upto
; break;}
6202 spanStartStyle
= "";
6204 text
= allText
.slice(at
, at
= styles
[i
++]);
6205 style
= interpretTokenStyle(styles
[i
++], builder
.cm
.options
);
6210 // DOCUMENT DATA STRUCTURE
6212 // By default, updates that start and end at the beginning of a line
6213 // are treated specially, in order to make the association of line
6214 // widgets and marker elements with the text behave more intuitive.
6215 function isWholeLineUpdate(doc
, change
) {
6216 return change
.from.ch
== 0 && change
.to
.ch
== 0 && lst(change
.text
) == "" &&
6217 (!doc
.cm
|| doc
.cm
.options
.wholeLineUpdateBefore
);
6220 // Perform a change on the document data structure.
6221 function updateDoc(doc
, change
, markedSpans
, estimateHeight
) {
6222 function spansFor(n
) {return markedSpans
? markedSpans
[n
] : null;}
6223 function update(line
, text
, spans
) {
6224 updateLine(line
, text
, spans
, estimateHeight
);
6225 signalLater(line
, "change", line
, change
);
6228 var from = change
.from, to
= change
.to
, text
= change
.text
;
6229 var firstLine
= getLine(doc
, from.line
), lastLine
= getLine(doc
, to
.line
);
6230 var lastText
= lst(text
), lastSpans
= spansFor(text
.length
- 1), nlines
= to
.line
- from.line
;
6232 // Adjust the line structure
6233 if (isWholeLineUpdate(doc
, change
)) {
6234 // This is a whole-line replace. Treated specially to make
6235 // sure line objects move the way they are supposed to.
6236 for (var i
= 0, added
= []; i
< text
.length
- 1; ++i
)
6237 added
.push(new Line(text
[i
], spansFor(i
), estimateHeight
));
6238 update(lastLine
, lastLine
.text
, lastSpans
);
6239 if (nlines
) doc
.remove(from.line
, nlines
);
6240 if (added
.length
) doc
.insert(from.line
, added
);
6241 } else if (firstLine
== lastLine
) {
6242 if (text
.length
== 1) {
6243 update(firstLine
, firstLine
.text
.slice(0, from.ch
) + lastText
+ firstLine
.text
.slice(to
.ch
), lastSpans
);
6245 for (var added
= [], i
= 1; i
< text
.length
- 1; ++i
)
6246 added
.push(new Line(text
[i
], spansFor(i
), estimateHeight
));
6247 added
.push(new Line(lastText
+ firstLine
.text
.slice(to
.ch
), lastSpans
, estimateHeight
));
6248 update(firstLine
, firstLine
.text
.slice(0, from.ch
) + text
[0], spansFor(0));
6249 doc
.insert(from.line
+ 1, added
);
6251 } else if (text
.length
== 1) {
6252 update(firstLine
, firstLine
.text
.slice(0, from.ch
) + text
[0] + lastLine
.text
.slice(to
.ch
), spansFor(0));
6253 doc
.remove(from.line
+ 1, nlines
);
6255 update(firstLine
, firstLine
.text
.slice(0, from.ch
) + text
[0], spansFor(0));
6256 update(lastLine
, lastText
+ lastLine
.text
.slice(to
.ch
), lastSpans
);
6257 for (var i
= 1, added
= []; i
< text
.length
- 1; ++i
)
6258 added
.push(new Line(text
[i
], spansFor(i
), estimateHeight
));
6259 if (nlines
> 1) doc
.remove(from.line
+ 1, nlines
- 1);
6260 doc
.insert(from.line
+ 1, added
);
6263 signalLater(doc
, "change", doc
, change
);
6266 // The document is represented as a BTree consisting of leaves, with
6267 // chunk of lines in them, and branches, with up to ten leaves or
6268 // other branch nodes below them. The top node is always a branch
6269 // node, and is the document object itself (meaning it has
6270 // additional methods and properties).
6272 // All nodes have parent links. The tree is used both to go from
6273 // line numbers to line objects, and to go from objects to numbers.
6274 // It also indexes by height, and is used to convert between height
6275 // and line object, and to find the total height of the document.
6277 // See also http://marijnhaverbeke.nl/blog/codemirror-line-tree.html
6279 function LeafChunk(lines
) {
6282 for (var i
= 0, height
= 0; i
< lines
.length
; ++i
) {
6283 lines
[i
].parent
= this;
6284 height
+= lines
[i
].height
;
6286 this.height
= height
;
6289 LeafChunk
.prototype = {
6290 chunkSize: function() { return this.lines
.length
; },
6291 // Remove the n lines at offset 'at'.
6292 removeInner: function(at
, n
) {
6293 for (var i
= at
, e
= at
+ n
; i
< e
; ++i
) {
6294 var line
= this.lines
[i
];
6295 this.height
-= line
.height
;
6297 signalLater(line
, "delete");
6299 this.lines
.splice(at
, n
);
6301 // Helper used to collapse a small branch into a single leaf.
6302 collapse: function(lines
) {
6303 lines
.push
.apply(lines
, this.lines
);
6305 // Insert the given array of lines at offset 'at', count them as
6306 // having the given height.
6307 insertInner: function(at
, lines
, height
) {
6308 this.height
+= height
;
6309 this.lines
= this.lines
.slice(0, at
).concat(lines
).concat(this.lines
.slice(at
));
6310 for (var i
= 0; i
< lines
.length
; ++i
) lines
[i
].parent
= this;
6312 // Used to iterate over a part of the tree.
6313 iterN: function(at
, n
, op
) {
6314 for (var e
= at
+ n
; at
< e
; ++at
)
6315 if (op(this.lines
[at
])) return true;
6319 function BranchChunk(children
) {
6320 this.children
= children
;
6321 var size
= 0, height
= 0;
6322 for (var i
= 0; i
< children
.length
; ++i
) {
6323 var ch
= children
[i
];
6324 size
+= ch
.chunkSize(); height
+= ch
.height
;
6328 this.height
= height
;
6332 BranchChunk
.prototype = {
6333 chunkSize: function() { return this.size
; },
6334 removeInner: function(at
, n
) {
6336 for (var i
= 0; i
< this.children
.length
; ++i
) {
6337 var child
= this.children
[i
], sz
= child
.chunkSize();
6339 var rm
= Math
.min(n
, sz
- at
), oldHeight
= child
.height
;
6340 child
.removeInner(at
, rm
);
6341 this.height
-= oldHeight
- child
.height
;
6342 if (sz
== rm
) { this.children
.splice(i
--, 1); child
.parent
= null; }
6343 if ((n
-= rm
) == 0) break;
6347 // If the result is smaller than 25 lines, ensure that it is a
6348 // single leaf node.
6349 if (this.size
- n
< 25 &&
6350 (this.children
.length
> 1 || !(this.children
[0] instanceof LeafChunk
))) {
6352 this.collapse(lines
);
6353 this.children
= [new LeafChunk(lines
)];
6354 this.children
[0].parent
= this;
6357 collapse: function(lines
) {
6358 for (var i
= 0; i
< this.children
.length
; ++i
) this.children
[i
].collapse(lines
);
6360 insertInner: function(at
, lines
, height
) {
6361 this.size
+= lines
.length
;
6362 this.height
+= height
;
6363 for (var i
= 0; i
< this.children
.length
; ++i
) {
6364 var child
= this.children
[i
], sz
= child
.chunkSize();
6366 child
.insertInner(at
, lines
, height
);
6367 if (child
.lines
&& child
.lines
.length
> 50) {
6368 while (child
.lines
.length
> 50) {
6369 var spilled
= child
.lines
.splice(child
.lines
.length
- 25, 25);
6370 var newleaf
= new LeafChunk(spilled
);
6371 child
.height
-= newleaf
.height
;
6372 this.children
.splice(i
+ 1, 0, newleaf
);
6373 newleaf
.parent
= this;
6382 // When a node has grown, check whether it should be split.
6383 maybeSpill: function() {
6384 if (this.children
.length
<= 10) return;
6387 var spilled
= me
.children
.splice(me
.children
.length
- 5, 5);
6388 var sibling
= new BranchChunk(spilled
);
6389 if (!me
.parent
) { // Become the parent node
6390 var copy
= new BranchChunk(me
.children
);
6392 me
.children
= [copy
, sibling
];
6395 me
.size
-= sibling
.size
;
6396 me
.height
-= sibling
.height
;
6397 var myIndex
= indexOf(me
.parent
.children
, me
);
6398 me
.parent
.children
.splice(myIndex
+ 1, 0, sibling
);
6400 sibling
.parent
= me
.parent
;
6401 } while (me
.children
.length
> 10);
6402 me
.parent
.maybeSpill();
6404 iterN: function(at
, n
, op
) {
6405 for (var i
= 0; i
< this.children
.length
; ++i
) {
6406 var child
= this.children
[i
], sz
= child
.chunkSize();
6408 var used
= Math
.min(n
, sz
- at
);
6409 if (child
.iterN(at
, used
, op
)) return true;
6410 if ((n
-= used
) == 0) break;
6418 var Doc
= CodeMirror
.Doc = function(text
, mode
, firstLine
) {
6419 if (!(this instanceof Doc
)) return new Doc(text
, mode
, firstLine
);
6420 if (firstLine
== null) firstLine
= 0;
6422 BranchChunk
.call(this, [new LeafChunk([new Line("", null)])]);
6423 this.first
= firstLine
;
6424 this.scrollTop
= this.scrollLeft
= 0;
6425 this.cantEdit
= false;
6426 this.cleanGeneration
= 1;
6427 this.frontier
= firstLine
;
6428 var start
= Pos(firstLine
, 0);
6429 this.sel
= simpleSelection(start
);
6430 this.history
= new History(null);
6431 this.id
= ++nextDocId
;
6432 this.modeOption
= mode
;
6434 if (typeof text
== "string") text
= splitLines(text
);
6435 updateDoc(this, {from: start
, to
: start
, text
: text
});
6436 setSelection(this, simpleSelection(start
), sel_dontScroll
);
6439 Doc
.prototype = createObj(BranchChunk
.prototype, {
6441 // Iterate over the document. Supports two forms -- with only one
6442 // argument, it calls that for each line in the document. With
6443 // three, it iterates over the range given by the first two (with
6444 // the second being non-inclusive).
6445 iter: function(from, to
, op
) {
6446 if (op
) this.iterN(from - this.first
, to
- from, op
);
6447 else this.iterN(this.first
, this.first
+ this.size
, from);
6450 // Non-public interface for adding and removing lines.
6451 insert: function(at
, lines
) {
6453 for (var i
= 0; i
< lines
.length
; ++i
) height
+= lines
[i
].height
;
6454 this.insertInner(at
- this.first
, lines
, height
);
6456 remove: function(at
, n
) { this.removeInner(at
- this.first
, n
); },
6458 // From here, the methods are part of the public interface. Most
6459 // are also available from CodeMirror (editor) instances.
6461 getValue: function(lineSep
) {
6462 var lines
= getLines(this, this.first
, this.first
+ this.size
);
6463 if (lineSep
=== false) return lines
;
6464 return lines
.join(lineSep
|| "\n");
6466 setValue
: docMethodOp(function(code
) {
6467 var top
= Pos(this.first
, 0), last
= this.first
+ this.size
- 1;
6468 makeChange(this, {from: top
, to
: Pos(last
, getLine(this, last
).text
.length
),
6469 text
: splitLines(code
), origin
: "setValue"}, true);
6470 setSelection(this, simpleSelection(top
));
6472 replaceRange: function(code
, from, to
, origin
) {
6473 from = clipPos(this, from);
6474 to
= to
? clipPos(this, to
) : from;
6475 replaceRange(this, code
, from, to
, origin
);
6477 getRange: function(from, to
, lineSep
) {
6478 var lines
= getBetween(this, clipPos(this, from), clipPos(this, to
));
6479 if (lineSep
=== false) return lines
;
6480 return lines
.join(lineSep
|| "\n");
6483 getLine: function(line
) {var l
= this.getLineHandle(line
); return l
&& l
.text
;},
6485 getLineHandle: function(line
) {if (isLine(this, line
)) return getLine(this, line
);},
6486 getLineNumber: function(line
) {return lineNo(line
);},
6488 getLineHandleVisualStart: function(line
) {
6489 if (typeof line
== "number") line
= getLine(this, line
);
6490 return visualLine(line
);
6493 lineCount: function() {return this.size
;},
6494 firstLine: function() {return this.first
;},
6495 lastLine: function() {return this.first
+ this.size
- 1;},
6497 clipPos: function(pos
) {return clipPos(this, pos
);},
6499 getCursor: function(start
) {
6500 var range
= this.sel
.primary(), pos
;
6501 if (start
== null || start
== "head") pos
= range
.head
;
6502 else if (start
== "anchor") pos
= range
.anchor
;
6503 else if (start
== "end" || start
== "to" || start
=== false) pos
= range
.to();
6504 else pos
= range
.from();
6507 listSelections: function() { return this.sel
.ranges
; },
6508 somethingSelected: function() {return this.sel
.somethingSelected();},
6510 setCursor
: docMethodOp(function(line
, ch
, options
) {
6511 setSimpleSelection(this, clipPos(this, typeof line
== "number" ? Pos(line
, ch
|| 0) : line
), null, options
);
6513 setSelection
: docMethodOp(function(anchor
, head
, options
) {
6514 setSimpleSelection(this, clipPos(this, anchor
), clipPos(this, head
|| anchor
), options
);
6516 extendSelection
: docMethodOp(function(head
, other
, options
) {
6517 extendSelection(this, clipPos(this, head
), other
&& clipPos(this, other
), options
);
6519 extendSelections
: docMethodOp(function(heads
, options
) {
6520 extendSelections(this, clipPosArray(this, heads
, options
));
6522 extendSelectionsBy
: docMethodOp(function(f
, options
) {
6523 extendSelections(this, map(this.sel
.ranges
, f
), options
);
6525 setSelections
: docMethodOp(function(ranges
, primary
, options
) {
6526 if (!ranges
.length
) return;
6527 for (var i
= 0, out
= []; i
< ranges
.length
; i
++)
6528 out
[i
] = new Range(clipPos(this, ranges
[i
].anchor
),
6529 clipPos(this, ranges
[i
].head
));
6530 if (primary
== null) primary
= Math
.min(ranges
.length
- 1, this.sel
.primIndex
);
6531 setSelection(this, normalizeSelection(out
, primary
), options
);
6533 addSelection
: docMethodOp(function(anchor
, head
, options
) {
6534 var ranges
= this.sel
.ranges
.slice(0);
6535 ranges
.push(new Range(clipPos(this, anchor
), clipPos(this, head
|| anchor
)));
6536 setSelection(this, normalizeSelection(ranges
, ranges
.length
- 1), options
);
6539 getSelection: function(lineSep
) {
6540 var ranges
= this.sel
.ranges
, lines
;
6541 for (var i
= 0; i
< ranges
.length
; i
++) {
6542 var sel
= getBetween(this, ranges
[i
].from(), ranges
[i
].to());
6543 lines
= lines
? lines
.concat(sel
) : sel
;
6545 if (lineSep
=== false) return lines
;
6546 else return lines
.join(lineSep
|| "\n");
6548 getSelections: function(lineSep
) {
6549 var parts
= [], ranges
= this.sel
.ranges
;
6550 for (var i
= 0; i
< ranges
.length
; i
++) {
6551 var sel
= getBetween(this, ranges
[i
].from(), ranges
[i
].to());
6552 if (lineSep
!== false) sel
= sel
.join(lineSep
|| "\n");
6557 replaceSelection: function(code
, collapse
, origin
) {
6559 for (var i
= 0; i
< this.sel
.ranges
.length
; i
++)
6561 this.replaceSelections(dup
, collapse
, origin
|| "+input");
6563 replaceSelections
: docMethodOp(function(code
, collapse
, origin
) {
6564 var changes
= [], sel
= this.sel
;
6565 for (var i
= 0; i
< sel
.ranges
.length
; i
++) {
6566 var range
= sel
.ranges
[i
];
6567 changes
[i
] = {from: range
.from(), to
: range
.to(), text
: splitLines(code
[i
]), origin
: origin
};
6569 var newSel
= collapse
&& collapse
!= "end" && computeReplacedSel(this, changes
, collapse
);
6570 for (var i
= changes
.length
- 1; i
>= 0; i
--)
6571 makeChange(this, changes
[i
]);
6572 if (newSel
) setSelectionReplaceHistory(this, newSel
);
6573 else if (this.cm
) ensureCursorVisible(this.cm
);
6575 undo
: docMethodOp(function() {makeChangeFromHistory(this, "undo");}),
6576 redo
: docMethodOp(function() {makeChangeFromHistory(this, "redo");}),
6577 undoSelection
: docMethodOp(function() {makeChangeFromHistory(this, "undo", true);}),
6578 redoSelection
: docMethodOp(function() {makeChangeFromHistory(this, "redo", true);}),
6580 setExtending: function(val
) {this.extend
= val
;},
6581 getExtending: function() {return this.extend
;},
6583 historySize: function() {
6584 var hist
= this.history
, done
= 0, undone
= 0;
6585 for (var i
= 0; i
< hist
.done
.length
; i
++) if (!hist
.done
[i
].ranges
) ++done
;
6586 for (var i
= 0; i
< hist
.undone
.length
; i
++) if (!hist
.undone
[i
].ranges
) ++undone
;
6587 return {undo
: done
, redo
: undone
};
6589 clearHistory: function() {this.history
= new History(this.history
.maxGeneration
);},
6591 markClean: function() {
6592 this.cleanGeneration
= this.changeGeneration(true);
6594 changeGeneration: function(forceSplit
) {
6596 this.history
.lastOp
= this.history
.lastSelOp
= this.history
.lastOrigin
= null;
6597 return this.history
.generation
;
6599 isClean: function (gen
) {
6600 return this.history
.generation
== (gen
|| this.cleanGeneration
);
6603 getHistory: function() {
6604 return {done
: copyHistoryArray(this.history
.done
),
6605 undone
: copyHistoryArray(this.history
.undone
)};
6607 setHistory: function(histData
) {
6608 var hist
= this.history
= new History(this.history
.maxGeneration
);
6609 hist
.done
= copyHistoryArray(histData
.done
.slice(0), null, true);
6610 hist
.undone
= copyHistoryArray(histData
.undone
.slice(0), null, true);
6613 addLineClass
: docMethodOp(function(handle
, where
, cls
) {
6614 return changeLine(this, handle
, where
== "gutter" ? "gutter" : "class", function(line
) {
6615 var prop
= where
== "text" ? "textClass"
6616 : where
== "background" ? "bgClass"
6617 : where
== "gutter" ? "gutterClass" : "wrapClass";
6618 if (!line
[prop
]) line
[prop
] = cls
;
6619 else if (classTest(cls
).test(line
[prop
])) return false;
6620 else line
[prop
] += " " + cls
;
6624 removeLineClass
: docMethodOp(function(handle
, where
, cls
) {
6625 return changeLine(this, handle
, "class", function(line
) {
6626 var prop
= where
== "text" ? "textClass"
6627 : where
== "background" ? "bgClass"
6628 : where
== "gutter" ? "gutterClass" : "wrapClass";
6629 var cur
= line
[prop
];
6630 if (!cur
) return false;
6631 else if (cls
== null) line
[prop
] = null;
6633 var found
= cur
.match(classTest(cls
));
6634 if (!found
) return false;
6635 var end
= found
.index
+ found
[0].length
;
6636 line
[prop
] = cur
.slice(0, found
.index
) + (!found
.index
|| end
== cur
.length
? "" : " ") + cur
.slice(end
) || null;
6642 markText: function(from, to
, options
) {
6643 return markText(this, clipPos(this, from), clipPos(this, to
), options
, "range");
6645 setBookmark: function(pos
, options
) {
6646 var realOpts
= {replacedWith
: options
&& (options
.nodeType
== null ? options
.widget
: options
),
6647 insertLeft
: options
&& options
.insertLeft
,
6648 clearWhenEmpty
: false, shared
: options
&& options
.shared
};
6649 pos
= clipPos(this, pos
);
6650 return markText(this, pos
, pos
, realOpts
, "bookmark");
6652 findMarksAt: function(pos
) {
6653 pos
= clipPos(this, pos
);
6654 var markers
= [], spans
= getLine(this, pos
.line
).markedSpans
;
6655 if (spans
) for (var i
= 0; i
< spans
.length
; ++i
) {
6656 var span
= spans
[i
];
6657 if ((span
.from == null || span
.from <= pos
.ch
) &&
6658 (span
.to
== null || span
.to
>= pos
.ch
))
6659 markers
.push(span
.marker
.parent
|| span
.marker
);
6663 findMarks: function(from, to
, filter
) {
6664 from = clipPos(this, from); to
= clipPos(this, to
);
6665 var found
= [], lineNo
= from.line
;
6666 this.iter(from.line
, to
.line
+ 1, function(line
) {
6667 var spans
= line
.markedSpans
;
6668 if (spans
) for (var i
= 0; i
< spans
.length
; i
++) {
6669 var span
= spans
[i
];
6670 if (!(lineNo
== from.line
&& from.ch
> span
.to
||
6671 span
.from == null && lineNo
!= from.line
||
6672 lineNo
== to
.line
&& span
.from > to
.ch
) &&
6673 (!filter
|| filter(span
.marker
)))
6674 found
.push(span
.marker
.parent
|| span
.marker
);
6680 getAllMarks: function() {
6682 this.iter(function(line
) {
6683 var sps
= line
.markedSpans
;
6684 if (sps
) for (var i
= 0; i
< sps
.length
; ++i
)
6685 if (sps
[i
].from != null) markers
.push(sps
[i
].marker
);
6690 posFromIndex: function(off
) {
6691 var ch
, lineNo
= this.first
;
6692 this.iter(function(line
) {
6693 var sz
= line
.text
.length
+ 1;
6694 if (sz
> off
) { ch
= off
; return true; }
6698 return clipPos(this, Pos(lineNo
, ch
));
6700 indexFromPos: function (coords
) {
6701 coords
= clipPos(this, coords
);
6702 var index
= coords
.ch
;
6703 if (coords
.line
< this.first
|| coords
.ch
< 0) return 0;
6704 this.iter(this.first
, coords
.line
, function (line
) {
6705 index
+= line
.text
.length
+ 1;
6710 copy: function(copyHistory
) {
6711 var doc
= new Doc(getLines(this, this.first
, this.first
+ this.size
), this.modeOption
, this.first
);
6712 doc
.scrollTop
= this.scrollTop
; doc
.scrollLeft
= this.scrollLeft
;
6716 doc
.history
.undoDepth
= this.history
.undoDepth
;
6717 doc
.setHistory(this.getHistory());
6722 linkedDoc: function(options
) {
6723 if (!options
) options
= {};
6724 var from = this.first
, to
= this.first
+ this.size
;
6725 if (options
.from != null && options
.from > from) from = options
.from;
6726 if (options
.to
!= null && options
.to
< to
) to
= options
.to
;
6727 var copy
= new Doc(getLines(this, from, to
), options
.mode
|| this.modeOption
, from);
6728 if (options
.sharedHist
) copy
.history
= this.history
;
6729 (this.linked
|| (this.linked
= [])).push({doc
: copy
, sharedHist
: options
.sharedHist
});
6730 copy
.linked
= [{doc
: this, isParent
: true, sharedHist
: options
.sharedHist
}];
6731 copySharedMarkers(copy
, findSharedMarkers(this));
6734 unlinkDoc: function(other
) {
6735 if (other
instanceof CodeMirror
) other
= other
.doc
;
6736 if (this.linked
) for (var i
= 0; i
< this.linked
.length
; ++i
) {
6737 var link
= this.linked
[i
];
6738 if (link
.doc
!= other
) continue;
6739 this.linked
.splice(i
, 1);
6740 other
.unlinkDoc(this);
6741 detachSharedMarkers(findSharedMarkers(this));
6744 // If the histories were shared, split them again
6745 if (other
.history
== this.history
) {
6746 var splitIds
= [other
.id
];
6747 linkedDocs(other
, function(doc
) {splitIds
.push(doc
.id
);}, true);
6748 other
.history
= new History(null);
6749 other
.history
.done
= copyHistoryArray(this.history
.done
, splitIds
);
6750 other
.history
.undone
= copyHistoryArray(this.history
.undone
, splitIds
);
6753 iterLinkedDocs: function(f
) {linkedDocs(this, f
);},
6755 getMode: function() {return this.mode
;},
6756 getEditor: function() {return this.cm
;}
6760 Doc
.prototype.eachLine
= Doc
.prototype.iter
;
6762 // Set up methods on CodeMirror's prototype to redirect to the editor's document.
6763 var dontDelegate
= "iter insert remove copy getEditor".split(" ");
6764 for (var prop
in Doc
.prototype) if (Doc
.prototype.hasOwnProperty(prop
) && indexOf(dontDelegate
, prop
) < 0)
6765 CodeMirror
.prototype[prop
] = (function(method
) {
6766 return function() {return method
.apply(this.doc
, arguments
);};
6767 })(Doc
.prototype[prop
]);
6771 // Call f for all linked documents.
6772 function linkedDocs(doc
, f
, sharedHistOnly
) {
6773 function propagate(doc
, skip
, sharedHist
) {
6774 if (doc
.linked
) for (var i
= 0; i
< doc
.linked
.length
; ++i
) {
6775 var rel
= doc
.linked
[i
];
6776 if (rel
.doc
== skip
) continue;
6777 var shared
= sharedHist
&& rel
.sharedHist
;
6778 if (sharedHistOnly
&& !shared
) continue;
6780 propagate(rel
.doc
, doc
, shared
);
6783 propagate(doc
, null, true);
6786 // Attach a document to an editor.
6787 function attachDoc(cm
, doc
) {
6788 if (doc
.cm
) throw new Error("This document is already in use.");
6791 estimateLineHeights(cm
);
6793 if (!cm
.options
.lineWrapping
) findMaxLine(cm
);
6794 cm
.options
.mode
= doc
.modeOption
;
6800 // Find the line object corresponding to the given line number.
6801 function getLine(doc
, n
) {
6803 if (n
< 0 || n
>= doc
.size
) throw new Error("There is no line " + (n
+ doc
.first
) + " in the document.");
6804 for (var chunk
= doc
; !chunk
.lines
;) {
6805 for (var i
= 0;; ++i
) {
6806 var child
= chunk
.children
[i
], sz
= child
.chunkSize();
6807 if (n
< sz
) { chunk
= child
; break; }
6811 return chunk
.lines
[n
];
6814 // Get the part of a document between two positions, as an array of
6816 function getBetween(doc
, start
, end
) {
6817 var out
= [], n
= start
.line
;
6818 doc
.iter(start
.line
, end
.line
+ 1, function(line
) {
6819 var text
= line
.text
;
6820 if (n
== end
.line
) text
= text
.slice(0, end
.ch
);
6821 if (n
== start
.line
) text
= text
.slice(start
.ch
);
6827 // Get the lines between from and to, as array of strings.
6828 function getLines(doc
, from, to
) {
6830 doc
.iter(from, to
, function(line
) { out
.push(line
.text
); });
6834 // Update the height of a line, propagating the height change
6835 // upwards to parent nodes.
6836 function updateLineHeight(line
, height
) {
6837 var diff
= height
- line
.height
;
6838 if (diff
) for (var n
= line
; n
; n
= n
.parent
) n
.height
+= diff
;
6841 // Given a line object, find its line number by walking up through
6842 // its parent links.
6843 function lineNo(line
) {
6844 if (line
.parent
== null) return null;
6845 var cur
= line
.parent
, no
= indexOf(cur
.lines
, line
);
6846 for (var chunk
= cur
.parent
; chunk
; cur
= chunk
, chunk
= chunk
.parent
) {
6847 for (var i
= 0;; ++i
) {
6848 if (chunk
.children
[i
] == cur
) break;
6849 no
+= chunk
.children
[i
].chunkSize();
6852 return no
+ cur
.first
;
6855 // Find the line at the given vertical position, using the height
6856 // information in the document tree.
6857 function lineAtHeight(chunk
, h
) {
6858 var n
= chunk
.first
;
6860 for (var i
= 0; i
< chunk
.children
.length
; ++i
) {
6861 var child
= chunk
.children
[i
], ch
= child
.height
;
6862 if (h
< ch
) { chunk
= child
; continue outer
; }
6864 n
+= child
.chunkSize();
6867 } while (!chunk
.lines
);
6868 for (var i
= 0; i
< chunk
.lines
.length
; ++i
) {
6869 var line
= chunk
.lines
[i
], lh
= line
.height
;
6877 // Find the height above the given line.
6878 function heightAtLine(lineObj
) {
6879 lineObj
= visualLine(lineObj
);
6881 var h
= 0, chunk
= lineObj
.parent
;
6882 for (var i
= 0; i
< chunk
.lines
.length
; ++i
) {
6883 var line
= chunk
.lines
[i
];
6884 if (line
== lineObj
) break;
6885 else h
+= line
.height
;
6887 for (var p
= chunk
.parent
; p
; chunk
= p
, p
= chunk
.parent
) {
6888 for (var i
= 0; i
< p
.children
.length
; ++i
) {
6889 var cur
= p
.children
[i
];
6890 if (cur
== chunk
) break;
6891 else h
+= cur
.height
;
6897 // Get the bidi ordering for the given line (and cache it). Returns
6898 // false for lines that are fully left-to-right, and an array of
6899 // BidiSpan objects otherwise.
6900 function getOrder(line
) {
6901 var order
= line
.order
;
6902 if (order
== null) order
= line
.order
= bidiOrdering(line
.text
);
6908 function History(startGen
) {
6909 // Arrays of change events and selections. Doing something adds an
6910 // event to done and clears undo. Undoing moves events from done
6911 // to undone, redoing moves them in the other direction.
6912 this.done
= []; this.undone
= [];
6913 this.undoDepth
= Infinity
;
6914 // Used to track when changes can be merged into a single undo
6916 this.lastModTime
= this.lastSelTime
= 0;
6917 this.lastOp
= this.lastSelOp
= null;
6918 this.lastOrigin
= this.lastSelOrigin
= null;
6919 // Used by the isClean() method
6920 this.generation
= this.maxGeneration
= startGen
|| 1;
6923 // Create a history change event from an updateDoc-style change
6925 function historyChangeFromChange(doc
, change
) {
6926 var histChange
= {from: copyPos(change
.from), to
: changeEnd(change
), text
: getBetween(doc
, change
.from, change
.to
)};
6927 attachLocalSpans(doc
, histChange
, change
.from.line
, change
.to
.line
+ 1);
6928 linkedDocs(doc
, function(doc
) {attachLocalSpans(doc
, histChange
, change
.from.line
, change
.to
.line
+ 1);}, true);
6932 // Pop all selection events off the end of a history array. Stop at
6934 function clearSelectionEvents(array
) {
6935 while (array
.length
) {
6936 var last
= lst(array
);
6937 if (last
.ranges
) array
.pop();
6942 // Find the top change event in the history. Pop off selection
6943 // events that are in the way.
6944 function lastChangeEvent(hist
, force
) {
6946 clearSelectionEvents(hist
.done
);
6947 return lst(hist
.done
);
6948 } else if (hist
.done
.length
&& !lst(hist
.done
).ranges
) {
6949 return lst(hist
.done
);
6950 } else if (hist
.done
.length
> 1 && !hist
.done
[hist
.done
.length
- 2].ranges
) {
6952 return lst(hist
.done
);
6956 // Register a change in the history. Merges changes that are within
6957 // a single operation, ore are close together with an origin that
6958 // allows merging (starting with "+") into a single event.
6959 function addChangeToHistory(doc
, change
, selAfter
, opId
) {
6960 var hist
= doc
.history
;
6961 hist
.undone
.length
= 0;
6962 var time
= +new Date
, cur
;
6964 if ((hist
.lastOp
== opId
||
6965 hist
.lastOrigin
== change
.origin
&& change
.origin
&&
6966 ((change
.origin
.charAt(0) == "+" && doc
.cm
&& hist
.lastModTime
> time
- doc
.cm
.options
.historyEventDelay
) ||
6967 change
.origin
.charAt(0) == "*")) &&
6968 (cur
= lastChangeEvent(hist
, hist
.lastOp
== opId
))) {
6969 // Merge this change into the last event
6970 var last
= lst(cur
.changes
);
6971 if (cmp(change
.from, change
.to
) == 0 && cmp(change
.from, last
.to
) == 0) {
6972 // Optimized case for simple insertion -- don't want to add
6973 // new changesets for every character typed
6974 last
.to
= changeEnd(change
);
6976 // Add new sub-event
6977 cur
.changes
.push(historyChangeFromChange(doc
, change
));
6980 // Can not be merged, start a new event.
6981 var before
= lst(hist
.done
);
6982 if (!before
|| !before
.ranges
)
6983 pushSelectionToHistory(doc
.sel
, hist
.done
);
6984 cur
= {changes
: [historyChangeFromChange(doc
, change
)],
6985 generation
: hist
.generation
};
6986 hist
.done
.push(cur
);
6987 while (hist
.done
.length
> hist
.undoDepth
) {
6989 if (!hist
.done
[0].ranges
) hist
.done
.shift();
6992 hist
.done
.push(selAfter
);
6993 hist
.generation
= ++hist
.maxGeneration
;
6994 hist
.lastModTime
= hist
.lastSelTime
= time
;
6995 hist
.lastOp
= hist
.lastSelOp
= opId
;
6996 hist
.lastOrigin
= hist
.lastSelOrigin
= change
.origin
;
6998 if (!last
) signal(doc
, "historyAdded");
7001 function selectionEventCanBeMerged(doc
, origin
, prev
, sel
) {
7002 var ch
= origin
.charAt(0);
7005 prev
.ranges
.length
== sel
.ranges
.length
&&
7006 prev
.somethingSelected() == sel
.somethingSelected() &&
7007 new Date
- doc
.history
.lastSelTime
<= (doc
.cm
? doc
.cm
.options
.historyEventDelay
: 500);
7010 // Called whenever the selection changes, sets the new selection as
7011 // the pending selection in the history, and pushes the old pending
7012 // selection into the 'done' array when it was significantly
7013 // different (in number of selected ranges, emptiness, or time).
7014 function addSelectionToHistory(doc
, sel
, opId
, options
) {
7015 var hist
= doc
.history
, origin
= options
&& options
.origin
;
7017 // A new event is started when the previous origin does not match
7018 // the current, or the origins don't allow matching. Origins
7019 // starting with * are always merged, those starting with + are
7020 // merged when similar and close together in time.
7021 if (opId
== hist
.lastSelOp
||
7022 (origin
&& hist
.lastSelOrigin
== origin
&&
7023 (hist
.lastModTime
== hist
.lastSelTime
&& hist
.lastOrigin
== origin
||
7024 selectionEventCanBeMerged(doc
, origin
, lst(hist
.done
), sel
))))
7025 hist
.done
[hist
.done
.length
- 1] = sel
;
7027 pushSelectionToHistory(sel
, hist
.done
);
7029 hist
.lastSelTime
= +new Date
;
7030 hist
.lastSelOrigin
= origin
;
7031 hist
.lastSelOp
= opId
;
7032 if (options
&& options
.clearRedo
!== false)
7033 clearSelectionEvents(hist
.undone
);
7036 function pushSelectionToHistory(sel
, dest
) {
7037 var top
= lst(dest
);
7038 if (!(top
&& top
.ranges
&& top
.equals(sel
)))
7042 // Used to store marked span information in the history.
7043 function attachLocalSpans(doc
, change
, from, to
) {
7044 var existing
= change
["spans_" + doc
.id
], n
= 0;
7045 doc
.iter(Math
.max(doc
.first
, from), Math
.min(doc
.first
+ doc
.size
, to
), function(line
) {
7046 if (line
.markedSpans
)
7047 (existing
|| (existing
= change
["spans_" + doc
.id
] = {}))[n
] = line
.markedSpans
;
7052 // When un/re-doing restores text containing marked spans, those
7053 // that have been explicitly cleared should not be restored.
7054 function removeClearedSpans(spans
) {
7055 if (!spans
) return null;
7056 for (var i
= 0, out
; i
< spans
.length
; ++i
) {
7057 if (spans
[i
].marker
.explicitlyCleared
) { if (!out
) out
= spans
.slice(0, i
); }
7058 else if (out
) out
.push(spans
[i
]);
7060 return !out
? spans
: out
.length
? out
: null;
7063 // Retrieve and filter the old marked spans stored in a change event.
7064 function getOldSpans(doc
, change
) {
7065 var found
= change
["spans_" + doc
.id
];
7066 if (!found
) return null;
7067 for (var i
= 0, nw
= []; i
< change
.text
.length
; ++i
)
7068 nw
.push(removeClearedSpans(found
[i
]));
7072 // Used both to provide a JSON-safe object in .getHistory, and, when
7073 // detaching a document, to split the history in two
7074 function copyHistoryArray(events
, newGroup
, instantiateSel
) {
7075 for (var i
= 0, copy
= []; i
< events
.length
; ++i
) {
7076 var event
= events
[i
];
7078 copy
.push(instantiateSel
? Selection
.prototype.deepCopy
.call(event
) : event
);
7081 var changes
= event
.changes
, newChanges
= [];
7082 copy
.push({changes
: newChanges
});
7083 for (var j
= 0; j
< changes
.length
; ++j
) {
7084 var change
= changes
[j
], m
;
7085 newChanges
.push({from: change
.from, to
: change
.to
, text
: change
.text
});
7086 if (newGroup
) for (var prop
in change
) if (m
= prop
.match(/^spans_(\d+)$/)) {
7087 if (indexOf(newGroup
, Number(m
[1])) > -1) {
7088 lst(newChanges
)[prop
] = change
[prop
];
7089 delete change
[prop
];
7097 // Rebasing/resetting history to deal with externally-sourced changes
7099 function rebaseHistSelSingle(pos
, from, to
, diff
) {
7100 if (to
< pos
.line
) {
7102 } else if (from < pos
.line
) {
7108 // Tries to rebase an array of history events given a change in the
7109 // document. If the change touches the same lines as the event, the
7110 // event, and everything 'behind' it, is discarded. If the change is
7111 // before the event, the event's positions are updated. Uses a
7112 // copy-on-write scheme for the positions, to avoid having to
7113 // reallocate them all on every rebase, but also avoid problems with
7114 // shared position objects being unsafely updated.
7115 function rebaseHistArray(array
, from, to
, diff
) {
7116 for (var i
= 0; i
< array
.length
; ++i
) {
7117 var sub
= array
[i
], ok
= true;
7119 if (!sub
.copied
) { sub
= array
[i
] = sub
.deepCopy(); sub
.copied
= true; }
7120 for (var j
= 0; j
< sub
.ranges
.length
; j
++) {
7121 rebaseHistSelSingle(sub
.ranges
[j
].anchor
, from, to
, diff
);
7122 rebaseHistSelSingle(sub
.ranges
[j
].head
, from, to
, diff
);
7126 for (var j
= 0; j
< sub
.changes
.length
; ++j
) {
7127 var cur
= sub
.changes
[j
];
7128 if (to
< cur
.from.line
) {
7129 cur
.from = Pos(cur
.from.line
+ diff
, cur
.from.ch
);
7130 cur
.to
= Pos(cur
.to
.line
+ diff
, cur
.to
.ch
);
7131 } else if (from <= cur
.to
.line
) {
7137 array
.splice(0, i
+ 1);
7143 function rebaseHist(hist
, change
) {
7144 var from = change
.from.line
, to
= change
.to
.line
, diff
= change
.text
.length
- (to
- from) - 1;
7145 rebaseHistArray(hist
.done
, from, to
, diff
);
7146 rebaseHistArray(hist
.undone
, from, to
, diff
);
7151 // Due to the fact that we still support jurassic IE versions, some
7152 // compatibility wrappers are needed.
7154 var e_preventDefault
= CodeMirror
.e_preventDefault = function(e
) {
7155 if (e
.preventDefault
) e
.preventDefault();
7156 else e
.returnValue
= false;
7158 var e_stopPropagation
= CodeMirror
.e_stopPropagation = function(e
) {
7159 if (e
.stopPropagation
) e
.stopPropagation();
7160 else e
.cancelBubble
= true;
7162 function e_defaultPrevented(e
) {
7163 return e
.defaultPrevented
!= null ? e
.defaultPrevented
: e
.returnValue
== false;
7165 var e_stop
= CodeMirror
.e_stop = function(e
) {e_preventDefault(e
); e_stopPropagation(e
);};
7167 function e_target(e
) {return e
.target
|| e
.srcElement
;}
7168 function e_button(e
) {
7171 if (e
.button
& 1) b
= 1;
7172 else if (e
.button
& 2) b
= 3;
7173 else if (e
.button
& 4) b
= 2;
7175 if (mac
&& e
.ctrlKey
&& b
== 1) b
= 3;
7181 // Lightweight event framework. on/off also work on DOM nodes,
7182 // registering native DOM handlers.
7184 var on
= CodeMirror
.on = function(emitter
, type
, f
) {
7185 if (emitter
.addEventListener
)
7186 emitter
.addEventListener(type
, f
, false);
7187 else if (emitter
.attachEvent
)
7188 emitter
.attachEvent("on" + type
, f
);
7190 var map
= emitter
._handlers
|| (emitter
._handlers
= {});
7191 var arr
= map
[type
] || (map
[type
] = []);
7196 var off
= CodeMirror
.off = function(emitter
, type
, f
) {
7197 if (emitter
.removeEventListener
)
7198 emitter
.removeEventListener(type
, f
, false);
7199 else if (emitter
.detachEvent
)
7200 emitter
.detachEvent("on" + type
, f
);
7202 var arr
= emitter
._handlers
&& emitter
._handlers
[type
];
7204 for (var i
= 0; i
< arr
.length
; ++i
)
7205 if (arr
[i
] == f
) { arr
.splice(i
, 1); break; }
7209 var signal
= CodeMirror
.signal = function(emitter
, type
/*, values...*/) {
7210 var arr
= emitter
._handlers
&& emitter
._handlers
[type
];
7212 var args
= Array
.prototype.slice
.call(arguments
, 2);
7213 for (var i
= 0; i
< arr
.length
; ++i
) arr
[i
].apply(null, args
);
7216 var orphanDelayedCallbacks
= null;
7218 // Often, we want to signal events at a point where we are in the
7219 // middle of some work, but don't want the handler to start calling
7220 // other methods on the editor, which might be in an inconsistent
7221 // state or simply not expect any other events to happen.
7222 // signalLater looks whether there are any handlers, and schedules
7223 // them to be executed when the last operation ends, or, if no
7224 // operation is active, when a timeout fires.
7225 function signalLater(emitter
, type
/*, values...*/) {
7226 var arr
= emitter
._handlers
&& emitter
._handlers
[type
];
7228 var args
= Array
.prototype.slice
.call(arguments
, 2), list
;
7229 if (operationGroup
) {
7230 list
= operationGroup
.delayedCallbacks
;
7231 } else if (orphanDelayedCallbacks
) {
7232 list
= orphanDelayedCallbacks
;
7234 list
= orphanDelayedCallbacks
= [];
7235 setTimeout(fireOrphanDelayed
, 0);
7237 function bnd(f
) {return function(){f
.apply(null, args
);};};
7238 for (var i
= 0; i
< arr
.length
; ++i
)
7239 list
.push(bnd(arr
[i
]));
7242 function fireOrphanDelayed() {
7243 var delayed
= orphanDelayedCallbacks
;
7244 orphanDelayedCallbacks
= null;
7245 for (var i
= 0; i
< delayed
.length
; ++i
) delayed
[i
]();
7248 // The DOM events that CodeMirror handles can be overridden by
7249 // registering a (non-DOM) handler on the editor for the event name,
7250 // and preventDefault-ing the event in that handler.
7251 function signalDOMEvent(cm
, e
, override
) {
7252 if (typeof e
== "string")
7253 e
= {type
: e
, preventDefault: function() { this.defaultPrevented
= true; }};
7254 signal(cm
, override
|| e
.type
, cm
, e
);
7255 return e_defaultPrevented(e
) || e
.codemirrorIgnore
;
7258 function signalCursorActivity(cm
) {
7259 var arr
= cm
._handlers
&& cm
._handlers
.cursorActivity
;
7261 var set = cm
.curOp
.cursorActivityHandlers
|| (cm
.curOp
.cursorActivityHandlers
= []);
7262 for (var i
= 0; i
< arr
.length
; ++i
) if (indexOf(set, arr
[i
]) == -1)
7266 function hasHandler(emitter
, type
) {
7267 var arr
= emitter
._handlers
&& emitter
._handlers
[type
];
7268 return arr
&& arr
.length
> 0;
7271 // Add on and off methods to a constructor's prototype, to make
7272 // registering events on such objects more convenient.
7273 function eventMixin(ctor
) {
7274 ctor
.prototype.on = function(type
, f
) {on(this, type
, f
);};
7275 ctor
.prototype.off = function(type
, f
) {off(this, type
, f
);};
7280 // Number of pixels added to scroller and sizer to hide scrollbar
7281 var scrollerCutOff
= 30;
7283 // Returned or thrown by various protocols to signal 'I'm not
7285 var Pass
= CodeMirror
.Pass
= {toString: function(){return "CodeMirror.Pass";}};
7287 // Reused option objects for setSelection & friends
7288 var sel_dontScroll
= {scroll
: false}, sel_mouse
= {origin
: "*mouse"}, sel_move
= {origin
: "+move"};
7290 function Delayed() {this.id
= null;}
7291 Delayed
.prototype.set = function(ms
, f
) {
7292 clearTimeout(this.id
);
7293 this.id
= setTimeout(f
, ms
);
7296 // Counts the column offset in a string, taking tabs into account.
7297 // Used mostly to find indentation.
7298 var countColumn
= CodeMirror
.countColumn = function(string
, end
, tabSize
, startIndex
, startValue
) {
7300 end
= string
.search(/[^\s\u00a0]/);
7301 if (end
== -1) end
= string
.length
;
7303 for (var i
= startIndex
|| 0, n
= startValue
|| 0;;) {
7304 var nextTab
= string
.indexOf("\t", i
);
7305 if (nextTab
< 0 || nextTab
>= end
)
7306 return n
+ (end
- i
);
7308 n
+= tabSize
- (n
% tabSize
);
7313 // The inverse of countColumn -- find the offset that corresponds to
7314 // a particular column.
7315 function findColumn(string
, goal
, tabSize
) {
7316 for (var pos
= 0, col
= 0;;) {
7317 var nextTab
= string
.indexOf("\t", pos
);
7318 if (nextTab
== -1) nextTab
= string
.length
;
7319 var skipped
= nextTab
- pos
;
7320 if (nextTab
== string
.length
|| col
+ skipped
>= goal
)
7321 return pos
+ Math
.min(skipped
, goal
- col
);
7322 col
+= nextTab
- pos
;
7323 col
+= tabSize
- (col
% tabSize
);
7325 if (col
>= goal
) return pos
;
7329 var spaceStrs
= [""];
7330 function spaceStr(n
) {
7331 while (spaceStrs
.length
<= n
)
7332 spaceStrs
.push(lst(spaceStrs
) + " ");
7333 return spaceStrs
[n
];
7336 function lst(arr
) { return arr
[arr
.length
-1]; }
7338 var selectInput = function(node
) { node
.select(); };
7339 if (ios
) // Mobile Safari apparently has a bug where select() is broken.
7340 selectInput = function(node
) { node
.selectionStart
= 0; node
.selectionEnd
= node
.value
.length
; };
7341 else if (ie
) // Suppress mysterious IE10 errors
7342 selectInput = function(node
) { try { node
.select(); } catch(_e
) {} };
7344 function indexOf(array
, elt
) {
7345 for (var i
= 0; i
< array
.length
; ++i
)
7346 if (array
[i
] == elt
) return i
;
7349 if ([].indexOf
) indexOf = function(array
, elt
) { return array
.indexOf(elt
); };
7350 function map(array
, f
) {
7352 for (var i
= 0; i
< array
.length
; i
++) out
[i
] = f(array
[i
], i
);
7355 if ([].map
) map = function(array
, f
) { return array
.map(f
); };
7357 function createObj(base
, props
) {
7359 if (Object
.create
) {
7360 inst
= Object
.create(base
);
7362 var ctor = function() {};
7363 ctor
.prototype = base
;
7366 if (props
) copyObj(props
, inst
);
7370 function copyObj(obj
, target
, overwrite
) {
7371 if (!target
) target
= {};
7372 for (var prop
in obj
)
7373 if (obj
.hasOwnProperty(prop
) && (overwrite
!== false || !target
.hasOwnProperty(prop
)))
7374 target
[prop
] = obj
[prop
];
7379 var args
= Array
.prototype.slice
.call(arguments
, 1);
7380 return function(){return f
.apply(null, args
);};
7383 var nonASCIISingleCaseWordChar
= /[\u00df\u0590-\u05f4\u0600-\u06ff\u3040-\u309f\u30a0-\u30ff\u3400-\u4db5\u4e00-\u9fcc\uac00-\ud7af]/;
7384 var isWordCharBasic
= CodeMirror
.isWordChar = function(ch
) {
7385 return /\w/.test(ch
) || ch
> "\x80" &&
7386 (ch
.toUpperCase() != ch
.toLowerCase() || nonASCIISingleCaseWordChar
.test(ch
));
7388 function isWordChar(ch
, helper
) {
7389 if (!helper
) return isWordCharBasic(ch
);
7390 if (helper
.source
.indexOf("\\w") > -1 && isWordCharBasic(ch
)) return true;
7391 return helper
.test(ch
);
7394 function isEmpty(obj
) {
7395 for (var n
in obj
) if (obj
.hasOwnProperty(n
) && obj
[n
]) return false;
7399 // Extending unicode characters. A series of a non-extending char +
7400 // any number of extending chars is treated as a single unit as far
7401 // as editing and measuring is concerned. This is not fully correct,
7402 // since some scripts/fonts/browsers also treat other configurations
7403 // of code points as a group.
7404 var extendingChars
= /[\u0300-\u036f\u0483-\u0489\u0591-\u05bd\u05bf\u05c1\u05c2\u05c4\u05c5\u05c7\u0610-\u061a\u064b-\u065e\u0670\u06d6-\u06dc\u06de-\u06e4\u06e7\u06e8\u06ea-\u06ed\u0711\u0730-\u074a\u07a6-\u07b0\u07eb-\u07f3\u0816-\u0819\u081b-\u0823\u0825-\u0827\u0829-\u082d\u0900-\u0902\u093c\u0941-\u0948\u094d\u0951-\u0955\u0962\u0963\u0981\u09bc\u09be\u09c1-\u09c4\u09cd\u09d7\u09e2\u09e3\u0a01\u0a02\u0a3c\u0a41\u0a42\u0a47\u0a48\u0a4b-\u0a4d\u0a51\u0a70\u0a71\u0a75\u0a81\u0a82\u0abc\u0ac1-\u0ac5\u0ac7\u0ac8\u0acd\u0ae2\u0ae3\u0b01\u0b3c\u0b3e\u0b3f\u0b41-\u0b44\u0b4d\u0b56\u0b57\u0b62\u0b63\u0b82\u0bbe\u0bc0\u0bcd\u0bd7\u0c3e-\u0c40\u0c46-\u0c48\u0c4a-\u0c4d\u0c55\u0c56\u0c62\u0c63\u0cbc\u0cbf\u0cc2\u0cc6\u0ccc\u0ccd\u0cd5\u0cd6\u0ce2\u0ce3\u0d3e\u0d41-\u0d44\u0d4d\u0d57\u0d62\u0d63\u0dca\u0dcf\u0dd2-\u0dd4\u0dd6\u0ddf\u0e31\u0e34-\u0e3a\u0e47-\u0e4e\u0eb1\u0eb4-\u0eb9\u0ebb\u0ebc\u0ec8-\u0ecd\u0f18\u0f19\u0f35\u0f37\u0f39\u0f71-\u0f7e\u0f80-\u0f84\u0f86\u0f87\u0f90-\u0f97\u0f99-\u0fbc\u0fc6\u102d-\u1030\u1032-\u1037\u1039\u103a\u103d\u103e\u1058\u1059\u105e-\u1060\u1071-\u1074\u1082\u1085\u1086\u108d\u109d\u135f\u1712-\u1714\u1732-\u1734\u1752\u1753\u1772\u1773\u17b7-\u17bd\u17c6\u17c9-\u17d3\u17dd\u180b-\u180d\u18a9\u1920-\u1922\u1927\u1928\u1932\u1939-\u193b\u1a17\u1a18\u1a56\u1a58-\u1a5e\u1a60\u1a62\u1a65-\u1a6c\u1a73-\u1a7c\u1a7f\u1b00-\u1b03\u1b34\u1b36-\u1b3a\u1b3c\u1b42\u1b6b-\u1b73\u1b80\u1b81\u1ba2-\u1ba5\u1ba8\u1ba9\u1c2c-\u1c33\u1c36\u1c37\u1cd0-\u1cd2\u1cd4-\u1ce0\u1ce2-\u1ce8\u1ced\u1dc0-\u1de6\u1dfd-\u1dff\u200c\u200d\u20d0-\u20f0\u2cef-\u2cf1\u2de0-\u2dff\u302a-\u302f\u3099\u309a\ua66f-\ua672\ua67c\ua67d\ua6f0\ua6f1\ua802\ua806\ua80b\ua825\ua826\ua8c4\ua8e0-\ua8f1\ua926-\ua92d\ua947-\ua951\ua980-\ua982\ua9b3\ua9b6-\ua9b9\ua9bc\uaa29-\uaa2e\uaa31\uaa32\uaa35\uaa36\uaa43\uaa4c\uaab0\uaab2-\uaab4\uaab7\uaab8\uaabe\uaabf\uaac1\uabe5\uabe8\uabed\udc00-\udfff\ufb1e\ufe00-\ufe0f\ufe20-\ufe26\uff9e\uff9f]/;
7405 function isExtendingChar(ch
) { return ch
.charCodeAt(0) >= 768 && extendingChars
.test(ch
); }
7409 function elt(tag
, content
, className
, style
) {
7410 var e
= document
.createElement(tag
);
7411 if (className
) e
.className
= className
;
7412 if (style
) e
.style
.cssText
= style
;
7413 if (typeof content
== "string") e
.appendChild(document
.createTextNode(content
));
7414 else if (content
) for (var i
= 0; i
< content
.length
; ++i
) e
.appendChild(content
[i
]);
7419 if (document
.createRange
) range = function(node
, start
, end
) {
7420 var r
= document
.createRange();
7421 r
.setEnd(node
, end
);
7422 r
.setStart(node
, start
);
7425 else range = function(node
, start
, end
) {
7426 var r
= document
.body
.createTextRange();
7427 try { r
.moveToElementText(node
.parentNode
); }
7428 catch(e
) { return r
; }
7430 r
.moveEnd("character", end
);
7431 r
.moveStart("character", start
);
7435 function removeChildren(e
) {
7436 for (var count
= e
.childNodes
.length
; count
> 0; --count
)
7437 e
.removeChild(e
.firstChild
);
7441 function removeChildrenAndAdd(parent
, e
) {
7442 return removeChildren(parent
).appendChild(e
);
7445 function contains(parent
, child
) {
7446 if (parent
.contains
)
7447 return parent
.contains(child
);
7448 while (child
= child
.parentNode
)
7449 if (child
== parent
) return true;
7452 function activeElt() { return document
.activeElement
; }
7453 // Older versions of IE throws unspecified error when touching
7454 // document.activeElement in some cases (during loading, in iframe)
7455 if (ie
&& ie_version
< 11) activeElt = function() {
7456 try { return document
.activeElement
; }
7457 catch(e
) { return document
.body
; }
7460 function classTest(cls
) { return new RegExp("(^|\\s)" + cls
+ "(?:$|\\s)\\s*"); }
7461 var rmClass
= CodeMirror
.rmClass = function(node
, cls
) {
7462 var current
= node
.className
;
7463 var match
= classTest(cls
).exec(current
);
7465 var after
= current
.slice(match
.index
+ match
[0].length
);
7466 node
.className
= current
.slice(0, match
.index
) + (after
? match
[1] + after
: "");
7469 var addClass
= CodeMirror
.addClass = function(node
, cls
) {
7470 var current
= node
.className
;
7471 if (!classTest(cls
).test(current
)) node
.className
+= (current
? " " : "") + cls
;
7473 function joinClasses(a
, b
) {
7474 var as
= a
.split(" ");
7475 for (var i
= 0; i
< as
.length
; i
++)
7476 if (as
[i
] && !classTest(as
[i
]).test(b
)) b
+= " " + as
[i
];
7480 // WINDOW-WIDE EVENTS
7482 // These must be handled carefully, because naively registering a
7483 // handler for each editor will cause the editors to never be
7484 // garbage collected.
7486 function forEachCodeMirror(f
) {
7487 if (!document
.body
.getElementsByClassName
) return;
7488 var byClass
= document
.body
.getElementsByClassName("CodeMirror");
7489 for (var i
= 0; i
< byClass
.length
; i
++) {
7490 var cm
= byClass
[i
].CodeMirror
;
7495 var globalsRegistered
= false;
7496 function ensureGlobalHandlers() {
7497 if (globalsRegistered
) return;
7498 registerGlobalHandlers();
7499 globalsRegistered
= true;
7501 function registerGlobalHandlers() {
7502 // When the window resizes, we need to refresh active editors.
7504 on(window
, "resize", function() {
7505 if (resizeTimer
== null) resizeTimer
= setTimeout(function() {
7507 knownScrollbarWidth
= null;
7508 forEachCodeMirror(onResize
);
7511 // When the window loses focus, we want to show the editor as blurred
7512 on(window
, "blur", function() {
7513 forEachCodeMirror(onBlur
);
7517 // FEATURE DETECTION
7519 // Detect drag-and-drop
7520 var dragAndDrop = function() {
7521 // There is *some* kind of drag-and-drop support in IE6-8, but I
7522 // couldn't get it to work yet.
7523 if (ie
&& ie_version
< 9) return false;
7524 var div
= elt('div');
7525 return "draggable" in div
|| "dragDrop" in div
;
7528 var knownScrollbarWidth
;
7529 function scrollbarWidth(measure
) {
7530 if (knownScrollbarWidth
!= null) return knownScrollbarWidth
;
7531 var test
= elt("div", null, null, "width: 50px; height: 50px; overflow-x: scroll");
7532 removeChildrenAndAdd(measure
, test
);
7533 if (test
.offsetWidth
)
7534 knownScrollbarWidth
= test
.offsetHeight
- test
.clientHeight
;
7535 return knownScrollbarWidth
|| 0;
7539 function zeroWidthElement(measure
) {
7540 if (zwspSupported
== null) {
7541 var test
= elt("span", "\u200b");
7542 removeChildrenAndAdd(measure
, elt("span", [test
, document
.createTextNode("x")]));
7543 if (measure
.firstChild
.offsetHeight
!= 0)
7544 zwspSupported
= test
.offsetWidth
<= 1 && test
.offsetHeight
> 2 && !(ie
&& ie_version
< 8);
7546 if (zwspSupported
) return elt("span", "\u200b");
7547 else return elt("span", "\u00a0", null, "display: inline-block; width: 1px; margin-right: -1px");
7550 // Feature-detect IE's crummy client rect reporting for bidi text
7552 function hasBadBidiRects(measure
) {
7553 if (badBidiRects
!= null) return badBidiRects
;
7554 var txt
= removeChildrenAndAdd(measure
, document
.createTextNode("A\u062eA"));
7555 var r0
= range(txt
, 0, 1).getBoundingClientRect();
7556 if (!r0
|| r0
.left
== r0
.right
) return false; // Safari returns null in some cases (#2780)
7557 var r1
= range(txt
, 1, 2).getBoundingClientRect();
7558 return badBidiRects
= (r1
.right
- r0
.right
< 3);
7561 // See if "".split is the broken IE version, if so, provide an
7562 // alternative way to split lines.
7563 var splitLines
= CodeMirror
.splitLines
= "\n\nb".split(/\n/).length
!= 3 ? function(string
) {
7564 var pos
= 0, result
= [], l
= string
.length
;
7566 var nl
= string
.indexOf("\n", pos
);
7567 if (nl
== -1) nl
= string
.length
;
7568 var line
= string
.slice(pos
, string
.charAt(nl
- 1) == "\r" ? nl
- 1 : nl
);
7569 var rt
= line
.indexOf("\r");
7571 result
.push(line
.slice(0, rt
));
7579 } : function(string
){return string
.split(/\r\n?|\n/);};
7581 var hasSelection
= window
.getSelection
? function(te
) {
7582 try { return te
.selectionStart
!= te
.selectionEnd
; }
7583 catch(e
) { return false; }
7585 try {var range
= te
.ownerDocument
.selection
.createRange();}
7587 if (!range
|| range
.parentElement() != te
) return false;
7588 return range
.compareEndPoints("StartToEnd", range
) != 0;
7591 var hasCopyEvent
= (function() {
7593 if ("oncopy" in e
) return true;
7594 e
.setAttribute("oncopy", "return;");
7595 return typeof e
.oncopy
== "function";
7598 var badZoomedRects
= null;
7599 function hasBadZoomedRects(measure
) {
7600 if (badZoomedRects
!= null) return badZoomedRects
;
7601 var node
= removeChildrenAndAdd(measure
, elt("span", "x"));
7602 var normal
= node
.getBoundingClientRect();
7603 var fromRange
= range(node
, 0, 1).getBoundingClientRect();
7604 return badZoomedRects
= Math
.abs(normal
.left
- fromRange
.left
) > 1;
7609 var keyNames
= {3: "Enter", 8: "Backspace", 9: "Tab", 13: "Enter", 16: "Shift", 17: "Ctrl", 18: "Alt",
7610 19: "Pause", 20: "CapsLock", 27: "Esc", 32: "Space", 33: "PageUp", 34: "PageDown", 35: "End",
7611 36: "Home", 37: "Left", 38: "Up", 39: "Right", 40: "Down", 44: "PrintScrn", 45: "Insert",
7612 46: "Delete", 59: ";", 61: "=", 91: "Mod", 92: "Mod", 93: "Mod", 107: "=", 109: "-", 127: "Delete",
7613 173: "-", 186: ";", 187: "=", 188: ",", 189: "-", 190: ".", 191: "/", 192: "`", 219: "[", 220: "\\",
7614 221: "]", 222: "'", 63232: "Up", 63233: "Down", 63234: "Left", 63235: "Right", 63272: "Delete",
7615 63273: "Home", 63275: "End", 63276: "PageUp", 63277: "PageDown", 63302: "Insert"};
7616 CodeMirror
.keyNames
= keyNames
;
7619 for (var i
= 0; i
< 10; i
++) keyNames
[i
+ 48] = keyNames
[i
+ 96] = String(i
);
7621 for (var i
= 65; i
<= 90; i
++) keyNames
[i
] = String
.fromCharCode(i
);
7623 for (var i
= 1; i
<= 12; i
++) keyNames
[i
+ 111] = keyNames
[i
+ 63235] = "F" + i
;
7628 function iterateBidiSections(order
, from, to
, f
) {
7629 if (!order
) return f(from, to
, "ltr");
7631 for (var i
= 0; i
< order
.length
; ++i
) {
7632 var part
= order
[i
];
7633 if (part
.from < to
&& part
.to
> from || from == to
&& part
.to
== from) {
7634 f(Math
.max(part
.from, from), Math
.min(part
.to
, to
), part
.level
== 1 ? "rtl" : "ltr");
7638 if (!found
) f(from, to
, "ltr");
7641 function bidiLeft(part
) { return part
.level
% 2 ? part
.to
: part
.from; }
7642 function bidiRight(part
) { return part
.level
% 2 ? part
.from : part
.to
; }
7644 function lineLeft(line
) { var order
= getOrder(line
); return order
? bidiLeft(order
[0]) : 0; }
7645 function lineRight(line
) {
7646 var order
= getOrder(line
);
7647 if (!order
) return line
.text
.length
;
7648 return bidiRight(lst(order
));
7651 function lineStart(cm
, lineN
) {
7652 var line
= getLine(cm
.doc
, lineN
);
7653 var visual
= visualLine(line
);
7654 if (visual
!= line
) lineN
= lineNo(visual
);
7655 var order
= getOrder(visual
);
7656 var ch
= !order
? 0 : order
[0].level
% 2 ? lineRight(visual
) : lineLeft(visual
);
7657 return Pos(lineN
, ch
);
7659 function lineEnd(cm
, lineN
) {
7660 var merged
, line
= getLine(cm
.doc
, lineN
);
7661 while (merged
= collapsedSpanAtEnd(line
)) {
7662 line
= merged
.find(1, true).line
;
7665 var order
= getOrder(line
);
7666 var ch
= !order
? line
.text
.length
: order
[0].level
% 2 ? lineLeft(line
) : lineRight(line
);
7667 return Pos(lineN
== null ? lineNo(line
) : lineN
, ch
);
7669 function lineStartSmart(cm
, pos
) {
7670 var start
= lineStart(cm
, pos
.line
);
7671 var line
= getLine(cm
.doc
, start
.line
);
7672 var order
= getOrder(line
);
7673 if (!order
|| order
[0].level
== 0) {
7674 var firstNonWS
= Math
.max(0, line
.text
.search(/\S/));
7675 var inWS
= pos
.line
== start
.line
&& pos
.ch
<= firstNonWS
&& pos
.ch
;
7676 return Pos(start
.line
, inWS
? 0 : firstNonWS
);
7681 function compareBidiLevel(order
, a
, b
) {
7682 var linedir
= order
[0].level
;
7683 if (a
== linedir
) return true;
7684 if (b
== linedir
) return false;
7688 function getBidiPartAt(order
, pos
) {
7690 for (var i
= 0, found
; i
< order
.length
; ++i
) {
7692 if (cur
.from < pos
&& cur
.to
> pos
) return i
;
7693 if ((cur
.from == pos
|| cur
.to
== pos
)) {
7694 if (found
== null) {
7696 } else if (compareBidiLevel(order
, cur
.level
, order
[found
].level
)) {
7697 if (cur
.from != cur
.to
) bidiOther
= found
;
7700 if (cur
.from != cur
.to
) bidiOther
= i
;
7708 function moveInLine(line
, pos
, dir
, byUnit
) {
7709 if (!byUnit
) return pos
+ dir
;
7711 while (pos
> 0 && isExtendingChar(line
.text
.charAt(pos
)));
7715 // This is needed in order to move 'visually' through bi-directional
7716 // text -- i.e., pressing left should make the cursor go left, even
7717 // when in RTL text. The tricky part is the 'jumps', where RTL and
7718 // LTR text touch each other. This often requires the cursor offset
7719 // to move more than one unit, in order to visually move one unit.
7720 function moveVisually(line
, start
, dir
, byUnit
) {
7721 var bidi
= getOrder(line
);
7722 if (!bidi
) return moveLogically(line
, start
, dir
, byUnit
);
7723 var pos
= getBidiPartAt(bidi
, start
), part
= bidi
[pos
];
7724 var target
= moveInLine(line
, start
, part
.level
% 2 ? -dir
: dir
, byUnit
);
7727 if (target
> part
.from && target
< part
.to
) return target
;
7728 if (target
== part
.from || target
== part
.to
) {
7729 if (getBidiPartAt(bidi
, target
) == pos
) return target
;
7730 part
= bidi
[pos
+= dir
];
7731 return (dir
> 0) == part
.level
% 2 ? part
.to
: part
.from;
7733 part
= bidi
[pos
+= dir
];
7734 if (!part
) return null;
7735 if ((dir
> 0) == part
.level
% 2)
7736 target
= moveInLine(line
, part
.to
, -1, byUnit
);
7738 target
= moveInLine(line
, part
.from, 1, byUnit
);
7743 function moveLogically(line
, start
, dir
, byUnit
) {
7744 var target
= start
+ dir
;
7745 if (byUnit
) while (target
> 0 && isExtendingChar(line
.text
.charAt(target
))) target
+= dir
;
7746 return target
< 0 || target
> line
.text
.length
? null : target
;
7749 // Bidirectional ordering algorithm
7750 // See http://unicode.org/reports/tr9/tr9-13.html for the algorithm
7751 // that this (partially) implements.
7753 // One-char codes used for character types:
7754 // L (L): Left-to-Right
7755 // R (R): Right-to-Left
7756 // r (AL): Right-to-Left Arabic
7757 // 1 (EN): European Number
7758 // + (ES): European Number Separator
7759 // % (ET): European Number Terminator
7760 // n (AN): Arabic Number
7761 // , (CS): Common Number Separator
7762 // m (NSM): Non-Spacing Mark
7763 // b (BN): Boundary Neutral
7764 // s (B): Paragraph Separator
7765 // t (S): Segment Separator
7766 // w (WS): Whitespace
7767 // N (ON): Other Neutrals
7769 // Returns null if characters are ordered as they appear
7770 // (left-to-right), or an array of sections ({from, to, level}
7771 // objects) in the order in which they occur visually.
7772 var bidiOrdering
= (function() {
7773 // Character types for codepoints 0 to 0xff
7774 var lowTypes
= "bbbbbbbbbtstwsbbbbbbbbbbbbbbssstwNN%%%NNNNNN,N,N1111111111NNNNNNNLLLLLLLLLLLLLLLLLLLLLLLLLLNNNNNNLLLLLLLLLLLLLLLLLLLLLLLLLLNNNNbbbbbbsbbbbbbbbbbbbbbbbbbbbbbbbbb,N%%%%NNNNLNNNNN%%11NLNNN1LNNNNNLLLLLLLLLLLLLLLLLLLLLLLNLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLLN";
7775 // Character types for codepoints 0x600 to 0x6ff
7776 var arabicTypes
= "rrrrrrrrrrrr,rNNmmmmmmrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrmmmmmmmmmmmmmmrrrrrrrnnnnnnnnnn%nnrrrmrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrrmmmmmmmmmmmmmmmmmmmNmmmm";
7777 function charType(code
) {
7778 if (code
<= 0xf7) return lowTypes
.charAt(code
);
7779 else if (0x590 <= code
&& code
<= 0x5f4) return "R";
7780 else if (0x600 <= code
&& code
<= 0x6ed) return arabicTypes
.charAt(code
- 0x600);
7781 else if (0x6ee <= code
&& code
<= 0x8ac) return "r";
7782 else if (0x2000 <= code
&& code
<= 0x200b) return "w";
7783 else if (code
== 0x200c) return "b";
7787 var bidiRE
= /[\u0590-\u05f4\u0600-\u06ff\u0700-\u08ac]/;
7788 var isNeutral
= /[stwN]/, isStrong
= /[LRr]/, countsAsLeft
= /[Lb1n]/, countsAsNum
= /[1n]/;
7789 // Browsers seem to always treat the boundaries of block elements as being L.
7790 var outerType
= "L";
7792 function BidiSpan(level
, from, to
) {
7794 this.from = from; this.to
= to
;
7797 return function(str
) {
7798 if (!bidiRE
.test(str
)) return false;
7799 var len
= str
.length
, types
= [];
7800 for (var i
= 0, type
; i
< len
; ++i
)
7801 types
.push(type
= charType(str
.charCodeAt(i
)));
7803 // W1. Examine each non-spacing mark (NSM) in the level run, and
7804 // change the type of the NSM to the type of the previous
7805 // character. If the NSM is at the start of the level run, it will
7806 // get the type of sor.
7807 for (var i
= 0, prev
= outerType
; i
< len
; ++i
) {
7808 var type
= types
[i
];
7809 if (type
== "m") types
[i
] = prev
;
7813 // W2. Search backwards from each instance of a European number
7814 // until the first strong type (R, L, AL, or sor) is found. If an
7815 // AL is found, change the type of the European number to Arabic
7817 // W3. Change all ALs to R.
7818 for (var i
= 0, cur
= outerType
; i
< len
; ++i
) {
7819 var type
= types
[i
];
7820 if (type
== "1" && cur
== "r") types
[i
] = "n";
7821 else if (isStrong
.test(type
)) { cur
= type
; if (type
== "r") types
[i
] = "R"; }
7824 // W4. A single European separator between two European numbers
7825 // changes to a European number. A single common separator between
7826 // two numbers of the same type changes to that type.
7827 for (var i
= 1, prev
= types
[0]; i
< len
- 1; ++i
) {
7828 var type
= types
[i
];
7829 if (type
== "+" && prev
== "1" && types
[i
+1] == "1") types
[i
] = "1";
7830 else if (type
== "," && prev
== types
[i
+1] &&
7831 (prev
== "1" || prev
== "n")) types
[i
] = prev
;
7835 // W5. A sequence of European terminators adjacent to European
7836 // numbers changes to all European numbers.
7837 // W6. Otherwise, separators and terminators change to Other
7839 for (var i
= 0; i
< len
; ++i
) {
7840 var type
= types
[i
];
7841 if (type
== ",") types
[i
] = "N";
7842 else if (type
== "%") {
7843 for (var end
= i
+ 1; end
< len
&& types
[end
] == "%"; ++end
) {}
7844 var replace
= (i
&& types
[i
-1] == "!") || (end
< len
&& types
[end
] == "1") ? "1" : "N";
7845 for (var j
= i
; j
< end
; ++j
) types
[j
] = replace
;
7850 // W7. Search backwards from each instance of a European number
7851 // until the first strong type (R, L, or sor) is found. If an L is
7852 // found, then change the type of the European number to L.
7853 for (var i
= 0, cur
= outerType
; i
< len
; ++i
) {
7854 var type
= types
[i
];
7855 if (cur
== "L" && type
== "1") types
[i
] = "L";
7856 else if (isStrong
.test(type
)) cur
= type
;
7859 // N1. A sequence of neutrals takes the direction of the
7860 // surrounding strong text if the text on both sides has the same
7861 // direction. European and Arabic numbers act as if they were R in
7862 // terms of their influence on neutrals. Start-of-level-run (sor)
7863 // and end-of-level-run (eor) are used at level run boundaries.
7864 // N2. Any remaining neutrals take the embedding direction.
7865 for (var i
= 0; i
< len
; ++i
) {
7866 if (isNeutral
.test(types
[i
])) {
7867 for (var end
= i
+ 1; end
< len
&& isNeutral
.test(types
[end
]); ++end
) {}
7868 var before
= (i
? types
[i
-1] : outerType
) == "L";
7869 var after
= (end
< len
? types
[end
] : outerType
) == "L";
7870 var replace
= before
|| after
? "L" : "R";
7871 for (var j
= i
; j
< end
; ++j
) types
[j
] = replace
;
7876 // Here we depart from the documented algorithm, in order to avoid
7877 // building up an actual levels array. Since there are only three
7878 // levels (0, 1, 2) in an implementation that doesn't take
7879 // explicit embedding into account, we can build up the order on
7880 // the fly, without following the level-based algorithm.
7882 for (var i
= 0; i
< len
;) {
7883 if (countsAsLeft
.test(types
[i
])) {
7885 for (++i
; i
< len
&& countsAsLeft
.test(types
[i
]); ++i
) {}
7886 order
.push(new BidiSpan(0, start
, i
));
7888 var pos
= i
, at
= order
.length
;
7889 for (++i
; i
< len
&& types
[i
] != "L"; ++i
) {}
7890 for (var j
= pos
; j
< i
;) {
7891 if (countsAsNum
.test(types
[j
])) {
7892 if (pos
< j
) order
.splice(at
, 0, new BidiSpan(1, pos
, j
));
7894 for (++j
; j
< i
&& countsAsNum
.test(types
[j
]); ++j
) {}
7895 order
.splice(at
, 0, new BidiSpan(2, nstart
, j
));
7899 if (pos
< i
) order
.splice(at
, 0, new BidiSpan(1, pos
, i
));
7902 if (order
[0].level
== 1 && (m
= str
.match(/^\s+/))) {
7903 order
[0].from = m
[0].length
;
7904 order
.unshift(new BidiSpan(0, 0, m
[0].length
));
7906 if (lst(order
).level
== 1 && (m
= str
.match(/\s+$/))) {
7907 lst(order
).to
-= m
[0].length
;
7908 order
.push(new BidiSpan(0, len
- m
[0].length
, len
));
7910 if (order
[0].level
!= lst(order
).level
)
7911 order
.push(new BidiSpan(order
[0].level
, len
, len
));
7919 CodeMirror
.version
= "4.8.0";