XUL:description

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

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

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

[edytuj] Przykłady

<description>
  This is a long section of text that is displayed.
</description>

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

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.

[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

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.

[edytuj] Podobne

TBD