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 1Edge Full support 12Firefox Full support 1IE Full support 9Opera Full support 9Safari Full support 1WebView Android Full support 1Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support 10.1Safari iOS Full support 1Samsung Internet Android Full support 1.0

Legend

Full support  
Full support

See also