Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
panel-ui-guidelines [2007/12/16 07:42] – mike | panel-ui-guidelines [2007/12/17 19:12] – 84.44.152.252 | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | This page is very much a work-in-progress at the moment. Feel free to contribute. | + | This page has been renamed |
- | + | ||
- | ===== Rationale ===== | + | |
- | UI consistency is an important aspect of a mature desktop like Xfce. On the other hand, there are tons of panel plugins out there, developed by many different people. A written set of UI guidelines will help those developers ensure their plugins maintain some basic level of consistency. | + | |
- | + | ||
- | ===== Process ===== | + | |
- | New guidelines should be submitted as a draft at the bottom of the page, in the "Draft Guidelines" | + | |
- | + | ||
- | ===== Mature Guidelines ===== | + | |
- | (none yet) | + | |
- | + | ||
- | + | ||
- | ===== Draft Guidelines ===== | + | |
- | + | ||
- | ==== Spacing Guideline ==== | + | |
- | * This text is revision 1 of this guideline. | + | |
- | * Core plugins implementing this guideline: ??? | + | |
- | * Additional plugins implementing this guideline: places | + | |
- | + | ||
- | * Plugins that display a single icon to the user: | + | |
- | * e.g., launchers | + | |
- | * Use 1px border around the icon. (This is the default border width for a GTK+ button.) | + | |
- | + | ||
- | * Plugins that display a button and a label in a horizontal (v.) box for horizontal (v.) panels: | + | |
- | * e.g., menu (when showing label) | + | |
- | * Use a spacing of 4 on that box. | + | |
- | + | ||
- | * Plugins that display a label, icon, or value reading next to a " | + | |
- | * e.g., system load monitor, volume control | + | |
- | * Use 2px spacing between the label/ | + | |
- | + | ||
- | ==== Monitor Layout Guideline ==== | + | |
- | * This text is revision 1 of this guideline. | + | |
- | * Core plugins implementing this guideline: ??? | + | |
- | * Additional plugins implementing this guideline: ??? | + | |
- | + | ||
- | * Many plugins display a monitor (progress bar) and give the user the option of showing a label, a value reading, or both. For example, the system load monitor can show labels and monitors for CPU, memory, and swap usage. | + | |
- | + | ||
- | * For horizontal panels: | + | |
- | * The label, if shown, should be placed to the left of the monitor. | + | |
- | * The value reading, if shown, should be placed to the right of the monitor. | + | |
- | + | ||
- | * For vertical panels: | + | |
- | * The label, if shown, should be placed above the monitor. | + | |
- | * The value reading, if shown, should be placed below the monitor. | + | |
- | + | ||
- | + | ||
- | ==== Text Guideline ==== | + | |
- | * This text is revision 1 of this guideline. | + | |
- | * Core plugins implementing this guideline: ??? | + | |
- | * Additional plugins implementing this guideline: ??? | + | |
- | + | ||
- | * Plugins that display a static label on the panel to explain an interactive widget: | + | |
- | * Use a short label to conserve space | + | |
- | * Use capitalization like a title (e.g., "My Button" | + | |
- | + | ||
- | * Plugins that display a static label on the panel to explain a monitor: | + | |
- | * Use a short label to conserve space. Abbreviations are acceptable. | + | |
- | * Use all lowercase letters (e.g., " | + | |
- | * Omit spaces in acronyms and abbreviations (e.g., " | + | |
- | + | ||
- | * Plugins that display a value reading next to a monitor: | + | |
- | * Don't include too much precision (e.g., " | + | |
- | * Include units if they add no more than 3 characters to the string (e.g., " | + |