This repository has been archived on 2020-11-02. You can view files and clone it, but cannot push or open issues or pull requests.
TripSit_Suite/node_modules/textcomplete
cranberry ed23347e56 Initial comission of TheLounge base files 2020-11-01 22:46:04 +00:00
..
dist Initial comission of TheLounge base files 2020-11-01 22:46:04 +00:00
docs Initial comission of TheLounge base files 2020-11-01 22:46:04 +00:00
lib Initial comission of TheLounge base files 2020-11-01 22:46:04 +00:00
node_modules/undate Initial comission of TheLounge base files 2020-11-01 22:46:04 +00:00
.eslintrc.yml Initial comission of TheLounge base files 2020-11-01 22:46:04 +00:00
.flowconfig Initial comission of TheLounge base files 2020-11-01 22:46:04 +00:00
.jsdoc.json Initial comission of TheLounge base files 2020-11-01 22:46:04 +00:00
CHANGELOG.md Initial comission of TheLounge base files 2020-11-01 22:46:04 +00:00
CONTRIBUTING.md Initial comission of TheLounge base files 2020-11-01 22:46:04 +00:00
LICENSE Initial comission of TheLounge base files 2020-11-01 22:46:04 +00:00
README.md Initial comission of TheLounge base files 2020-11-01 22:46:04 +00:00
RELEASE.md Initial comission of TheLounge base files 2020-11-01 22:46:04 +00:00
inch.json Initial comission of TheLounge base files 2020-11-01 22:46:04 +00:00
karma.conf.js Initial comission of TheLounge base files 2020-11-01 22:46:04 +00:00
package.json Initial comission of TheLounge base files 2020-11-01 22:46:04 +00:00
webpack.config.js Initial comission of TheLounge base files 2020-11-01 22:46:04 +00:00
webpack.doc.config.js Initial comission of TheLounge base files 2020-11-01 22:46:04 +00:00

README.md

textcomplete

Autocomplete for textarea elements.

NPM version Build Status Code Climate Test Coverage Analytics

Requirements

Distributed scripts are self-contained.

To require as npm package, textcomplete requires the following to run:

Usage

Textcomplete is easiest to use when installed with npm:

npm install --save textcomplete

Then you can load the module into your code with require call:

var { Textcomplete, Textarea } = require('textcomplete');

The Textarea object is a kind of editor class. An editor encapsulates an HTML element where users input text. The Textarea editor is an editor for textarea element.

You can find some additional editors at List of editors wiki.

The Textcomplete is the core object of textcomplete.

var editor = new Textarea(textareaElement);
var textcomplete = new Textcomplete(editor);

Register series of autocomplete strategies:

textcomplete.register([{
  // Emoji strategy
  match: /(^|\s):(\w+)$/,
  search: function (term, callback) {
    callback(emojies.filter(emoji => { return emoji.startsWith(term); }));
  },
  replace: function (value) {
    return '$1:' + value + ': ';
  }
}, {
  // Another strategy
  ...
}]);

Now, the textcomplete listens keyboard event on the editor and render autocomplete dropdown when one of the strategy matches to the inputted value.

Browser Support

Chrome Firefox Internet Explorer Opera Safari
Current Current 10+ Current Current

Install

If your project is using npm, you can install textcomplete package by npm command:

npm install --save textcomplete

if not, you can download released packages from the release page which contain bundled scripts in dist directory.

Contributing

To contribute to textcomplte, clone this repo locally and commit your code on a separate branch. Please write unit tests for your code, and run the linter before opening a pull-request:

npm test # run linter and all tests

You can find more detail in our contributing guide.

License

The MIT License