1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
|
---
title: Selection
slug: Web/API/Selection
tags:
- DOM
- Dokumentacja_Gecko_DOM
- Gecko
- Strony_wymagające_dopracowania
- Wszystkie_kategorie
translation_of: Web/API/Selection
---
<p>{{ ApiRef("DOM") }}{{SeeCompatTable}}</p>
<h3 id="Podsumowanie" name="Podsumowanie">Podsumowanie</h3>
<p>Klasa obiektu zwracanego przez <code><a href="pl/DOM/window.getSelection"> window.getSelection()</a></code> i inne metody.</p>
<h3 id="Opis" name="Opis">Opis</h3>
<p>Obiekt reprezentujący <a href="pl/DOM/range">zakresy</a>, które zaznaczył użytkownik. Zazwyczaj przechowuje tylko jeden zakres, który pobieramy następująco:</p>
<pre class="eval">range = sel.getRangeAt(0);
</pre>
<p>Wywołanie metody <code><a href="pl/DOM/Selection/toString">toString()</a></code> zwróci tekst znajdujący się wewnątrz zaznaczenia, na przykład:</p>
<pre class="eval">selObj = window.getSelection();
window.alert(selObj);
</pre>
<h3 id="S.C5.82ownik" name="S.C5.82ownik">Słownik</h3>
<p>Inne kluczowe pojęcia używane w tym dziale.</p>
<dl>
<dt>kotwica (anchor)</dt>
<dd>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.</dd>
<dt>skupienie (focus)</dt>
<dd>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.</dd>
<dt>zakres (range)</dt>
<dd>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 <a href="pl/DOM/range">zakresu</a>. Obiekty zakresów mogą być również utworzone poprzez DOM i programowo dodane lub usunięte z zaznaczenia.</dd>
</dl>
<h3 id="W.C5.82asno.C5.9Bci" name="W.C5.82asno.C5.9Bci">Własności</h3>
<dl>
<dt><a href="pl/DOM/Selection/anchorNode">anchorNode</a></dt>
<dd>Zwraca węzeł, w którym rozpoczyna się zaznaczenie.</dd>
<dt><a href="pl/DOM/Selection/anchorOffset">anchorOffset</a></dt>
<dd>Zwraca pozycję, gdzie kotwica zaznaczenia znajduje się w węźle <code>anchorNode</code>.</dd>
<dt><a href="pl/DOM/Selection/focusNode">focusNode</a></dt>
<dd>Zwraca węzeł, w którym kończy się zaznaczenie.</dd>
<dt><a href="pl/DOM/Selection/focusOffset">focusOffset</a></dt>
<dd>Zwraca pozycję, gdzie skupienie zaznaczenia znajduje się w węźle <code>focusNode</code></dd>
<dt><a href="pl/DOM/Selection/isCollapsed">isCollapsed</a></dt>
<dd>Zwraca wartość logiczną wskazującą czy początek zaznaczenia znajduje się w tym samym miejscu, co jego koniec.</dd>
<dt><a href="pl/DOM/Selection/rangeCount">rangeCount</a></dt>
<dd>Zwraca liczbę zakresów znajdujących się w zaznaczeniu.</dd>
</dl>
<h3 id="Metody" name="Metody">Metody</h3>
<dl>
<dt><a href="pl/DOM/Selection/getRangeAt">getRangeAt</a></dt>
<dd>Zwraca obiekt zakresu reprezentujący jeden z obecnie zaznaczonych zakresów.</dd>
<dt><a href="pl/DOM/Selection/collapse">collapse</a></dt>
<dd>Zawęża aktualne zaznaczenie do pojedynczego punktu.</dd>
<dt><a href="pl/DOM/Selection/extend">extend</a></dt>
<dd>Przesuwa koniec zaznaczenia do podanego punktu.</dd>
<dt><a href="pl/DOM/Selection/collapseToStart">collapseToStart</a></dt>
<dd>Przesuwa koniec zaznaczenia do tego samego miejsca, w którym znajduje się początek.</dd>
<dt><a href="pl/DOM/Selection/collapseToEnd">collapseToEnd</a></dt>
<dd>Przesuwa początek zaznaczenia do tego samego miejsca, w którym znajduje się koniec. Sam koniec zaznaczenia nie zmienia swojego położenia.</dd>
<dt><a href="pl/DOM/Selection/selectAllChildren">selectAllChildren</a></dt>
<dd>Dodaje wszystkie dzieci podanego węzła do zaznaczenia.</dd>
<dt><a href="pl/DOM/Selection/addRange">addRange</a></dt>
<dd>Obiekt zakresu, który zostanie dodany do zaznaczenia.</dd>
<dt><a href="pl/DOM/Selection/removeRange">removeRange</a></dt>
<dd>Usuwa zakres z zaznaczenia</dd>
<dt><a href="pl/DOM/Selection/removeAllRanges">removeAllRanges</a></dt>
<dd>Usuwa wszystkie zakresy z zaznaczenia.</dd>
<dt><a href="pl/DOM/Selection/deleteFromDocument">deleteFromDocument</a></dt>
<dd>Usuwa zawartość zaznaczenia z dokumentu.</dd>
<dt><a href="pl/DOM/Selection/selectionLanguageChange">selectionLanguageChange</a></dt>
<dd> </dd>
<dt><a href="pl/DOM/Selection/toString">toString</a></dt>
<dd>Zwraca ciąg znaków, który jest obecnie reprezentowany przez obiekt zaznaczenia, tj. aktualnie zaznaczony tekst.</dd>
<dt><a href="pl/DOM/Selection/containsNode">containsNode</a></dt>
<dd>Wskazuje czy konkretny węzeł jest częścią zaznaczenia.</dd>
</dl>
<h3 id="Zobacz_tak.C5.BCe" name="Zobacz_tak.C5.BCe">Zobacz także</h3>
<p><a href="pl/DOM/window.getSelection">window.getSelection</a>, <a href="pl/DOM/range">Range</a></p>
<h3 id="Odno.C5.9Bniki_zewn.C4.99trzne" name="Odno.C5.9Bniki_zewn.C4.99trzne">Odnośniki zewnętrzne</h3>
<ul>
<li><a class="external" href="http://lxr.mozilla.org/mozilla/source/content/base/public/nsISelection.idl">IDL definition in Mozilla cross-reference</a></li>
</ul>
|
