path: root/files/pl/mozilla/tech/xul/checkbox/index.html

---
title: checkbox
slug: Mozilla/Tech/XUL/checkbox
tags:
  - Dokumentacja_XUL
  - Elementy_XUL
translation_of: Archive/Mozilla/XUL/checkbox
---
<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, który można włączać i wyłączać. Zazwyczaj jest wyświetlany jako pusty prostokąt, kiedy jest wyłączony i jako prostokąt z zaznaczeniem, kiedy jest włączony. Użytkownik posiada możliwość włączenia stanu pola wyboru poprzez zaznaczenie pudełka myszą. Etykieta, określona atrybutem <code id="a-label"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/label">label</a></code> może być dodana obok pola wyboru. </p><p>Dodatkowe informacje są dostępne w <a href="pl/Kurs_XUL/Kontrolki_wej%c5%9bcia">kursie XUL</a>.
</p>
<dl><dt> Atrybuty
</dt><dd> <a href="#a-accesskey">accesskey</a>, <a href="#a-checked">checked</a>, <a href="#a-command">command</a>, <a href="#a-crop">crop</a>, <a href="#a-disabled">disabled</a>, <a href="#a-image">image</a>, <a href="#a-label">label</a>, <a href="#a-preference">preference</a>, <a href="#a-tabindex">tabindex</a>
</dd></dl>
<dl><dt> Własności
</dt><dd> <a href="#p-accessKey">accessKey</a>, <a href="#p-accessible">accessible</a>, <a href="#p-checked">checked</a>, <a href="#p-command">command</a>, <a href="#p-crop">crop</a>, <a href="#p-disabled">disabled</a>, <a href="#p-image">image</a>, <a href="#p-label">label</a>, <a href="#p-tabIndex">tabIndex</a>, <a href="#p-value">value</a>
</dd></dl>
<h3 id="Przyk.C5.82ady" name="Przyk.C5.82ady"> Przykłady </h3>
<div class="float-right"><img alt="Image:XUL_ref_checkbox.png"></div>
<pre class="eval">&lt;checkbox label="Enable JavaScript" checked="true"/&gt;
&lt;checkbox label="Enable Java" checked="false"/&gt;
</pre>
<h3 id="Atrybuty" name="Atrybuty"> Atrybuty </h3>
<p>
</p><p></p><div id="a-accesskey">

