Daftar Snippet untuk Implementasi DOM Range API

Mendapatkan Teks yang Terseleksi 

Paling dasar. Fungsi ini digunakan untuk mengambil teks yang terseleksi. Hanya teks. Tag HTML tidak akan direpresentasikan sebagai node apa adanya. Untuk mengubah node terseleksi menjadi HTML, gunakan fungsi ini:

function getSelectionText() {
    var sel = "";
    if (window.getSelection) {
        sel = window.getSelection();
    } else if (document.getSelection) {
        sel = document.getSelection();
    } else if (document.selection) { // IE
        sel = document.selection.createRange().text;
    }
    return sel;
}

Contoh Penggunaan 

document.onmouseup = function() {
    alert(getSelectionText());
};

Lihat Demo

Seleksi Teks Otomatis 

function autoSelect(elem) {
    var sel, range;
    if (window.getSelection) {
        sel = window.getSelection();
        range = document.createRange();
        range.selectNodeContents(elem);
        sel.removeAllRanges();
        sel.addRange(range);
    } else if (document.selection) { // IE
        sel = document.selection.createRange().text;
        range = document.body.createTextRange();
        range.moveToElementText(elem);
        range.select();
    }
}

Selengkapnya

Konversi Node Terseleksi ke HTML 

Fungsinya adalah untuk membawa bagian-bagian yang terseleksi menjadi HTML dalam bentuk string, sehingga hasil yang didapatkan bisa ditempelkan ke area tertentu sebagai duplikat yang sama dengan bagian yang terseleksi:

// http://stackoverflow.com/a/4652824
function getSelectionHTML() {
    var html = "";
    if (typeof window.getSelection != 'undefined') {
        var sel = window.getSelection();
        if (sel.rangeCount) {
            var container = document.createElement('div'); // Just a placeholder
            for (var i = 0, len = sel.rangeCount; i < len; ++i) {
                container.appendChild(sel.getRangeAt(i).cloneContents());
            }
            html = container.innerHTML;
        }
    } else if (typeof document.selection != 'undefined') {
        if (document.selection.type == 'Text') {
            html = document.selection.createRange().htmlText;
        }
    }
    return html;
}

Contoh Penggunaan 

Sisipkan bagian yang terseleksi ke dalam area #result-container sebagai HTML:

document.getElementById('action-btn').onclick = function() {
    document.getElementById('result-container').innerHTML = getSelectionHTML();
};

Lihat Demo

Manipulasi Posisi dan Jarak Seleksi 

Fungsi ini digunakan untuk membuat jarak seleksi pada posisi yang telah ditentukan. Cuma berlaku untuk elemen formulir. Menentukan nilai yang sama pada parameter selectionStart dan selectionEnd memungkinkan fungsi ini untuk digunakan sebagai pengatur letak caret teks:

// http://stackoverflow.com/a/499158
function setSelectionRange(input, selectionStart, selectionEnd) {
    if (input.setSelectionRange) {
        input.focus();
        input.setSelectionRange(selectionStart, selectionEnd);
    } else if (input.createTextRange) {
        var range = input.createTextRange();
        range.collapse(true);
        range.moveEnd('character', selectionEnd);
        range.moveStart('character', selectionStart);
        range.select();
    }
}

Contoh Penggunaan 

document.getElementById('action-btn').onclick = function() {
    setSelectionRange(document.getElementById('target-textarea'), 10, 100);
};

Lihat Demo

Memposisikan Caret ke Bagian Akhir Area Teks 

// http://stackoverflow.com/a/4716021
function moveCaretToEnd(el) {
    if (typeof el.selectionStart == 'number') {
        el.selectionStart = el.selectionEnd = el.value.length;
    } else if (typeof el.createTextRange != 'undefined') {
        el.focus();
        var range = el.createTextRange();
        range.collapse(false);
        range.select();
    }
}

Contoh Penggunaan 

<textarea onfocus="moveCaretToEnd(this);"> ... </textarea>

Lihat Demo

Menyimpan dan Mengembalikan Teks Terseleksi 

