UWAGA: Tłumaczenie tej strony nie zostało zakończone.
Może być ona niekompletna lub wymagać korekty.
Chcesz pomóc? | Dokończ tłumaczenie | Sprawdź ortografię | Więcej takich stron+.

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

 

 

 

Autorzy i etykiety dokumentu

 Autorzy tej strony: teoli, khalid32, Mgjbot, Gocio, DR, Diablownik, Rev, Ptak82, Internauta1024A
 Ostatnia aktualizacja: khalid32,