Release notes and version history
Version 4.x
21-07-2014: Version 4.4:
- Note: Some events might now fire in slightly
different order (
"change"is still guaranteed to fire before"cursorActivity") - Nested operations in multiple editors are now synced (complete at same time, reducing DOM reflows)
- Visual block mode for vim (<C-v>) is nearly complete
- New mode: Kotlin
- Better multi-selection paste for text copied from multiple CodeMirror selections
- Full list of patches.
23-06-2014: Version 4.3:
- Several vim bindings
improvements: search and exCommand history, global flag
for
:substitute,:globalcommand. - Allow hiding the cursor by
setting
cursorBlinkRateto a negative value. - Make gutter markers themeable, use this in foldgutter.
- Full list of patches.
19-05-2014: Version 4.2:
- Fix problem where some modes were broken by the fact that empty tokens were forbidden.
- Several fixes to context menu handling.
- On undo, scroll change, not cursor, into view.
- Rewritten Jade mode.
- Various improvements to Shell (support for more syntax) and Python (better indentation) modes.
- New mode: Cypher.
- New theme: Neo.
- Support direct styling options (color, line style, width) in the rulers addon.
- Recognize per-editor configuration for the show-hint and foldcode addons.
- More intelligent scanning for existing close tags in closetag addon.
- In the Vim bindings: Fix bracket matching, support case conversion in visual mode, visual paste, append action.
- Full list of patches.
22-04-2014: Version 4.1:
- Slightly incompatible:
The
"cursorActivity"event now fires after all other events for the operation (and only for handlers that were actually registered at the time the activity happened). - New command:
insertSoftTab. - New mode: Django.
- Improved modes: Verilog (rewritten), Jinja2, Haxe, PHP (string interpolation highlighted), JavaScript (indentation of trailing else, template strings), LiveScript (multi-line strings).
- Many small issues from the 3.x→4.x transition were found and fixed.
- Full list of patches.
20-03-2014: Version 4.0:
This is a new major version of CodeMirror. There are a few incompatible changes in the API. Upgrade with care, and read the upgrading guide.
- Multiple selections (ctrl-click, alt-drag, API).
- Sublime Text bindings.
- Module loader shims wrapped around all modules.
- Selection undo/redo.
- Improved character measuring (faster, handles wrapped lines more robustly).
- Full list of patches.
Version 3.x
22-04-2014: Version 3.24:
Merges the improvements from 4.1 that could easily be applied to the 3.x code. Also improves the way the editor size is updated when line widgets change.
20-03-2014: Version 3.23:
- In the XML mode,
add
bracketsstyle to angle brackets, fix case-sensitivity of tags for HTML. - New mode: Dylan.
- Many improvements to the Vim bindings.
21-02-2014: Version 3.22:
- Adds the
findMarksmethod. - New addons: rulers, markdown-fold, yaml-lint.
- New theme: mdn-like.
- New mode: Solr.
- Full list of patches.
16-01-2014: Version 3.21:
- Auto-indenting a block will no longer add trailing whitespace to blank lines.
- Marking text has a new option
clearWhenEmptyto control auto-removal. - Several bugfixes in the handling of bidirectional text.
- The XML and CSS modes were largely rewritten. LESS support was added to the CSS mode.
- The OCaml mode was moved to an mllike mode, F# support added.
- Make it possible to fetch multiple applicable helper values with
getHelpers, and to register helpers matched on predicates withregisterGlobalHelper. - New theme pastel-on-dark.
- Better ECMAScript 6 support in JavaScript mode.
- Full list of patches.
21-11-2013: Version 3.20:
- New modes: Julia and PEG.js.
- Support ECMAScript 6 in the JavaScript mode.
- Improved indentation for the CoffeeScript mode.
- Make non-printable-character representation configurable.
- Add ‘notification’ functionality to dialog addon.
- Full list of patches.
21-10-2013: Version 3.19:
- New modes: Eiffel, Gherkin, MSSQL dialect.
- New addons: hardwrap, sql-hint.
- New theme: MBO.
- Add support for line-level styling from mode tokenizers.
- Full list of patches.
23-09-2013: Version 3.18:
Emergency release to fix a problem in 3.17
where .setOption("lineNumbers", false) would raise an
error.
23-09-2013: Version 3.17:
- New modes: Fortran, Octave (Matlab), TOML, and DTD.
- New addons:
css-lint,css-hint. - Improve resilience to CSS 'frameworks' that globally mess up
box-sizing. - Full list of patches.
21-08-2013: Version 3.16:
- The whole codebase is now under a single license file.
- The project page was overhauled and redesigned.
- New themes: Paraiso (light), The Matrix.
- Improved interaction between themes and active-line/matchbrackets addons.
- New folding function
CodeMirror.fold.comment. - Added fullscreen addon.
- Full list of patches.
29-07-2013: Version 3.15:
- New modes: Jade, Nginx.
- New addons: Tern, matchtags, and foldgutter.
- Introduced helper concept (context).
- New method:
getModeAt. - New themes: base16 dark/light, 3024 dark/light, tomorrow-night.
- Full list of patches.
20-06-2013: Version 3.14:
- New addons: trailing space highlight, XML completion (rewritten), and diff merging.
markTextandaddLineWidgetnow take ahandleMouseEventsoption.- New methods:
lineAtHeight,getTokenTypeAt. - More precise cleanness-tracking
using
changeGenerationandisClean. - Many extensions to Emacs mode (prefixes, more navigation units, and more).
- New
events
"keyHandled"and"inputRead". - Various improvements to Ruby, Smarty, SQL, and Vim modes.
- Full list of patches.
20-05-2013: Version 3.13:
- New modes: COBOL and HAML.
- New options:
cursorScrollMarginandcoverGutterNextToScrollbar. - New addon: commenting.
- More features added to the Vim keymap.
- Full list of patches.
19-04-2013: Version 3.12:
- New mode: GNU assembler.
- New
options:
maxHighlightLengthandhistoryEventDelay. - Added
addToHistoryoption formarkText. - Various fixes to JavaScript tokenization and indentation corner cases.
- Further improvements to the vim mode.
- Full list of patches.
20-03-2013: Version 3.11:
- Removed code:
collapserange,formatting, andsimple-hintaddons.plsqlandmysqlmodes (usesqlmode). - Moved code: the range-finding functions for folding now have their own files.
- Changed interface:
the
continuecommentaddon now exposes an option, rather than a command. - New modes: SCSS, Tcl, LiveScript, and mIRC.
- New addons:
placeholder, HTML completion. - New
methods:
hasFocus,defaultCharWidth. - New events:
beforeCursorEnter,renderLine. - Many improvements to the
show-hintcompletion dialog addon. - Tweak behavior of by-word cursor motion.
- Further improvements to the vim mode.
- Full list of patches.
21-02-2013: Version 3.1:
- Incompatible: key handlers may
now return, rather
than throw
CodeMirror.Passto signal they didn't handle the key. - Make documents a first-class construct, support split views and subviews.
- Add a new module
for showing completion hints.
Deprecate
simple-hint.js. - Extend htmlmixed mode to allow custom handling of script types.
- Support an
insertLeftoption tosetBookmark. - Add an
eachLinemethod to iterate over a document. - New addon modules: selection marking, linting, and automatic bracket closing.
- Add
"beforeChange"and"beforeSelectionChange"events. - Add
"hide"and"unhide"events to marked ranges. - Fix
coordsChar's interpretation of its argument to match the documentation. - New modes: Turtle and Q.
- Further improvements to the vim mode.
- Full list of patches.
25-01-2013: Version 3.02:
Single-bugfix release. Fixes a problem that prevents CodeMirror instances from being garbage-collected after they become unused.
21-01-2013: Version 3.01:
- Move all add-ons into an organized directory structure
under
/addon. You might have to adjust your paths. - New modes: D, Sass, APL, SQL (configurable), and Asterisk.
- Several bugfixes in right-to-left text support.
- Add
rtlMoveVisuallyoption. - Improvements to vim keymap.
- Add built-in (lightweight) overlay mode support.
- Support
showIfHiddenoption for line widgets. - Add simple Python hinter.
- Bring back the
fixedGutteroption. - Full list of patches.
10-12-2012: Version 3.0:
New major version. Only partially backwards-compatible. See the upgrading guide for more information. Changes since release candidate 2:
- Rewritten VIM mode.
- Fix a few minor scrolling and sizing issues.
- Work around Safari segfault when dragging.
- Full list of patches.
20-11-2012: Version 3.0, release candidate 2:
- New mode: HTTP.
- Improved handling of selection anchor position.
- Improve IE performance on longer lines.
- Reduce gutter glitches during horiz. scrolling.
- Add
addKeyMapandremoveKeyMapmethods. - Rewrite
formattingandclosetagadd-ons. - Full list of patches.
20-11-2012: Version 3.0, release candidate 1:
- New theme: Solarized.
- Introduce
addLineClassandremoveLineClass, dropsetLineClass. - Add a lot of new options for marked text (read-only, atomic, collapsed, widget replacement).
- Remove the old code folding interface in favour of these new ranges.
- Add
isClean/markCleanmethods. - Remove
compoundChangemethod, use better undo-event-combining heuristic. - Improve scrolling performance smoothness.
- Full list of patches.
22-10-2012: Version 3.0, beta 2:
- Fix page-based coordinate computation.
- Fix firing of
gutterClickevent. - Add
cursorHeightoption. - Fix bi-directional text regression.
- Add
viewportMarginoption. - Directly handle mousewheel events (again, hopefully better).
- Make vertical cursor movement more robust (through widgets, big line gaps).
- Add
flattenSpansoption. - Many optimizations. Poor responsiveness should be fixed.
- Initialization in hidden state works again.
- Full list of patches.
19-09-2012: Version 3.0, beta 1:
- Bi-directional text support.
- More powerful gutter model.
- Support for arbitrary text/widget height.
- In-line widgets.
- Generalized event handling.
Version 2.x
21-01-2013: Version 2.38:
Integrate some bugfixes, enhancements to the vim keymap, and new modes (D, Sass, APL) from the v3 branch.
20-12-2012: Version 2.37:
- New mode: SQL (will replace plsql and mysql modes).
- Further work on the new VIM mode.
- Fix Cmd/Ctrl keys on recent Operas on OS X.
- Full list of patches.
20-11-2012: Version 2.36:
- New mode: Z80 assembly.
- New theme: Twilight.
- Add command-line compression helper.
- Make
scrollIntoViewpublic. - Add
defaultTextHeightmethod. - Various extensions to the vim keymap.
- Make PHP mode build on mixed HTML mode.
- Add comment-continuing add-on.
- Full list of patches.
22-10-2012: Version 2.35:
- New (sub) mode: TypeScript.
- Don't overwrite (insert key) when pasting.
- Fix several bugs in
markText/undo interaction. - Better indentation of JavaScript code without semicolons.
- Add
defineInitHookfunction. - Full list of patches.
19-09-2012: Version 2.34:
- New mode: Common Lisp.
- Fix right-click select-all on most browsers.
- Change the way highlighting happens:
Saves memory and CPU cycles.
compareStatesis no longer needed.
onHighlightCompleteno longer works. - Integrate mode (Markdown, XQuery, CSS, sTex) tests in central testsuite.
- Add a
CodeMirror.versionproperty. - More robust handling of nested modes in formatting and closetag plug-ins.
- Un/redo now preserves marked text and bookmarks.
- Full list of patches.
23-08-2012: Version 2.33:
- New mode: Sieve.
- New
getViewPortandonViewportChangeAPI. - Configurable cursor blink rate.
- Make binding a key to
falsedisabling handling (again). - Show non-printing characters as red dots.
- More tweaks to the scrolling model.
- Expanded testsuite. Basic linter added.
- Remove most uses of
innerHTML. RemoveCodeMirror.htmlEscape. - Full list of patches.
23-07-2012: Version 2.32:
Emergency fix for a bug where an editor with line wrapping on IE will break when there is no scrollbar.
20-07-2012: Version 2.31:
- New modes: OCaml, Haxe, and VB.NET.
- Several fixes to the new scrolling model.
- Add a
setSizemethod for programmatic resizing. - Add
getHistoryandsetHistorymethods. - Allow custom line separator string in
getValueandgetRange. - Support double- and triple-click drag, double-clicking whitespace.
- And more... (all patches)
22-06-2012: Version 2.3:
- New scrollbar implementation. Should flicker less. Changes DOM structure of the editor.
- New theme: vibrant-ink.
- Many extensions to the VIM keymap (including text objects).
- Add mode-multiplexing utility script.
- Fix bug where right-click paste works in read-only mode.
- Add a
getScrollInfomethod. - Lots of other fixes.
23-05-2012: Version 2.25:
- New mode: Erlang.
- Remove xmlpure mode (use xml.js).
- Fix line-wrapping in Opera.
- Fix X Windows middle-click paste in Chrome.
- Fix bug that broke pasting of huge documents.
- Fix backspace and tab key repeat in Opera.
23-04-2012: Version 2.24:
- Drop support for Internet Explorer 6.
- New modes: Shell, Tiki wiki, Pig Latin.
- New themes: Ambiance, Blackboard.
- More control over drag/drop
with
dragDropandonDragEventoptions. - Make HTML mode a bit less pedantic.
- Add
compoundChangeAPI method. - Several fixes in undo history and line hiding.
- Remove (broken) support for
catchallin key maps, addnofallthroughboolean field instead.
26-03-2012: Version 2.23:
- Change default binding for tab [more]
- New modes: XQuery and VBScript.
- Two new themes: lesser-dark and xq-dark.
- Differentiate between background and text styles in
setLineClass. - Fix drag-and-drop in IE9+.
- Extend
charCoordsandcursorCoordswith amodeargument. - Add
autofocusoption. - Add
findMarksAtmethod.
27-02-2012: Version 2.22:
- Allow key handlers to pass up events, allow binding characters.
- Add
autoClearEmptyLinesoption. - Properly use tab stops when rendering tabs.
- Make PHP mode more robust.
- Support indentation blocks in code folder.
- Add a script for highlighting instances of the selection.
- New .properties mode.
- Fix many bugs.
27-01-2012: Version 2.21:
- Added LESS, MySQL, Go, and Verilog modes.
- Add
smartIndentoption. - Support a cursor in
readOnly-mode. - Support assigning multiple styles to a token.
- Use a new approach to drawing the selection.
- Add
scrollTomethod. - Allow undo/redo events to span non-adjacent lines.
- Lots and lots of bugfixes.
20-12-2011: Version 2.2:
- Slightly incompatible API changes. Read this.
- New approach to binding keys, support for custom bindings.
- Support for overwrite (insert).
- Custom-width and stylable tabs.
- Moved more code into add-on scripts.
- Support for sane vertical cursor movement in wrapped lines.
- More reliable handling of editing marked text.
- Add minimal emacs and vim bindings.
- Rename
coordsFromIndextoposFromIndex, addindexFromPosmethod.
21-11-2011: Version 2.18:
Fixes TextMarker.clear, which is broken in 2.17.
21-11-2011: Version 2.17:
- Add support for line wrapping and code folding.
- Add Github-style Markdown mode.
- Add Monokai and Rubyblue themes.
- Add
setBookmarkmethod. - Move some of the demo code into reusable components
under
lib/util. - Make screen-coord-finding code faster and more reliable.
- Fix drag-and-drop in Firefox.
- Improve support for IME.
- Speed up content rendering.
- Fix browser's built-in search in Webkit.
- Make double- and triple-click work in IE.
- Various fixes to modes.
27-10-2011: Version 2.16:
- Add Perl, Rust, TiddlyWiki, and Groovy modes.
- Dragging text inside the editor now moves, rather than copies.
- Add a
coordsFromIndexmethod. - API change:
setValuenow no longer clears history. UseclearHistoryfor that. - API change:
markTextnow returns an object withclearandfindmethods. Marked text is now more robust when edited. - Fix editing code with tabs in Internet Explorer.
26-09-2011: Version 2.15:
Fix bug that snuck into 2.14: Clicking the character that currently has the cursor didn't re-focus the editor.
26-09-2011: Version 2.14:
- Add Clojure, Pascal, NTriples, Jinja2, and Markdown modes.
- Add Cobalt and Eclipse themes.
- Add a
fixedGutteroption. - Fix bug with
setValuebreaking cursor movement. - Make gutter updates much more efficient.
- Allow dragging of text out of the editor (on modern browsers).
23-08-2011: Version 2.13:
- Add Ruby, R, CoffeeScript, and Velocity modes.
- Add
getGutterElementto API. - Several fixes to scrolling and positioning.
- Add
smartHomeoption. - Add an experimental pure XML mode.
25-07-2011: Version 2.12:
- Add a SPARQL mode.
- Fix bug with cursor jumping around in an unfocused editor in IE.
- Allow key and mouse events to bubble out of the editor. Ignore widget clicks.
- Solve cursor flakiness after undo/redo.
- Fix block-reindent ignoring the last few lines.
- Fix parsing of multi-line attrs in XML mode.
- Use
innerHTMLfor HTML-escaping. - Some fixes to indentation in C-like mode.
- Shrink horiz scrollbars when long lines removed.
- Fix width feedback loop bug that caused the width of an inner DIV to shrink.
04-07-2011: Version 2.11:
- Add a Scheme mode.
- Add a
replacemethod to search cursors, for cursor-preserving replacements. - Make the C-like mode mode more customizable.
- Update XML mode to spot mismatched tags.
- Add
getStateAfterAPI andcompareStatemode API methods for finer-grained mode magic. - Add a
getScrollerElementAPI method to manipulate the scrolling DIV. - Fix drag-and-drop for Firefox.
- Add a C# configuration for the C-like mode.
- Add full-screen editing and mode-changing demos.
07-06-2011: Version 2.1:
Add a theme system (demo). Note that this is not backwards-compatible—you'll have to update your styles and modes!
07-06-2011: Version 2.02:
- Add a Lua mode.
- Fix reverse-searching for a regexp.
- Empty lines can no longer break highlighting.
- Rework scrolling model (the outer wrapper no longer does the scrolling).
- Solve horizontal jittering on long lines.
- Add runmode.js.
- Immediately re-highlight text when typing.
- Fix problem with 'sticking' horizontal scrollbar.
26-05-2011: Version 2.01:
- Add a Smalltalk mode.
- Add a reStructuredText mode.
- Add a Python mode.
- Add a PL/SQL mode.
coordsCharnow works- Fix a problem where
onCursorActivityinterfered withonChange. - Fix a number of scrolling and mouse-click-position glitches.
- Pass information about the changed lines to
onChange. - Support cmd-up/down on OS X.
- Add triple-click line selection.
- Don't handle shift when changing the selection through the API.
- Support
"nocursor"mode forreadOnlyoption. - Add an
onHighlightCompleteoption. - Fix the context menu for Firefox.
28-03-2011: Version 2.0:
CodeMirror 2 is a complete rewrite that's faster, smaller, simpler to use, and less dependent on browser quirks. See this and this for more information.
22-02-2011: Version 2.0 beta 2:
Somewhat more mature API, lots of bugs shaken out.
17-02-2011: Version 0.94:
tabMode: "spaces"was modified slightly (now indents when something is selected).- Fixes a bug that would cause the selection code to break on some IE versions.
- Disabling spell-check on WebKit browsers now works.
08-02-2011: Version 2.0 beta 1:
CodeMirror 2 is a complete rewrite of CodeMirror, no longer depending on an editable frame.
19-01-2011: Version 0.93:
- Added a Regular Expression parser.
- Fixes to the PHP parser.
- Support for regular expression in search/replace.
- Add
savemethod to instances created withfromTextArea. - Add support for MS T-SQL in the SQL parser.
- Support use of CSS classes for highlighting brackets.
- Fix yet another hang with line-numbering in hidden editors.
Version 0.x
28-03-2011: Version 1.0:
- Fix error when debug history overflows.
- Refine handling of C# verbatim strings.
- Fix some issues with JavaScript indentation.
17-12-2010: Version 0.92:
- Make CodeMirror work in XHTML documents.
- Fix bug in handling of backslashes in Python strings.
- The
styleNumbersoption is now officially supported and documented. onLineNumberClickoption added.- More consistent names
onLoadandonCursorActivitycallbacks. Old names still work, but are deprecated. - Add a Freemarker mode.
11-11-2010: Version 0.91:
- Adds support for Java.
- Small additions to the PHP and SQL parsers.
- Work around various Webkit issues.
- Fix
toTextAreato update the code in the textarea. - Add a
noScriptCachingoption (hack to ease development). - Make sub-modes of HTML mixed mode configurable.
02-10-2010: Version 0.9:
- Add support for searching backwards.
- There are now parsers for Scheme, XQuery, and OmetaJS.
- Makes
height: "dynamic"more robust. - Fixes bug where paste did not work on OS X.
- Add a
enterModeandelectricCharsoptions to make indentation even more customizable. - Add
firstLineNumberoption. - Fix bad handling of
@mediarules by the CSS parser. - Take a new, more robust approach to working around the invisible-last-line bug in WebKit.
22-07-2010: Version 0.8:
- Add a
cursorCoordsmethod to find the screen coordinates of the cursor. - A number of fixes and support for more syntax in the PHP parser.
- Fix indentation problem with JSON-mode JS parser in Webkit.
- Add a minification UI.
- Support a
height: dynamicmode, where the editor's height will adjust to the size of its content. - Better support for IME input mode.
- Fix JavaScript parser getting confused when seeing a no-argument function call.
- Have CSS parser see the difference between selectors and other identifiers.
- Fix scrolling bug when pasting in a horizontally-scrolled editor.
- Support
toTextAreamethod in instances created withfromTextArea. - Work around new Opera cursor bug that causes the cursor to jump when pressing backspace at the end of a line.
27-04-2010: Version 0.67:
More consistent page-up/page-down behaviour
across browsers. Fix some issues with hidden editors looping forever
when line-numbers were enabled. Make PHP parser parse
"\\" correctly. Have jumpToLine work on
line handles, and add cursorLine function to fetch the
line handle where the cursor currently is. Add new
setStylesheet function to switch style-sheets in a
running editor.
01-03-2010: Version 0.66:
Adds removeLine method to API.
Introduces the PLSQL parser.
Marks XML errors by adding (rather than replacing) a CSS class, so
that they can be disabled by modifying their style. Fixes several
selection bugs, and a number of small glitches.
12-11-2009: Version 0.65:
Add support for having both line-wrapping and
line-numbers turned on, make paren-highlighting style customisable
(markParen and unmarkParen config
options), work around a selection bug that Opera
reintroduced in version 10.
23-10-2009: Version 0.64:
Solves some issues introduced by the
paste-handling changes from the previous release. Adds
setSpellcheck, setTextWrapping,
setIndentUnit, setUndoDepth,
setTabMode, and setLineNumbers to
customise a running editor. Introduces an SQL parser. Fixes a few small
problems in the Python
parser. And, as usual, add workarounds for various newly discovered
browser incompatibilities.
31-08-2009: Version 0.63:
Overhaul of paste-handling (less fragile), fixes for several serious IE8 issues (cursor jumping, end-of-document bugs) and a number of small problems.
30-05-2009: Version 0.62:
Introduces Python
and Lua parsers. Add
setParser (on-the-fly mode changing) and
clearHistory methods. Make parsing passes time-based
instead of lines-based (see the passTime option).
