Difference between revisions of "Plasma/Panels"

Jump to: navigation, search
(Added Section: Multiple Panel TODO:: Screenshot + Add Panel behavior)
m (update to plasma 5.16)
 
(39 intermediate revisions by 10 users not shown)
Line 1: Line 1:
 +
<languages/>
 +
<translate>
 +
 
== Panels in Plasma Desktop == <!--T:1-->
 
== Panels in Plasma Desktop == <!--T:1-->
  
<!--T:1-->
+
<!--T:2-->
[[Image:Panel_Settings.png|thumb|512px|center|Panel in configuration mode with More settings -submenu open.]]
+
[[Image:Panel_Settings.png|thumb|512px|center|Panel in configuration mode with <menuchoice>More settings</menuchoice>-submenu open.]]
  
A Panel is a widget container which can be located on any side of the desktop. There can be multiple panels on the same side. The default layout is one panel that stretches across the entire bottom of the desktop with the following widgets: [[/Widgets/Kickoff|application menu]], [[/Widgets/Pager|desktop pager]], [[/Widgets/Tasks|task manager]] (list of open windows), [[/Widgets/SystemTray|system tray]] and [[/Widgets/Clocks|clock]]. At the end of the panel is a toolbox button which can be activated to access configuration options.
+
<!--T:3-->
 +
