appearance (-moz-appearance, -webkit-appearance) - CSS: Cascading Style Sheets 编辑
The appearance
CSS property is used to display an element using platform-native styling, based on the operating system's theme. The -moz-appearance
and -webkit-appearance
properties are non-standard versions of this property, used (respectively) by Gecko (Firefox) and by WebKit-based (e.g., Safari) and Blink-based (e.g., Chrome, Opera) browsers to achieve the same thing. Note that Firefox and Edge also support -webkit-appearance
, for compatibility reasons.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
The -moz-appearance
property was used in XUL stylesheets to design custom widgets with platform-appropriate styling. It was also used in the XBL implementations of the widgets that ship with the Mozilla platform. Starting with Gecko/Firefox 80, these uses were changed to -moz-default-appearance
, which should never be used outside of internal stylesheets.
Compatibility note: If you wish to use this property on websites, you should test it very carefully. Although it is supported in most modern browsers, its implementation varies. In older browsers, even the keyword none
does not have the same effect on all form elements across different browsers, and some do not support it at all. The differences are smaller in the newest browsers.
Syntax
/* CSS Basic User Interface Module Level 4 values */
appearance: none;
appearance: auto;
appearance: menulist-button;
appearance: textfield;
/* "Compat-auto" values, which have the same effect as 'auto' */
appearance: button;
appearance: searchfield;
appearance: textarea;
appearance: push-button;
appearance: slider-horizontal;
appearance: checkbox;
appearance: radio;
appearance: square-button;
appearance: menulist;
appearance: listbox;
appearance: meter;
appearance: progress-bar;
/* Partial list of available values in Gecko */
-moz-appearance: scrollbarbutton-up;
-moz-appearance: button-bevel;
/* Partial list of available values in WebKit/Blink (as well as Gecko and Edge) */
-webkit-appearance: media-mute-button;
-webkit-appearance: caret;
Values
Standard keywords
Value | Demo | Browser | Description |
---|---|---|---|
none |
| Firefox Chrome Safari Edge | No special styling is applied. This is the default. |
auto |
| Firefox Chrome | The user agent selects the appropriate special styling based on the element. Acts as none on elements with no special styling. |
menulist-button |
| Firefox Chrome Safari Edge | The element is styled as a button that would indicate a menulist can be opened. |
textfield |
| Firefox Chrome Safari Edge | |
The following values are treated as equivalent to auto : | |||
button |
| Firefox Chrome Safari Edge | The element is drawn like a button. |
checkbox |
| Firefox Chrome Safari Edge | The element is drawn like a checkbox, including only the actual "checkbox" portion. |
listbox |
| Firefox Chrome Safari Edge | |
menulist |
| Firefox Chrome Safari Edge | |
meter |
| Chrome Safari Firefox | |
progress-bar |
| Chrome Safari Firefox | |
push-button |
| Chrome Safari Edge | |
radio |
| Firefox Chrome Safari Edge | The element is drawn like a radio button, including only the actual "radio button" portion. |
searchfield |
<div>Lorem</div> | Firefox Chrome Safari Edge | |
slider-horizontal |
| Chrome Safari Edge | |
square-button |
| Chrome Safari Edge | |
textarea |
| Firefox Chrome Safari Edge |
Non-standard keywords
The following values are implemented only for one or both of the prefixed properties, but not on the standard appearance
property.
Value | Demo | Browser | Description |
---|---|---|---|
attachment |
| Safari | |
borderless-attachment |
| Safari | |
button-bevel |
| Firefox Chrome Safari Edge | |
caps-lock-indicator |
| Safari Edge | |
caret |
| Firefox Chrome Safari Edge | |
checkbox-container |
| Firefox | The element is drawn like a container for a checkbox, which may include a prelighting background effect under certain platforms. Normally it would contain a label and a checkbox. |
checkbox-label |
| Firefox | |
checkmenuitem |
| Firefox | |
color-well |
| Safari | input type=color |
continuous-capacity-level-indicator |
| Safari | |
default-button |
| Safari Edge | |
discrete-capacity-level-indicator |
| Safari | |
inner-spin-button |
| Firefox Chrome Safari | |
image-controls-button |
| Safari | |
list-button |
| Safari | datalist |
listitem |
| Firefox Chrome Safari Edge | |
media-enter-fullscreen-button |
| Chrome Safari | |
media-exit-fullscreen-button |
| Chrome Safari | |
media-fullscreen-volume-slider |
| Safari | |
media-fullscreen-volume-slider-thumb |
| Safari | |
media-mute-button |
| Chrome Safari Edge | |
media-play-button |
| Chrome Safari Edge | |
media-overlay-play-button |
| Chrome Safari | |
media-return-to-realtime-button |
| Safari | |
media-rewind-button |
| Safari | |
media-seek-back-button |
| Safari Edge | |
media-seek-forward-button |
| Safari Edge | |
media-toggle-closed-captions-button |
| Chrome Safari | |
media-slider |
| Chrome Safari Edge | |
media-sliderthumb |
| Chrome Safari Edge | |
media-volume-slider-container |
| Chrome Safari | |
media-volume-slider-mute-button |
| Safari | |
media-volume-slider |
| Chrome Safari | |
media-volume-sliderthumb |
| Chrome Safari | |
media-controls-background |
| Chrome Safari | |
media-controls-dark-bar-background |
| Safari | |
media-controls-fullscreen-background |
| Chrome Safari | |
media-controls-light-bar-background |
| Safari | |
media-current-time-display |
| Chrome Safari | |
media-time-remaining-display |
| Chrome Safari | |
menulist-text |
| Firefox Chrome Safari Edge | |
menulist-textfield |
| Firefox Chrome Safari Edge | The element is styled as the text field for a menulist. (Not implemented for the Windows platform) |
meterbar |
| Firefox | Use meter instead. |
number-input |
| Firefox | |
progress-bar-value |
| Chrome Safari | |
progressbar |
| Firefox | The element is styled like a progress bar. Use progress-bar instead |
progressbar-vertical |
| Firefox | |
range | range
| Firefox | |
range-thumb |
| Firefox | |
rating-level-indicator |
| Safari | |
relevancy-level-indicator |
| Safari | |
scale-horizontal |
| Firefox | |
scalethumbend |
| Firefox | |
scalethumb-horizontal |
| Firefox | |
scalethumbstart |
| Firefox | |
scalethumbtick |
| Firefox | |
scalethumb-vertical |
| Firefox | |
scale-vertical |
| Firefox | |
scrollbarthumb-horizontal |
<div>Lorem</div> | Firefox | |
scrollbarthumb-vertical |
<div>Lorem</div> | Firefox | |
scrollbartrack-horizontal |
<div>Lorem</div> | Firefox | |
scrollbartrack-vertical |
<div>Lorem</div> | Firefox | |
searchfield-decoration |
| Safari Edge | |
searchfield-results-decoration |
| Chrome Safari Edge | (Works on Chrome 51 on Windows 7) |
searchfield-results-button |
| Safari Edge | |
searchfield-cancel-button |
| Chrome Safari Edge | |
snapshotted-plugin-overlay |
| Safari | |
sheet |
| None | |
slider-vertical |
| Chrome Safari Edge | |
sliderthumb-horizontal |
| Chrome Safari Edge | |
sliderthumb-vertical |
| Chrome Safari Edge | |
textfield-multiline |
| Firefox | Use textarea instead. |
-apple-pay-button |
| Safari | iOS and macOS only. Available on the web starting in iOS 10.1 and macOS 10.12.1 |
Obsolete values
The following values were at some point implemented for a prefixed property, but are no longer supported.
Value | Browser | Description | |
---|---|---|---|
button-arrow-down | Firefox | Removed in Firefox 64 | |
button-arrow-next | Firefox | Removed in Firefox 64 | |
button-arrow-previous | Firefox | Removed in Firefox 64 | |
button-arrow-up | Firefox | Removed in Firefox 64 | |
button-focus | Firefox | Removed in Firefox 64 | |
dualbutton | Firefox | Removed in Firefox 64 | |
groupbox | Firefox | Removed in Firefox 64 | |
menuarrow | Firefox | Removed in Firefox 64 | |
menubar | Firefox | Removed in Firefox 64 | |
menucheckbox | Firefox | Removed in Firefox 64 | |
menuimage | Firefox | Removed in Firefox 64 | |
menuitem | Firefox | Removed in Firefox 64. | |
menuitemtext | Firefox | Removed in Firefox 64 | |
menupopup | Firefox | Removed in Firefox 64 | |
menuradio | Firefox | Removed in Firefox 64 | |
menuseparator | Firefox | Removed in Firefox 64 | |
meterchunk | Firefox | Removed in Firefox 64. | |
progresschunk | Firefox | Removed in Firefox 64. | |
progresschunk-vertical | Firefox | Removed in Firefox 64. | |
radio-container | Firefox | Removed in Firefox 64. | |
radio-label | Firefox | Removed in Firefox 64. | |
radiomenuitem | Firefox | Removed in Firefox 64. | |
resizer | Firefox | Removed in Firefox 63 | |
resizerpanel | Firefox | Removed in Firefox 63. | |
scrollbarbutton-down | Firefox | Removed in Firefox 63. | |
scrollbarbutton-left | Firefox | Removed in Firefox 63. | |
scrollbarbutton-right | Firefox | Removed in Firefox 63. | |
scrollbarbutton-up | Firefox | Removed in Firefox 63. | |
separator | Firefox | Removed in Firefox 64. | |
spinner | Firefox | Removed in Firefox 64. | |
spinner-downbutton | Firefox | Removed in Firefox 64. | |
spinner-textfield | Firefox | Removed in Firefox 64. | |
spinner-upbutton | Firefox | Removed in Firefox 64. | |
splitter | Firefox | Removed in Firefox 64. | |
statusbar | Firefox | Removed in Firefox 64. | |
statusbarpanel | Firefox | Removed in Firefox 64. | |
tab | Firefox | Removed in Firefox 64 | |
tabpanel | Firefox | Removed in Firefox 64. | |
tabpanels | Firefox | Removed in Firefox 64 | |
tab-scroll-arrow-back | Firefox | Removed in Firefox 64. | |
tab-scroll-arrow-forward | Firefox | Removed in Firefox 64. | |
toolbar | Firefox | Removed in Firefox 64. | |
toolbarbutton | Firefox | Removed in Firefox 64. | |
toolbarbutton-dropdown | Firefox | Removed in Firefox 64. | |
toolbargripper | Firefox | Removed in Firefox 64. | |
toolbox | Firefox | Removed in Firefox 64. | |
tooltip | Firefox | Removed in Firefox 64. | |
treeheader | Firefox | Removed in Firefox 64. | |
treeheadercell | Firefox | Removed in Firefox 64. | |
treeheadersortarrow | Firefox | Removed in Firefox 64. | |
treeitem | Firefox | Removed in Firefox 64. | |
treeline | Firefox | Removed in Firefox 64. | |
treetwisty | Firefox | Removed in Firefox 64. | |
treetwistyopen | Firefox | Removed in Firefox 64. | |
treeview | Firefox | Removed in Firefox 64. | |
-moz-win-borderless-glass | Firefox | Removed in Firefox 64. | |
-moz-win-browsertabbar-toolbox | Firefox | Removed in Firefox 64. | |
-moz-win-communicationstext | Firefox | Removed in Firefox 64. | |
-moz-win-communications-toolbox | Firefox | Removed in Firefox 64. | |
-moz-win-exclude-glass | Firefox | Removed in Firefox 64. | |
-moz-win-glass | Firefox | Removed in Firefox 64. | |
-moz-win-media-toolbox | Firefox | Removed in Firefox 64. | |
-moz-window-button-box | Firefox | Removed in Firefox 64. | |
-moz-window-button-box-maximized | Firefox | Removed in Firefox 64. | |
-moz-window-button-close | Firefox | Removed in Firefox 64. | |
-moz-window-button-maximize | Firefox | Removed in Firefox 64. | |
-moz-window-button-minimize | Firefox | Removed in Firefox 64. | |
-moz-window-button-restore | Firefox | Removed in Firefox 64. | |
-moz-window-frame-bottom | Firefox | Removed in Firefox 64. | |
-moz-window-frame-left | Firefox | Removed in Firefox 64. | |
-moz-window-frame-right | Firefox | Removed in Firefox 64. | |
-moz-window-titlebar | Firefox | Removed in Firefox 64. | |
-moz-window-titlebar-maximized | Firefox | Removed in Firefox 64. |
Formal definition
Initial value | auto |
---|---|
Applies to | all elements |
Inherited | no |
Computed value | as specified |
Animation type | discrete |
Formal syntax
none | auto | textfield | menulist-button | <compat-auto>where
<compat-auto> = searchfield | textarea | push-button | slider-horizontal | checkbox | radio | square-button | menulist | listbox | meter | progress-bar | button
Examples
Make an element look like a menulist button
.exampleone {
appearance: menulist-button;
}
See also this JSFiddle for an example showing how you might use appearance: none
to apply custom styling to radio buttons and checkboxes.
Specifications
Specification | Status | Comment |
---|---|---|
CSS Basic User Interface Module Level 4 The definition of 'appearance' in that specification. | Working Draft | Initial definition. |
Browser compatibility
BCD tables only load in the browser
See also
- Definition of
appearance
in CSS 3 Basic User Interface (Candidate Recommendation from 2004-05-11). - Dropped CSS3 features from the UI spec.4
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论