Selection

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

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

Odnośniki zewnętrzne