Cursores.js

Get and replace tokens under the cursor

Cursores (cur·so·res) allows you to get and replace the token under the cursor in a <textarea>, <input>, or string.

It does so by trying to match separate regexes for the text on the left side of the cursor and the text on the right. For performance reasons, the number of characters examined on either side of the cursor is restricted.

For example, if we match a whitespace delimited token in the string "the quick brown fo|x jumps over the lazy dog" (where | denotes the cursor), the token under the cursor is fox.

Cursores is an open-source component of Bitbucket.

Download Cursores.js (v0.2)

16
(?:^|\s)(\S*)
(\S*)
16

Try changing the regexes and search window size.

Usage

By default new instances match whitespace delimited tokens.

You can also create an instance that matches a whitespace delimited token that starts with a specific character.

Finally, the Cursores constructor accepts the left regex, right regex, and maximum search window length either side of the cursor.

> cursor = new Cursores()
> cursor = Cursores.startsWith('@')

One can get the token under the cursor in a textarea or text input by calling cursor.token(el). Alternatively, you can pass in a string and the index of the cursor within that string.

> split = 'The quick brown fo|x jumps'.split('|')
> cursor = new Cursores()
> cursor.token(split.join(''), split[0].length)
{"value": "fox", "prefix": "fo", "suffix": "x"}

To replace the token under the cursor in a textarea or text input, call cursor.replace(el, replacement). You can also replace the token in a string:

> cursor.replace(split.join(''), split[0].length,
>                'Fantastic Mr. Fox')
"The quick brown Fantastic Mr. Fox jumps"

Browser support

Cursores supports modern browsers, including Internet Explorer 9, that implement selectionStart and setSelectionRange().

License

Cursores is licensed under Apache 2.0.