Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

description

Ten element jest stosowany do tworzenia bloku tekstu. Tekst może być ustawiony przy użyciu atrybutu value lub umieszczony wewnątrz znaczników description (otwierającego i zamykającego). Atrybut value stosuje się do ustawienia tekstu, który pojawi się w jednej linii. Jeśli tekst podany zostanie jako element potomny, będzie zawijany do nowej linii. Element ten może zawierać dowolne elementy potomne, którym w razie potrzeby można nadawać styl.

Dodatkowe informacje są dostępne w kursie XUL.

Atrybuty
accesskey, control, crop, disabled, value
Własności
acccessKey, accessible, control, crop, disabled, value
Klasy stylów
header, indent, monospace, plain, small-margin

Przykłady

grafika:XUL_ref_description.png
<description>
  This is a long section of text that is displayed.
</description>

Atrybuty

accesskey
Typ: znak
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 (label) dla elementu.


Przykład

grafika:XUL_ref_accesskey_attr.png
<vbox>	
  <label value="Enter Name" accesskey="e" control="myName"/>
  <textbox id="myName"/>
  <button label="Cancel" accesskey="n"/>
  <button label="Ok" accesskey="O"/>
</vbox>

Zobacz także

Atrybut label, atrybut acceltext



control
Typ: id elementu
Ten atrybut określa id elementu, z którym powiązana jest etykieta. Kiedy użytkownik na nią kliknie, połączony element staje się aktywny (focus).
crop
Typ: jedna z poniższych wartości
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 crop. 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):
  • start: Tekst będzie skrócony z lewej strony.
  • end: Tekst będzie skrócony z prawej strony.
  • left: Tekst będzie skrócony z lewej strony.
  • right: Tekst będzie skrócony z prawej strony.
  • center: Tekst będzie skrócony w środku, pokazując oba końce: początek i koniec normalnego tekstu.
  • none: 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.
 menupopup > menuitem, menupopup > menu { max-width: none; }



disabled
Typ: boolean
Określa, czy element jest wyłączony. Jeśli atrybut ten ma wartość true, 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 command nie zostanie wywołane.
grafika:XUL_ref_attr_disabled.png
<!-- 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"/>
value
Typ: string
Atrybut łańcucha znaków pozwalający na współpracę wartości danych z elementem. Nie jest stosowany dla określenia jakiegoś konkretnego celu, lecz można go wykorzystać w skrypcie do własnego użytku.

Własności

accessKey
Typ: znak
Pobiera i ustawia wartość atrybutu accesskey.
accessible
Typ: nsIAccessible
Zwraca obiekt dostępności dla elementu.
{{ languages( { "ja": "ja/XUL/Property/control", "en": "en/XUL/Property/control" } ) }}
{{ XULProp("control") }} {{ mediawiki['#switch']('<magic name="\"PAGENAME\"/">', XUL:menuitem, XUL:menuseparator = ) }}</magic>

{{ Fx_minversion_inline(3) }}

Typ: id elementu
Pobiera i ustawia wartość atrybutu {{ XULAttr("control") }}.
crop
Typ: string
Pobiera i ustawia wartość atrybutu crop.
disabled
Typ: boolean
Pobiera i ustawia wartość atrybutu disabled.
value
Typ: string
Pobiera i ustawia wartość atrybutu value.

Metody

Dziedziczy z elementu XUL
blur, click, doCommand, focus, getElementsByAttribute

Dziedziczy z elementu DOM
addEventListener(), appendChild(), dispatchEvent(), getAttribute(), getAttributeNode(), getAttributeNodeNS(), getAttributeNS(), getElementsByTagName(), getElementsByTagNameNS(), hasAttribute(), hasAttributeNS(), hasAttributes(), hasChildNodes(), insertBefore(), isSupported(), normalize(), removeAttribute(), removeAttributeNode(), removeAttributeNS(), removeChild(), removeEventListener(), replaceChild(), setAttribute(), setAttributeNode(), setAttributeNodeNS(), setAttributeNS()

Klasy stylów

header
Klasę stosujemy do nagłówków. Zazwyczaj będzie powodować, że tekst ukaże się pogrubiony.
indent
Klasa ta powoduje wcięcie z lewej strony tekstu.
monospace
Klasa powoduje, że tekst będzie wyświetlany w czcionce o stałej szerokości znaków.
plain
Ta klasa sprawia, że element będzie wyświetlony bez obramowania lub marginesu.
small-margin
Ta klasa powoduje wyświetlenie tekstu z małym marginesem.


Podobne

TBD

Autorzy i etykiety dokumentu

 Autorzy tej strony: teoli, lmorchard, Mgjbot, Marcoos, Ptak82, Kjj2
 Ostatnia aktualizacja: teoli,