XUL:caption

From MDC

« XUL Reference home [ Examples | Attributes | Properties | Methods | Related ]

A header for a groupbox. It may contain either a text label, using the label attribute, or child elements for a more complex caption.

More information is available in the XUL tutorial.

Attributes: accesskey, crop, image, label, tabindex

Properties: accessKey, crop, image, label, tabIndex

[edit] Examples

<groupbox>
  <caption label="My groupbox"/>
</groupbox>
<groupbox flex="1">
  <caption>
    <checkbox label="A checked groupbox"/>
  </caption>
</groupbox>

[edit] Attributes

Inherited from XUL element
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, querytype, ref, removeelement, sortDirection, sortResource, sortResource2, statustext, style, template, tooltip, tooltiptext, top, uri, wait-cursor, width

accesskey: Type: character; This should be set to a letter that is used as a shortcut key. This letter should be one of the characters that appears in the label text for the element.

crop: Type: one of the values below; If the label of the element is too big to fit in its given space, the text will be cropped on the side specified by the crop attribute. An ellipsis will be used in place of the cropped text. If the box direction is reversed, the cropping is reversed.

start: The text will be cropped on its left side.
end: The text will be cropped on its right side.
left: Deprecated The text will be cropped on its left side.
right: Deprecated The text will be cropped on its right side.
center: The text will be cropped in the middle, showing both the start and end of the text normally.
none: The text will be not be cropped using an ellipsis. However, the text will simply be cut off if it is too large. The side depends on the CSS text alignment.

image: Type: image URL; The URL of the image to appear on the element. If this attribute is empty or left out, no image appears. The position of the image is determined by the dir and orient attributes.

label: Type: string; The label that will appear on the element. If this is left out, no text appears.

tabindex: Type: integer; The tab order of the element. The tab order is the order in which the focus is moved when the user presses the "tab" key. Elements with a higher tabindex are later in the tab sequence.