Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
panel-ui-guidelines [2007/12/14 05:07] – ongardie | panel-ui-guidelines [2007/12/19 17:04] (current) – removed mike | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | This page is very much a work-in-progress at the moment. Feel free to contribute. | ||
- | ===== 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., " |