A Panel is a widget container which can be located on any side of the desktop. There can be multiple panels on the same side. The default layout is one panel that stretches across the entire bottom of the desktop with the following widgets: [[Special:myLanguage/Plasma/Kickoff|application menu]], [[Special:myLanguage/Plasma/Pager|desktop pager]], [[Special:myLanguage/Plasma/Tasks|task manager]] (list of open windows), [[Special:myLanguage/Plasma/SystemTray|system tray]] (including things like a [[Special:myLanguage/Plasma/DeviceNotifier|device notifier]]) and [[Special:myLanguage/Plasma/Clocks|clock]]. If you are using a laptop, netbook or other computer that uses a battery there will also be a [[Special:mylanguage/Plasma/Plasmoids#PowerDevil|power management]] widget in the system tray. At the end of the panel is a toolbox button which can be activated to access configuration options.
  
== Configuration ==
+
== Configuration == <!--T:4-->
 +
 
 +
<!--T:5-->
 
The panel can then be configured by clicking on the toolbox located on the right for horizontal or bottom for vertical panel. At that point, the panel will be in configuration mode. Panel configuration may also be accessed via the context (right click) menu in the panel.
 
The panel can then be configured by clicking on the toolbox located on the right for horizontal or bottom for vertical panel. At that point, the panel will be in configuration mode. Panel configuration may also be accessed via the context (right click) menu in the panel.
  
<!--T:15-->
+
<!--T:6-->
[[Image:Panel_Settings_resize.png|thumb|512px|center|The arrows on the edge of panel allow the panel's size to be adjusted. Dragging the arrow makes the panel smaller or larger. Dragging the arrow pointing down, moves the panel's position.]]
+
[[Image:Panel_Settings_resize.png|thumb|512px|center|The arrows on the edge of the settings menu allow the menu size to be adjusted. Arrows pointing left change the minimum panel size. Arrows pointing right change the maximum panel size. The arrow pointing up is the center of the panel.]]
  
Widgets in panel can be sorted by dragging when in configuration mode. Widget align left in horizontal and top in vertical panel
+
<!--T:7-->
 +
Widgets in the panel can be sorted by dragging them when in configuration mode. Widgets align left in the horizontal and top in the vertical panel
 +
 
 +
</translate><span id="The Panel Toolbox"></span><translate>
  
===== Settings =====
+
=== The Panel Toolbox === <!--T:8-->
  
 
<!--T:14-->
 
<!--T:14-->
*'''Screen Edge:''' Allows you to drag the panel to any of the four edges of the screen.
+
*<menuchoice>Lock Widgets</menuchoice>: Locks the panel and widgets in position. Also hides the toolbox.
 +
 
 +
<!--T:19-->
 +
*<menuchoice>Remove this panel</menuchoice>: Removes the current panel and all widgets in it.
 +
 
 +
<!--T:9-->
 +
*<menuchoice>Screen Edge</menuchoice>: Allows you to drag the panel to any of the four edges of the screen.
 +
 
 +
<!--T:10-->
 +
*<menuchoice>Height</menuchoice> (for horizontal panel): Allows the panel height to be adjusted.
 +
 
 +
<!--T:11-->
 +
*<menuchoice>Width</menuchoice> (for vertical panel): Allows the panel width to be adjusted.
 +
 
 +
<!--T:12-->
 +
*<menuchoice>Add Widgets</menuchoice>: Allows widgets to be added to the panel.
 +
 
 
<!--T:13-->
 
<!--T:13-->
*'''Height (for horizontal panel):''' Allows the panel height to be adjusted.
+
*<menuchoice>Add Spacer</menuchoice>: Allows you to add a spacer into the panel giving space between the items in it.
<!--T:13-->
+
**The standard behavior of a spacer is that it uses as much space as possible (flexible size), but you can also set it to a <menuchoice>fixed size:</menuchoice>. Enter the context (right click) menu and deactivate <menuchoice>Set Flexible Size</menuchoice>.
*'''Width (for vertical panel):''' Allows the panel width to be adjusted.
+
 
<!--T:12-->
+
=== The "More Settings" Menu === <!--T:15-->
*'''Add Widgets:''' Allows widgets to be added to the panel.
+
 
<!--T:11-->
+
<!--T:16-->
*'''Add Spacer:''' Allows you to add a spacer into the panel giving space between the items in it.
+
*<menuchoice>Panel Alignment</menuchoice>: Allows the alignment of the panel to be set in three pre-set positions.
**The standard behavior of a spacer is that it uses as much as possible space (flexible size), but you can also set it to a '''fixed size:''' Right click and deactivate "Set Flexible Size".
+
**<menuchoice>Left/Top</menuchoice>
<!--T:10-->
+
**<menuchoice>Center</menuchoice>
*'''Lock Widgets:''' Locks the panel and widgets in position. Also hides the toolbox.
+
**<menuchoice>Right/Bottom</menuchoice>
 +
 
 +
<!--T:17-->
 +
*<menuchoice>Visibility</menuchoice>
 +
**<menuchoice>Always Visible</menuchoice>: Keeps the panel visible at all times, even when windows are maximised.
 +
**<menuchoice>Auto Hide</menuchoice>: Hides the panel off screen until the mouse is placed near the screen edge.
 +
**<menuchoice>Windows can cover</menuchoice>: This allows windows to cover the panel and if maximised, will cover the panel.
 +
**<menuchoice>Windows go below</menuchoice>: This allows windows to go below the panel, even when maximised.
 +
 
 +
<!--T:18-->
 +
*<menuchoice>Maximize Panel</menuchoice>: Makes the panel fit to the screen edges, if it has been resized.
 +
 
 +
=== Under the Hood === <!--T:29-->
 +
 
 +
<!--T:30-->
 +
Should anything "untoward" happen to your panel have a look at <tt>~/.config/plasma-org.kde.plasma.desktop-appletsrc</tt> - the panel itself is classed as a containment (there are at least two, the desktop and the panel) which is home to all the different widgets you put there.
 +
 
 +
<!--T:31-->
 +
{{Remember|2=Info needed|1=Here the relevant section of <tt>plasma-desktop-appletsrc</tt> for a default panel containment should go. Please help us provide the info if you know anything about this.}}
  
====== More settings -submenu ======
+
== Multiple Panels == <!--T:20-->
  
<!--T:3-->
+
<!--T:21-->
*'''Panel Alignment:''' Allows the alignment of the panel to be set in three pre-set positions.
+
It is also possible to have more than one panel on your desktop. This proves useful if you want to have a more flexible layout:
**Top
+
[[Image:Multipanel.png|thumb|768px|center|Screenshot showing a desktop with multiple panels: a vertical panel with an application launcher, shortcuts and a system tray and a second panel placed horizontally at the top of the screen with a task manager and a clock.]]
**Center
 
**Bottom
 
<!--T:4-->
 
*Visibility
 
**'''Always Visible:''' Keeps the panel visible at all times, even when windows are maximised.
 
<!--T:5-->
 
**'''Auto Hide:''' Hides the panel off screen until the mouse is placed near the screen edge.
 
<!--T:6-->
 
**'''Windows can cover:''' This allows windows to cover the panel and if maximised, will cover the panel.
 
<!--T:7-->
 
**'''Windows go below:''' This allows windows to go below the panel, even when maximised.
 
<!--T:8-->
 
*'''Maximize Panel:''' Makes the panel fit to the screen edges, if it has been resized.
 
<!--T:9-->
 
*'''Remove this panel:''' Removes the current panel and all widgets in it.
 
  
 +
===== Adding a Panel ===== <!--T:22-->
  
<!--T:20-->
+
<!--T:23-->
 +
To add a new panel either click on the desktop toolbox button and select <menuchoice>Add Panel</menuchoice> or open the context (right click) menu on the desktop and select <menuchoice>Add Panel</menuchoice> from the menu.
  
== Multiple Panels ==
+
<!--T:24-->
 +
If more than one kind of Panel is installed, you will be able to select between them to choose what sort of Panel you would prefer. By default, two Panel types are available: <menuchoice>Default Panel</menuchoice>, which creates a Panel containing all of the default widgets (launcher, pager, tasks, system tray, clock, etc.), and <menuchoice>Blank Panel</menuchoice>, which adds an empty Panel without any pre-configured widgets in it.
  
It is also possible to have more than one panel on your Desktop. This proofs useful if you want to have a more flexible layout:
+
== Locking == <!--T:25-->
e.g. one vertical panel for the Application Luncher, shortcuts and the System Tray and a horizontal panel for the Task Manager and the clock.
 
  
=== Add a Panel ===
+
<!--T:26-->
To add a panel right click on the Desktop and select "Add Panel".
+
The panels and desktop may be locked to prevent changes being made to them. When locked, the toolbox buttons will not be shown on either the desktop or on the panels. To configure a panel, it must be unlocked, otherwise the toolbox and context menu entries to configure or add widgets are unavailable.  
  
== Locking ==
+
<!--T:27-->
The panels and desktop may be locked to prevent changes being made to them. When locked, the toolbox buttons will not be shown on either the desktop or on panels. To configure a panel, it must be unlocked, otherwise the toolbox and context menu entries to configure or add widgets are unavailable.  
+
Locking can be done by either selecting the <menuchoice>Lock Widgets</menuchoice> entry in the Panel toolbox or in the Panel context (right click) menu. Once locked, the Panels can be unlocked again by right clicking on either a panel or desktop and selecting <menuchoice>Unlock Widgets</menuchoice> from the menu that is displayed.
  
Locking can be done by either selecting the "Lock Widgets" entry in the Panel toolbox's "More Settings" menu or in the Panel context (right click) menu. Once locked, the Panels can be unlocked again by right clicking on either a panel or desktop and selecting "Unlock Widgets" from the menu that is displayed.
+
<!--T:28-->
 +
[[Category:Desktop]]
 +
[[Category:Plasma]]
 +
</translate>

Latest revision as of 14:11, 12 June 2019

Other languages:
Deutsch • ‎English • ‎Türkçe • ‎català • ‎dansk • ‎français • ‎italiano • ‎polski • ‎русский • ‎українська

Panels in Plasma Desktop

Panel in configuration mode with More settings-submenu open.

A Panel is a widget container which can be located on any side of the desktop. There can be multiple panels on the same side. The default layout is one panel that stretches across the entire bottom of the desktop with the following widgets: application menu, desktop pager, task manager (list of open windows), system tray (including things like a device notifier) and clock. If you are using a laptop, netbook or other computer that uses a battery there will also be a power management widget in the system tray. At the end of the panel is a toolbox button which can be activated to access configuration options.

Configuration

The panel can then be configured by clicking on the toolbox located on the right for horizontal or bottom for vertical panel. At that point, the panel will be in configuration mode. Panel configuration may also be accessed via the context (right click) menu in the panel.

The arrows on the edge of the settings menu allow the menu size to be adjusted. Arrows pointing left change the minimum panel size. Arrows pointing right change the maximum panel size. The arrow pointing up is the center of the panel.

Widgets in the panel can be sorted by dragging them when in configuration mode. Widgets align left in the horizontal and top in the vertical panel

The Panel Toolbox

  • Lock Widgets: Locks the panel and widgets in position. Also hides the toolbox.
  • Remove this panel: Removes the current panel and all widgets in it.
  • Screen Edge: Allows you to drag the panel to any of the four edges of the screen.
  • Height (for horizontal panel): Allows the panel height to be adjusted.
  • Width (for vertical panel): Allows the panel width to be adjusted.
  • Add Widgets: Allows widgets to be added to the panel.
  • Add Spacer: Allows you to add a spacer into the panel giving space between the items in it.
    • The standard behavior of a spacer is that it uses as much space as possible (flexible size), but you can also set it to a fixed size:. Enter the context (right click) menu and deactivate Set Flexible Size.

The "More Settings" Menu

  • Panel Alignment: Allows the alignment of the panel to be set in three pre-set positions.
    • Left/Top
    • Center
    • Right/Bottom
  • Visibility
    • Always Visible: Keeps the panel visible at all times, even when windows are maximised.
    • Auto Hide: Hides the panel off screen until the mouse is placed near the screen edge.
    • Windows can cover: This allows windows to cover the panel and if maximised, will cover the panel.
    • Windows go below: This allows windows to go below the panel, even when maximised.
  • Maximize Panel: Makes the panel fit to the screen edges, if it has been resized.

Under the Hood

Should anything "untoward" happen to your panel have a look at ~/.config/plasma-org.kde.plasma.desktop-appletsrc - the panel itself is classed as a containment (there are at least two, the desktop and the panel) which is home to all the different widgets you put there.

Flag-red.png
Info needed
Here the relevant section of plasma-desktop-appletsrc for a default panel containment should go. Please help us provide the info if you know anything about this.


Multiple Panels

It is also possible to have more than one panel on your desktop. This proves useful if you want to have a more flexible layout:

Screenshot showing a desktop with multiple panels: a vertical panel with an application launcher, shortcuts and a system tray and a second panel placed horizontally at the top of the screen with a task manager and a clock.
Adding a Panel

To add a new panel either click on the desktop toolbox button and select Add Panel or open the context (right click) menu on the desktop and select Add Panel from the menu.

If more than one kind of Panel is installed, you will be able to select between them to choose what sort of Panel you would prefer. By default, two Panel types are available: Default Panel, which creates a Panel containing all of the default widgets (launcher, pager, tasks, system tray, clock, etc.), and Blank Panel, which adds an empty Panel without any pre-configured widgets in it.

Locking

The panels and desktop may be locked to prevent changes being made to them. When locked, the toolbox buttons will not be shown on either the desktop or on the panels. To configure a panel, it must be unlocked, otherwise the toolbox and context menu entries to configure or add widgets are unavailable.

Locking can be done by either selecting the Lock Widgets entry in the Panel toolbox or in the Panel context (right click) menu. Once locked, the Panels can be unlocked again by right clicking on either a panel or desktop and selecting Unlock Widgets from the menu that is displayed.


This page was last edited on 12 June 2019, at 14:11. Content is available under Creative Commons License SA 4.0 unless otherwise noted.