Window.getSelection()

Window.getSelection() adalah metode Selection yang menggambarkan teks yang ditandai oleh pengguna atau posisi sekarang.

Syntak

selection = window.getSelection();

Hasil Output

Objek Selection

Ketika berganti ke string, lebih baik menggunakan string kosong ("") atau menggunakan Selection.toString(), hasil output adalah teks yang dipilih.

Ketika memanggil sebuah <iframe> ini tidak akan ditampilkan (misalnya display: none telah diatur) Firefox akan menampilkan null, sedangkan browser lain akan menampilkan objek Selection dengan Selection.type yang diatur ke None.

Contoh

function foo() {
    var selObj = window.getSelection(); 
    alert(selObj);
    var selRange = selObj.getRangeAt(0);
    // do stuff with the range
}

Catatan

Representasi dari objek Selection

Dalam JavaScript, ketika sebuah objek dimasukan ke function yang membutuhkan string (seperti window.alert() atau document.write()), objek metode toString() akan dipanggil dan hasilnya akan dikembalikan ke function tersebut. Ini akan membuat objek dapat tampil sebagai string ketika digunakan oleh function lainnya ketika ini adalah objek dan metode yang benar.

Pada contoh berikut, selObj.toString() akan otomatis dipanggil ketika melewati window.alert(). Bagaimanapun, mencoba menggunakan properti atau metode JavaScript String seperti length atau substr secara langsung pada objek Selection akan menghasilkan kesalahan jika tidak memiliki properti atau metode dan dapat mengembalikan hasil yang tidak terduga jika itu benar. Untuk menggunakan objek Selection sebagai string, panggil metode toString () secara langsung:

var selectedText = selObj.toString();

• selObj adalah objek Selection.
• selectedText adalah sebuah string (Selected text).

Objek terhubung

Kamu bisa memanggil Document.getSelection(), yang mana ini bekerja seperti Window.getSelection().

Perlu diingat, bahwa saat ini getSelection() tidak bekerja pada elemen <textarea> and <input> di Firefox. Properti HTMLInputElement.setSelectionRange() atau selectionStart dan selectionEnd yang dapat menangani hal ini.

Perhatikan juga perbedaan atara selection dan focus. Document.activeElement menampilkan elemen yang sedang difokus.

Spesifikasi

Browser compatibility

See also

• Selection API
• Selection
• Range
• Document.getSelection()
• HTMLInputElement.setSelectionRange()