(Widget) Recycle Bin

Recycle Bin Widget

Recycle Bin widget is simple widget that shows the status of the recycle bin. It displays the number of items in the recycle bin and the total size of the items. The widget can be customized to show different icons and colors based on the status of the recycle bin.

Option	Type	Default	Description
label	string	{icon} {items_count} {items_size}	Format for displaying recycle bin information. Available variables: {icon}, {items_count}, {items_size}.
label_alt	string	{icon} {items_count} {items_size}	Alternative label format that can be toggled with right-click (or configured callback).
class_name	string	""	Additional CSS class name for the widget.
icons	dict	{"bin_empty": "\udb82\ude7a","bin_filled": "\udb82\ude79"}	Customize icons used for different recycle bin states.
tooltip	boolean	True	Whether to show the tooltip on hover.
animation	dict	{'enabled': True, 'type': 'fadeInOut', 'duration': 200}	Animation settings for the widget.
callbacks	dict	See below	Configure widget interaction callbacks.
container_shadow	dict	None	Container shadow options.
label_shadow	dict	None	Label shadow options.

Example Configuration

  bin:
    type: "yasb.recycle_bin.RecycleBinWidget"
    options:
      label: "<span>{icon}</span> Items {items_count} ({items_size})"
      label_alt: "Items {items_count}, Total size ({items_size})"
      icons:
        bin_empty: "\udb82\ude7a"
        bin_filled: "\udb82\ude79"
      callbacks:
        on_left: "open_bin"
        on_right: "toggle_label"
        on_middle: "empty_bin"
      label_shadow:
        enabled: true
        color: "black"
        radius: 3
        offset: [ 1, 1 ]

Description of Options

• label: Format for displaying recycle bin information. Available variables: {icon}, {items_count}, {items_size}.
• label_alt: Alternative label format that can be toggled with right-click (or configured callback).
• class_name: Additional CSS class name for the widget. This allows for custom styling.
• icons: Customize icons used for different recycle bin states. The default icons are:
  • bin_empty: Icon when the recycle bin is empty.
  • bin_filled: Icon when the recycle bin has items.
• tooltip: Whether to show the tooltip on hover.
• animation: Animation settings including type and duration.
• callbacks: Configure what happens when clicking the widget.
• container_shadow: Container shadow options.
• label_shadow: Label shadow options.

Available Callbacks

• toggle_label: Toggle between main and alternative label format.
• empty_bin: Empty the recycle bin.
• open_bin: Open the recycle bin.

Available Style

.recycle-bin-widget {} /*Style for widget.*/
.recycle-bin-widget.your_class {} /* If you are using class_name option */
.recycle-bin-widget .widget-container {} /*Style for widget container.*/
.recycle-bin-widget .label {} /*Style for label.*/
.recycle-bin-widget .icon {} /*Style for icon.*/
.recycle-bin-widget .label.bin-empty {} /*Style for label when bin is empty.*/
.recycle-bin-widget .label.bin-filled  {} /*Style for label when bin is filled.*/
.recycle-bin-widget .icon.bin-empty  {} /*Style for icon when bin is empty.*/
.recycle-bin-widget .icon.bin-filled  {} /*Style for icon when bin is filled.*/