Quickshell


IconImage: Item

import Quickshell.Widgets

This is a specialization of Image configured for icon-style images, designed to make it easier to use correctly. If you need more control, use Image directly.

The image’s aspect raito is assumed to be 1:1. If it is not 1:1, padding will be added to make it 1:1. This is currently applied before the actual aspect ratio of the image is taken into account, and may change in a future release.

You should use it for:

  • Icons for custom buttons
  • Status indicator icons
  • System tray icons
  • Things similar to the above.

Do not use it for:

  • Big images
  • Images that change size frequently
  • Anything that doesn’t feel like an icon.

NOTE

More information about many of these properties can be found in the documentation for Image.