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

---
title: label
slug: Mozilla/Tech/XUL/label
tags:
  - Dokumentacja_XUL
  - Elementy_XUL
translation_of: Archive/Mozilla/XUL/label
---
<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>Ten element pozwala zastosować etykietę dla elementu sterującego. Po kliknięciu etykiety, focus zostanie przełączony na element sterujący określony przez atrybut <code id="a-control"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/control">control</a></code>.
</p><p>Dodatkowe informacje są dostępne w <a href="pl/Kurs_XUL/Dodawanie_etykiet_i_obrazk%c3%b3w">kursie XUL</a>.
</p>
<dl><dt> Atrybuty
</dt><dd> <a href="#a-accesskey">accesskey</a>, <a href="#a-control">control</a>, <a href="#a-crop">crop</a>, <a href="#a-disabled">disabled</a>, <a href="#a-href">href</a>, <a href="#a-label.value">value</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-control">control</a>, <a href="#p-crop">crop</a>, <a href="#p-disabled">disabled</a>, <a href="#p-value">value</a>
</dd></dl>
<dl><dt> Klasy stylów
</dt><dd> <a href="#s-header">header</a>, <a href="#s-indent">indent</a>, <a href="#s-monospace">monospace</a>, <a href="#s-plain">plain</a>, <a href="#s-small-margin">small-margin</a>, <a href="#s-text-link">text-link</a> </dd></dl>
<h3 id="Przyk.C5.82ady" name="Przyk.C5.82ady"> Przykłady </h3>
<div class="float-right"><img alt="grafika:XUL_ref_label.png"></div>
<pre class="eval">&lt;label value="Email address" control="email"/&gt;
&lt;textbox id="email"/&gt;
</pre>
<h3 id="Atrybuty" name="Atrybuty"> Atrybuty </h3>
<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-control">

<dl><dt> <code id="a-control"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/control">control</a></code>
</dt><dd> Typ: <i>id elementu</i>
</dd><dd> Ten atrybut określa <code id="a-id"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/id">id</a></code> elementu, z którym powiązana jest etykieta. Kiedy użytkownik na nią kliknie, połączony element staje się aktywny (focus).
</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-href">

<dl><dt> <code id="a-href"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/href">href</a></code>
</dt><dd> Typ: <i>string</i>
</dd><dd> Definiuje adres URL do otworzenia, w momencie naciśnięcia elementu. Żąda atrybutu <code>class</code>, by włączyć <a href="pl/XUL/Styl/text-link">text-link</a>.
</dd></dl>


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

<dl><dt> <a href="pl/XUL/Atrybut/label.value">value</a>
</dt><dd> Typ: <i>string</i>
</dd><dd> Tekst dla etykiety.
</dd></dl>


</div>
<p></p>
<h3 id="W.C5.82asno.C5.9Bci" name="W.C5.82asno.C5.9Bci"> Własności </h3>
<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-control">
<dl>
 <dt>
  <code><span><a href="https://developer.mozilla.org/pl/docs/XUL/W%C5%82asno%C5%9B%C4%87/control">control</a></span></code>&lt;magic name="\"PAGENAME\"/"&gt;&lt;/magic&gt;</dt>
</dl>
<p></p>
<dl>
 <dd>
  Typ:
  <i>
   id elementu</i>
 </dd>
 <dd>
  Pobiera i ustawia wartość atrybutu <code id="a-control"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/control">control</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-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="Klasy_styl.C3.B3w" name="Klasy_styl.C3.B3w"> Klasy stylów </h3>
<p>Następujące klasy możemy zastosować do nadania stylu temu elementowi. Należy korzystać z tych klas zamiast nadawać styl bezpośrednio w danym elemencie - dzięki temu będą bardziej pasować do motywu wybranego przez użytkownika.
</p><p></p><dl>
 <dt>
  <code><a href="https://developer.mozilla.org/pl/docs/XUL/Styl/header">header</a></code></dt>
 <dd>
  Klasę stosujemy do nagłówków. Zazwyczaj będzie powodować, że tekst ukaże się pogrubiony.</dd>
</dl>
<dl>
 <dt>
  <code><a href="https://developer.mozilla.org/pl/docs/XUL/Styl/indent">indent</a></code></dt>
 <dd>
  Klasa ta powoduje wcięcie z lewej strony tekstu.</dd>
</dl>
<dl>
 <dt>
  <code><a href="https://developer.mozilla.org/pl/docs/XUL/Styl/monospace">monospace</a></code></dt>
 <dd>
  Klasa powoduje, że tekst będzie wyświetlany w czcionce o stałej szerokości znaków.</dd>
</dl>
<dl>
 <dt>
  <code><a href="https://developer.mozilla.org/pl/docs/XUL/Styl/plain">plain</a></code></dt>
 <dd>
  Ta klasa sprawia, że element będzie wyświetlony bez obramowania lub marginesu.</dd>
</dl>
<dl><dt> <code><a href="https://developer.mozilla.org/pl/docs/XUL/Styl/small-margin">small-margin</a></code>
</dt><dd> Ta klasa powoduje wyświetlenie tekstu z małym marginesem.
</dd></dl>
<p><br>
</p>
<dl><dt> <code><a href="https://developer.mozilla.org/pl/docs/XUL/Styl/text-link">text-link</a></code>
</dt><dd> Etykiety o tej klasie mogą być aktywne (focus), a funkcja obsługi zdarzenia kliknięcia zostanie wywołana zarówno dla kliknięcia myszą, jak i wciśnięcia klawisza Enter.
</dd></dl>
<p><br>
</p>
<p></p>
<h3 id="Podobne" name="Podobne"> Podobne </h3>
<dl><dt> Elementy
</dt><dd> <code><a href="/pl/docs/Mozilla/Tech/XUL/description" title="description">description</a></code>
</dd></dl>
<dl><dt> Atrybuty
</dt><dd> <code id="a-label"><a href="https://developer.mozilla.org/pl/docs/Mozilla/Tech/XUL/Atrybut/label">label</a></code>
</dd></dl>
<dl><dt> Interfejsy
</dt><dd> <a href="pl/NsIAccessibleProvider">nsIAccessibleProvider</a>, <a href="pl/NsIDOMXULLabelElement">nsIDOMXULLabelElement</a>
</dd></dl>
<h3 id="Notatki" name="Notatki"> Notatki </h3>
<p>Należy pamiętać, że, inaczej niż w języku HTML, element <code>label</code> posiada atrybut "value", natomiast przyciski i pola wyboru używają <code>label="foo"</code> jako atrybutu. </p>
<pre>&lt;label label="Przycisk"/&gt; &lt;-- Źle --&gt;
&lt;label value="Przycisk"/&gt;

&lt;label value="Kliknij w przycisk"/&gt;
&lt;button label="Przycisk"/&gt;
&lt;checkbox label="Decyzja" value="1"/&gt;
</pre>
<p><br>
</p>
<div class="noinclude">
</div>