Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
| dev:hig:panel-plugins [2012/05/09 14:25] – [Monitor] andrzejr | dev:hig:panel-plugins [2012/06/03 19:06] – [Size] mike | ||
|---|---|---|---|
| Line 68: | Line 68: | ||
| Labels should be oriented horizontally in the horizontal and deskbar mode and vertically (rotated clockwise) in the vertical mode. | Labels should be oriented horizontally in the horizontal and deskbar mode and vertically (rotated clockwise) in the vertical mode. | ||
| - | (RFC) For consistency with orther | + | (RFC) For consistency with other panel plugins and for good aligning of plugins in the panel, I'd suggest aligning all labels to the left edge of the plugin, or icon, if present. Currently many plugins center their labels, which looks poorly in the deskbar mode, or if multiple rows are used in other modes. |
| If plugin displays multiple rows of labels, it should preserve their native spacing (e.g. vbox with labels should be wrapped with a GtkAdjustment widget to prevent expanding the box). | If plugin displays multiple rows of labels, it should preserve their native spacing (e.g. vbox with labels should be wrapped with a GtkAdjustment widget to prevent expanding the box). | ||
| Line 101: | Line 101: | ||
| * It would be nice if the monitor plugin could display only an icon and still be useful (have the gauge displayed on it) - not too different from the mixer plugin. | * It would be nice if the monitor plugin could display only an icon and still be useful (have the gauge displayed on it) - not too different from the mixer plugin. | ||
| + | The above would result in the following layout (mockup): | ||
| + | |||
| + | {{http:// | ||
| + | |||
| + | In a horizontal panel. | ||
| + | |||
| + | {{http:// | ||
| + | |||
| + | In a deskbar. | ||
| + | |||
| + | Note that the icons/ | ||
| ===== Panel properties ===== | ===== Panel properties ===== | ||
| - | ==== mode ==== | + | ==== Mode ==== |
| + | |||
| + | The panel has three modes: horizontal, vertical, and deskbar. | ||
| + | |||
| + | === Horizontal | ||
| + | * Widgets are placed horizontally | ||
| + | * Progressbars are placed vertically | ||
| + | |||
| + | === Vertical mode === | ||
| + | * Widgets are placed vertically | ||
| + | * Labels are rotated to 90 degrees | ||
| + | * Progressbars are placed horizontally | ||
| + | |||
| + | === Deskbar mode === | ||
| + | * Widgets are placed vertically | ||
| + | * Composited widgets can be packed horizontally | ||
| + | * Labels are not rotated | ||
| + | * Progressbars are placed horizontally | ||
| - | The panel (starting with 4.10) has 3 modes : horizontal, vertical and deskbar. A plugin should layout its widgets following those rules : | + | ==== Size ==== |
| - | * use a vertical XfceHVBox if the panel is in vertical or deskbar mode, horizontal otherwise. | + | |
| - | * labels should be oriented vertically (using '' | + | |
| - | * progressbars should be oriented vertically in horizontal mode, horizontally otherwise. | + | |
| - | ==== size ==== | + | Two category of sizes can be distinguished for the panel: small and large size. |
| - | Plugins should | + | |
| - | The exception is a deskbar mode - it should look good when: | + | === Padding === |
| - | * a single row is used - in such a case plugins should resort to displaying icons only. Plugins which must display text or input fields are exempt from this requirement. | + | |
| - | * look " | + | |
| + | * Plugins that include a padding have to stick to 1px for a size < 28px and 2px otherwise. | ||
| + | * When displaying a frame around the plugin, the padding has to be 0px for a size of < 28px and 1px otherwise. | ||
| ==== number of rows ==== | ==== number of rows ==== | ||