Differences

This shows you the differences between two versions of the page.

--- panel-plugins:xfce4-docklike-plugin:start [2021/09/15 21:49] – add screenshots davekeogh
+++ panel-plugins:xfce4-docklike-plugin:start [2024/12/09 09:45] (current) – kevinbowen
@@ Line 3: / Line 3: @@
 ====== xfce4-docklike-plugin - Docklike Taskbar ======
-A modern, minimalist taskbar for Xfce
+A modern, minimalist taskbar for Xfce.
-  * **[[#Usage|Usage]]**
+Docklike Taskbar behaves similarly to many other desktop environments and operating systems. Wherein all application windows are grouped together as an icon and can be pinned to act as a launcher when the application is not running. Commonly referred to as a dock.
   * **[[#Screenshots|Screenshots]]**
+  * **[[#Usage|Usage]]**
+  * **[[#Theming|Theming]]**
   * **[[#Latest Release|Latest Release]]**
   * **[[#Source Code Repository|Source Code Repository]]**
@@ Line 13: / Line 16: @@
 ----
-===== Usage =====
-...
-----
 ===== Screenshots =====
-<figure "Properties Dialog">
+<figure "Docklike Properties Dialog">
-{{:panel-plugins:xfce4-docklike-plugin/xfce4-docklike-plugin-properties.png|Properties Dialog}}
+{{:panel-plugins:xfce4-docklike-plugin/xfce4-docklike-plugin-properties.png|Docklike Properties Dialog}}
 </figure>
-<figure "Window List">
+<figure "Docklike Window List">
-{{:panel-plugins:xfce4-docklike-plugin/xfce4-docklike-plugin-switch.png|Window List}}
+{{:panel-plugins:xfce4-docklike-plugin/xfce4-docklike-plugin-switch.png|Docklike Window List}}
 </figure>
-<figure "Alternate Indicator Styles">
+<figure "Docklike Window Preview">
-{{:panel-plugins:xfce4-docklike-plugin/xfce4-docklike-plugin-dashes.png|Alternate Indicator Styles}}
+{{:panel-plugins:xfce4-docklike-plugin/xfce4-docklike-plugin-previews.png|Docklike Window Preview}}
 </figure>
-<figure "Window Previews">
+<figure "Docklike Alternate Indicator Styles: Dashes">
-{{:panel-plugins:xfce4-docklike-plugin/xfce4-docklike-plugin-previews.png|Window Previews}}
+{{:panel-plugins:xfce4-docklike-plugin/xfce4-docklike-plugin-dashes.png|Docklike Alternate Indicator Styles: Dashes}}
+</figure>
+<figure "Docklike Alternate Indicator Styles: Dots">
+{{:panel-plugins:xfce4-docklike-plugin/xfce4-docklike-plugin-dots.png|Docklike Alternate Indicator Styles: Dots}}
 </figure>
 [[|Back to Top]]
+----
+===== Usage =====
+  - [[:xfce:xfce4-panel:add-new-items|Add the plugin to the panel]].
+  - Right-click on the added plugin, select **Properties** to open the settings window.
+**Mouse Actions**
+  * **ctrl+left-click** to begin dragging an item in the dock
+  * **ctrl+right-click** to access Properties, move/remove the plugin
+  * **shift+click** to launch another instance of an application
+  * **middle-click** to close all instances of an application
+  * **mouse wheel** to cycle through open windows in either direction
+**Keyboard Shortcuts**
+Keyboard shortcuts are disabled by default. Be careful to avoid conflicting keyboard shortcuts!
+  * **super+[1,2,...]** to switch between applications based on dock position
+  * **super** to switch to the previous window
+It would be nice to add a setting to change the modifier key in the future.
+**Hidden Settings**
+Your settings file is located at //~/.config/xfce4/panel/docklike-1.rc// (or something like that). The file is only created after changing anything in the xfce4-docklike-plugin Properties window.
+  * **dockSize=<int>** sets the minimum width/height (depending on panel orientation) of the dock widget (unset by default)
+  * **previewScale=<double>** adjusts the scale factor of preview images (the default value is 0.125)
+  * **previewSleep=<int>** adjusts the time, in milliseconds, between new preview images being generated (the default is 250)
+[[|Back to Top]]
+----
+===== Theming =====
+You can modify the appearance of dock items with CSS. Create (or modify) //~/.config/gtk-3.0/gtk.css// and add any of the following:
+    /* Taller or wider buttons */
+    #docklike-plugin button {
+      min-height: 48px;
+      min-width: 48px;
+    }
+    /* Brightly colored buttons */
+    #docklike-plugin .open_group { background-color: lightblue; }
+    #docklike-plugin .active_group { background-color: hotpink; }
+    #docklike-plugin .hover_group { background-color: orange; }
+    /* number of open windows label */
+    #docklike-plugin .window_count { color: red; }
+    #docklike-plugin .open_group .window_count { color: white; }
+    #docklike-plugin .active_group .window_count { color : hotpink; }
+A list of all the CSS selectors created by the plugin:
+    #docklike-plugin
+      .group
+      .open_group
+      .active_group
+      .window_count
+      .menu
+      .active_menu_item
+      .hover_menu_item
+Changes will take effect after the panel is restarted (//xfce4-panel -r//).
 ----
@@ Line 43: / Line 112: @@
 ===== Latest Release =====
-{{rss>https://archive.xfce.org/feeds/project/xfce4-docklike-plugin 1 date description 2h}}
+{{rss>https://archive.xfce.org/feeds/project/xfce4-docklike-plugin 1 date 2h}}
-  * **[[https://archive.xfce.org/src/panel-plugins/xfce4-docklike-plugin/|Previous Releases]]**
+[[https://gitlab.xfce.org/panel-plugins/xfce4-docklike-plugin/-/blob/master/NEWS|Read the CHANGELOG]]
+  * **[[https://archive.xfce.org/src/panel-plugins/xfce4-docklike-plugin/|Download current release]]** (older versions of this component are also available here)
 [[|Back to Top]]
@@ Line 52: / Line 123: @@
 ===== Source Code Repository =====
 [[https://gitlab.xfce.org/panel-plugins/xfce4-docklike-plugin/]]
@@ Line 57: / Line 129: @@
 ===== Reporting Bugs =====
-[[https://gitlab.xfce.org/panel-plugins/xfce4-docklike-plugin/-/issues]] -- Open bug reports and how to report new bugs
+  * **[[:panel-plugins:xfce4-docklike-plugin:bugs|Reporting Bugs]]** -- List of currently open bugs and instructions on how to submit new bug reports
 [[|Back To Top]]
 ----
+[[ :xfce:xfce4-panel:start:|Return to xfce4-panel Main Documentation Page]]
-[[ :xfce:xfce4-panel:start:|Return to Main Xfce4-panel page]]

Xfce Wiki

Sub domains

Differences

Xfce Wiki

Sub domains

Differences

Tools