This element is used to provide a label for a control element. If the user clicks the label, it will move the focus to the associated control, specified with the control
attribute.
More information is available in the XUL tutorial.
Examples
<label value="Email address" control="email"/> <textbox id="email"/>
Attributes
accesskey
- 类型: character【字符】
- 本属性允许为控件(元素)设定一个字符作为快捷键,这个字符应该是
属性文本中的一个字符。该字符将会被加下划线以重点强调,平台和主体的变换并不影响这一表现行为。 当用户点击 ALT (在其他平台上具有类似功能的键) 和这个字符对应的按键时, 控件(元素)将立刻被从窗口中的某处激活或/并且获得焦点 。虽说字符不分大小写,但是当label中存在大写字符和小写字符时,快捷键的字符将首先选择与之完全匹配的那一个,如果label中存在两个或更多的与accesskey字符相同的字符,其中的第一个字符将被加下划线。label
- *(有些键在监听按键事件时,分别对应event.ctrlKey和event.metaKey。)
Example
<vbox> <label value="Enter Name" accesskey="e" control="myName"/> <textbox id="myName"/> <button label="Cancel" accesskey="n"/> <button label="Ok" accesskey="O"/> </vbox>
See also
-
control
- Type: element id
-
This attribute specifies the
id
of the element with which the label is associated. When the user clicks on the label, the associated element is given focus.
这个属性定义了元素的id
,它与label
相关联。当用户点击label
的时候,相关联的元素将获得焦点。
-
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
: The text will be cropped on its left side.right
: 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.
disabled
-
类型:boolean
-
表示元素是被禁用的。
如果这个元素的disabled属性被设置为true,表示元素被禁用,被禁用的属性在页面上通常会显示灰色文本,它无法响应用户的操作,它也无法得到光标。
然而,这个元素仍然能够响应鼠标事件,如果要启用这个元素,把disabled设置为false
示例:

// Disabling an element
document.getElementById('buttonRemove').setAttribute("disabled", "true");
// Enabling back an element by removing the "disabled" attribute
document.getElementById('buttonRemove').removeAttribute("disabled");
For keyset
elements, support for this attribute was added in Firefox 3.5.
value
- Type: string
- The text to be used for the label.
Properties
-
accessibleType
- Type: integer
- A value indicating the type of accessibility object for the element.
Methods
Style classes
The following classes may be used to style the element. These classes should be used instead of changing the style of the element directly since they will fit more naturally with the user's selected theme.
header
- A class used for headings. Typically, this will cause the text to appear bold.
indent
- This class causes the text to be indented on its left side.
monospace
- This class causes the text to be displayed in a monospace font.
plain
- This class causes the element to be displayed with no border or margin.
small-margin
- This class causes the text to be displayed with a smaller margin.
text-link
- Labels with this class may be focused and the click handler run or the address in the href attribute opened on a mouse click or Enter key press. Labels will appear like a link (blue and underlined).
Related
User notes
Remember that the label element has a "value" attribute, unlike value in HTML whereas buttons, checkboxes use label="foo" as the attribute
<label label="A Caption"/> <-- wrong --> <label value="A Caption"/> <label value="Click the button"/> <button label="A Button"/> <checkbox label="A Decision" value="1"/>