.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.TH "waybar\-dwl\-window" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
waybar \- ماژول پنجره برای مدیر پنجره dwl
.PP
.SH "شرح (DESCRIPTION)"
.PP
ماژول
\fBwindow\fR
عنوان پنجره دارای فوکوس فعلی را در DWL نمایش می‌دهد.
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
با شناسه
\fBdwl/window\fR
آدرس‌دهی می‌شود.
.PP
\fBformat\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: {title}
.br
قالب نحوه نمایش اطلاعات.\&
.PP
\fBrotate\fR:
.br
نوع: عدد صحیح (integer)
.br
مقدار مثبت برای چرخاندن برچسب متنی (با گام‌های ۹۰ درجه).\&
.PP
\fBmax\-length\fR:
.br
نوع: عدد صحیح (integer)
.br
حداکثر طول به کاراکتر که ماژول باید نمایش دهد.\&
.PP
\fBmin\-length\fR:
.br
نوع: عدد صحیح (integer)
.br
حداقل طول به کاراکتر که ماژول باید بپذیرد.\&
.PP
\fBalign\fR:
.br
نوع: ممیز شناور (float)
.br
تراز برچسب در داخل ماژول، که در آن 0 تراز چپ و 1 تراز راست است.\& اگر ماژول چرخانده شود، از جهت جریان متن پیروی خواهد کرد.\&
.PP
\fBjustify\fR:
.br
نوع: رشته (string)
.br
تراز متن درون برچسب ماژول، با گزینه‌های '\&left'\&، '\&right'\& یا '\&center'\& برای تعیین موقعیت.\&
.PP
\fBon\-click\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام کلیک کردن روی ماژول اجرا می‌شود.\&
.PP
\fBon\-click\-middle\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام کلیک میانی با چرخ ماوس روی ماژول اجرا می‌شود.\&
.PP
\fBon\-click\-right\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام راست‌کلیک روی ماژول اجرا می‌شود.\&
.PP
\fBon\-update\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام به‌روزرسانی ماژول اجرا می‌شود.\&
.PP
\fBon\-scroll\-up\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام اسکرول به بالا روی ماژول اجرا می‌شود.\&
.PP
\fBon\-scroll\-down\fR:
.br
نوع: رشته (string)
.br
دستوری که هنگام اسکرول به پایین روی ماژول اجرا می‌شود.\&
.PP
\fBsmooth\-scrolling\-threshold\fR:
.br
نوع: ممیز شناور دقیق (double)
.br
آستانه مورد استفاده هنگام اسکرول روان.\&
.PP
\fBtooltip\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: true
.br
گزینه‌ای برای غیرفعال کردن پیش‌نمایش متنی (tooltip) هنگام رفتن ماوس روی ماژول.\&
.PP
\fBrewrite\fR:
.br
نوع: شیء (object)
.br
قوانین بازنویسی قالب خروجی ماژول.\& بخش \fBقوانین بازنویسی (REWRITE RULES)\fR را ببینید.\&
.PP
\fBicon\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
گزینه‌ای برای پنهان کردن آیکون برنامه.\&
.PP
\fBicon\-size\fR:
.br
نوع: عدد صحیح (integer)
.br
پیش‌فرض: 24
.br
گزینه‌ای برای تغییر اندازه آیکون برنامه.\&
.PP
\fBexpand\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
به این ماژول امکان می‌دهد تا تمام فضای باقی‌مانده را به‌طور پویا مصرف کند.\&
.PP
.SH "جایگزین‌های قالب (FORMAT REPLACEMENTS)"
.PP
\fB{title}\fR: عنوان پنجره دارای فوکوس.\&
.PP
\fB{app_id}\fR: شناسه برنامه (app_id) پنجره دارای فوکوس.\&
.PP
\fB{layout}\fR: چیدمان پنجره دارای فوکوس.\&
.PP
.SH "قوانین بازنویسی (REWRITE RULES)"
.PP
گزینه \fBrewrite\fR یک شیء است که کلیدهای آن عبارت‌های منظم (regex) و مقادیر آن قوانین بازنویسی در صورت تطابق عبارت هستند.\& قوانین می‌توانند شامل ارجاع به گروه‌های گیراندازی‌شده (captures) عبارت منظم باشند.\&
.PP
عبارات منظم و جایگزینی از قوانین ECMA-script پیروی می‌کنند.\&
.PP
اگر هیچ عبارتی مطابقت نداشته باشد، قالب خروجی بدون تغییر باقی می‌ماند.\&
.PP
عبارت‌های نامعتبر (مانند پرانتزهای بسته نشده) نادیده گرفته می‌شوند.\&
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
"dwl/window": {
	"format": "{}",
	"max\-length": 50,
	"rewrite": {
		"(\&.*) \- Mozilla Firefox": "🌎 $1",
		"(\&.*) \- zsh": "> [$1]"
	}
}
.fi
.RE