Fungsi pertama digunakan untuk mendapatkan teks terseleksi agar bisa Anda simpan ke dalam variabel. Fungsi ke dua digunakan untuk mengembalikan node terseleksi yang telah Anda simpan tadi:

// http://stackoverflow.com/a/2925633

var savedSelection = null; // Variable to save the selected node

function saveSelection() {
    if (window.getSelection) {
        var sel = window.getSelection();
        if (sel.getRangeAt && sel.rangeCount) {
            return sel.getRangeAt(0);
        }
    } else if (document.selection && document.selection.createRange) {
        return document.selection.createRange();
    }
    return null;
}

function restoreSelection(range) {
    if (range) {
        if (window.getSelection) {
            var sel = window.getSelection();
            sel.removeAllRanges();
            sel.addRange(range);
        } else if (document.selection && range.select) {
            range.select();
        }
    }
}

Penggunaan 

document.getElementById('save-selection-btn').onclick = function() {
    savedSelection = saveSelection();
};

document.getElementById('restore-selection-btn').onclick = function() {
    restoreSelection(savedSelection);
};

Lihat Demo

Mendapatkan Jarak Awal dan Akhir Teks Terseleksi pada Area Teks 

function getInputSelection(el) { // http://stackoverflow.com/a/3053640

    var start = 0,
        end = 0,
        normalizedValue,
        range,
        textInputRange,
        len,
        endRange;

    if (typeof el.selectionStart == 'number' && typeof el.selectionEnd == 'number') {

        start = el.selectionStart;
        end = el.selectionEnd;

    } else {

        range = document.selection.createRange();

        if (range && range.parentElement() == el) {

            len = el.value.length;
            normalizedValue = el.value.replace(/\r\n/g, "\n");

            // Create a working text range that lives only in the input
            textInputRange = el.createTextRange();
            textInputRange.moveToBookmark(range.getBookmark());

            // Check if the start and end of the selection are at the very end
            // of the input, since `moveStart`/`moveEnd` doesn't return what we want
            // in those cases
            endRange = el.createTextRange();
            endRange.collapse(false);

            if (textInputRange.compareEndPoints("StartToEnd", endRange) > -1) {
                start = end = len;
            } else {
                start = -textInputRange.moveStart("character", -len);
                start += normalizedValue.slice(0, start).split("\n").length - 1;
                if (textInputRange.compareEndPoints("EndToEnd", endRange) > -1) {
                    end = len;
                } else {
                    end = -textInputRange.moveEnd("character", -len);
                    end += normalizedValue.slice(0, end).split("\n").length - 1;
                }
            }

        }

    }

    return {
        start: start,
        end: end
    };

}

Penggunaan 

document.getElementById('test-btn').onmousedown = function() {
    var position = getInputSelection(document.getElementById('test-textarea'));
    alert('Start: ' + position.start + ', End: ' + position.end);
};

Lihat Demo

Menyisipkan Sesuatu Setelah Caret 

1. <div contenteditable> 

Fungsi yang bisa bekerja pada elemen HTML dengan atribut contenteditable:

// http://stackoverflow.com/a/6691294
function pasteHtmlAtCaret(html) {
    var sel, range, el, frag, node, lastNode;
    if (window.getSelection) {
        // IE9 and non-IE
        sel = window.getSelection();
        if (sel.getRangeAt && sel.rangeCount) {
            range = sel.getRangeAt(0);
            range.deleteContents();
            // `Range.createContextualFragment()` would be useful here but is
            // non-standard and not supported in all browsers (IE9, for one)
            el = document.createElement('div');
            el.innerHTML = html;
            frag = document.createDocumentFragment();
            while ((node = el.firstChild)) {
                lastNode = frag.appendChild(node);
            }
            range.insertNode(frag);
            // Preserve the selection
            if (lastNode) {
                range = range.cloneRange();
                range.setStartAfter(lastNode);
                range.collapse(true);
                sel.removeAllRanges();
                sel.addRange(range);
            }
        }
    } else if (document.selection && document.selection.type != 'Control') {
        // IE < 9
        document.selection.createRange().pasteHTML(html);
    }
}

