Type: Element

Розширює Element Type методами, корисними для керування вхідними даними.

Навчальний посібник/Демо

• Онлайн навчальний посібник/Демо

Element Method: tidy

Використовуйте String:tidy для очищення поширених спеціальних символів їхніми ASCII-аналогами (розумні лапки, символи еліпсис, речі з MS Word тощо).

Синтаксис

$('myInput').tidy();

Повертає

• (element) Цей Element.

Element Method: getTextInRange

Повертає текст введення в межах діапазону.

Синтаксис

$('myInput').getTextInRange(start, end);

Аргументи

1. start - (number) початкова позиція виділення
2. end - (number) кінцева позиція

Повертає

• (string) текст у вказаному діапазоні

Примітки

• Якщо вказаний діапазон виходить за межі (наприклад, якщо текст — «123», а ви запитуєте діапазон 2-10), повертається текст, що знаходиться в межах. Якщо жоден текст не потрапляє в межі, повертається порожній рядок.

Element Method: getSelectedText

Отримує виділений текст у введенні, повертає діапазон (див. Element:getTextInRange).

Синтаксис

$('myInput').getSelectedText();

Повертає

• (string) Виділений текст

Примітки

• Якщо текст не виділено, повертається порожній рядок.

Element Method: getSelectionStart

Повертає індекс початку виділеного тексту.

Синтаксис

$('myInput').getSelectionStart();

Повертає

• (number) Числовий індекс початку виділення.

Element Method: getSelectionEnd

Повертає індекс кінця виділеного тексту.

Синтаксис

$('myInput').getSelectionEnd();

Повертає

• (number) Числовий індекс кінця виділення.

Примітки

• Якщо виділення відсутнє, це значення буде дорівнювати Element:getSelectionStart

Element Method: getSelectedRange

Повертає діапазон того, що виділено всередині елемента.

Синтаксис

$('myInput').getSelectedRange();

Повертає

• (object) значення start та end (кожне number).

Приклад повернення

{start: 2, end: 12}

Element Method: setCaretPosition

Встановлює каретку у заданій позиції.

Синтаксис

$('myInput').setCaretPosition(pos);

Аргументи

1. pos - (number) розташування для розміщення каретки АБО «end» для розміщення в кінці.

Повертає

• (element) Цей Element.

Приклад

$('myInput').setCaretPosition(3);
$('myInput').setCaretPosition("end");

Element Method: getCaretPosition

Повертає позицію каретки.

Синтаксис

$('myInput').getCaretPosition();

Повертає

• (number) Позиція каретки.

Element Method: selectRange

Виділяє текст у заданому діапазоні.

Синтаксис

$('myInput').selectRange(start, end);

Аргументи

1. start - (number) початковий номер
2. end - (number) кінцевий номер

Повертає

• (element) Цей Element.

Приклад

$('myInput').selectRange(2, 4);
 
<input id="test" value="012345" />
$('test').selectRange(2, 4); //selects "23"

Element Method: insertAtCursor

Вставляє значення у позицію курсора; якщо текст виділено, замінює його.

Синтаксис

$('myInput').insertAtCursor(value[, selectText]);

Аргументи

1. value - (string) значення для вставки.
2. selectText - (boolean) виділяє текст після вставки

Повертає

• (element) Цей Element.

Приклад

$('myInput').insertAtCursor("<br />");
$('myInput').insertAtCursor("type something here", true);

Element Method: insertAroundCursor

Вставляє два рядки навколо виділеного тексту.

Синтаксис

$('myInput').insertAroundCursor(options);

Аргументи

1. options - (object) набір параметрів ключ/значення.

Опції

1. before - (string) префікс для вставки перед виділеним текстом
2. after - (string) суфікс для вставки після виділеного тексту
3. defaultMiddle - (string) значення для вставки між префіксом та суфіксом, якщо текст не виділено (за замовчуванням «SOMETHING HERE»)

Повертає

• (element) Цей Element.

Приклад

<input id="test" value="ninjas are the most dangerous thing in the world" />
//let's assume that the user selects the word "ninjas"
$('test').insertAroundCursor({before: "<", after: ">", defaultMiddle: "tag-name"});
//value is now:
//<ninjas> are the most dangerous thing in the world