XUL:label

z Mozilla Developer Center, polskiego centrum programistów Mozilli.

« Dokumentacja XUL    [ Przykłady | Atrybuty | Własności | Metody | Podobne ]

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 control.

Dodatkowe informacje są dostępne w kursie XUL.

Atrybuty

accesskey, control, crop, disabled, href, value

Własności

accessKey, accessible, control, crop, disabled, value

Klasy stylów

header, indent, monospace, plain, small-margin, text-link

[edytuj] Przykłady

<label value="Email address" control="email"/>
<textbox id="email"/>

[edytuj] Atrybuty

Dziedziczy z elementu XUL align, allowevents, allownegativeassertions, class, coalesceduplicatearcs, collapsed, container, containment, context, contextmenu, datasources, dir, empty, equalsize, flags, flex, height, hidden, id, insertafter, insertbefore, left, maxheight, maxwidth, menu, minheight, minwidth, mousethrough, observes, ordinal, orient, pack, persist, popup, position, preference-editable, ref, removeelement, sortDirection, sortResource, sortResource2, statustext, style, template, tooltip, tooltiptext, top, uri, wait-cursor, width

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.

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: Wycofywany Tekst będzie skrócony z lewej strony.
• right: Wycofywany 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.

href

Typ: string

Definiuje adres URL do otworzenia, w momencie naciśnięcia elementu. Żąda atrybutu class, by włączyć text-link.

value

Typ: string

Tekst dla etykiety.

[edytuj] Własności

Dziedziczy z elementu XUL align, allowEvents, boxObject, builder, className, collapsed, contextMenu, controllers, currentItem, database, datasources, dir, flex, height, hidden, id, left, listBoxObject, maxHeight, maxWidth, menu, minHeight, minWidth, observes, ordinal, orient, pack, persist, ref, resource, statusText, style, tooltip, tooltipText, top, value, width Dziedziczy z elementu DOM attributes, childNodes, cloneNode, firstChild, lastChild, localName, namespaceURI, nextSibling, nodeName, nodeType, nodeValue, ownerDocument, parentNode, prefix, previousSibling, tagName

accessKey

Typ: znak

Pobiera i ustawia wartość atrybutu accesskey.

accessible

Typ: nsIAccessible

Zwraca obiekt dostępności dla elementu.

control

Typ: id elementu

Pobiera i ustawia wartość atrybutu 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.

[edytuj] 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

[edytuj] Klasy stylów

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.

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.

text-link

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.

[edytuj] Podobne

Elementy

description

Atrybuty

label

Interfejsy

nsIAccessibleProvider, nsIDOMXULLabelElement

[edytuj] Notatki

Należy pamiętać, że, inaczej niż w języku HTML, element label posiada atrybut "value", natomiast przyciski i pola wyboru używają label="foo" jako atrybutu.

<label label="Przycisk"/> <-- Źle -->
<label value="Przycisk"/>

<label value="Kliknij w przycisk"/>
<button label="Przycisk"/>
<checkbox label="Decyzja" value="1"/>