.\" 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\-sway\-window" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
waybar \- ماژول پنجره برای مدیر پنجره sway
.PP
.SH "شرح (DESCRIPTION)"
.PP
ماژول
\fBwindow\fR
عنوان پنجره دارای فوکوس فعلی را در Sway نمایش می‌دهد.
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
با شناسه
\fBsway/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
\fBall\-outputs\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
گزینه‌ای برای نمایش پنجره دارای فوکوس به همراه استایل‌های فضای کاری آن روی تمام خروجی‌ها (نمایشگرها).\&
.PP
\fBoffscreen\-css\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
تنها زمانی که all\-outputs برابر true باشد فعال است.\& به جای نمایش پنجره و استایل فوکوس‌شده، بر اساس پنجره‌های موجود در خروجی‌های بدون فوکوس استایل اضافه می‌کند.\&
.PP
\fBoffscreen\-css\-text\fR:
.br
نوع: رشته (string)
.br
تنها زمانی فعال است که هر دو گزینه all\-outputs و offscreen\-style برابر true باشند.\& روی صفحه‌هایی که در حال حاضر فوکوس ندارند، متن داده شده را همراه با استایل‌های آن فضای کاری نمایش می‌دهد.\&
.PP
\fBshow\-focused\-workspace\-name\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
اگر خود فضای کاری فوکوس داشته باشد و فضای کاری شامل گره‌ها یا floating_nodes باشد، نام فضای کاری را نمایش می‌دهد.\& در صورت عدم تنظیم، متن خالی می‌ماند اما استایل‌های مربوط به گره‌های فضای کاری همچنان اعمال می‌شوند.\&
.PP
\fBshow\-hidden\-marks\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
برای جایگزین قالب \fB{marks}\fR، نشانه‌های مخفی که با زیرخط (_) شروع می‌شوند را نیز شامل می‌شود.\&
.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{shell}\fR: پوسته پنجره دارای فوکوس.\& وقتی پنجره از طریق xwayland اجرا می‌شود مقدار آن '\&xwayland'\& است، در غیر این صورت '\&xdg\-shell'\& است.\&
.PP
\fB{marks}\fR: نشانه‌های (علامت‌های) پنجره.\&
.PP
.SH "قوانین بازنویسی (REWRITE RULES)"
.PP
گزینه \fBrewrite\fR یک شیء است که کلیدهای آن عبارت‌های منظم (regex) و مقادیر آن قوانین بازنویسی در صورت تطابق عبارت هستند.\& قوانین می‌توانند شامل ارجاع به گروه‌های گیراندازی‌شده (captures) عبارت منظم باشند.\&
.PP
عبارات منظم و جایگزینی از قوانین ECMA-script پیروی می‌کنند.\&
.PP
اگر هیچ عبارتی مطابقت نداشته باشد، قالب خروجی بدون تغییر باقی می‌ماند.\&
.PP
عبارت‌های نامعتبر (مانند پرانتزهای باز مانده) نادیده گرفته می‌شوند.\&
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
"sway/window": {
	"format": "{}",
	"max\-length": 50,
	"rewrite": {
		"(\&.*) \- Mozilla Firefox": "🌎 $1",
		"(\&.*) \- zsh": "> [$1]"
	}
}
.fi
.RE
.PP
.SH "استایل (STYLE)"
.PP
.PD 0
.IP \(bu 4
\fB#window\fR
.PD
.PP
کلاس‌های زیر به کل Waybar اعمال می‌شوند، نه فقط به ویجت پنجره:
.PP
.PD 0
.IP \(bu 4
\fBwindow#waybar.\&empty\fR هنگامی که هیچ پنجره‌ای در فضای کاری نیست، یا صفحه فوکوس ندارد و گزینه offscreen\-css تنظیم نشده است
.IP \(bu 4
\fBwindow#waybar.\&solo\fR هنگامی که یک پنجره کاشی‌بندی‌شده (tiled) در فضای کاری است
.IP \(bu 4
\fBwindow#waybar.\&floating\fR هنگامی که فقط پنجره‌های شناور در فضای کاری وجود دارند
.IP \(bu 4
\fBwindow#waybar.\&stacked\fR هنگامی که بیش از یک پنجره در فضای کاری است و چیدمان فضای کاری stacked (پشته‌ای) است
.IP \(bu 4
\fBwindow#waybar.\&tabbed\fR هنگامی که بیش از یک پنجره در فضای کاری است و چیدمان فضای کاری tabbed (تب‌دار) است
.IP \(bu 4
\fBwindow#waybar.\&tiled\fR هنگامی که بیش از یک پنجره در فضای کاری است و چیدمان فضای کاری splith یا splitv است
.IP \(bu 4
\fBwindow#waybar.\&<app_id>\fR که در آن \fBapp_id\fR شناسه برنامه یا نام نمایه (\fBinstance\fR مانند \fBchromium\fR) تنها پنجره موجود در فضای کاری است