插件 jQuery.TextRange 中文API文档

🌙
手机阅读
本文目录结构

插件 jQuery.TextRange 中文API文档 https://github.com/dwieeb/jquery-textrange This jQuery plugin is for easily finding the starting and ending positions of selected text in text fields and textareas. It can also be used to set the selection, and replace the selection with given text (or insert text wherever the cursor is in the text field or textarea).

Demo

Browser Support

  • Chrome
  • Firefox
  • Microsoft Edge
  • yes, even Internet Explorer 5.5+

Include

Include the file directly using <script> tags:

<script src="https://code.jquery.com/jquery-latest.min.js"></script>
<script src="jquery-plugins/jquery-textrange.js"></script>

:memo: note: jquery-textrange can be loaded through any UMD-compatible Javascript Module Loader.

Methods

You can use this method to get all the information on the selected text of an element or a specific bit of information.

‘get’

Get everything
$('input[name="example"]').textrange('get');

or for short:

$('input[name="example"]').textrange();

This will return a JSON object with the following information:

{
   "position": // cursor location in the text field)
   "start": //starting position of the selected text in the text field
   "end": // ending position of the selected text in the text field
   "length": // the length of the selected text in the text field
   "text": // the text that is selected
}
Get a particular property

This function can also be used to get a particular property of the object.

For example, this will obtain the starting location of the selected text:

var start = $('input[name="example"]').textrange('get', 'start');

‘set’

You can use this method to set the starting and ending locations of the selected text in an element.

It works much like PHP’s substr(), so if you’re familiar with that, it should be a breeze! Here are some examples, anyway.

For the following examples, let’s say input[name="example"] contains the text abcdef.

$('input[name="example"]').textrange('set'); // selects "abcdef" (select all)
$('input[name="example"]').textrange('set', 2); // selects "cdef"
$('input[name="example"]').textrange('set', 2, 3); // selects "cde"
$('input[name="example"]').textrange('set', 2, -2); // selects "cd"
$('input[name="example"]').textrange('set', -3); // selects "def"
$('input[name="example"]').textrange('set', -2, 1); // selects "e"
$('input[name="example"]').textrange('set', -4, -1); // selects "cde"

If you’re looking to set the cursor at one specific location, you can use 0 for length, or you can use $().textrange('setcursor') (see below).

‘setcursor’

You can use this method to set the location of the cursor in your text field.

To set the cursor at the fifth character position:

$('input[name="example"]').textrange('setcursor', 5);

‘replace’

You can use this method to replace the selection with given text.

$('input[name="example"]').textrange('replace', 'some text');

There is also an insert alias for replace if you’re using this method to insert text at the cursor location. They work the same way.

Options

For the first parameter of each method, you can pass an object instead of a string with additional options:

$('input[name="example"]').textrange({ method: 'get' });
$('input[name="example"]').textrange({ method: 'set', nofocus: true }, 2);
$('input[name="example"]').textrange({ method: 'get', nofocus: true }, 'start');
  • method (defaults to 'get'): One of the methods above.
  • nofocus: Do not call .focus() on the dom element. See PR #20.

AXIHE / 精选资源

浏览全部教程

面试题

学习网站

前端培训
自己甄别

前端书籍

关于朱安邦

我叫 朱安邦,阿西河的站长,在杭州。

以前是一名平面设计师,后来开始接接触前端开发,主要研究前端技术中的JS方向。

业余时间我喜欢分享和交流自己的技术,欢迎大家关注我的 Bilibili

关注我: Github / 知乎

于2021年离开前端领域,目前重心放在研究区块链上面了

我叫朱安邦,阿西河的站长

目前在杭州从事区块链周边的开发工作,机械专业,以前从事平面设计工作。

2014年底脱产在老家自学6个月的前端技术,自学期间几乎从未出过家门,最终找到了满意的前端工作。更多>

于2021年离开前端领域,目前从事区块链方面工作了