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 objekSelection
.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
Specification | Status | Comment |
---|---|---|
Selection API The definition of 'Window.getSelection()' in that specification. |
Working Draft | New spec. |
HTML Editing APIs The definition of 'Window.getSelection()' in that specification. |
Editor's Draft | Initial definition |
Browser compatibility
BCD tables only load in the browser