Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
panel-ui-guidelines [2007/12/14 04:32] – spacing r1 ongardie | panel-ui-guidelines [2007/12/16 18:02] – Nick: "it's GtkWidget->style" ongardie | ||
---|---|---|---|
Line 3: | Line 3: | ||
===== Rationale ===== | ===== 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. | 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 ===== | ===== Process ===== | ||
New guidelines should be submitted as a draft at the bottom of the page, in the "Draft Guidelines" | New guidelines should be submitted as a draft at the bottom of the page, in the "Draft Guidelines" | ||
+ | |||
+ | ===== Plugin Classes ===== | ||
+ | Most guidelines apply differently based on the plugin class. (" | ||
+ | |||
+ | ==== Class B: Button ==== | ||
+ | < | ||
+ | |||
+ | sometimes opening a menu | ||
+ | |||
+ | examples: menu, places, launcher, window list, ... | ||
+ | |||
+ | ==== Class I: Input ==== | ||
+ | < | ||
+ | |||
+ | database queries, command execution, etc from the panel | ||
+ | |||
+ | examples: verve, dict(ionary) | ||
+ | |||
+ | ==== Class M: Monitor ==== | ||
+ | < | ||
+ | |||
+ | the resource monitoring ones | ||
+ | |||
+ | examples: system load monitor, battery monitor | ||
+ | |||
+ | ==== Class G: Grid ==== | ||
+ | < | ||
+ | |||
+ | examples: icon box, task list, system tray | ||
+ | |||
+ | ==== Class O: Other ==== | ||
+ | examples: pager, xfapplet | ||
===== Mature Guidelines ===== | ===== Mature Guidelines ===== | ||
(none yet) | (none yet) | ||
+ | |||
===== Draft Guidelines ===== | ===== 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. | ||
- | | + | ==== Spacing Guideline ==== |
- | * e.g., system load monitor, volume control | + | This text is revision 1 of this guideline. |
- | * Use 2px spacing between the label/icon/value reading | + | |
+ | === Display an image inside a button === | ||
+ | | ||
+ | * Set the size of the image to:\\ '' | ||
+ | |||
+ | === Display a label === | ||
+ | * Plugins using it: //menu (xfdesktop)// | ||
+ | * Put the label inside a box and use a spacing of 4 on that box --- // | ||
+ | |||
+ | === Mix several widgets side by side === | ||
+ | * Plugins using it: // | ||
+ | * Use 2px spacing between the label/ | ||
+ | |||
+ | |||
+ | |||
+ | ==== Monitor Layout Guideline ==== | ||
+ | This text is revision 2 of this guideline. | ||
+ | |||
+ | Many plugins | ||
+ | |||
+ | === Order to display widgets === | ||
+ | The order of the widgets, starting from the left or the top according to the panel orientation, | ||
+ | - Icon | ||
+ | - Name | ||
+ | - Monitor | ||
+ | - Value | ||
+ | |||
+ | |||
+ | |||
+ | ==== Text Guideline ==== | ||
+ | This text is revision 1 of this guideline. | ||
+ | |||
+ | === Name of the plugin === | ||
+ | * Use a short label to conserve space | ||
+ | * Use capitalization like a title (e.g., "My Button" | ||
+ | |||
+ | === Name of 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., " | ||
+ | | ||
+ | |||
+ | === Display a value === | ||
+ | * Don't include too much precision (e.g., " | ||
+ | * Include units if they add no more than 3 characters to the string (e.g., " |