New Features In One Point Three

Documentation home

New features in Rangy 1.3

Rangy 1.3 is still in development. It is incomplete and the API may change.

New TextRange module

Demo page

Character and word-based Range and Selection manipulation, relative to the visible text on the page. This is a major new module with some powerful features:

• moveStart(), moveEnd(), move() and expand() Range methods inspired by IE's TextRange object
• Page text search, using a string or a regular expression
• Character offset-based selection save and restore, immune to changes in innerHTML
• Selection snap to words
• Cross-browser innerText implementation
• Selection and range trimming

New Highlighter module

Demo page

API to allow creation, removal, serialization and deserialization of highlights within a page. It uses either character offsets relative to the page's textContent or the TextRange module's character-based features to keep track of highlight positions. This should be an improvement on the approach of the previous, unofficial Highlighter module, whose performance worsened exponentially as the number of highlights increased.

Renamed CSS Class Applier module to Class Applier module

The file name in the latest Rangy build is now rangy-classapplier.js rather than rangy-cssclassapplier.js.

Additions and enhancements

• AMD support

• Rangy's main entry functions are now much more permissive. For example, rangy.createRange() and rangy.getSelection() and all related methods now accept a Window, Document or iframe element

• Added setStartAndEnd() convenience method to Range

• Added getBookmark() and moveToBookmark() methods to Range

• Added new useExistingElements option to class applier options object (issue 111)

• Selection setSingleRange() now accepts an additional second parameter, direction

• Every backwards Boolean API parameter replaced with string direction parameter

• Added applyToRanges(), unapplyToRanges() and toggleRanges() to class applier

• Added removeEmptyElements option to class applier. When true, empty elements generated by (or appearing to be generated by) the applier are removed when applying or unapplying to a range or selection

• Added getNativeTextRange() method to selection

• Module loading improved: module script include order no longer matters, so long as rangy-core.js comes first. Modules now initialize automatically if Rangy has initialized. Also, the console now provides more helpful warning messages when modules fail to load.

• New config option to allow control over whether Rangy automatically initializes when the page loads

• Build script now works on non-Windows platforms

Issues fixed

• issue 75
• issue 80
• issue 92
• issue 99
• issue 101
• issue 104
• issue 107
• issue 108
• issue 111
• issue 174
• issue 176
• issue 177
• issue 184
• issue 186
• issue 188
• issue 189
• issue 190
• issue 199
• issue 202