waybar-styles(5) File Formats Manual waybar-styles(5)

waybar-styles - استفاده از شیوه‌نامه‌ها برای waybar

برنامه Waybar از شیوه‌نامه‌های آبشاری (CSS) برای پیکربندی ظاهر خود استفاده می‌کند.

این برنامه از اولین فایل یافت‌شده به ترتیب جستجوی زیر استفاده می‌کند:

  • $XDG_CONFIG_HOME/waybar/style.css
  • ~/.config/waybar/style.css
  • ~/waybar/style.css
  • /etc/xdg/waybar/style.css
  • /etc/xdg/waybar/style.css

یک نمونه شیوه‌نامه تحت کنترل کاربر که تنها رنگ ساعت را به سبز روی پس‌زمینه سیاه تغییر می‌دهد، در حالی که بقیه پیکربندی سیستم را دست‌نخورده باقی می‌گذارد:

@import url("file:///etc/xdg/waybar/style.css")
#clock {
  background: #000000;
  color: #00ff00;
}

می‌توانید استایل‌دهی ویژه‌ای را برای هر ماژول هنگام قرار گرفتن نشانگر ماوس روی آن (hover) اعمال کنید.

#clock:hover {
  background-color: #ffffff;
}

اکثر انواع ماژول‌ها (اگر نگوییم همه) از تنظیم گزینه `cursor` پشتیبانی می‌کنند. این مورد در `config.jsonc` شما پیکربندی می‌شود. اگر روی `false` تنظیم شود، هنگام قرار گرفتن نشانگر روی ماژول، نشانگر به سبک "اشاره‌گر" (pointer - همان‌طور که در استایل‌دهی وب CSS با `cursor: pointer` شناخته می‌شود) نمایش داده نخواهد شد. رفتار پیش‌فرض این است که نشان دهد یک رویداد تعاملی در دسترس است.

انواع بیشتری از نشانگر برای انتخاب وجود دارد که با تنظیم گزینه `cursor` روی یک عدد قابل استفاده هستند؛ برای مشاهده تمامی انواع ممکن نشانگر به مستندات رسمی Gdk3 مراجعه کنید: https://docs.gtk.org/gdk3/enum.CursorType.html. با این حال، توجه داشته باشید که ممکن است همه گزینه‌های نشانگر فهرست‌شده در سیستم شما موجود نباشند. اگر سعی کنید از نشانگری استفاده کنید که در دسترس نیست، برنامه از کار خواهد افتاد (crash).

مثال غیرفعال کردن نوع نشانگر اشاره‌گر (`Gdk::Hand2`) روی یک ماژول سفارشی:

"custom/my-custom-module": {
    ...
    "cursor": false,
}

):'>https://docs.gtk.org/gdk3/enum.CursorType.html#boat):

"custom/my-custom-module": {
    ...
    "cursor": 8,
}

•
waybar(5)
2026-08-31