.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "sway-bar" "5" "2026-06-23"
.PP
.SH "نام (NAME)"
.PP
sway-bar \- فایل پیکربندی و دستورهای نوار swaybar
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار Sway امکان پیکربندی swaybar را درون فایل پیکربندی sway فراهم می‌کند.\&
.PP
.SH "دستورها (COMMANDS)"
.PP
دستورهای زیر فقط می‌توانند درون فایل پیکربندی استفاده شوند.\&
.PP
\fBid\fR <bar_id>
.RS 4
شناسه (ID) نوار را تعیین می‌کند.\&
.PP
.RE
\fBswaybar_command\fR <command>
.RS 4
دستور سفارشی نوار را اجرا می‌کند.\& مقدار پیش‌فرض \fIswaybar\fR است.\&
.PP
.RE
دستورهای زیر را می‌توان هم در فایل پیکربندی و هم در زمان اجرا به کار برد.\&
.PP
\fBbindcode\fR [--release] <event-code> <command>
.RS 4
هنگامی که کلید موش‌پاره (ماوس) فشرده شود (یا اگر \fI--release\fR مشخص شده باشد، هنگام رها شدن کلید)، \fIcommand\fR را اجرا می‌کند.\& کلیدها را می‌توان به صورت یک کد رخداد (event code) که از \fBlibinput debug-events\fR به دست می‌آید مشخص کرد.\& برای غیرفعال کردن رفتار پیش‌فرض یک کلید، از دستور \fInop\fR استفاده کنید.\&
.PP
.RE
\fBbindsym\fR [--release] button[1-9]|<event-name> <command>
.RS 4
هنگامی که کلید موش‌پاره فشرده شود (یا در صورت ارائه \fI--release\fR، هنگام رها شدن کلید)، \fIcommand\fR را اجرا می‌کند.\& کلیدها را می‌توان به عنوان شماره کلید x11 یا نام رخداد که از \fBlibinput debug-events\fR به دست می‌آید مشخص کرد.\& برای غیرفعال کردن رفتار پیش‌فرض یک کلید، از دستور \fInop\fR استفاده کنید.\&
.PP
.RE
\fBbinding_mode_indicator\fR yes|no
.RS 4
نشانگر حالت مقیدسازی کلیدها (binding mode indicator) را فعال یا غیرفعال می‌کند.\& پیش‌فرض \fIyes\fR است.\&
.PP
.RE
\fBfont\fR <font>
.RS 4
قلم مورد استفاده در نوار را مشخص می‌کند.\& مقدار \fIfont\fR باید به صورت یک توصیف قلم pango مشخص شود.\& برای اطلاعات بیشتر درباره توصیف‌های قلم pango، به https://docs.\&gtk.\&org/Pango/type_func.\&FontDescription.\&from_string.\&html#description مراجعه کنید.\&
.PP
.RE
\fBgaps\fR <all> | <horizontal> <vertical> | <top> <right> <bottom> <left>
.RS 4
فاصله‌ها (gaps) از لبه صفحه برای نوار را تعیین می‌کند.\& فاصله‌ها را می‌توان به طور یکجا برای همه جهات، به تفکیک افقی/عمودی، یا به تفکیک هر جهت (بالا، راست، پایین، چپ) تنظیم کرد.\& توجه داشته باشید که فقط لبه‌هایی که با لبه صفحه نمایش در تماس هستند می‌توانند فاصله داشته باشند.\& برای لبه‌ای که با لبه صفحه تماسی ندارد، فاصله‌های بیرونی فضاهای کاری ممکن است مفید باشند.\&
.PP
.RE
\fBheight\fR <height>
.RS 4
ارتفاع نوار را تعیین می‌کند.\& ارتفاع پیش‌فرض (0) با اندازه قلم مطابقت خواهد داشت.\&
.PP
.RE
\fBhidden_state\fR hide|show [<bar-id>]
.RS 4
رفتار نوار را هنگام قرار داشتن در حالت \fIhide\fR مشخص می‌کند.\& وقتی وضعیت پنهان روی \fIhide\fR باشد، نوار به طور معمول پنهان است و تنها با فشردن کلید تبدیل‌کننده (modifier) یا در صورت وجود نشانه‌های فوریت (urgency hints) آشکار می‌شود.\& وقتی وضعیت پنهان روی \fIshow\fR باشد، نوار به طور دائم نمایان بوده و روی فضای کاری فعال فعلی ترسیم می‌شود.\& پیش‌فرض \fIhide\fR است.\&
.PP
برای سازگاری با i3، ساختار \fIbar hidden_state hide|show [<bar-id>]\fR به همراه ساختار اختصاصی sway یعنی \fIbar <bar-id> hidden_state hide|show\fR پشتیبانی می‌شود.\& هنگام استفاده از ساختار i3، اگر \fIbar-id\fR حذف شود، hidden_state برای تمام نوارها تغییر خواهد کرد.\& تلاش برای استفاده از \fIbar <bar-id1> hidden_state hide|show <bar-id2>\fR به دلیل تداخل شناسه‌های نوار با خطا مواجه خواهد شد.\&
.PP
.RE
\fBmode\fR dock|hide|invisible|overlay [<bar-id>]
.RS 4
میزان نمایانی نوار را مشخص می‌کند.\& در حالت \fIdock\fR، نوار به طور دائم در یک لبه صفحه نمایان است.\& در حالت \fIhide\fR، نوار پنهان است مگر اینکه کلید تبدیل‌کننده فشرده شود، هرچند این رفتار به وضعیت پنهان (hidden state) بستگی دارد.\& در حالت \fIinvisible\fR، به طور دائم پنهان است.\& در حالت \fIoverlay\fR، به طور دائم روی پنجره‌های دیگر نمایش داده می‌شود (در حالت \fIoverlay\fR نوار نسبت به رخدادهای ورودی شفاف است و آن‌ها را دریافت نمی‌کند).\& مقدار پیش‌فرض \fIdock\fR است.\&
.PP
برای سازگاری با i3، ساختار \fIbar mode <mode> [<bar-id>]\fR به همراه ساختار اختصاصی sway یعنی \fIbar <bar-id> mode <mode>\fR پشتیبانی می‌شود.\& هنگام استفاده از ساختار i3، اگر \fIbar-id\fR حذف شود، حالت برای تمام نوارها تغییر خواهد کرد.\& تلاش برای استفاده از \fIbar <bar-id1> mode <mode> <bar-id2>\fR به دلیل تداخل شناسه‌های نوار منجر به خطا خواهد شد.\&
.PP
.RE
\fBmodifier\fR <Modifier>|none
.RS 4
کلید تبدیل‌کننده‌ای (modifier) را که نوار پنهان را آشکار می‌کند مشخص می‌سازد.\& مقدار پیش‌فرض \fIMod4\fR است.\&
.PP
.RE
\fBoutput\fR <output>|*
.RS 4
نوار را به یک خروجی (نمایشگر) خاص محدود می‌کند؛ می‌توان این دستور را چندین بار تکرار کرد.\& اگر دستور output حذف شود، نوار روی تمام خروجی‌ها نمایش داده می‌شود.\& در هر زمان می‌توان از \fI*\fR برای بازنشانی آن به نمایش در تمام خروجی‌ها استفاده کرد.\&
.PP
.RE
\fBpango_markup\fR enabled|disabled
.RS 4
نشانه‌گذاری pango را برای خطوط وضعیت فعال یا غیرفعال می‌کند.\& این گزینه تاثیری بر خطوط وضعیتی که از پروتکل JSON در i3bar استفاده می‌کنند ندارد.\&
.PP
.RE
\fBposition\fR top|bottom
.RS 4
موقعیت نوار را تعیین می‌کند.\& پیش‌فرض \fIbottom\fR است.\&
.PP
.RE
\fBseparator_symbol\fR <symbol>
.RS 4
نماد جداکننده را برای تفکیک بلوک‌ها روی نوار مشخص می‌کند.\&
.PP
.RE
\fBstatus_command\fR <status command>
.RS 4
دستور وضعیت نوار (\fIstatus command\fR) را با \fIsh -c\fR اجرا می‌کند.\& هر خط متنی که توسط این دستور در خروجی استاندارد (stdout) چاپ شود در ناحیه وضعیت نوار نمایش داده خواهد شد.\& شما همچنین می‌توانید از پروتکل خط وضعیت JSON متعلق به swaybar استفاده کنید.\& برای اطلاعات بیشتر درباره این پروتکل به \fBswaybar-protocol\fR(7) مراجعه کنید.\&
.PP
اگر این دستور را از طریق IPC اجرا می‌کنید، می‌توانید با تنظیم دستور روی یک خط تیره تک، دستور وضعیت در حال اجرا را غیرفعال کنید: \fIswaybar bar bar-0 status_command -\fR
.PP
.RE
\fBstatus_edge_padding\fR <padding>
.RS 4
فاصله درونی (padding) مورد استفاده در زمانی که خط وضعیت در لبه راست نوار قرار دارد را تعیین می‌کند.\& این مقدار در ضریب مقیاس خروجی (scale) ضرب خواهد شد.\& مقدار پیش‌فرض \fI3\fR است.\&
.PP
.RE
\fBstatus_padding\fR <padding>
.RS 4
فاصله درونی عمودی مورد استفاده برای خط وضعیت را تعیین می‌کند.\& مقدار پیش‌فرض \fI1\fR است.\& اگر \fIpadding\fR برابر \fI0\fR باشد، بلوک‌ها می‌توانند تمام ارتفاع نوار را پر کنند.\& این مقدار در ضریب مقیاس خروجی ضرب خواهد شد.\&
.PP
.RE
\fBstrip_workspace_name\fR yes|no
.RS 4
اگر روی \fIyes\fR تنظیم شود، نام فضاهای کاری از دکمه فضای کاری حذف شده و فقط شماره سفارشی نمایش داده می‌شود.\& مقدار پیش‌فرض \fIno\fR است.\&
.PP
.RE
\fBstrip_workspace_numbers\fR yes|no
.RS 4
اگر روی \fIyes\fR تنظیم شود، شماره فضاهای کاری از دکمه فضای کاری حذف شده و فقط نام سفارشی نمایش داده می‌شود.\& مقدار پیش‌فرض \fIno\fR است.\&
.PP
.RE
\fBunbindcode\fR [--release] <event-code>
.RS 4
قید کلید مربوط به <event-code> داده‌شده را حذف می‌کند.\&
.PP
.RE
\fBunbindsym\fR [--release] button[1-9]|<event-name>
.RS 4
قید کلید مربوط به <button> یا <event-name> داده‌شده را حذف می‌کند.\&
.PP
.RE
\fBwrap_scroll\fR yes|no
.RS 4
پیمایش چرخشی (wrap) هنگام پیمایش میان فضاهای کاری با چرخ موش‌پاره را فعال یا غیرفعال می‌کند.\& مقدار پیش‌فرض \fIno\fR است.\&
.PP
.RE
\fBworkspace_buttons\fR yes|no
.RS 4
دکمه‌های فضای کاری را روی نوار فعال یا غیرفعال می‌کند.\& مقدار پیش‌فرض \fIyes\fR است.\&
.PP
.RE
\fBworkspace_min_width\fR <px> [px]
.RS 4
حداقل عرض دکمه‌های فضای کاری روی نوار را مشخص می‌کند.\& مقدار پیش‌فرض \fI0\fR است.\&
.PP
این تنظیم همچنین بر نشانگر حالت مقیدسازی کلیدها فعلی اعمال می‌شود.\&
.PP
.RE
دستورهای زیر فقط می‌توانند در زمان اجرا استفاده شوند.\&
.PP
\fBmode\fR toggle [<bar_id>]
.RS 4
حالت فعلی را بین \fIhide\fR و \fIdock\fR تغییر می‌دهد (ضامن می‌کند).\& با هر حالت دیگری همانند \fIhide\fR رفتار می‌شود.\&
.PP
.RE
.SS "سینی سامانه (TRAY)"
.PP
نوار swaybar یک سینی سامانه (system tray) فراهم می‌کند که برنامه‌های ثالث می‌توانند آیکون‌های خود را در آن قرار دهند.\& دستورهای زیر سینی سامانه را پیکربندی می‌کنند.\&
.PP
\fBtray_bindcode\fR <event-code>
ContextMenu|Activate|SecondaryActivate|ScrollDown|ScrollLeft|ScrollRight|ScrollUp|nop
.RS 4
هنگامی که کلید موش‌پاره فشرده شود، عملیات را اجرا می‌کند.\& کلیدها را می‌توان به عنوان یک کد رخداد که از \fBlibinput debug-events\fR به دست می‌آید مشخص کرد.\& برای غیرفعال کردن رفتار پیش‌فرض یک کلید، از دستور \fInop\fR استفاده کنید.\&
.PP
.RE
\fBtray_bindsym\fR button[1-9]|<event-name>
ContextMenu|Activate|SecondaryActivate|ScrollDown|ScrollLeft|ScrollRight|ScrollUp|nop
.RS 4
هنگامی که کلید موش‌پاره فشرده شود، عملیات را اجرا می‌کند.\& کلیدها را می‌توان به عنوان شماره کلید x11 یا نام رخداد که از \fBlibinput debug-events\fR به دست می‌آید مشخص کرد.\& برای غیرفعال کردن عملیات پیش‌فرض (Activate برای button1،‏ ContextMenu برای button2 و SecondaryActivate برای button3) از دستور \fInop\fR استفاده کنید.\&
.PP
.RE
\fBtray_padding\fR <px> [px]
.RS 4
فاصله درونی پیکسلی سینی سامانه را تنظیم می‌کند.\& این فاصله دور تا دور سینی و بین هر آیتم اعمال خواهد شد.\& مقدار پیش‌فرض برای \fIpx\fR برابر 2 است.\&
.PP
.RE
\fBtray_output\fR none|<output>|*
.RS 4
سینی سامانه را به یک خروجی خاص محدود می‌کند؛ می‌توان چندین بار آن را مشخص کرد.\& در صورت حذف، سینی در تمام خروجی‌ها نمایش داده می‌شود.\& برخلاف i3bar، نوار swaybar می‌تواند آیکون‌ها را روی هر تعداد نوار و خروجی بدون ایجاد شرایط رقابتی نمایش دهد.\& در هر زمان می‌توان از \fI*\fR برای بازنشانی آن به نمایش در تمام خروجی‌ها استفاده کرد.\&
.PP
.RE
\fBicon_theme\fR <name>
.RS 4
پوسته آیکونی را که sway در آن به دنبال آیکون آیتم‌ها می‌گردد تعیین می‌کند.\& این گزینه مقدار پیش‌فرضی ندارد، زیرا sway همیشه به پوسته جایگزین، یعنی hicolor رجوع می‌کند.\&
.PP
.RE
.SS "رنگ‌ها (COLORS)"
.PP
رنگ‌ها درون یک بلوک \fIcolors { }\fR در داخل بلوک \fIbar { }\fR تعریف می‌شوند.\& رنگ‌ها باید در قالب شانزده‌شانزدهی (hex) تعریف شوند: \fI#RRGGBB\fR یا \fI#RRGGBBAA\fR.\&
.PP
\fBbackground\fR <color>
.RS 4
رنگ پس‌زمینه نوار.\&
.PP
.RE
\fBstatusline\fR <color>
.RS 4
رنگ متن مورد استفاده برای خط وضعیت.\&
.PP
.RE
\fBseparator\fR <color>
.RS 4
رنگ متن مورد استفاده برای جداکننده.\&
.PP
.RE
\fBfocused_background\fR <color>
.RS 4
رنگ پس‌زمینه نوار روی خروجی نمایشگری که در حال حاضر فوکوس دارد.\& در صورت عدم استفاده، رنگ از \fIbackground\fR گرفته خواهد شد.\&
.PP
.RE
\fBfocused_statusline\fR <color>
.RS 4
رنگ متن مورد استفاده برای خط وضعیت روی خروجی نمایشگری که در حال حاضر فوکوس دارد.\& در صورت عدم استفاده، رنگ از \fIstatusline\fR گرفته خواهد شد.\&
.PP
.RE
\fBfocused_separator\fR <color>
.RS 4
رنگ متن مورد استفاده برای جداکننده روی خروجی نمایشگری که در حال حاضر فوکوس دارد.\& در صورت عدم استفاده، رنگ از \fIseparator\fR گرفته خواهد شد.\&
.PP
.RE
\fBfocused_workspace\fR <border> <background> <text>
.RS 4
رنگ حاشیه، پس‌زمینه و متن برای دکمه فضای کاری، هنگامی که فضای کاری فوکوس را در اختیار دارد.\&
.PP
.RE
\fBactive_workspace\fR <border> <background> <text>
.RS 4
رنگ حاشیه، پس‌زمینه و متن برای دکمه فضای کاری، هنگامی که فضای کاری روی یکی از خروجی‌ها فعال (نمایان) است، اما فوکوس روی خروجی دیگری قرار دارد.\& تفاوت این حالت با فضای کاری دارای فوکوس تنها در زمان استفاده از چند نمایشگر قابل تشخیص است.\&
.PP
.RE
\fBinactive_workspace\fR <border> <background> <text>
.RS 4
رنگ حاشیه، پس‌زمینه و متن برای دکمه فضای کاری، هنگامی که فضای کاری فوکوس ندارد و روی هیچ خروجی فعال (نمایان) نیست.\& این حالت برای اکثر فضاهای کاری صدق می‌کند.\&
.PP
.RE
\fBurgent_workspace\fR <border> <background> <text>
.RS 4
رنگ حاشیه، پس‌زمینه و متن برای دکمه فضای کاری، هنگامی که فضای کاری حاوی پنجره‌ای با نشانه فوریت (urgency hint) باشد.\&
.PP
.RE
\fBbinding_mode\fR <border> <background> <text>
.RS 4
رنگ حاشیه، پس‌زمینه و متن برای نشانگر حالت مقیدسازی کلیدها.\& در صورت عدم استفاده، رنگ‌ها از \fIurgent_workspace\fR گرفته خواهند شد.\&
.PP
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsway\fR(5) \fBswaybar-protocol\fR(7)