Selection

Selection - об'єкт виділеного тексту і поточної позації курсору клавіатури.

Синтаксис:

objSelection = window.getSelection();

objSelection = document.getSelection();

Параметри:

objSelection - зміна яка отримує об'єкт Selection.

window - об'єкт window.

document - об'єкт document.

getSelection() - метод який повертає об'єкт Selection.

Опис:

Selection об'єкт виділеного тексту.

Об'єкт Selection повертають методи window.getSelection() і document.getSelection().

Користувач може виділити текст зліва направо або справа наліво.

Selection має якір і фокус.

Коли текст не виділений то його якір і фокус обидва мають значення 0.

Коли текст виділено то якір є початок виділення, а фокус це кінець.

Виділення складається з фрагментів (діапазонів) які у JavaScript є об'єктами Range. Зазвичай виділення складається з одного фрагменту - одиного об'єкту Range.

Фрагмети додаються користувачем коли натиснути клавішу Ctrl і виділити новий фрагмент.

Зверніть увагу що у Internet Explorer до версії 9 Range не підтримується, а підтримується TextRange.

Selection.anchorNode - повертає Node в якому починається виділення тексту.
Selection.anchorOffset - повертає число, що представляє позицію якора.
Selection.focusNode -поветає Node в якому закінчується виділення.
Selection.focusOffset - повертає число, що представляє позицію фокуса.
Selection.isCollapsed - повертає логічне значення, яке вказує, чи початкові і кінцеві точки при виділені знаходяться в тій ж самій позиції.
Selection.rangeCount - кількість Range об'єктів.
Selection.type - тип виділення.

Selection.getRangeAt() - повертає Range об'єкт за його індексом.
Selection.collapse() - згортання поточного виділення в одній точці.
Selection.extend() - переміщення фокуса вибору в заданій точці.
Selection.modify() - змінює поточне виділення.
Selection.collapseToStart() - згортання виділення на початок першого діапазону в виділеному фрагменті.
Selection.collapseToEnd() - згортання виділення до кінця останнього діапазону в виділеному фрагменті.
Selection.selectAllChildren() - виділяє вказаний елеметн і його дочірні елементи.
Selection.addRange() - додаємо об'єкт Range до виділення.
Selection.removeRange() - видаляє об'єкт Range від виділення.
Selection.removeAllRanges() - видаляє всі об'єкти Rang від виділення.
Selection.deleteFromDocument() - видаляє вміст виділеної області з документа.
Selection.toString() - повертає рядок що представляє поточний виділений текст.
Selection.containsNode() - перевіряє чи є елемент частиною виділення.

Приклад:

Приклад виділення всієї сорінки:

//створюємо об'єкт Selection
var selection = window.getSelection(); 
//виділяємо сторінку
selection.selectAllChildren(document.getElementsByTagName('body')[0]);