نام (NAME)

waybar - ماژول نوار وظیفه wlr (wlr taskbar module)

توضیحات (DESCRIPTION)

ماژول taskbar برنامه‌های در حال حاضر باز را نمایش می‌دهد. این ماژول نیازمند یک کامپوزیتور است که رابط foreign-toplevel-manager را پیاده‌سازی کرده باشد.

پیکربندی (CONFIGURATION)

با نام wlr/taskbar آدرس‌دهی می‌شود

all-outputs:
نوع: bool
پیش‌فرض: false
اگر روی false تنظیم شود، برنامه‌های موجود در خروجی فعلی waybar نمایش داده می‌شوند. در غیر این صورت، همه برنامه‌ها نشان داده خواهند شد.

format:
نوع: string
پیش‌فرض: {icon}
قالب نحوه نمایش اطلاعات.

icon-theme:
نوع: array|string
نام‌های تم‌های آیکون که باید برای یافتن یک آیکون استفاده شوند. فهرست از چپ به راست پیمایش خواهد شد. در صورت تعیین نشدن، پیش‌فرض سیستم استفاده خواهد شد.

icon-size:
نوع: integer
پیش‌فرض: 16
اندازه آیکون.

markup:
نوع: bool
پیش‌فرض: false
اگر روی true تنظیم شود، نشانه‌گذاری پانگو (pango markup) در format و tooltip-format پذیرفته می‌شود.

tooltip:
نوع: bool
پیش‌فرض: true
اگر روی false تنظیم شود، هیچ تول‌تیپی نمایش داده نخواهد شد.

tooltip-format:
نوع: string
پیش‌فرض: {title}
قالب نحوه نمایش اطلاعات در تول‌تیپ.

active-first:
نوع: bool
پیش‌فرض: false
اگر روی true تنظیم شود، همیشه وظایف در نوار وظیفه به‌گونه‌ای مرتب می‌شوند که برنامه فعال فعلی اول باشد. در غیر این صورت مرتب‌سازی مجدد انجام نمی‌شود.

sort-by-app-id:
نوع: bool
پیش‌فرض: false
اگر روی true تنظیم شود، وظایف بر اساس app_id خود گروه‌بندی می‌شوند. نمی‌تواند همراه با 'active-first' استفاده شود.

on-click:
نوع: string
عملیاتی که باید هنگام کلیک با کلید چپ ماوس روی دکمه برنامه اجرا شود.

on-click-middle:
نوع: string
عملیاتی که باید هنگام کلیک با کلید میانی ماوس روی دکمه برنامه اجرا شود.

on-click-right:
نوع: string
عملیاتی که باید هنگام کلیک با کلید راست ماوس روی دکمه برنامه اجرا شود.

on-update:
نوع: string
دستوری که هنگام به‌روزرسانی ماژول اجرا می‌شود.

ignore-list:
نوع: array
فهرستی از app_idها/عنوان‌ها که باید پنهان باشند.

app_ids-mapping:
نوع: object
دیکشنری از app_id برای جایگزینی.

rewrite:
نوع: object
قوانین بازنویسی قالب خروجی ماژول. بخش قوانین بازنویسی (REWRITE RULES) را ببینید.

جایگزین‌های قالب (FORMAT REPLACEMENTS)

{icon}: آیکون برنامه.

{name}: نام برنامه مطابق با فایل desktop در صورتی که فایل desktop مناسب یافت شود، در غیر این صورت مشابه {app_id} است.

{title}: عنوان برنامه.

{app_id}: شناسه برنامه (app_id == نام برنامه).

{state}: وضعیت برنامه (minimized، maximized، active، fullscreen).

{short_state}: وضعیت برنامه (minimize == m، maximized == M، active == A، fullscreen == F) که به‌صورت یک کاراکتر نمایش داده می‌شود.

عملیات‌های کلیک (CLICK ACTIONS)

activate: آوردن برنامه به پیش‌زمینه.

minimize: تغییر وضعیت کمینه‌سازی برنامه.

minimize-raise: آوردن برنامه به پیش‌زمینه یا تغییر وضعیت کمینه‌سازی آن.

maximize: تغییر وضعیت بیشینه‌سازی برنامه.

fullscreen: تغییر وضعیت تمام‌صفحه برنامه.

close: بستن برنامه.

قوانین بازنویسی (REWRITE RULES)

گزینه rewrite یک شیء است که در آن کلیدها عبارت‌های منظم (regex) و مقادیر قوانین بازنویسی در صورت تطابق عبارت هستند. قوانین می‌توانند شامل ارجاع به بخش‌های منطبق‌شده (captures) عبارت باشند.

عبارات منظم و جایگزینی از قوانین ECMA-script پیروی می‌کنند.

اگر هیچ عبارتی مطابقت نداشته باشد، قالب خروجی بدون تغییر باقی می‌ماند.

عبارت‌های نامعتبر (مانند پرانتزهای جفت‌نشده) نادیده گرفته می‌شوند.

مثال‌ها (EXAMPLES)

"wlr/taskbar": {
	"format": "{icon}",
	"icon-size": 14,
	"icon-theme": "Numix-Circle",
	"tooltip-format": "{title}",
	"on-click": "activate",
	"on-click-middle": "close",
	"ignore-list": [
	    "Alacritty"
	],
	"app_ids-mapping": {
		"firefoxdeveloperedition": "firefox-developer-edition"
	},
	"rewrite": {
		"Firefox Web Browser": "Firefox",
		"Foot Server": "Terminal"
	}
}

استایل (STYLE)

#taskbar
#taskbar button
#taskbar button.maximized
#taskbar button.minimized
#taskbar button.active
#taskbar button.fullscreen