This is the manual page, it’s friendlier than other manual pages, in some circles even known as “THE manual”. Please consult it first for any TextExt related question, and if you don’t find your answers, please consult it second and third. If all else fails, use the towel to wipe your tears and then reach out to me on the TextExt Twitter hot support line. The “hotness” of said support line may or may not be actually all that hot. The temprature will vary greatly based on your time zone, my time zone and whenever or not somebody recently purchased the whole shenanigans.

If you are curious what “TextExt” stands for, not unlike the “PHP”, it’s a double reverse self referencing anagram where “TExt” expands to “TextExt”. Also stands for “Text EXTREME!!!!” with that exact number of exclamation signs and to only be said out loud with the coarse, rustic, honed in one hundred battles kind of voice.

For the sake of filling in the rest of the page with something useful, here’s the “README” again. If you are asked once again to refer to the manual page, you may skip this step at your leisure since you are already on that page.

About

TextExt is a plugin for jQuery which is designed to provide functionality such as tag input and autocomplete.

The core design principle behind TextExt is modularity and extensibility. Each piece of functionality is separated from the main core and can act individually or together with other plugins.

TextExt’s modular design allows you easily turn a standard HTML text input into a wide range of modern, tailored to your needs input field without bloating your source code and slowing down your site with the code that you aren’t using.

A wide number of plugins are available including Tags, Autocomplete, Filter, Ajax as well as a few which are purely aesthetic like Focus.

Please refer to the manual for the full API documentation and examples.

Features

  • Tags
  • Autocomplete
  • AJAX loading
  • Placeholder text
  • Arrow
  • … and much more!

Example

<textarea id="textarea" rows="1"></textarea>

<script type="text/javascript">
    $('#textarea').textext({
        plugins : 'tags prompt focus autocomplete ajax arrow',
        tagsItems : [ 'Basic', 'JavaScript', 'PHP', 'Scala' ],
        prompt : 'Add one...',
        ajax : {
            url : '/manual/examples/data.json',
            dataType : 'json',
            cacheResults : true
        }
    });
</script>

How To Use

The steps to using TextExt are as follows:

  1. Specify which plugins you need via the plugins option
  2. Configure each plugin individually if necessary
  3. Enjoy!

History

1.3.1

Bug Fixes

  • Fixed jQuery 1.8.x compatability (issue #74).

1.3.0

New Features

  • Added tagClick event to the tags plugin (issue #13). See the example.
  • Prompt plugin now checks placeholder attribute (issue #8). See the example.
  • Clicking on item in autocomplete will automatically add that item to tags #2.

Bug Fixes

  • Fixes getter methods created when plugins are initialized. (issue #20).
  • Fixed issues #4, #4 and #10 related to the mouse issues in the autocomplete dropdown.
  • Fixed textext.[pluginName]() (issue #20).

1.2.0

  • Added ability to get instances of plugins to call methods on them directy (issue #6). See the example.

1.1.0

New Features

  • Added autocomplete.render option for custom rendering. See the manual and example.
  • Added autocomplete.dropdown.maxHeight option for setting height of the dropdown. See manual and example.
  • Added Arrow plugin.
  • Switched to MIT license.

Bug Fixes

  • TextExt core now works with <input/> tags.
  • Filter plugin now works without Tags.
  • Fixed clicking on suggestion in autocomplete dropdown.

1.0.0

  • Initial release.

License

The TextExt component is released under the open source MIT. This means that you can use it any way you want, but I would very much appreciate if you take a minute and support the project through a donation.

Contributors

Alphabetically:

Fork me on GitHub