2.0.0 • Published 8 years ago

textarea-op-stream v2.0.0

Weekly downloads
2
License
ISC
Repository
github
Last release
8 years ago

textarea-op-stream

Get a readable stream of all of a textarea's inserts and deletes.

Background

textarea is complex: they have a slew of properties and events, and describing its state is non-trivial. It's not easy to learn about inserts and delete operations: interpreting multiple keydown events to determine what key and modifiers were pressed is onerous. I thought it would be nice to have a readable stream of these operations.

Usage

Let's wrap a textarea and type in it:

var wrap = require('textarea-op-stream')

var ta = document.createElement('textarea')
ta.setAttribute('cols', 80)
ta.setAttribute('rows', 8)
document.body.appendChild(ta)

var ops = wrap(ta)

ops.on('data', function (ev) {
  console.log(ev.op, '@', ev.pos, '( ' + (ev.str ? ev.str : ev.count) + ')')
})

After editing some text, you may see

insert @ 0 (hello)
insert @ 5 (!)
delete @ 5 1
delete @ 0 5

as you insert 'Hello!' and then delete pieces of the text.

API

var wrap = require('textarea-op-stream')

wrap(textarea)

Wraps a <textarea> element, returning a Readable object stream of insert and delete operations. The two object forms to be expected are

{
  op: 'insert',
  pos: Number,
  str: String
}
{
  op: 'delete',
  pos: Number,
  count: Number  // the number of consecutive chars deleted at 'pos'
}

Install

With npm installed, run

$ npm install textarea-op-stream

See Also

License

ISC