Window.getSelection()

This translation is incomplete. Please help translate this article from English

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 focusDocument.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

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
getSelectionChrome Full support YesEdge Full support 12Firefox Full support YesIE Full support 9Opera Full support YesSafari Full support YesWebView Android Full support YesChrome Android Full support YesFirefox Android Full support 55
Notes
Full support 55
Notes
Notes No support for selection events.
Opera Android Full support 37Safari iOS Full support 5.1
Notes
Full support 5.1
Notes
Notes No support for selection start.
Samsung Internet Android Full support Yes

Legend

Full support  
Full support
See implementation notes.
See implementation notes.

See also