--- title: Selection slug: Web/API/Selection tags: - DOM - Dokumentacja_Gecko_DOM - Gecko - Strony_wymagające_dopracowania - Wszystkie_kategorie translation_of: Web/API/Selection ---

Podsumowanie

Klasa obiektu zwracanego przez window.getSelection() i inne metody.

Opis

Obiekt reprezentujący zakresy, które zaznaczył użytkownik. Zazwyczaj przechowuje tylko jeden zakres, który pobieramy następująco:

range = sel.getRangeAt(0);

Wywołanie metody toString() zwróci tekst znajdujący się wewnątrz zaznaczenia, na przykład:

selObj = window.getSelection();
window.alert(selObj);

Słownik

Inne kluczowe pojęcia używane w tym dziale.

kotwica (anchor): Kotwicą zaznaczenia jest jego właściwy początek. Kiedy tworzymy zaznaczenie przy użyciu myszki, kotwica w dokumencie znajduje się dokładnie tam, gdzie początkowo został wciśnięty przycisk myszki. Gdy użytkownik zmienia zaznaczenie używając myszki lub klawiatury, kotwica nie zmienia swego położenia.
skupienie (focus): Skupieniem zaznaczenia jest jego właściwy koniec. Kiedy tworzymy zaznaczenie przy użyciu myszki, jej skupienie jest dokładnie tam, gdzie przycisk myszki zostaje zwolniony. Gdy użytkownik zmienia zaznaczenie używając myszki lub klawiatury, skupienie zmienia swe położenie na koniec tego zaznaczenia.
zakres (range): Zakres to przyległa część dokumentu. Zakres może zawierać zarówno całe węzły, jak i ich części, jak np. wycinek węzła tekstowego. Użytkownik zazwyczaj wybiera tylko jedno zaznaczenie w danej chwili, jednak możliwe jest zaznaczenie kilku fragmentów na raz (na przykład używając klawisza Control). Zakres może być pobrany z zaznaczenia jako obiekt zakresu. Obiekty zakresów mogą być również utworzone poprzez DOM i programowo dodane lub usunięte z zaznaczenia.

Własności

anchorNode: Zwraca węzeł, w którym rozpoczyna się zaznaczenie.
anchorOffset: Zwraca pozycję, gdzie kotwica zaznaczenia znajduje się w węźle anchorNode.
focusNode: Zwraca węzeł, w którym kończy się zaznaczenie.
focusOffset: Zwraca pozycję, gdzie skupienie zaznaczenia znajduje się w węźle focusNode
isCollapsed: Zwraca wartość logiczną wskazującą czy początek zaznaczenia znajduje się w tym samym miejscu, co jego koniec.
rangeCount: Zwraca liczbę zakresów znajdujących się w zaznaczeniu.

Metody

getRangeAt: Zwraca obiekt zakresu reprezentujący jeden z obecnie zaznaczonych zakresów.
collapse: Zawęża aktualne zaznaczenie do pojedynczego punktu.
extend: Przesuwa koniec zaznaczenia do podanego punktu.
collapseToStart: Przesuwa koniec zaznaczenia do tego samego miejsca, w którym znajduje się początek.
collapseToEnd: Przesuwa początek zaznaczenia do tego samego miejsca, w którym znajduje się koniec. Sam koniec zaznaczenia nie zmienia swojego położenia.
selectAllChildren: Dodaje wszystkie dzieci podanego węzła do zaznaczenia.
addRange: Obiekt zakresu, który zostanie dodany do zaznaczenia.
removeRange: Usuwa zakres z zaznaczenia
removeAllRanges: Usuwa wszystkie zakresy z zaznaczenia.
deleteFromDocument: Usuwa zawartość zaznaczenia z dokumentu.
selectionLanguageChange
toString: Zwraca ciąg znaków, który jest obecnie reprezentowany przez obiekt zaznaczenia, tj. aktualnie zaznaczony tekst.
containsNode: Wskazuje czy konkretny węzeł jest częścią zaznaczenia.

Zobacz także

window.getSelection, Range

Odnośniki zewnętrzne

IDL definition in Mozilla cross-reference