<dl><dt> <code id="a-accesskey"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/accesskey">accesskey</a></code></dt>
<dd> Typ: <i>znak</i>
</dd><dd> Powinien być ustawiony na literę, która zostanie zastosowana jako klawisz dostępu. Litera ta powinna być jedną z liter, które są wyświetlane w etykiecie tekstowej (<code><code id="a-label"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/label">label</a></code></code>) dla elementu. </dd></dl>
<p><br>
</p>
<h4 id="Przyk.C5.82ad" name="Przyk.C5.82ad">Przykład</h4>
<div class="float-right"><img alt="grafika:XUL_ref_accesskey_attr.png"></div>
<pre>&lt;vbox&gt;
  &lt;label value="Enter Name" accesskey="e" control="myName"/&gt;
  &lt;textbox id="myName"/&gt;
  &lt;button label="Cancel" accesskey="n"/&gt;
  &lt;button label="Ok" accesskey="O"/&gt;
&lt;/vbox&gt;
</pre>
<h4 id="Zobacz_tak.C5.BCe" name="Zobacz_tak.C5.BCe">Zobacz także</h4>
<p>Atrybut <code id="a-label"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/label">label</a></code>, atrybut <code id="a-acceltext"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/acceltext">acceltext</a></code>
</p> <p><br>
</p><p><br>
</p>


</div>
<div id="a-checked">

<dl><dt> <code id="a-checked"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/checked">checked</a></code>
</dt><dd> Typ: <i>boolean</i>
</dd><dd> Określa, czy przycisk jest zaznaczony. Konieczne jest ustawienie atrybutu <code><code id="a-type"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/type">type</a></code></code> na <code>checkbox</code> lub <code>radio</code>, aby zmiana atrybutu <code>checked</code> mogła odnosić jakiekolwiek skutki.
</dd></dl>
<p><br>
</p>


</div>
<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-crop">

<dl><dt> <code id="a-crop"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/crop">crop</a></code>
</dt><dd> Typ: <i>jedna z poniższych wartości</i>
</dd><dd> Jeśli etykieta elementu jest zbyt duża by zmieścić się w danym miejscu, to jej tekst zostanie skrócony po stronie określonej przy pomocy atrybutu <code>crop</code>. Wycięty fragment tekstu zostanie zastąpiony wielokropkiem. Jeśli kierunek pudełka jest określony w lewą stronę, to skrócenie tekstu nastąpi w tym samym kierunku (czyli z lewej strony):
</dd></dl>
<ul><li> <code>start</code>: Tekst będzie skrócony z lewej strony.
</li><li> <code>end</code>: Tekst będzie skrócony z prawej strony.
</li><li> <code>left</code>: <span title="This deprecated API should no longer be used, but will probably still work."><i class="icon-thumbs-down-alt"> </i></span> Tekst będzie skrócony z lewej strony.
</li><li> <code>right</code>: <span title="This deprecated API should no longer be used, but will probably still work."><i class="icon-thumbs-down-alt"> </i></span> Tekst będzie skrócony z prawej strony.
</li><li> <code>center</code>: Tekst będzie skrócony w środku, pokazując oba końce: początek i koniec normalnego tekstu. </li><li> <code>none</code>: Tekst nie będzie skrócony przy zastosowaniu wielokropka. Jednakże, tekst skrócony zostanie po prostu obcięty, jeśli będzie za duży. Strona skrócenia owego tekstu zależy od rozmieszczenia tekstu określonego w arkuszu stylów CSS.
</li></ul>
<pre class="eval"> menupopup &gt; menuitem, menupopup &gt; menu { max-width: none; }
</pre>
<p><br>
</p><p><br>
</p>


</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>&lt;!-- Pole wyboru włącza/wyłącza przycisk --&gt;
&lt;checkbox label="Enable button"
    onclick="document.getElementById('buttRemove').disabled = this.checked"/&gt;
&lt;button id="buttRemove" label="Remove All" disabled="true"/&gt;
</pre>
</div>
<div id="a-image">

<dl><dt> <code id="a-image"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/image">image</a></code>
</dt><dd> Typ: <i>adres URL obrazka</i>
</dd><dd> Adres URL obrazka do wyświetlenia na elemencie. Jeśli ten atrybut zostanie opuszczony, to żaden obrazek nie zostanie wyświetlony. Pozycja obrazka jest określona przez atrybuty <code id="a-dir"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/dir">dir</a></code> i <code id="a-orient"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/orient">orient</a></code>.
</dd></dl>


</div>
<div id="a-label">

<dl><dt> <code id="a-label"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/label">label</a></code>
</dt><dd> Typ: <i>string</i>
</dd><dd> Etykieta, która zostanie wyświetlona na elemencie. Jeśli zostanie on usunięty, to żaden tekst nie zostanie wyświetlony. </dd></dl>


</div>
<div id="a-preference">

<dl><dt> <code id="a-preference"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/preference">preference</a></code>
</dt><dd> Typ: <i>id elementu</i>
</dd><dd> Łączy dany element z odpowiadającym mu elementem <code><a href="/pl/docs/Mozilla/Tech/XUL/preference" title="preference">preference</a></code>. Atrybut ten ma skutek tylko wewnątrz okna <code><a href="/pl/docs/Mozilla/Tech/XUL/prefwindow" title="prefwindow">prefwindow</a></code>. Wartość opcji (z elementu <code>preference</code>) zostanie zaktualizowana zgodnie z wartością własności <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/W%C5%82asno%C5%9B%C4%87/value">value</a></span></code> tego elementu.
</dd></dl>
<p><br>
</p><p><br>
</p>


</div>
<div id="a-tabindex">

<dl><dt> <code id="a-tabindex"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/tabindex">tabindex</a></code>
</dt><dd> Typ: <i>integer</i>
</dd><dd> Porządek dla przełączania elementów klawiszem Tab. Elementy o wyższym tabindex umieszczane są w dalszej części sekwencji przełączania.
</dd></dl>


</div>
<p></p>
<h3 id="W.C5.82asno.C5.9Bci" name="W.C5.82asno.C5.9Bci"> Własności </h3>
<p>
</p><p></p><div id="p-accessKey">
<dl>
 <dt>
  <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/W%C5%82asno%C5%9B%C4%87/accessKey">accessKey</a></span></code></dt>
 <dd>
  Typ:
  <i>
   znak</i>
 </dd>
 <dd>
  Pobiera i ustawia wartość atrybutu <code id="a-accesskey"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/accesskey">accesskey</a></code>.</dd>
</dl></div>
<div id="p-accessible">
<dl>
 <dt>
  <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/W%C5%82asno%C5%9B%C4%87/accessible">accessible</a></span></code></dt>
 <dd>
  Typ:
  <i>
   <a href="pl/NsIAccessible">nsIAccessible</a></i>
 </dd>
 <dd>
  Zwraca obiekt dostępności dla elementu.</dd>
</dl></div>
<div id="p-checked">
<dl><dt> <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/W%C5%82asno%C5%9B%C4%87/checked">checked</a></span></code>
</dt><dd> Typ: <i>boolean</i>
</dd><dd> Pobiera i ustawia wartość atrybutu <code id="a-checked"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/checked">checked</a></code>.
</dd></dl>
<p><br>
</p>

</div>
<div id="p-command">
<dl>
 <dt>
  <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/W%C5%82asno%C5%9B%C4%87/command">command</a></span></code></dt>
 <dd>
  Typ:
  <i>
   element id</i>
 </dd>
 <dd>
  Pobiera i ustawia wartość atrybutu <code id="a-command"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/command">command</a></code>.</dd>
</dl></div>
<div id="p-crop">
<dl>
 <dt>
  <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/W%C5%82asno%C5%9B%C4%87/crop">crop</a></span></code></dt>
 <dd>
  Typ:
  <i>
   string</i>
 </dd>
 <dd>
  Pobiera i ustawia wartość atrybutu <code id="a-crop"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/crop">crop</a></code>.</dd>
</dl></div>
<div id="p-disabled">
<dl>
 <dt>
  <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/W%C5%82asno%C5%9B%C4%87/disabled">disabled</a></span></code></dt>
 <dd>
  Typ:
  <i>
   boolean</i>
 </dd>
 <dd>
  Pobiera i ustawia wartość atrybutu <code id="a-disabled"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/disabled">disabled</a></code>.</dd>
</dl></div>
<div id="p-image">
<dl>
 <dt>
  <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/W%C5%82asno%C5%9B%C4%87/image">image</a></span></code></dt>
 <dd>
  Typ:
  <i>
   adres URL obrazka</i>
 </dd>
 <dd>
  Pobiera i ustawia wartość atrybutu <code id="a-image"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/image">image</a></code>.</dd>
</dl></div>
<div id="p-label">
<dl><dt> <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/W%C5%82asno%C5%9B%C4%87/label">label</a></span></code>
</dt><dd> Typ: <i>string</i>
</dd><dd> Pobiera i ustawia wartość atrybutu <code id="a-label"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/label">label</a></code>.
</dd></dl>
<p><br>
</p>

</div>
<div id="p-tabIndex">
<dl>
 <dt>
  <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/W%C5%82asno%C5%9B%C4%87/tabIndex">tabIndex</a></span></code></dt>
 <dd>
  Typ:
  <i>
   integer</i>
 </dd>
 <dd>
  Pobiera i ustawia wartość atrybutu <code id="a-tabindex"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/tabindex">tabindex</a></code>.</dd>
</dl></div>
<div id="p-value">
<dl>
 <dt>
  <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/W%C5%82asno%C5%9B%C4%87/value">value</a></span></code></dt>
 <dd>
  Typ:
  <i>
   string</i>
 </dd>
 <dd>
  Pobiera i ustawia wartość atrybutu <code id="a-value"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/value">value</a></code>.</dd>
</dl></div>
<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>
<dl><dt> Interfejsy
</dt><dd> <a href="pl/NsIAccessibleProvider">nsIAccessibleProvider</a>, <a href="pl/NsIDOMXULCheckboxElement">nsIDOMXULCheckboxElement</a>
</dd></dl>
<div class="noinclude">
</div>