-
buttons
- Type: comma-separated list of the values below
-
A comma-separated list of buttons to appear in the dialog box. The buttons will be placed in suitable locations for the user's platform and basic event handling will be performed automatically. The following values can be used in the list:
accept
: The OK button, which will accept the changes when pressed. This button will also be the default button.cancel
: The cancel button which will cancel the operation.help
: A help button for displaying help about the dialog.disclosure
: A button to show more information. This might be a button or a disclosure triangle.extra1
: An optional additional button. You can set its label with the
attribute and its command with thebuttonlabelextra1
attributeondialogextra1
extra2
: A second optional additional button. You can set its label with the
attribute and its command with thebuttonlabelextra2
attributeondialogextra2
Note: If you don't want to display any buttons in the dialog box, set the value of this attribute to "," (a single comma).
Warning: If the
The default setting of
accept
and cancel
buttons are actually shown is system dependent and is mainly controlled by the value of the boolean preference browser.preferences.instantApply
. If it is set to true
any changes to settings are supposed to be applied immediately. The accept
button is therefore unnecessary and is hidden. The cancel
button might be shown as an additional possibility to close the dialog in this situation (Windows and Linux) or might be hidden, too (Mac OS).The default setting of
browser.preferences.instantApply
currently is true
on Linux and Mac OS and false
on Windows (which however might or might not change soon, see bug 738797 and bug 1037225).