نام (NAME)

waybar - ماژول پنجره برای مدیر پنجره sway

شرح (DESCRIPTION)

ماژول window عنوان پنجره دارای فوکوس فعلی را در Sway نمایش می‌دهد.

پیکربندی (CONFIGURATION)

با شناسه sway/window آدرس‌دهی می‌شود.

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

rotate:
نوع: عدد صحیح (integer)
مقدار مثبت برای چرخاندن برچسب متنی (با گام‌های ۹۰ درجه).

max-length:
نوع: عدد صحیح (integer)
حداکثر طول به کاراکتر که ماژول باید نمایش دهد.

min-length:
نوع: عدد صحیح (integer)
حداقل طول به کاراکتر که ماژول باید بپذیرد.

align:
نوع: ممیز شناور (float)
تراز برچسب در داخل ماژول، که در آن 0 تراز چپ و 1 تراز راست است. اگر ماژول چرخانده شود، از جهت جریان متن پیروی خواهد کرد.

justify:
نوع: رشته (string)
تراز متن درون برچسب ماژول، با گزینه‌های 'left'، 'right' یا 'center' برای تعیین موقعیت.

on-click:
نوع: رشته (string)
دستوری که هنگام کلیک کردن روی ماژول اجرا می‌شود.

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

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

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

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

on-scroll-down:
نوع: رشته (string)
دستوری که هنگام اسکرول به پایین روی ماژول اجرا می‌شود.

smooth-scrolling-threshold:
نوع: ممیز شناور دقیق (double)
آستانه مورد استفاده هنگام اسکرول روان.

tooltip:
نوع: بولی (bool)
پیش‌فرض: true
گزینه‌ای برای غیرفعال کردن پیش‌نمایش متنی (tooltip) هنگام رفتن ماوس روی ماژول.

all-outputs:
نوع: بولی (bool)
پیش‌فرض: false
گزینه‌ای برای نمایش پنجره دارای فوکوس به همراه استایل‌های فضای کاری آن روی تمام خروجی‌ها (نمایشگرها).

offscreen-css:
نوع: بولی (bool)
پیش‌فرض: false
تنها زمانی که all-outputs برابر true باشد فعال است. به جای نمایش پنجره و استایل فوکوس‌شده، بر اساس پنجره‌های موجود در خروجی‌های بدون فوکوس استایل اضافه می‌کند.

offscreen-css-text:
نوع: رشته (string)
تنها زمانی فعال است که هر دو گزینه all-outputs و offscreen-style برابر true باشند. روی صفحه‌هایی که در حال حاضر فوکوس ندارند، متن داده شده را همراه با استایل‌های آن فضای کاری نمایش می‌دهد.

show-focused-workspace-name:
نوع: بولی (bool)
پیش‌فرض: false
اگر خود فضای کاری فوکوس داشته باشد و فضای کاری شامل گره‌ها یا floating_nodes باشد، نام فضای کاری را نمایش می‌دهد. در صورت عدم تنظیم، متن خالی می‌ماند اما استایل‌های مربوط به گره‌های فضای کاری همچنان اعمال می‌شوند.

show-hidden-marks:
نوع: بولی (bool)
پیش‌فرض: false
برای جایگزین قالب {marks}، نشانه‌های مخفی که با زیرخط (_) شروع می‌شوند را نیز شامل می‌شود.

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

icon:
نوع: بولی (bool)
پیش‌فرض: false
گزینه‌ای برای پنهان کردن آیکون برنامه.

icon-size:
نوع: عدد صحیح (integer)
پیش‌فرض: 24
گزینه‌ای برای تغییر اندازه آیکون برنامه.

expand:
نوع: بولی (bool)
پیش‌فرض: false
به این ماژول امکان می‌دهد تا تمام فضای باقی‌مانده را به‌طور پویا مصرف کند.

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

{title}: عنوان پنجره دارای فوکوس.

{app_id}: شناسه برنامه (app_id) پنجره دارای فوکوس.

{shell}: پوسته پنجره دارای فوکوس. وقتی پنجره از طریق xwayland اجرا می‌شود مقدار آن 'xwayland' است، در غیر این صورت 'xdg-shell' است.

{marks}: نشانه‌های (علامت‌های) پنجره.

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

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

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

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

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

مثال‌ها (EXAMPLES)

"sway/window": {
	"format": "{}",
	"max-length": 50,
	"rewrite": {
		"(.*) - Mozilla Firefox": "🌎 $1",
		"(.*) - zsh": "> [$1]"
	}
}

استایل (STYLE)

•

#window

کلاس‌های زیر به کل Waybar اعمال می‌شوند، نه فقط به ویجت پنجره:

• window#waybar.empty هنگامی که هیچ پنجره‌ای در فضای کاری نیست، یا صفحه فوکوس ندارد و گزینه offscreen-css تنظیم نشده است
• window#waybar.solo هنگامی که یک پنجره کاشی‌بندی‌شده (tiled) در فضای کاری است
• window#waybar.floating هنگامی که فقط پنجره‌های شناور در فضای کاری وجود دارند
• window#waybar.stacked هنگامی که بیش از یک پنجره در فضای کاری است و چیدمان فضای کاری stacked (پشته‌ای) است
• window#waybar.tabbed هنگامی که بیش از یک پنجره در فضای کاری است و چیدمان فضای کاری tabbed (تب‌دار) است
• window#waybar.tiled هنگامی که بیش از یک پنجره در فضای کاری است و چیدمان فضای کاری splith یا splitv است
• window#waybar.<app_id> که در آن app_id شناسه برنامه یا نام نمایه (instance مانند chromium) تنها پنجره موجود در فضای کاری است