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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
|
---
title: key
slug: Mozilla/Tech/XUL/key
tags:
- Dokumentacja_XUL
- Elementy_XUL
- Strony_wymagające_dopracowania
translation_of: Archive/Mozilla/XUL/key
---
<div class="noinclude"><span class="breadcrumbs XULRef_breadcrumbs">
« <a href="/pl/docs/Dokumentacja_XUL">Dokumentacja XUL</a> [
<a href="#Przyk.C5.82ady">Przykłady</a> |
<a href="#Atrybuty">Atrybuty</a> |
<a href="#W.C5.82asno.C5.9Bci">Własności</a> |
<a href="#Metody">Metody</a> |
<a href="#Podobne">Podobne</a> ]
</span></div>
<p>Element <code>key</code> określa skrót klawiaturowy. Dzięki funkcjom obsługi zdarzeń można odpowiedzieć na wciśnięcie danego klawisza. Element <code>key</code> musi być umieszczony wewnątrz elementu <code><a href="/pl/docs/Mozilla/Tech/XUL/keyset" title="keyset">keyset</a></code>.</p>
<p>When a key matching the attributes on the key element is pressed, the command will be fired on the key element. The key pressed must match the key attribute (or keycode attribute) as well as the modifiers attribute in order for the key element to be activated and fire a command event.</p>
<p>For example, consider the following key:</p>
<pre class="eval"><key key="r" modifiers="shift"/>
</pre>
<p>This key will only match when the Shift key is pressed as well as the R key, and no other keys. For instance, if the Shift, Control and R keys are all pressed, the key will not match.</p>
<p>To indiciate that a modifier key may optionally be pressed, place the word 'any' after a listing the optional modifier key. For example:</p>
<pre class="eval"><key key="r" modifiers="shift any control"/>
</pre>
<p>In this example, the shift key may or may not be pressed, while the control key must be pressed. This allows keys to match more loosely for modifier keys that aren't relevant, yet still allows specific modifiers to be required.</p>
<p>If the modifiers attribute is not specified, then no modifiers may be pressed for the key to match.</p>
<p>Dodatkowe informacje są dostępne w <a href="pl/Kurs_XUL/Skr%c3%b3ty_klawiaturowe">kursie XUL</a>.</p>
<dl>
<dt>Atrybuty</dt>
<dd><a href="#a-command">command</a>, <a href="#a-disabled">disabled</a>, <a href="#a-key">key</a>, <a href="#a-keycode">keycode</a>, <a href="#a-keytext">keytext</a>, <a href="#a-modifiers">modifiers</a>, <a href="#a-oncommand">oncommand</a>, <a href="#a-phase">phase</a></dd>
</dl>
<h3 id="Przyk.C5.82ady" name="Przyk.C5.82ady">Przykłady</h3>
<p>(potrzebne przykłady)</p>
<h3 id="Atrybuty" name="Atrybuty">Atrybuty</h3>
<p> </p><div id="a-command">
<dl><dt> <code id="a-command"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/command">command</a></code>
</dt><dd> Typ: <i>id elementu</i>
</dd><dd> Ustawiony na wartość atrybutu <code id="a-id"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/id">id</a></code> elementu <code><a href="/pl/docs/Mozilla/Tech/XUL/command" title="command">command</a></code>, obserwowanego przez ten element.
</dd></dl>
</div> <div id="a-disabled">
<dl><dt> <code id="a-disabled"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/disabled">disabled</a></code>
</dt><dd> Typ: <i>boolean</i>
</dd><dd> Określa, czy element jest wyłączony. Jeśli atrybut ten ma wartość <code>true</code>, to element będzie wyłączony. Wyłączone elementy zazwyczaj są wyszarzone. Jeśli element jest wyłączony, nie odpowiada na czynności użytkownika, nie może zostać na niego ustawiony focus, a zdarzenie <i>command</i> nie zostanie wywołane. </dd></dl>
<div class="float-right"><img alt="grafika:XUL_ref_attr_disabled.png"></div>
<pre><!-- Pole wyboru włącza/wyłącza przycisk -->
<checkbox label="Enable button"
onclick="document.getElementById('buttRemove').disabled = this.checked"/>
<button id="buttRemove" label="Remove All" disabled="true"/>
</pre>
</div> <div id="a-key">
<dl><dt> <code id="a-key"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/key">key</a></code>
</dt><dd> Typ: <i>znak</i>
</dd><dd> Litera, która musi zostać naciśnięta. Powinien to być znak, który może być wyświetlany.
</dd></dl>
<p><br>
</p>
</div> <div id="a-keycode">
<dl><dt> <code id="a-keycode"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/keycode">keycode</a></code>
</dt><dd> Typ: <i>kod klawisza łańcucha znaków</i>
</dd><dd> Dla klawiszy skrótu, które nie są wyświetlane jako litery, takich jak Enter lub klawisze funkcyjne, można wykorzystać ten atrybut zamiast <code id="a-key"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/key">key</a></code>. Dozwolone kody klawiszy są wymienione na <a class="external" href="http://www.xulplanet.com/tutorials/xultu/keyref.html">tej liście</a>.
</dd></dl>
<p><br>
</p>
</div> <div id="a-keytext">
<dl><dt> <code id="a-keytext"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/keytext">keytext</a></code>
</dt><dd> Typ: <i>string</i>
</dd><dd> Etykieta skrótu klawiaturowego. Tekst ten będzie wyświetlony obok etykiety pozycji menu (<code><a href="/pl/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>), jeśli pozycja ta (<code><a href="/pl/docs/Mozilla/Tech/XUL/menuitem" title="menuitem">menuitem</a></code>) jest połączona z elementem <code><a href="/pl/docs/Mozilla/Tech/XUL/key" title="key">key</a></code> poprzez jej atrybut <code id="a-key"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/key">key</a></code>.
</dd></dl>
<p><br>
</p>
</div> <div id="a-modifiers">
<dl><dt> <code id="a-modifiers"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/modifiers">modifiers</a></code>
</dt><dd> Typ: <i>oddzielona spacją lista wartości poniżej</i>
</dd><dd> Lista klawiszy-modyfikatorów, które powinny być wciśnięte, aby wywołać dany skrót klawiatury. Jeśli klawiszy-modyfikatorów jest więcej niż jeden, należy je oddzielić spacjami lub przecinkami. Klawisze niedostępne na danej platformie będą mapowane na inne.
</dd></dl>
<ul><li> <code>shift</code>: Klawisz <tt>Shif</tt>t.
</li><li> <code>alt</code>: Klawisz <tt>Alt</tt>. Na Macintoshu jest to klawisz <tt>Option</tt>.
</li><li> <code>meta</code>: Klawisz <tt>Meta</tt>. Na Macintoshu jest to klawisz <tt>Command</tt>.
</li><li> <code>control</code>: Klawisz <tt>Control</tt>.
</li><li> <code>accel</code>: Klawisz zwykle używany dla skrótów na danej platformie. Zwykle właśnie tej wartości należy użyć.
</li><li> <code>access</code>: Klawisz dostępu, zwykle używany do aktywowania menu i innych elementów. W Windows jest to klawisz Alt używany w połączeniu z klawiszem dostępu danego elementu.
</li><li> <code>any</code>: Określa, że wszelkie poprzedzające go modyfikatory są opcjonalne.
</li></ul>
<p><br>
</p>
</div> <div id="a-oncommand">
<dl><dt> <code id="a-oncommand"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/oncommand">oncommand</a></code>
</dt><dd> Typ: <i>kod skrypt</i>
</dd><dd> Ta funkcja obsługi zdarzenia jest wywołana w momencie aktywacji polecenia. Ma to miejsce, gdy użytkownik zaznaczy pozycję menu lub kiedy naciśnie skrót klawiaturowy przypisany do polecenia.
</dd></dl>
</div> <div id="a-phase">
<dl>
<dt><code id="a-phase"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/phase">phase</a></code></dt>
<dd>Typ:<em>ciąg znaków</em></dd>
<dd>Faza zdarzeń, w której wywoływana jest funkcja obsługi. Należy atrybut ten ustawić na wartość <code>capturing</code>, by określić, że ma to nastąpić w fazie przechwytywania, albo na <code>target</code>, aby określić to na elemencie docelowym, albo pominąć, by wywołanie funkcji obsługi nastąpiło w fazie bąbelkowania.</dd>
</dl>
</div><p></p>
<h3 id="W.C5.82asno.C5.9Bci" name="W.C5.82asno.C5.9Bci">Własności</h3>
<p></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Dziedziczy z elementu XUL</strong><br> <small> <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/align">align</a></span></code>, , <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/allowEvents">allowEvents</a></span></code>, , <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/boxObject">boxObject</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/builder">builder</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/className">className</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/collapsed">collapsed</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/contextMenu">contextMenu</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/controllers">controllers</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/database">database</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/datasources">datasources</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/dir">dir</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/flex">flex</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/height">height</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/hidden">hidden</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/id">id</a></span></code>, , , <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/left">left</a></span></code>, , <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/maxHeight">maxHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/maxWidth">maxWidth</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/menu">menu</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/minHeight">minHeight</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/minWidth">minWidth</a></span></code>, , , , , , , <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/observes">observes</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/ordinal">ordinal</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/orient">orient</a></span></code>, , <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/pack">pack</a></span></code>, , <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/persist">persist</a></span></code>, , , , <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/ref">ref</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/resource">resource</a></span></code>, , , , , <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/statusText">statusText</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/style">style</a></span></code>, ,, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/tooltip">tooltip</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/tooltipText">tooltipText</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/top">top</a></span></code>, <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/Własność/width">width</a></span></code></small></p> </td> </tr> </tbody>
</table><p></p>
<h3 id="Metody" name="Metody">Metody</h3>
<p></p><table style="border: 1px solid rgb(204, 204, 204); margin: 0px 0px 10px 10px; padding: 0px 10px; background: rgb(238, 238, 238) none repeat scroll 0% 50%;"> <tbody> <tr> <td> <p><strong>Dziedziczy z elementu XUL</strong><br> <small> <span id="m-blur"><code><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Metoda/blur">blur</a></code></span>, <span id="m-click"><code><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Metoda/click">click</a></code></span>, <span id="m-doCommand"><code><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Metoda/doCommand">doCommand</a></code></span>, <span id="m-focus"><code><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Metoda/focus">focus</a></code></span>, <span id="m-getElementsByAttribute"><code><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Metoda/getElementsByAttribute">getElementsByAttribute</a></code></span></small></p> <p><strong>Dziedziczy z elementu DOM</strong><br> <small> <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.addEventListener">addEventListener()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.appendChild">appendChild()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.dispatchEvent">dispatchEvent()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.getAttribute">getAttribute()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.getAttributeNode">getAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.getAttributeNodeNS">getAttributeNodeNS()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.getAttributeNS">getAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.getElementsByTagName">getElementsByTagName()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.getElementsByTagNameNS">getElementsByTagNameNS()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.hasAttribute">hasAttribute()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.hasAttributeNS">hasAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.hasAttributes">hasAttributes()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.hasChildNodes">hasChildNodes()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.insertBefore">insertBefore()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.isSupported">isSupported()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.normalize">normalize()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.removeAttribute">removeAttribute()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.removeAttributeNode">removeAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.removeAttributeNS">removeAttributeNS()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.removeChild">removeChild()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.removeEventListener">removeEventListener()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.replaceChild">replaceChild()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.setAttribute">setAttribute()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.setAttributeNode">setAttributeNode()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.setAttributeNodeNS">setAttributeNodeNS()</a></code>, <code><a href="https://developer.mozilla.org/pl/docs/DOM/element.setAttributeNS">setAttributeNS()</a></code></small></p> </td> </tr> </tbody>
</table><p></p>
<h3 id="Podobne" name="Podobne">Podobne</h3>
<p>TBD</p>
|
