From f73d3df2339bd2ec6017e156dbc5edadf2b9c18b Mon Sep 17 00:00:00 2001 From: Lee Dohm Date: Sat, 3 Jan 2015 10:36:56 -0800 Subject: [PATCH] :memo: Add priority recommendation for variable-sized panels Applies to #4834 --- src/workspace.coffee | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/src/workspace.coffee b/src/workspace.coffee index aaca0bf02..c62784d1c 100644 --- a/src/workspace.coffee +++ b/src/workspace.coffee @@ -668,6 +668,16 @@ class Workspace extends Model ### Section: Panels + + Panels are used to display UI related to an editor window. They are placed at one of the four + edges of the window: left, right, top or bottom. If there are multiple panels on the same window + edge they are stacked in order of priority: higher priority is closer to the center, lower + priority towards the edge. + + *Note:* If your panel changes its size throughout its lifetime, consider giving it a higher + priority, allowing fixed size panels to be closer to the edge. This allows control targets to + remain more static for easier targeting by users that employ mice or trackpads. (See + [atom/atom#4834](https://github.com/atom/atom/issues/4834) for discussion.) ### # Essential: Get an {Array} of all the panel items at the bottom of the editor window.