Contoh Penggunaan 

Sisipkan emoticon setelah kursor caret:

document.getElementById('insert-btn').onclick = function() {
    pasteHtmlAtCaret('<img src="emoticon.gif" width="16" height="16">');
};

Lihat Demo

2. <textarea> 

Fungsi yang bisa bekerja pada elemen formulir teks seperti <textarea>:

// http://stackoverflow.com/a/11070952
function insertStringAtCaret(str, elem) {
    var value = elem.value,
        before = value.substring(0, elem.selectionStart),
        after = value.substring(elem.selectionEnd, value.length),
        pos = before.length + str.length;
    elem.value = before + str + after;
    setSelectionRange(elem, pos, pos);
}

function setSelectionRange(input, selectionStart, selectionEnd) {#code-snippet:manipulasi-posisi-dan-jarak-seleksi}

Contoh Penggunaan 

<button onmousedown="insertStringAtCaret(' :D ', document.getElementById('target-textarea'));">:D</button>

Lihat Demo

Menyisipkan Sesuatu Sebelum dan Setelah Teks Terseleksi 

Pada umumnya digunakan untuk menyisipkan tag HTML sebelum teks terseleksi dan setelah teks terseleksi. Fungsi ini Saya buat berdasarkan fungsi di atas:

// Mendukung untuk semua peramban mayor dan IE8+
function wrapText(str1, str2, elem) {
    var value = elem.value,
        before = value.substring(0, elem.selectionStart),
        selected = value.substring(elem.selectionStart, elem.selectionEnd),
        after = value.substring(elem.selectionEnd, value.length),
        endpos = before.length + str1.length + selected.length + str2.length;
    elem.value = before + str1 + selected + str2 + after;
    setSelectionRange(elem, before.length, endpos);
}

function setSelectionRange(input, selectionStart, selectionEnd) {#code-snippet:manipulasi-posisi-dan-jarak-seleksi}

Contoh Penggunaan 

<button onclick="wrapText('<b>', '</b>', document.getElementById('target-textarea'));">Bold</button>

Lihat Demo

Mendapatkan Elemen Induk dari Teks yang Terseleksi 

// http://stackoverflow.com/a/1336922
// The following will return the container element of the start or end boundary of the current selection
// `getSelectionBoundaryElement()` will select the last container element of the current multiple container selection.
// `getSelectionBoundaryElement(true)` will select the first container element of the current multiple container selection.
function getSelectionBoundaryElement(isStart) {
    var range, sel, container;
    if (document.selection) {
        range = document.selection.createRange();
        range.collapse(isStart);
        return range.parentElement();
    } else {
        sel = window.getSelection();
        if (sel.getRangeAt) {
            if (sel.rangeCount > 0) {
                range = sel.getRangeAt(0);
            }
        } else {
            // Old WebKit
            range = document.createRange();
            range.setStart(sel.anchorNode, sel.anchorOffset);
            range.setEnd(sel.focusNode, sel.focusOffset);
            // Handle the case when the selection was selected backwards (from the end to the start in the document)
            if (range.collapsed !== sel.isCollapsed) {
                range.setStart(sel.focusNode, sel.focusOffset);
                range.setEnd(sel.anchorNode, sel.anchorOffset);
            }
        }
        if (range) {
           container = range[isStart ? "startContainer" : "endContainer"];
           // Check if the container is a text node and return its parent if so
           return container.nodeType === 3 ? container.parentNode : container;
        }   
    }
}

Contoh Penggunaan 

function getSelectionText() {#code-snippet:mendapatkan-teks-yang-terseleksi}

document.onmouseup = function() {
    if (getSelectionText().toString() !== "") {
        var parentElem = getSelectionBoundaryElement();
        parentElem.style.backgroundColor = "#ff0";
    }
};

Lihat Demo

Lainnya 

• W3C - Document Object Model Range
• Quirksmode - Range Introduction
• MDN - Selection Web API
• Rangy Library