نام (NAME)

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

شرح (DESCRIPTION)

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

پیکربندی (CONFIGURATION)

با شناسه dwl/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) هنگام رفتن ماوس روی ماژول.

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

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

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

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

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

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

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

{layout}: چیدمان پنجره دارای فوکوس.

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

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

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

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

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

مثال‌ها (EXAMPLES)

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