.\" Generated by scdoc 1.11.4 .\" 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 .\" Begin generated content: .TH "sway" "5" "2026-06-23" .PP .SH "نام (NAME)" .PP sway \- فایل پیکربندی و دستورات مدیر پنجره sway .PP .SH "توضیحات (DESCRIPTION)" .PP یک فایل پیکربندی sway فهرستی از دستورات sway است که هنگام راه‌اندازی توسط sway اجرا می‌شوند.\& این دستورات معمولاً شامل تنظیم اولویت‌های شما و تعیین کلیدهای میانبر هستند.\& یک نمونه پیکربندی احتمالاً در مسیر /etc/sway/config برای بررسی شما وجود دارد.\& .PP خطوط در فایل پیکربندی ممکن است با افزودن یک نویسه '\&\e'\& در انتهای خط، در چندین خط امتداد یابند.\& به عنوان نمونه: .PP .nf .RS 4 bindsym Shift+XF86AudioRaiseVolume exec \\ pactl set-sink-volume @DEFAULT_SINK@ -1% .fi .RE .PP دستورات همچنین می‌توانند به عنوان یک بلوک به شکل \fBcommand { }\fR داده شوند.\& هر چیزی قبل از \fB{\fR آغازین به خطوط درون بلوک اضافه خواهد شد.\& برای نمونه: .PP .nf .RS 4 output eDP-1 { background ~/wallpaper\&.png fill resolution 1920x1080 } .fi .RE .PP دقیقاً معادل است با: .PP .nf .RS 4 output eDP-1 background ~/wallpaper\&.png fill output eDP-1 resolution 1920x1080 .fi .RE .PP این دستورات می‌توانند در فایل پیکربندی شما، از طریق \fBswaymsg\fR(1)، یا از طریق دستور bindsym اجرا شوند.\& .PP .SH "قواعد نگارش دستورات (COMMAND CONVENTIONS)" .PP دستورات با استفاده از فاصله‌ها به چندین آرگومان تقسیم می‌شوند.\& می‌توانید آرگومان‌ها را درون علامت‌های نقل‌قول (\fB".\&.\&.\&"\fR یا \fB'\&.\&.\&.\&'\fR) محصور کنید تا فاصله‌ها را به یک آرگومان منفرد اضافه نمایید.\& همچنین می‌توانید چندین دستور را به ترتیب با جدا کردن هر یک با \fB,\fR یا \fB;\fR اجرا کنید.\& معیارها (Criteria) در میان دستوراتی که با \fB,\fR جدا شده‌اند حفظ می‌شوند، اما برای دستوراتی که با \fB;\fR جدا شده‌اند بازنشانی خواهند شد (و در صورت تمایل، امکان معیارهای جدید را فراهم می‌کنند).\& .PP در سرتاسر مستندات، \fB|\fR برای تمایز میان آرگومان‌هایی استفاده می‌شود که تنها می‌توانید یکی از آن‌ها را انتخاب کنید.\& \fB[.\&.\&.\&]\fR برای آرگومان‌های اختیاری، و \fB<.\&.\&.\&>\fR برای آرگومان‌هایی که انتظار می‌رود مقداری برای آن‌ها ارائه دهید استفاده می‌شود.\& .PP .SH "دستورات (COMMANDS)" .PP این بخش تنها دستورات عمومی را فهرست می‌کند.\& برای دستورات ورودی و خروجی، به \fBsway-input\fR(5) و \fBsway-output\fR(5) مراجعه فرمایید.\& .PP .SS "دستورات ویژه فایل پیکربندی (Config only commands)" دستورات زیر تنها می‌توانند در فایل پیکربندی استفاده شوند.\& .PP \fBbar\fR [] .RS 4 برای جزئیات درباره زیردستورات نوار وضعیت (bar)، به \fBsway-bar\fR(5) مراجعه کنید.\& .PP .RE \fBdefault_orientation\fR horizontal|vertical|auto .RS 4 چیدمان ظرف پیش‌فرض را برای ظرف‌های کاشی‌کاری‌شده (tiled) تنظیم می‌کند.\& .PP .RE \fBinclude\fR .RS 4 فایل‌ها را از \fIpaths\fR وارد می‌کند.\& \fIpaths\fR می‌تواند شامل یک مسیر کامل یا یک مسیر نسبت به پیکربندی والد باشد، و نحو شل را گسترش می‌دهد (برای جزئیات به \fBwordexp\fR(3) مراجعه کنید).\& یک فایل یکسان تنها یک بار می‌تواند وارد شود؛ تلاش‌های بعدی نادیده گرفته خواهند شد.\& .PP .RE \fBswaybg_command\fR .RS 4 دستور سفارشی پس‌زمینه \fIcommand\fR را اجرا می‌کند.\& پیش‌فرض \fIswaybg\fR است.\& برای اطلاعات بیشتر به \fBsway-output\fR(5) مراجعه فرمایید.\& .PP می‌توان آن را با تنظیم دستور روی یک خط تیره منفرد غیرفعال کرد: \fIswaybg_command -\fR .PP .RE \fBswaynag_command\fR .RS 4 دستور سفارشی را برای \fIswaynag\fR اجرا می‌کند.\& پیش‌فرض \fIswaynag\fR است.\& آرگومان‌های اضافی ممکن است به انتها اضافه شوند.\& این دستور تنها باید برای هدایت sway به فراخوانی swaynag از یک مسیر سفارشی یا برای ارائه آرگومان‌های اضافی استفاده شود.\& این دستور برای دستیابی به بهترین نتیجه باید در بالای فایل پیکربندی قرار گیرد.\& .PP می‌توان آن را با تنظیم دستور روی یک خط تیره منفرد غیرفعال کرد: \fIswaynag_command -\fR .PP .RE \fBworkspace_layout\fR default|stacking|tabbed .RS 4 چیدمان اولیه را برای ظرف‌های جدید در یک فضای کاری خالی مشخص می‌کند.\& .PP .RE \fBxwayland\fR enable|disable|force .RS 4 پشتیبانی از Xwayland را فعال یا غیرفعال می‌کند، که امکان استفاده از برنامه‌های X11 را فراهم می‌سازد.\& مقدار \fIenable\fR برنامه Xwayland را به صورت تنبلانه (lazy) بارگذاری می‌کند تا Xwayland تا زمانی که نخستین کلاینت تلاش برای اتصال نکند اجرا نشود.\& در برخی موارد، مانند ماشین‌های کندتر، ممکن است مطلوب باشد که Xwayland با استفاده از \fIforce\fR به جای \fIenable\fR بلافاصله راه‌اندازی شود.\& .PP .RE .SS "دستورات زمان اجرا (Runtime only commands)" دستورات زیر نمی‌توانند مستقیماً در فایل پیکربندی استفاده شوند.\& انتظار می‌رود آن‌ها با \fBbindsym\fR یا در زمان اجرا از طریق \fBswaymsg\fR(1) استفاده شوند.\& .PP \fBborder\fR none|normal|csd|pixel [] .RS 4 سبک حاشیه را برای پنجره فوکوس‌شده تنظیم می‌کند.\& مقدار \fInormal\fR شامل حاشیه‌ای به ضخامت \fIn\fR و یک نوار عنوان است.\& مقدار \fIpixel\fR حاشیه‌ای بدون نوار عنوان به ضخامت \fIn\fR پیکسل است.\& نوار عنوان همواره در چیدمان‌های انباشته (stacking) یا زبانه‌ای (tabbed) نمایش داده می‌شود.\& مقدار \fIcsd\fR کوتاه‌شده تزیینات سمت کلاینت (client-side-decorations) است که به کلاینت اجازه می‌دهد تزیینات خود را ترسیم کند.\& پیش‌فرض \fInormal\fR با ضخامت حاشیه ۲ است.\& .PP .RE \fBborder\fR toggle .RS 4 میان سبک‌های حاشیه موجود جابه‌جا می‌شود (چرخش می‌کند).\& .PP .RE \fBexit\fR .RS 4 از sway خارج می‌شود و نشست ویلند (Wayland) شما را خاتمه می‌دهد.\& .PP .RE \fBfloating\fR enable|disable|toggle .RS 4 پنجره فوکوس‌شده را شناور، غیرشناور، یا برعکس وضعیت کنونی آن می‌کند.\& .PP .RE \fBfocus\fR .RS 4 فوکوس را به ظرفی که با معیارهای مشخص‌شده مطابقت دارد منتقل می‌کند.\& .PP .RE \fBfocus\fR up|right|down|left .RS 4 فوکوس را به ظرف بعدی در جهت مشخص‌شده منتقل می‌کند.\& .PP .RE \fBfocus\fR prev|next [sibling] .RS 4 فوکوس را به ظرف قبلی یا بعدی در چیدمان کنونی منتقل می‌کند.\& به طور پیش‌فرض، آخرین فرزند فعال ظرف تازه‌فوکوس‌شده فوکوس خواهد شد.\& گزینه \fIsibling\fR نشان می‌دهد که بلافاصله فرزند ظرف فوکوس نشود.\& .PP .RE \fBfocus\fR child .RS 4 فوکوس را به آخرین فرزند فوکوس‌شده از ظرف فوکوس‌شده منتقل می‌کند.\& .PP .RE \fBfocus\fR parent .RS 4 فوکوس را به والد ظرف فوکوس‌شده منتقل می‌کند.\& .PP .RE \fBfocus\fR output up|right|down|left .RS 4 فوکوس را به خروجی (نمایشگر) بعدی در جهت مشخص‌شده منتقل می‌کند.\& .PP .RE \fBfocus\fR output .RS 4 فوکوس را به خروجی نام‌برده‌شده منتقل می‌کند.\& .PP .RE \fBfocus\fR tiling .RS 4 فوکوس را روی آخرین ظرف کاشی‌کاری‌شده فوکوس‌شده قرار می‌دهد.\& .PP .RE \fBfocus\fR floating .RS 4 فوکوس را روی آخرین ظرف شناور فوکوس‌شده قرار می‌دهد.\& .PP .RE \fBfocus\fR mode_toggle .RS 4 فوکوس را میان لایه‌های شناور و کاشی‌کاری‌شده جابه‌جا می‌کند.\& .PP .RE \fBfullscreen\fR [enable|disable|toggle] [global] .RS 4 پنجره فوکوس‌شده را تمام‌صفحه، غیرتمام‌صفحه، یا برعکس وضعیت کنونی آن می‌کند.\& اگر هیچ آرگومانی داده نشود، مانند \fItoggle\fR عمل می‌کند.\& اگر \fIglobal\fR مشخص شود، پنجره در تمام خروجی‌ها تمام‌صفحه خواهد شد.\& .PP .RE \fBgaps\fR inner|outer|horizontal|vertical|top|right|bottom|left all|current set|plus|minus|toggle .RS 4 شکاف‌های \fIinner\fR (درونی) یا \fIouter\fR (بیرونی) را برای \fIall\fR (همه) فضاهای کاری یا فضای کاری \fIcurrent\fR (کنونی) تغییر می‌دهد.\& شکاف‌های \fIouter\fR می‌توانند برای هر ضلع با \fItop\fR، \fIright\fR، \fIbottom\fR، و \fIleft\fR یا در هر جهت با \fIhorizontal\fR و \fIvertical\fR تغییر یابند.\& .PP .RE \fBinhibit_idle\fR focus|fullscreen|open|none|visible .RS 4 یک مهارکننده بیکاری (idle inhibitor) را برای پنجره تنظیم یا لغو می‌کند.\& مقدار \fIfocus\fR هنگامی که پنجره توسط هر نشستی فوکوس شود بیکاری را مهار می‌کند.\& مقدار \fIfullscreen\fR هنگامی که نما تمام‌صفحه باشد (یا فرزندی از یک ظرف تمام‌صفحه باشد) و مرئی باشد بیکاری را مهار می‌کند.\& مقدار \fIopen\fR تا زمان بسته شدن پنجره (یا لغو/تغییر مهارکننده) بیکاری را مهار می‌کند.\& مقدار \fIvisible\fR هنگامی که پنجره در هر خروجی مرئی باشد بیکاری را مهار می‌کند.\& مقدار \fInone\fR هر مهارکننده بیکاری موجود را برای پنجره حذف می‌نماید.\& .PP این دستور همچنین می‌تواند با معیارها برای تنظیم مهارکننده بیکاری برای هر پنجره موجود یا با \fIfor_window\fR برای تنظیم مهارکننده‌های بیکاری برای پنجره‌های آینده استفاده شود.\& .PP .RE \fBlayout\fR default|splith|splitv|stacking|tabbed .RS 4 حالت چیدمان ظرف فوکوس‌شده را تنظیم می‌کند.\& .PP هنگام استفاده از چیدمان \fIstacking\fR (انباشته)، تنها پنجره فوکوس‌شده در ظرف نمایش داده می‌شود، همراه با فهرست پنجره‌های باز در بالای ظرف.\& .PP چیدمان \fItabbed\fR (زبانه) شبیه به \fIstacking\fR است، اما فهرست پنجره‌ها به صورت عمودی تقسیم می‌شود.\& .PP .RE \fBlayout\fR toggle [split|all] .RS 4 حالت چیدمان ظرف فوکوس‌شده را میان فهرستی از پیش تنظیم‌شده از چیدمان‌ها جابه‌جا می‌کند.\& اگر هیچ آرگومانی داده نشود، میان چیدمان‌های انباشته، زبانه و آخرین چیدمان تقسیم گردش می‌کند.\& اگر \fIsplit\fR داده شود، میان splith و splitv جابه‌جا می‌شود.\& اگر \fIall\fR داده شود، میان تمام چیدمان‌ها گردش می‌کند.\& .PP .RE \fBlayout\fR toggle [split|tabbed|stacking|splitv|splith] [split|tabbed|stacking|splitv|splith].\&.\&.\& .RS 4 حالت چیدمان ظرف فوکوس‌شده را میان فهرستی از چیدمان‌ها جابه‌جا می‌کند.\& .PP .RE \fBmax_render_time\fR off| .RS 4 زمان اطلاع‌رسانی به برنامه مربوطه برای رندر کردن این پنجره را کنترل می‌کند، به صورت تعداد میلی‌ثانیه مثبت قبل از زمان بعدی ترکیب خروجی توسط sway.\& یک عدد کوچک‌تر منجر به رندر فریم‌های تازه‌تر برای ترکیب توسط sway و کاهش تاخیر ورودی ادراک‌شده می‌شود، اما اگر خیلی کم تنظیم شود، ممکن است برنامه پیش از ترکیب خروجی توسط sway رندر را تمام نکند، که منجر به فریم‌های با تاخیر می‌شود.\& .PP هنگامی که روی off تنظیم شود، به برنامه مربوطه گفته می‌شود که این پنجره را بلافاصله پس از نوسازی نمایشگر رندر کند.\& اینکه چقدر زمان برای رندر قبل از ترکیب خروجی توسط sway در آن نقطه باقی می‌ماند به تنظیم \fBmax_render_time\fR خروجی بستگی دارد.\& .PP برای راه‌اندازی این مورد جهت دستیابی به تاخیر بهینه: .PD 0 .IP 1. 4 تنظیم \fBoutput max_render_time\fR را انجام دهید (به \fBsway-output\fR(5) مراجعه کنید).\& .IP 2. 4 برنامه هدف را در حالت \fIfull-screen\fR قرار دهید و از آن بخواهید به طور مداوم چیزی را رندر کند.\& .IP 3. 4 با تنظیم \fBmax_render_time 1\fR شروع کنید.\& اگر برنامه فریم‌ها را از دست داد، به مقدار \fB1\fR اضافه کنید.\& .PD .PP این تنظیم تنها زمانی اثر دارد که یک \fBmax_render_time\fR به ازای هر خروجی در خروجی که پنجره در حال حاضر روی آن قرار دارد موثر باشد.\& برای جزئیات بیشتر به \fBsway-output\fR(5) مراجعه فرمایید.\& .PP .RE \fBallow_tearing\fR yes|no .RS 4 پارگی تصویر (screen tearing) ناشی از چرخش فوری صفحه (immediate page flips) را برای یک برنامه تمام‌صفحه مجاز یا غیرمجاز می‌کند.\& .PP هنگامی که این گزینه تنظیم نشده باشد، راهنماهای پارگی ارائه‌شده توسط برنامه تعیین می‌کنند که آیا پارگی مجاز است یا خیر.\& هنگامی که \fIyes\fR مشخص شود، برنامه صرف‌نظر از راهنماهای پارگی، پارگی را مجاز می‌داند.\& هنگامی که \fIno\fR مشخص شود، پارگی هرگز روی برنامه مجاز نخواهد بود، صرف‌نظر از راهنماهای پارگی.\& .PP این تنظیم تنها زمانی اثر دارد که پارگی در خروجی از طریق تنظیم \fBallow_tearing\fR به ازای خروجی مجاز باشد.\& برای جزئیات بیشتر به \fBsway-output\fR(5) مراجعه کنید.\& .PP .RE \fBmove\fR left|right|up|down [ px] .RS 4 ظرف فوکوس‌شده را در جهت مشخص‌شده جابه‌جا می‌کند.\& آرگومان اختیاری \fIpx\fR مشخص می‌کند که ظرف چند پیکسل جابه‌جا شود.\& در صورت عدم تعیین، پیش‌فرض ۱۰ پیکسل است.\& پیکسل‌ها هنگام جابه‌جایی ظرف‌های کاشی‌کاری‌شده نادیده گرفته می‌شوند.\& .PP .RE \fBmove\fR [absolute] position [px|ppt] [px|ppt] .RS 4 ظرف فوکوس‌شده را به موقعیت مشخص‌شده در فضای کاری جابه‌جا می‌کند.\& موقعیت می‌تواند بر حسب پیکسل یا درصد مشخص شود؛ با حذف واحد، پیش‌فرض پیکسل است.\& اگر \fIabsolute\fR استفاده شود، موقعیت نسبت به تمام خروجی‌ها است.\& \fIabsolute\fR نمی‌تواند با درصد استفاده شود.\& .PP .RE \fBmove\fR [absolute] position center .RS 4 ظرف فوکوس‌شده را در مرکز فضای کاری قرار می‌دهد.\& اگر \fIabsolute\fR استفاده شود، به مرکز تمام خروجی‌ها جابه‌جا می‌شود.\& .PP .RE \fBmove\fR position cursor|mouse|pointer .RS 4 ظرف فوکوس‌شده را در مرکز مکان‌نما (کرسر) قرار می‌دهد.\& .PP .RE \fBmove\fR [container|window] [to] mark .RS 4 ظرف فوکوس‌شده را به نشانه‌گذاری (mark) مشخص‌شده جابه‌جا می‌کند.\& .PP .RE \fBmove\fR [--no-auto-back-and-forth] [container|window] [to] workspace [number] .RS 4 ظرف فوکوس‌شده را به فضای کاری مشخص‌شده منتقل می‌کند.\& رشته \fInumber\fR اختیاری است و برای تطبیق فضای کاری با همان شماره استفاده می‌شود، حتی اگر نام متفاوتی داشته باشد.\& .PP .RE \fBmove\fR [container|window] [to] workspace prev|next|current .RS 4 ظرف فوکوس‌شده را به فضای کاری قبلی، بعدی یا کنونی در این خروجی، یا در صورتی که فضای کاری باقی نمانده باشد، به خروجی قبلی یا بعدی منتقل می‌کند.\& .PP .RE \fBmove\fR [container|window] [to] workspace prev_on_output|next_on_output .RS 4 ظرف فوکوس‌شده را به فضای کاری قبلی یا بعدی در این خروجی منتقل می‌کند، و در صورتی که از قبل در نخستین یا آخرین فضای کاری باشد به ابتدا یا انتها دور می‌زند.\& .PP .RE \fBmove\fR [container|window] [to] workspace back_and_forth .RS 4 ظرف فوکوس‌شده را به فضای کاری که قبلاً فوکوس شده بود منتقل می‌کند.\& .PP .RE \fBmove\fR [container|window] [to] output |current .RS 4 ظرف فوکوس‌شده را به خروجی مشخص‌شده منتقل می‌کند.\& .PP .RE \fBmove\fR [container|window] [to] output up|right|down|left .RS 4 ظرف فوکوس‌شده را به خروجی بعدی در جهت مشخص‌شده منتقل می‌کند.\& .PP .RE \fBmove\fR [container|window] [to] scratchpad .RS 4 ظرف فوکوس‌شده را به چک‌نویس (scratchpad) منتقل می‌کند.\& .PP .RE \fBmove\fR workspace [to] output |current .RS 4 فضای کاری فوکوس‌شده را به خروجی مشخص‌شده منتقل می‌کند.\& .PP .RE \fBmove\fR workspace to [output] |current .RS 4 فضای کاری فوکوس‌شده را به خروجی مشخص‌شده منتقل می‌کند.\& .PP .RE \fBmove\fR workspace [to] output up|right|down|left .RS 4 فضای کاری فوکوس‌شده را به خروجی بعدی در جهت مشخص‌شده منتقل می‌کند.\& .PP .RE \fBmove\fR workspace to [output] up|right|down|left .RS 4 فضای کاری فوکوس‌شده را به خروجی بعدی در جهت مشخص‌شده منتقل می‌کند.\& .PP .RE \fBnop\fR .RS 4 دستور بدون عملیات (no-op) که می‌تواند برای بازنویسی رفتار پیش‌فرض استفاده شود.\& آرگومان اختیاری comment نادیده گرفته می‌شود، اما برای اهداف اشکال‌زدایی ثبت می‌گردد.\& .PP .RE \fBreload\fR .RS 4 فایل پیکربندی sway را دوباره بارگذاری کرده و هرگونه تغییر را اعمال می‌کند.\& فایل پیکربندی در مسیری قرار دارد که هنگام شروع با آرگومان‌های خط فرمان مشخص شده است، در غیر این صورت بر اساس اولویت ذکر شده در \fBsway\fR(1) تعیین می‌شود.\& .PP .RE \fBrename\fR workspace [] to .RS 4 یا یا فضای کاری فوکوس‌شده را به تغییر نام می‌دهد.\& .PP .RE \fBresize\fR shrink|grow up|right|down|left|width|height [ [px|ppt]] .RS 4 اندازه ظرف در حال حاضر فوکوس‌شده را به مقدار \fIamount\fR، مشخص‌شده بر حسب پیکسل یا درصد، تغییر می‌دهد.\& اگر واحدها حذف شوند، ظرف‌های شناور بر حسب px و ظرف‌های کاشی‌کاری‌شده بر حسب ppt تغییر اندازه می‌یابند.\& در صورت حذف، پیش‌فرض \fIamount\fR برابر با ۱۰ خواهد بود.\& برای ظرف‌های کاشی‌کاری‌شده، فضا از ظرف در جهت مشخص‌شده گرفته یا به آن داده می‌شود.\& اگر \fIwidth\fR یا \fIheight\fR مشخص شود، فضا از تمام ظرف‌های دیگر گرفته یا به آن‌ها داده خواهد شد.\& .PP .RE \fBresize\fR set height [px|ppt] .RS 4 ارتفاع ظرف را به \fIheight\fR، مشخص‌شده بر حسب پیکسل یا درصد، تنظیم می‌کند.\& اگر واحدها حذف شوند، ظرف‌های شناور بر حسب px و ظرف‌های کاشی‌کاری‌شده بر حسب ppt تغییر اندازه می‌یابند.\& اگر \fIheight\fR برابر با ۰ باشد، اندازه ظرف تغییر نخواهد کرد.\& برای ظرف‌های کاشی‌کاری‌شده، فضا از تمام ظرف‌های دیگر گرفته یا به آن‌ها داده می‌شود.\& .PP .RE \fBresize\fR set [width] [px|ppt] .RS 4 عرض ظرف را به \fIwidth\fR، مشخص‌شده بر حسب پیکسل یا درصد، تنظیم می‌کند.\& اگر واحدها حذف شوند، ظرف‌های شناور بر حسب px و ظرف‌های کاشی‌کاری‌شده بر حسب ppt تغییر اندازه می‌یابند.\& اگر \fIwidth\fR برابر با ۰ باشد، اندازه ظرف تغییر نخواهد کرد.\& برای ظرف‌های کاشی‌کاری‌شده، فضا از تمام ظرف‌های دیگر گرفته یا به آن‌ها داده می‌شود.\& .PP .RE \fBresize\fR set [width] [px|ppt] [height] [px|ppt] .RS 4 عرض و ارتفاع ظرف را به \fIwidth\fR و \fIheight\fR، مشخص‌شده بر حسب پیکسل یا درصد، تنظیم می‌کند.\& اگر واحدها حذف شوند، ظرف‌های شناور بر حسب px و ظرف‌های کاشی‌کاری‌شده بر حسب ppt تغییر اندازه می‌یابند.\& اگر \fIwidth\fR یا \fIheight\fR برابر با ۰ باشد، اندازه ظرف روی آن محور تغییر نخواهد کرد.\& برای ظرف‌های کاشی‌کاری‌شده، فضا از تمام ظرف‌های دیگر گرفته یا به آن‌ها داده می‌شود.\& .PP .RE \fBscratchpad\fR show .RS 4 پنجره‌ای را از چک‌نویس (scratchpad) نشان می‌دهد.\& استفاده مکرر از این دستور میان پنجره‌های موجود در چک‌نویس چرخش ایجاد می‌کند.\& .PP .RE \fBshortcuts_inhibitor\fR enable|disable .RS 4 توانایی کلاینت‌ها را برای مهار کلیدهای میانبر صفحه‌کلید برای یک پنجره فعال یا غیرفعال می‌کند.\& این در درجه اول برای نرم‌افزارهای مجازی‌سازی و دسکتاپ راه دور مفید است.\& بر پنجره در حال حاضر فوکوس‌شده یا مجموعه‌ای از پنجره‌های انتخاب‌شده با معیارها تاثیر می‌گذارد.\& زیردستور \fIdisable\fR علاوه بر این، هرگونه مهارکننده فعال را برای پنجره(های) داده‌شده غیرفعال می‌سازد.\& معیارها به ویژه با دستور \fBfor_window\fR برای پیکربندی دسته‌ای از پنجره‌ها به صورت متفاوت از پیش‌فرض‌های هر نشست ایجاد شده توسط زیردستور \fBseat\fR با همین نام مفید هستند.\& برای روش‌های بیشتر برای تاثیر بر مهارکننده‌ها به \fBsway-input\fR(5) مراجعه فرمایید.\& .PP .RE \fBsplit\fR vertical|v|horizontal|h|none|n|toggle|t .RS 4 ظرف کنونی را به صورت عمودی یا افقی تقسیم می‌کند.\& هنگامی که \fInone\fR مشخص شود، اثر یک تقسیم قبلی در صورتی که ظرف کنونی تنها فرزند یک والد تقسیم‌شده باشد خنثی می‌شود.\& هنگامی که \fItoggle\fR مشخص شود، ظرف کنونی برعکس چیدمان ظرف والد تقسیم می‌گردد.\& .PP .RE \fBsplith\fR .RS 4 معادل با \fBsplit horizontal\fR .PP .RE \fBsplitv\fR .RS 4 معادل با \fBsplit vertical\fR .PP .RE \fBsplitt\fR .RS 4 معادل با \fBsplit toggle\fR .PP .RE \fBsticky\fR enable|disable|toggle .RS 4 یک پنجره شناور را به خروجی کنونی «سنجاق» (stick) می‌کند تا در تمام فضاهای کاری نمایش داده شود.\& .PP .RE \fBswap\fR container with id|con_id|mark .RS 4 موقعیت، هندسه و وضعیت تمام‌صفحه دو ظرف را با هم تعویض می‌کند.\& ظرف نخست می‌تواند با معیارها یا با فوکوس انتخاب شود.\& ظرف دوم می‌تواند با \fIid\fR، \fIcon_id\fR، یا \fImark\fR انتخاب شود.\& \fIid\fR تنها می‌تواند با پنجره‌های xwayland استفاده شود.\& اگر ظرف نخست دارای فوکوس باشد، فوکوس را حفظ خواهد کرد مگر اینکه به یک فضای کاری متفاوت منتقل شود یا ظرف دوم در همان فضای کاری ظرف نخست تمام‌صفحه گردد.\& در هر یک از این موارد، ظرف دوم فوکوس را به دست خواهد آورد.\& .PP .RE \fBtitle_format\fR .RS 4 قالب عناوین پنجره‌ها را تنظیم می‌کند.\& متغیرهای جایگزین زیر می‌توانند استفاده شوند: .PP \fB%title\fR .RS 4 عنوان ارائه‌شده توسط پنجره .PP .RE \fB%app_id\fR .RS 4 شناسه برنامه در ویلند (تنها برای پنجره‌های ویلند کاربرد دارد) .PP .RE \fB%class\fR .RS 4 نام کلاس در X11 (تنها برای پنجره‌های xwayland کاربرد دارد) .PP .RE \fB%instance\fR .RS 4 نمونه (instance) در X11 (تنها برای پنجره‌های xwayland کاربرد دارد) .PP .RE \fB%shell\fR .RS 4 پروتکلی که پنجره استفاده می‌کند (معمولاً xwayland یا xdg_shell) .PP .RE \fB%sandbox_engine\fR .RS 4 موتور ایزوله‌سازی (sandbox) مرتبط .PP .RE \fB%sandbox_app_id\fR .RS 4 شناسه برنامه ارائه‌شده توسط موتور ایزوله‌سازی مرتبط .PP .RE \fB%sandbox_instance_id\fR .RS 4 شناسه نمونه ارائه‌شده توسط موتور ایزوله‌سازی مرتبط .PP .RE این دستور معمولاً با معیارهای \fBfor_window\fR استفاده می‌شود.\& برای نمونه: .PP .RS 4 for_window [title=".\&"] title_format "%title (%app_id)" .PP .RE توجه داشته باشید که نشانه‌گذاری نیازمند فعال بودن pango از طریق دستور \fBfont\fR است.\& .PP قالب پیش‌فرض "%title" است.\& .PP .RE .SS "دستورات پیکربندی یا زمان اجرا (Config or runtime commands)" دستورات زیر می‌توانند در فایل پیکربندی یا در زمان اجرا استفاده شوند.\& .PP \fBassign\fR [→] [workspace] [number] .RS 4 پنجره‌های منطبق با \fIcriteria\fR (برای جزئیات به \fBCRITERIA\fR مراجعه کنید) را به \fIworkspace\fR اختصاص می‌دهد.\& علامت → (U+2192) اختیاری و صرفاً تزیینی است.\& این دستور معادل است با: .PP .RS 4 for_window move container to workspace .PP .RE .RE \fBassign\fR [→] output left|right|up|down| .RS 4 پنجره‌های منطبق با \fIcriteria\fR (برای جزئیات به \fBCRITERIA\fR مراجعه کنید) را به خروجی مشخص‌شده اختصاص می‌دهد.\& علامت → (U+2192) اختیاری و صرفاً تزیینی است.\& این دستور معادل است با: .PP .RS 4 for_window move container to output .PP .RE .RE \fBbindsym\fR [--whole-window] [--border] [--exclude-titlebar] [--release] [--locked] [--to-code] [--input-device=] [--no-warn] [--no-repeat] [--inhibited] [Group<1-4>+] .RS 4 ترکیب کلیدی \fIkey combo\fR را برای اجرای دستور sway با نام \fIcommand\fR هنگام فشرده شدن مقید می‌سازد.\& می‌توانید از نام‌های کلید XKB در اینجا استفاده کنید (\fBwev\fR(1) ابزار خوبی برای کشف این موارد است).\& با پرچم \fI--release\fR، دستور هنگام رها شدن ترکیب کلید اجرا می‌شود.\& اگر \fIinput-device\fR داده شود، کلید تنها برای آن دستگاه ورودی اجرا خواهد شد و به جای هر اتصالی که برای همه دستگاه‌ها عمومی است اجرا می‌گردد.\& اگر شماره گروه داده شود، پیوند تنها برای آن گروه در دسترس خواهد بود.\& به طور پیش‌فرض، اگر یک اتصال را بازنویسی کنید، swaynag به شما هشدار می‌دهد.\& برای خاموش کردن این هشدار، از پرچم \fI--no-warn\fR استفاده کنید.\& .PP برای مشخص کردن کلیدهای تغییردهنده، می‌توانید از نام‌های تغییردهنده XKB شامل \fIShift\fR، \fILock\fR (برای Caps Lock)، \fIControl\fR، \fIMod1\fR (برای Alt)، \fIMod2\fR (برای Num Lock)، \fIMod3\fR (برای تغییردهنده Mod3 در XKB)، \fIMod4\fR (برای کلید لوگو/ویندوز)، و \fIMod5\fR (برای AltGr) استفاده کنید.\& علاوه بر این، می‌توانید از نام‌های مستعار \fICtrl\fR (برای Control)، \fIAlt\fR (برای Alt)، و \fISuper\fR (برای کلید لوگو) استفاده نمایید.\& .PP مگر اینکه پرچم \fI--locked\fR تنظیم شده باشد، دستور هنگام فعال بودن برنامه قفل صفحه اجرا نخواهد شد.\& اگر یک پیوند منطبق با و بدون \fI--locked\fR وجود داشته باشد، موردی که دارای پرچم است هنگام قفل بودن ترجیح داده می‌شود و موردی که ندارد هنگام باز بودن ترجیح داده خواهد شد.\& اگر پیوندهای منطبق وجود داشته باشند و یکی هم \fI--input-device\fR و هم \fI--locked\fR داشته باشد و دیگری هیچ‌کدام را نداشته باشد، اولی حتی هنگام باز بودن قفل ترجیح داده می‌شود.\& .PP مگر اینکه پرچم \fI--inhibited\fR تنظیم شده باشد، دستور هنگامی که یک مهارکننده کلیدهای میانبر صفحه‌کلید برای پنجره در حال حاضر فوکوس‌شده فعال است اجرا نخواهد شد.\& چنین مهارکننده‌هایی معمولاً توسط نرم‌افزارهای دسکتاپ راه دور و مجازی‌سازی درخواست می‌شوند تا کاربر بتواند میانبرهای صفحه‌کلید را به نشست راه دور یا مجازی ارسال کند.\& پرچم \fI--inhibited\fR به شخص امکان می‌دهد پیوندهایی را تعریف کند که از عبور به چنین نرم‌افزارهایی معاف باشند.\& همان منطق اولویت مانند \fI--locked\fR اعمال می‌شود.\& .PP مگر اینکه پرچم \fI--no-repeat\fR تنظیم شده باشد، هنگامی که کلید نگه داشته شود، دستور بر اساس تنظیمات تکرار مشخص‌شده در پیکربندی ورودی، مکرراً اجرا خواهد شد.\& .PP اتصالات به keysymها وابسته به چیدمان صفحه‌کلید هستند.\& این می‌تواند با پرچم \fI--to-code\fR تغییر یابد.\& در این صورت، keysymها به کدهای کلید مربوطه در نخستین چیدمان پیکربندی‌شده ترجمه خواهند شد.\& .PP اتصالات ماوس روی ظرف زیر مکان‌نما به جای ظرفی که فوکوس دارد عمل می‌کنند.\& دکمه‌های ماوس می‌توانند به صورت \fIbutton[1-9]\fR یا با استفاده از نام کد رویداد (مانند \fIBTN_LEFT\fR یا \fIBTN_RIGHT\fR) مشخص شوند.\& برای گزینه نخست، دکمه‌ها به مقادیر آن‌ها در X11 نگاشت می‌شوند (۱=چپ، ۲=وسط، ۳=راست، ۴=پیمایش بالا، ۵=پیمایش پایین، ۶=پیمایش چپ، ۷=پیمایش راست، ۸=عقب، ۹=جلو).\& برای گزینه دوم، می‌توانید نام رویدادها را با استفاده از \fIlibinput debug-events\fR بیابید.\& .PP اولویت برای پیوندهای منطبق به این صورت است: دستگاه ورودی، گروه، و وضعیت قفل.\& .PP گزینه‌های \fI--whole-window\fR، \fI--border\fR، و \fI--exclude-titlebar\fR گزینه‌های ویژه‌ی ماوس هستند که بر ناحیه‌ای که اتصالات ماوس در آن می‌توانند فعال شوند تاثیر می‌گذارند.\& به طور پیش‌فرض، اتصالات ماوس تنها زمانی فعال می‌شوند که روی نوار عنوان باشند.\& با گزینه \fI--border\fR، حاشیه پنجره در این ناحیه گنجانده خواهد شد.\& با گزینه \fI--whole-window\fR، مکان‌نما می‌تواند در هر نقطه روی یک پنجره از جمله عنوان، حاشیه و محتوا باشد.\& گزینه \fI--exclude-titlebar\fR می‌تواند همراه با هر گزینه دیگری استفاده شود تا مشخص کند نوار عنوان باید از ناحیه مورد نظر مستثنی شود.\& .PP اگر \fI--whole-window\fR داده شود، دستور می‌تواند زمانی که مکان‌نما روی یک فضای کاری خالی است تحریک شود.\& استفاده از اتصال ماوس روی ناحیه اختصاصی سطح لایه (layer surface) در حال حاضر امکان‌پذیر نیست.\& .PP نمونه: .RE .nf .RS 4 # اجرای فایرفاکس هنگامی که alt، shift و f با هم فشرده شوند bindsym Mod1+Shift+f exec firefox .fi .RE .PP .RS 4 \fBbindcode\fR [--whole-window] [--border] [--exclude-titlebar] [--release] [--locked] [--input-device=] [--no-warn] [--no-repeat] [--inhibited] [Group<1-4>+] نیز برای اتصال با کدهای کلید/دکمه به جای نام‌های کلید/دکمه در دسترس است.\& .PP .RE \fBbindswitch\fR [--locked] [--no-warn] [--reload] : .RS 4 سوییچ را برای اجرای دستور sway با نام \fIcommand\fR در هنگام تغییر وضعیت مقید می‌سازد.\& سوییچ‌های پشتیبانی‌شده عبارتند از سوییچ‌های \fIlid\fR (درب لپ‌تاپ)، \fItablet\fR (حالت تبلت) و \fIkeypad_slide\fR (آیا صفحه کلید دستگاه نمایان است یا خیر).\& مقادیر معتبر برای \fIstate\fR عبارتند از \fIon\fR، \fIoff\fR و \fItoggle\fR.\& این سوییچ‌ها به ترتیب زمانی که درب دستگاه بسته است، زمانی که حالت تبلت فعال است و زمانی که صفحه کلید نمایان است روشن هستند.\& مقدار \fItoggle\fR نیز برای اجرای یک دستور هم هنگام روشن شدن و هم خاموش شدن سوییچ پشتیبانی می‌شود.\& .PP مگر اینکه پرچم \fI--locked\fR تنظیم شده باشد، دستور هنگام فعال بودن برنامه قفل صفحه اجرا نخواهد شد.\& اگر یک پیوند منطبق با و بدون \fI--locked\fR وجود داشته باشد، موردی که دارای پرچم است هنگام قفل بودن ترجیح داده می‌شود و موردی که ندارد هنگام باز بودن ترجیح داده خواهد شد.\& .PP اگر پرچم \fI--reload\fR داده شود، پیوند هنگام بازخوانی پیکربندی نیز اجرا خواهد شد.\& اتصالات \fItoggle\fR هنگام بارگذاری مجدد اجرا نخواهند شد.\& پرچم \fI--locked\fR طبق معمول عمل خواهد کرد بنابراین اگر پیکربندی در حین قفل بودن دوباره بارگذاری شود و \fI--locked\fR داده نشده باشد، پیوند اجرا نخواهد شد.\& .PP به طور پیش‌فرض، اگر یک اتصال را بازنویسی کنید، swaynag به شما هشدار می‌دهد.\& برای خاموش کردن این هشدار، از پرچم \fI--no-warn\fR استفاده کنید.\& .PP نمونه: .RE .nf .RS 4 # نمایش صفحه کلید مجازی هنگام ورود به حالت تبلت bindswitch tablet:on busctl call --user sm\&.puri\&.OSK0 /sm/puri/OSK0 sm\&.puri\&.OSK0 SetVisible b true # ثبت یک پیام در لاگ هنگام باز یا بسته شدن درب لپ‌تاپ bindswitch lid:toggle exec echo "Lid moved" .fi .RE .PP \fBbindgesture\fR [--exact] [--input-device=] [--no-warn] [:][:directions] .RS 4 ژست حرکتی \fIgesture\fR را برای اجرای دستور sway با نام \fIcommand\fR هنگام شناسایی مقید می‌سازد.\& در حال حاضر از ژست‌های \fIhold\fR، \fIpinch\fR یا \fIswipe\fR پشتیبانی می‌کند.\& به صورت اختیاری می‌تواند به تعداد معینی از \fIfingers\fR (انگشتان) یا، برای ژست \fIpinch\fR یا \fIswipe\fR، به جهت‌های خاصی (\fIdirections\fR) محدود شود.\& .PP .RE .TS allbox;l l lx l c lx l c lx l c lx. T{ \fBtype\fR T} T{ \fBfingers\fR T} T{ \fBdirection\fR T} T{ hold T} T{ 1 - 5 T} T{ none T} T{ swipe T} T{ 3 - 5 T} T{ up, down, left, right T} T{ pinch T} T{ 2 - 5 T} T{ all above + inward, outward, clockwise, counterclockwise T} .TE .sp 1 .RS 4 تعداد \fIfingers\fR می‌تواند به هر تعداد معقولی محدود شود یا خالی رها شود تا هر تعداد انگشتی را بپذیرد.\& جهت‌های معتبر عبارتند از \fIup\fR، \fIdown\fR، \fIleft\fR و \fIright\fR، و همچنین \fIinward\fR، \fIoutward\fR، \fIclockwise\fR، \fIcounterclockwise\fR برای ژست \fIpinch\fR.\& جهت‌های متعدد می‌توانند با یک علامت مثبت ترکیب شوند.\& .PP اگر یک \fIinput-device\fR داده شود، پیوند تنها برای آن دستگاه ورودی اجرا خواهد شد و به جای هر اتصالی که برای همه دستگاه‌ها عمومی است اجرا می‌شود.\& به طور پیش‌فرض، اگر یک اتصال را بازنویسی کنید، swaynag به شما هشدار می‌دهد.\& برای خاموش کردن این هشدار، از پرچم \fI--no-warn\fR استفاده کنید.\& .PP پرچم \fI--exact\fR می‌تواند برای اطمینان از اینکه یک پیوند تنها زمانی مطابقت دارد که دقیقاً تمام جهت‌های مشخص‌شده تطابق داشته باشند و نه بیشتر استفاده شود.\& اگر پیوند منطبقی با \fI--exact\fR وجود داشته باشد، ترجیح داده خواهد شد.\& .PP اولویت برای پیوندهای منطبق به این صورت است: دستگاه ورودی، سپس تطابق‌های دقیق و به دنبال آن تطابق‌هایی با بیشترین تعداد جهت‌های منطبق.\& .PP ژست‌هایی که در حالی که اشاره‌گر بالای یک نوار وضعیت است اجرا می‌شوند توسط sway مدیریت نمی‌شوند.\& به مستندات مربوطه مراجعه کنید، به عنوان نمونه \fBbindgesture\fR در \fBsway-bar\fR(5).\& .PP نمونه: .RE .nf .RS 4 # اجازه جابه‌جایی میان فضاهای کاری با کشیدن انگشت به چپ و راست bindgesture swipe:right workspace prev bindgesture swipe:left workspace next # اجازه جابه‌جایی ظرف با نیشگون گرفتن (pinch) آن‌ها bindgesture pinch:inward+up move up bindgesture pinch:inward+down move down bindgesture pinch:inward+left move left bindgesture pinch:inward+right move right .fi .RE .PP \fBclient.\&background\fR .RS 4 این دستور نادیده گرفته می‌شود و تنها برای سازگاری با i3 وجود دارد.\& .PP .RE \fBclient.\&\fR [ []] .RS 4 رنگ حاشیه‌های پنجره و نوارهای عنوان را پیکربندی می‌کند.\& سه رنگ نخست الزامی هستند.\& در صورت حذف، \fIindicator\fR از یک پیش‌فرض مناسب استفاده خواهد کرد و \fIchild_border\fR از رنگ تنظیم‌شده برای \fIbackground\fR استفاده می‌کند.\& رنگ‌ها ممکن است به صورت هگزادسیمال، یا به صورت \fI#RRGGBB\fR یا \fI#RRGGBBAA\fR مشخص شوند.\& .PP کلاس‌های موجود عبارتند از: .PP \fBclient.\&focused\fR .RS 4 پنجره‌ای که فوکوس دارد.\& .PP .RE \fBclient.\&focused_inactive\fR .RS 4 پنجره‌ای که اخیراً در یک ظرف غیرفوکوس‌شده فوکوس شده است.\& .PP .RE \fBclient.\&focused_tab_title\fR .RS 4 پنجره‌ای که دارای ظرف فرزند فوکوس‌شده است.\& عنوان ظرف زبانه یا انباشته که والد ظرف فوکوس‌شده است اما مستقیماً فوکوس نشده است.\& در صورت عدم تعیین، به طور پیش‌فرض روی focused_inactive تنظیم می‌شود و از رنگ‌های indicator و child_border استفاده نمی‌کند.\& .PP .RE \fBclient.\&placeholder\fR .RS 4 نادیده گرفته می‌شود (برای سازگاری با i3 وجود دارد).\& .PP .RE \fBclient.\&unfocused\fR .RS 4 پنجره‌ای که فوکوس ندارد.\& .PP .RE \fBclient.\&urgent\fR .RS 4 پنجره‌ای با راهنمای اضطراری (urgency hint).\& \fBتوجه\fR: پنجره‌های بومی ویلند از وضعیت اضطراری پشتیبانی نمی‌کنند.\& وضعیت اضطراری تنها برای پنجره‌های Xwayland کار می‌کند.\& .PP .RE معنای هر رنگ به شرح زیر است: .PP \fIborder\fR .RS 4 حاشیه دور نوار عنوان.\& .PP .RE \fIbackground\fR .RS 4 پس‌زمینه نوار عنوان.\& .PP .RE \fItext\fR .RS 4 رنگ متن نوار عنوان.\& .PP .RE \fIindicator\fR .RS 4 رنگی که برای نشان دادن محل باز شدن یک پنجره جدید استفاده می‌شود.\& در یک ظرف کاشی‌کاری‌شده، این رنگ حاشیه راست پنجره کنونی را در صورتی که پنجره جدیدی در سمت راست باز شود رنگ‌آمیزی می‌کند.\& .PP .RE \fIchild_border\fR .RS 4 حاشیه دور خود پنجره.\& .PP .RE .RE رنگ‌های پیش‌فرض عبارتند از: .PP .TS allbox;c l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l l. T{ \fBclass\fR T} T{ \fIborder\fR T} T{ \fIbackground\fR T} T{ \fItext\fR T} T{ \fIindicator\fR T} T{ \fIchild_border\fR T} T{ \fBbackground\fR T} T{ n/a T} T{ #ffffff T} T{ n/a T} T{ n/a T} T{ n/a T} T{ \fBfocused\fR T} T{ #4c7899 T} T{ #285577 T} T{ #ffffff T} T{ #2e9ef4 T} T{ #285577 T} T{ \fBfocused_inactive\fR T} T{ #333333 T} T{ #5f676a T} T{ #ffffff T} T{ #484e50 T} T{ #5f676a T} T{ \fBfocused_tab_title\fR T} T{ #333333 T} T{ #5f676a T} T{ #ffffff T} T{ n/a T} T{ n/a T} T{ \fBunfocused\fR T} T{ #333333 T} T{ #222222 T} T{ #888888 T} T{ #292d2e T} T{ #222222 T} T{ \fBurgent\fR T} T{ #2f343a T} T{ #900000 T} T{ #ffffff T} T{ #900000 T} T{ #900000 T} T{ \fBplaceholder\fR T} T{ #000000 T} T{ #0c0c0c T} T{ #ffffff T} T{ #000000 T} T{ #0c0c0c T} .TE .sp 1 .PP \fBdefault_border\fR normal|none|pixel [] .RS 4 سبک حاشیه پیش‌فرض را برای پنجره‌های کاشی‌کاری‌شده جدید تنظیم می‌کند.\& بارگذاری مجدد پیکربندی بر پنجره‌های موجود تاثیری نخواهد داشت، تنها بر پنجره‌های تازه ایجاد شده پس از بارگذاری مجدد اعمال می‌شود.\& .PP .RE \fBdefault_floating_border\fR normal|none|pixel [] .RS 4 سبک حاشیه پیش‌فرض را برای پنجره‌های شناور جدید تنظیم می‌کند.\& این تنها بر پنجره‌هایی که در حالت شناور ایجاد می‌شوند اعمال می‌شود، نه پنجره‌هایی که بعداً شناور می‌شوند.\& .PP .RE \fBexec\fR .RS 4 دستور شل \fIshell command\fR را با sh اجرا می‌کند.\& .PP .RE \fBexec_always\fR .RS 4 مشابه با \fBexec\fR، اما دستور شل \fIدوباره\fR پس از \fBreload\fR اجرا خواهد شد.\& .PP .RE \fBfloating_maximum_size\fR x .RS 4 حداکثر اندازه پنجره‌های شناور را مشخص می‌کند.\& مقدار -1 x -1 حد بالا را حذف می‌کند.\& پیش‌فرض 0 x 0 است که از عرض و ارتفاع کل چیدمان خروجی به عنوان حداکثر استفاده می‌کند.\& .PP .RE \fBfloating_minimum_size\fR x .RS 4 حداقل اندازه پنجره‌های شناور را مشخص می‌کند.\& پیش‌فرض 75 x 50 است.\& .PP .RE \fBfloating_modifier\fR [normal|inverse] .RS 4 هنگامی که کلید \fImodifier\fR پایین نگه داشته شود، می‌توانید برای جابه‌جایی پنجره‌ها کلیک چپ را نگه دارید و برای تغییر اندازه آن‌ها کلیک راست کنید.\& تنظیم \fImodifier\fR روی \fInone\fR این ویژگی را غیرفعال می‌کند.\& اگر \fIinverse\fR مشخص شود، کلیک چپ برای تغییر اندازه و کلیک راست برای جابه‌جایی استفاده می‌شود.\& .PP .RE \fBfocus_follows_mouse\fR yes|no|always .RS 4 اگر روی \fIyes\fR تنظیم شود، حرکت ماوس روی یک پنجره آن پنجره را فوکوس می‌کند.\& اگر روی \fIalways\fR تنظیم شود، پنجره زیر مکان‌نما همیشه فوکوس خواهد شد، حتی پس از جابه‌جایی میان فضاهای کاری.\& .PP .RE \fBfocus_on_window_activation\fR smart|urgent|focus|none .RS 4 این گزینه تعیین می‌کند هنگامی که کلاینتی درخواست فعال‌سازی پنجره را دارد چه کاری انجام شود.\& اگر روی \fIurgent\fR تنظیم شود، وضعیت اضطراری برای آن پنجره تنظیم خواهد شد.\& اگر روی \fIfocus\fR تنظیم شود، پنجره فوکوس خواهد شد.\& اگر روی \fIsmart\fR تنظیم شود، پنجره تنها در صورتی که از قبل مرئی باشد فوکوس می‌شود، در غیر این صورت وضعیت اضطراری تنظیم خواهد شد.\& پیش‌فرض \fIurgent\fR است.\& .PP .RE \fBfocus_wrapping\fR yes|no|force|workspace .RS 4 این گزینه تعیین می‌کند هنگام تلاش برای فوکوس فراتر از لبه یک ظرف چه کاری انجام شود.\& اگر روی \fIno\fR تنظیم شود، در صورت عدم وجود ظرف‌های دیگر در آن جهت، ظرف فوکوس‌شده فوکوس را حفظ می‌کند.\& اگر روی \fIyes\fR تنظیم شود، در صورت عدم وجود ظرف‌های دیگر در آن جهت، فوکوس به لبه مقابل ظرف دور می‌زند.\& اگر روی \fIforce\fR تنظیم شود، حتی اگر ظرف‌های دیگری در آن جهت وجود داشته باشند، فوکوس به لبه مقابل ظرف دور می‌زند.\& اگر روی \fIworkspace\fR تنظیم شود، فوکوس مانند حالت \fIyes\fR دور می‌زند و علاوه بر این هنگام حرکت به خارج از مرزهای فضاهای کاری نیز دور می‌زند.\& پیش‌فرض \fIyes\fR است.\& .PP .RE \fBfont\fR [pango:] .RS 4 قلم مورد استفاده برای نوارهای عنوان را تنظیم می‌کند.\& برای فعال‌سازی پشتیبانی از نشانه‌گذاری pango، نام قلم را با \fIpango:\fR پیشوندگذاری کنید.\& برای نمونه، \fImonospace 10\fR قلم پیش‌فرض است.\& برای فعال‌سازی پشتیبانی از نشانه‌گذاری pango، باید به جای آن از \fIpango:monospace 10\fR استفاده شود.\& صرف‌نظر از اینکه نشانه‌گذاری pango فعال است یا خیر، \fIfont\fR باید به عنوان توصیف قلم pango مشخص شود.\& برای اطلاعات بیشتر درباره توصیف‌های قلم pango، نشانی زیر را ببینید: https://docs.gtk.org/Pango/type_func.FontDescription.from_string.html#description .PP .RE \fBforce_display_urgency_hint\fR [ms] .RS 4 اگر برنامه‌ای در یک فضای کاری دیگر راهنمای اضطراری تنظیم کند، جابه‌جایی به این فضای کاری ممکن است منجر به فوکوس فوری برنامه شود، که همچنین به این معنی است که رنگ تزیینات پنجره بلافاصله به \fBclient.\&focused\fR بازنشانی می‌شود.\& این ممکن است تشخیص اینکه کدام پنجره در اصل این رویداد را ایجاد کرده است را دشوار سازد.\& این گزینه به شخص امکان می‌دهد یک مهلت زمانی (\fItimeout\fR) را بر حسب میلی‌ثانیه برای به تاخیر انداختن بازنشانی راهنمای اضطراری تنظیم کند.\& .PP .RE \fBtitlebar_border_thickness\fR .RS 4 ضخامت حاشیه نوار عنوان بر حسب پیکسل .PP .RE \fBtitlebar_padding\fR [] .RS 4 فاصله‌گذاری درونی (padding) متن در نوار عنوان.\& مقدار \fIhorizontal\fR بر فاصله‌گذاری افقی متن تاثیر می‌گذارد در حالی که مقدار \fIvertical\fR بر فاصله‌گذاری عمودی (فضای بالا و پایین متن) اثر می‌گذارد.\& فاصله‌گذاری شامل حاشیه‌های نوار عنوان است بنابراین مقدار آن‌ها باید بیشتر از titlebar_border_thickness باشد.\& اگر مقدار \fIvertical\fR مشخص نشود، برابر با مقدار \fIhorizontal\fR تنظیم می‌شود.\& .PP .RE \fBfor_window\fR .RS 4 هر زمان پنجره‌ای که با \fIcriteria\fR مطابقت دارد ظاهر شود، فهرستی از دستورات را اجرا می‌کند.\& برای جزئیات بیشتر به \fBCRITERIA\fR مراجعه کنید.\& .PP .RE \fBgaps\fR inner|outer|horizontal|vertical|top|right|bottom|left .RS 4 مقدار پیش‌فرض \fIamount\fR پیکسل از شکاف \fIinner\fR یا \fIouter\fR را تنظیم می‌کند، که در آن شکاف درونی بر فاصله دور هر پنجره و شکاف بیرونی بر فاصله دور هر فضای کاری تاثیر می‌گذارد.\& شکاف‌های بیرونی علاوه بر شکاف‌های درونی اعمال می‌شوند.\& برای کاهش یا حذف شکاف‌های بیرونی، می‌توان شکاف‌های بیرونی را روی یک مقدار منفی تنظیم کرد.\& شکاف‌های \fIouter\fR همچنین می‌توانند به ازای هر ضلع با \fItop\fR، \fIright\fR، \fIbottom\fR، و \fIleft\fR یا در هر جهت با \fIhorizontal\fR و \fIvertical\fR مشخص شوند.\& .PP این تنها بر فضاهای کاری جدید تاثیر می‌گذارد، و زمانی استفاده می‌شود که فضای کاری تنظیمات شکاف‌های اختصاصی خود را نداشته باشد (ببینید: workspace gaps ...).\& .PP .RE \fBhide_edge_borders\fR [--i3] none|vertical|horizontal|both|smart|smart_no_gaps .RS 4 حاشیه‌های پنجره مجاور لبه‌های صفحه را پنهان می‌کند.\& پیش‌فرض \fInone\fR است.\& گزینه \fI--i3\fR رفتار سازگار با i3 را برای پنهان کردن نوار عنوان در ظرف‌های زبانه‌ای و انباشته با یک فرزند فعال می‌کند.\& گزینه‌های \fIsmart\fR|\fIsmart_no_gaps\fR معادل با تنظیم \fIsmart_borders\fR smart|no_gaps و \fIhide_edge_borders\fR none هستند.\& .PP .RE \fBinput\fR .RS 4 برای جزئیات درباره زیردستورات ورودی، به \fBsway-input\fR(5) مراجعه کنید.\& .PP می‌توان از * به جای یک نام دستگاه خاص برای پیکربندی تمام دستگاه‌های ورودی استفاده کرد.\& فهرستی از نام‌های دستگاه‌های ورودی ممکن است از طریق \fBswaymsg -t get_inputs\fR به دست آید.\& .PP .RE \fBseat\fR .RS 4 برای جزئیات درباره زیردستورات نشست، به \fBsway-input\fR(5) مراجعه فرمایید.\& .PP .RE \fBkill\fR .RS 4 ظرف در حال حاضر فوکوس‌شده و تمام فرزندان آن را می‌بندد (می‌کشد).\& .PP .RE \fBsmart_borders\fR on|no_gaps|off .RS 4 اگر smart_borders برابر با \fIon\fR باشد، حاشیه‌ها تنها در صورتی فعال می‌شوند که فضای کاری بیش از یک فرزند مرئی داشته باشد.\& اگر smart_borders روی \fIno_gaps\fR تنظیم شود، حاشیه‌ها تنها در صورتی فعال خواهند شد که فضای کاری بیش از یک فرزند مرئی داشته باشد و شکاف‌ها برابر با صفر باشند.\& .PP .RE \fBsmart_gaps\fR on|off|toggle|inverse_outer .RS 4 اگر smart_gaps روی \fIon\fR باشد، شکاف‌ها تنها در صورتی فعال می‌شوند که یک فضای کاری بیش از یک فرزند داشته باشد.\& اگر smart_gaps روی \fIinverse_outer\fR باشد، شکاف‌های بیرونی تنها در صورتی فعال می‌شوند که یک فضای کاری دقیقاً یک فرزند داشته باشد.\& .PP .RE \fBmark\fR --add|--replace [--toggle] .RS 4 نشانه‌ها (Marks) برچسب‌های دلخواهی هستند که می‌توانند برای شناسایی پنجره‌های خاص و سپس پرش به آن‌ها در زمانی دیگر استفاده شوند.\& هر \fIidentifier\fR تنها می‌تواند روی یک پنجره واحد در یک زمان تنظیم شود زیرا به عنوان یک شناسه یکتا عمل می‌کند.\& به طور پیش‌فرض، \fBmark\fR مقدار \fIidentifier\fR را به عنوان تنها نشانه روی یک پنجره تنظیم می‌کند.\& پرچم \fI--add\fR در عوض \fIidentifier\fR را به فهرست نشانه‌های کنونی برای آن پنجره می‌افزاید.\& اگر \fI--toggle\fR مشخص شود، دستور در صورتی که پنجره از قبل نشانه‌گذاری شده باشد، \fIidentifier\fR را حذف می‌کند.\& .PP .RE \fBmode\fR .RS 4 به حالت مشخص‌شده تغییر وضعیت می‌دهد.\& حالت پیش‌فرض \fIdefault\fR است.\& .PP .RE \fBmode\fR [--pango_markup] .RS 4 تنها زیردستورات معتبر عبارتند از \fBbindsym\fR، \fBbindcode\fR، \fBbindswitch\fR، و \fBset\fR.\& اگر \fI--pango_markup\fR داده شود، آنگاه \fImode\fR به عنوان نشانه‌گذاری pango تفسیر خواهد شد.\& .PP .RE \fBmouse_warping\fR output|container|none .RS 4 اگر \fIoutput\fR مشخص شود، هنگامی که فوکوس را میان خروجی‌ها جابه‌جا می‌کنید، ماوس به خروجی‌های جدید منتقل می‌شود.\& اگر \fIcontainer\fR مشخص شود، ماوس هنگام جابه‌جایی به وسط ظرف منتقل می‌گردد.\& پیش‌فرض \fIoutput\fR است.\& .PP .RE \fBno_focus\fR .RS 4 از فوکوس خودکار پنجره‌های منطبق با در زمان ایجاد آن‌ها جلوگیری می‌کند.\& این بر نخستین پنجره در یک فضای کاری تاثیری ندارد.\& .PP .RE \fBoutput\fR .RS 4 برای جزئیات درباره زیردستورات خروجی، به \fBsway-output\fR(5) مراجعه کنید.\& .PP می‌توان از * به جای یک نام خروجی خاص برای پیکربندی تمام خروجی‌ها استفاده کرد.\& فهرستی از نام‌های خروجی ممکن است از طریق \fBswaymsg -t get_outputs\fR به دست آید.\& .PP .RE \fBpopup_during_fullscreen\fR smart|ignore|leave_fullscreen .RS 4 تعیین می‌کند هنگامی که یک پنجره تمام‌صفحه یک کادر محاوره‌ای (dialog) باز می‌کند چه کاری انجام شود.\& اگر \fIsmart\fR باشد (پیش‌فرض)، کادر محاوره‌ای نمایش داده خواهد شد.\& اگر \fIignore\fR باشد، کادر محاوره‌ای رندر نخواهد شد.\& اگر \fIleave_fullscreen\fR باشد، پنجره از حالت تمام‌صفحه خارج می‌شود و کادر محاوره‌ای رندر خواهد شد.\& .PP .RE \fBprimary_selection\fR enabled|disabled .RS 4 کلیپ‌بورد انتخاب اولیه (primary selection) را فعال یا غیرفعال می‌کند.\& تنها در زمان راه‌اندازی قابل پیکربندی است.\& پیش‌فرض \fIenabled\fR است.\& .PP .RE \fBset\fR $ .RS 4 متغیر $\fIname\fR را روی \fIvalue\fR تنظیم می‌کند.\& می‌توانید از متغیر جدید در آرگومان‌های دستورات آینده استفاده نمایید.\& هنگامی که متغیر استفاده می‌شود، می‌تواند با یک $ اضافی گریز داده شود (یعنی $$\fIname\fR) تا جایگزینی به جای زمان خواندن پیکربندی در زمان اجرا اتفاق بیفتد.\& با این حال، جایگزینی متغیر در زمان اجرا همیشه منطقی نیست زیرا برخی آرگومان‌ها باید در زمان پیکربندی مشخص باشند.\& .PP .RE \fBshow_marks\fR yes|no .RS 4 اگر \fBshow_marks\fR روی yes باشد، نشانه‌ها در حاشیه‌های پنجره نمایش داده خواهند شد.\& هر نشانه‌ای که با خط زیرین (_) آغاز شود حتی اگر \fBshow_marks\fR روی yes باشد رسم نخواهد شد.\& پیش‌فرض \fIyes\fR است.\& .PP .RE \fBopacity\fR [set|plus|minus] .RS 4 میزان کدر بودن (شفافیت) پنجره را بین ۰ (کاملاً شفاف) و ۱ (کاملاً کدر) تنظیم می‌کند.\& اگر عملیات حذف شود، از \fIset\fR استفاده خواهد شد.\& .PP .RE \fBtiling_drag\fR enable|disable|toggle .RS 4 تعیین می‌کند که آیا ظرف‌های کاشی‌کاری‌شده می‌توانند با ماوس کشیده (drag) شوند یا خیر.\& اگر \fIenabled\fR باشد (پیش‌فرض)، کلید تغییردهنده \fIfloating_mod\fR می‌تواند برای کشیدن ظرف‌های کاشی‌کاری‌شده و همچنین شناور استفاده شود.\& استفاده از دکمه چپ ماوس روی نوارهای عنوان بدون \fIfloating_mod\fR نیز امکان کشیدن ظرف را فراهم می‌سازد.\& مقدار \fItoggle\fR نباید در فایل پیکربندی استفاده شود.\& .PP .RE \fBtiling_drag_threshold\fR .RS 4 آستانه‌ای را تعیین می‌کند که برای کشیده شدن یک ظرف از طریق نوار عنوان آن باید از آن فراتر رفت.\& اگر \fIfloating_mod\fR استفاده شود یا اگر \fItiling_drag\fR روی \fIdisable\fR تنظیم شده باشد، این مورد هیچ تاثیری ندارد.\& هنگامی که یک بار از آستانه فراتر رفت، کشیدن آغاز می‌شود و مکان‌نما می‌تواند بدون توقف کشیدن به داخل آستانه بازگردد.\& \fIthreshold\fR در مقیاس خروجی که مکان‌نما روی آن قرار دارد ضرب می‌شود.\& پیش‌فرض ۹ است.\& .PP .RE \fBtitle_align\fR left|center|right .RS 4 تراز عنوان را تنظیم می‌کند.\& اگر \fIright\fR انتخاب شود و \fIshow_marks\fR روی \fIyes\fR تنظیم شده باشد، نشانه‌ها به جای سمت راست در سمت چپ نشان داده خواهند شد.\& .PP .RE \fBunbindswitch\fR : .RS 4 یک اتصال را برای زمانی که به تغییر می‌کند حذف می‌نماید.\& .PP .RE \fBunbindgesture\fR [--exact] [--input-device=] [:][:directions] .RS 4 یک اتصال را برای ترکیب مشخص‌شده از \fIgesture\fR، \fIfingers\fR و \fIdirections\fR حذف می‌کند.\& .PP .RE \fBunbindsym\fR [--whole-window] [--border] [--exclude-titlebar] [--release] [--locked] [--to-code] [--input-device=] .RS 4 اتصال برای \fIkey combo\fR را که پیش‌تر با پرچم‌های داده‌شده متصل شده بود حذف می‌کند.\& اگر \fIinput-device\fR داده شود، تنها اتصال برای آن دستگاه ورودی لغو خواهد شد.\& .PP \fBunbindcode\fR [--whole-window] [--border] [--exclude-titlebar] [--release] [--locked] [--input-device=] نیز برای لغو اتصال با کدهای کلید/دکمه به جای نام‌های کلید/دکمه در دسترس است.\& .PP .RE \fBunmark\fR [] .RS 4 دستور \fBunmark\fR شناسه \fIidentifier\fR را از فهرست نشانه‌های کنونی روی یک پنجره حذف می‌کند.\& اگر \fIidentifier\fR حذف شود، تمام نشانه‌ها حذف می‌گردند.\& .PP .RE \fBurgent\fR enable|disable|allow|deny .RS 4 استفاده از \fIenable\fR یا \fIdisable\fR به صورت دستی وضعیت اضطراری پنجره را تنظیم یا لغو می‌کند.\& استفاده از \fIallow\fR یا \fIdeny\fR توانایی پنجره را برای اضطراری قرار دادن خود کنترل می‌کند.\& به طور پیش‌فرض، پنجره‌ها مجاز به تنظیم وضعیت اضطراری خود هستند.\& .PP .RE \fBworkspace\fR [--no-auto-back-and-forth] [number] <[num:]name> .RS 4 به فضای کاری مشخص‌شده جابه‌جا می‌شود.\& بخش \fInum:\fR نام اختیاری است و برای ترتیب‌بندی استفاده خواهد شد.\& اگر \fInum:\fR داده نشود و \fIname\fR یک عدد باشد، آنگاه برای ترتیب‌بندی نیز استفاده خواهد شد.\& .PP اگر گزینه \fIno-auto-back-and-forth\fR داده شود، در صورتی که فضای کاری از قبل فوکوس شده باشد و \fIworkspace_auto_back_and_forth\fR فعال باشد، این دستور عملیات بازگشت و رفت را انجام نخواهد داد.\& .PP اگر کلیدواژه \fInumber\fR مشخص شود و یک فضای کاری با آن شماره از قبل وجود داشته باشد، آنگاه فضای کاری با آن شماره استفاده خواهد شد.\& اگر فضای کاری با آن شماره وجود نداشته باشد، یک فضای کاری جدید با نام \fIname\fR ایجاد می‌شود.\& .PP .RE \fBworkspace\fR prev|next .RS 4 به فضای کاری بعدی در خروجی کنونی یا در خروجی بعدی در صورتی که در حال حاضر در آخرین فضای کاری باشد جابه‌جا می‌شود.\& .PP .RE \fBworkspace\fR prev_on_output|next_on_output .RS 4 به فضای کاری بعدی در خروجی کنونی جابه‌جا می‌شود.\& .PP .RE \fBworkspace\fR back_and_forth .RS 4 به فضای کاری که پیش‌تر فوکوس شده بود جابه‌جا می‌شود.\& .PP .RE \fBworkspace\fR gaps inner|outer|horizontal|vertical|top|right|bottom|left .RS 4 مشخص می‌کند که فضای کاری \fIname\fR هنگام ایجاد باید تنظیمات شکاف‌های داده‌شده را داشته باشد.\& .PP این دستور بر فضاهای کاری موجود تاثیری ندارد.\& برای تغییر شکاف‌های یک فضای کاری موجود، از دستور \fIgaps\fR استفاده کنید.\& .PP .RE \fBworkspace\fR output .RS 4 مشخص می‌کند که فضای کاری \fIname\fR باید روی خروجی‌های مشخص‌شده (\fIoutputs\fR) نمایش داده شود.\& چندین خروجی می‌توانند فهرست شوند و نخستین خروجی در دسترس استفاده خواهد شد.\& اگر فضای کاری روی خروجی پایین‌تری در فهرست قرار گیرد و خروجی با اولویت بالاتری در دسترس قرار گیرد، فضای کاری به خروجی با اولویت بالاتر منتقل خواهد شد.\& .PP این دستور بر فضاهای کاری موجود تاثیری ندارد.\& برای جابه‌جایی یک فضای کاری موجود، از دستور \fImove\fR در ترکیب با معیارهای \fIworkspace\fR (تنها فضاهای کاری غیرخالی) یا دستور \fIworkspace\fR (برای تغییر به فضای کاری قبل از جابه‌جایی) استفاده کنید.\& .PP .RE \fBworkspace_auto_back_and_forth\fR yes|no .RS 4 هنگامی که \fIyes\fR باشد، تکرار یک دستور تعویض فضای کاری به فضای کاری قبلی بازمی‌گردد.\& برای نمونه، اگر در حال حاضر در فضای کاری ۱ هستید، به فضای کاری ۲ بروید، سپس دستور \fBworkspace 2\fR را دوباره اجرا کنید، به فضای کاری ۱ بازگردانده خواهید شد.\& پیش‌فرض \fIno\fR است.\& .PP .RE .SH "معیارها (CRITERIA)" .PP یک معیار رشته‌ای است به عنوان نمونه به فرم: .PP .nf .RS 4 [app_id="some-application" title="[Rr]egex\&.*"] .fi .RE .PP این رشته حاوی یک یا چند جفت صفت/مقدار (جداشده با فاصله) است.\& آن‌ها توسط برخی دستورات برای انتخاب پنجره‌هایی که باید عملیات روی آن‌ها اجرا شود استفاده می‌شوند.\& تمام صفت‌ها برای تطابق معیار باید مطابقت داشته باشند.\& معیارها در میان دستوراتی که با \fB,\fR جدا شده‌اند حفظ می‌شوند، اما برای دستوراتی که با \fB;\fR جدا شده‌اند بازنشانی خواهند شد (و در صورت تمایل، امکان معیارهای جدید را فراهم می‌کنند).\& .PP معیارها ممکن است با دستورات \fBfor_window\fR یا \fBassign\fR برای تعیین عملیات قابل انجام روی پنجره‌های جدید استفاده شوند.\& یک معیار همچنین ممکن است برای انجام دستورات خاص (دستوراتی که معمولاً روی یک پنجره عمل می‌کنند) روی تمام پنجره‌هایی که با آن معیار مطابقت دارند استفاده شود.\& برای نمونه: .PP فوکوس روی پنجره‌ای با نشانه‌گذاری "IRC": .PP .nf .RS 4 [con_mark="IRC"] focus .fi .RE .PP بستن تمام پنجره‌هایی که عنوان آن‌ها حاوی "Emacs" است: .PP .nf .RS 4 [title="Emacs"] kill .fi .RE .PP چندین صفت امکان استفاده از عبارت‌های باقاعده (Regular Expressions) را فراهم می‌سازند.\& این‌ها از عبارت‌های باقاعده سازگار با پرل (PCRE2) استفاده می‌کنند که در \fBpcre2pattern\fR(3) مستندسازی شده و در \fBpcre2syntax\fR(3) خلاصه شده‌اند.\& برای مثال، این دستور تمام پنجره‌هایی را که عنوان آن‌ها به "sway" یا "Sway" ختم می‌شود به فضای کاری ۱ منتقل می‌کند: .PP .nf .RS 4 [title="[Ss]way$"] move workspace 1 .fi .RE .PP ممکن است بخواهید از دستور swaymsg -t get_tree برای یافتن مقادیر این ویژگی‌ها در عمل برای برنامه‌های خود استفاده کنید.\& .PP ویژگی‌های زیر می‌توانند برای تطبیق استفاده شوند: .PP \fBall\fR .RS 4 با تمام پنجره‌ها مطابقت دارد.\& .PP .RE \fBapp_id\fR .RS 4 مقدار را با شناسه برنامه (app id) مقایسه می‌کند.\& می‌تواند یک عبارت باقاعده باشد.\& اگر مقدار __focused__ باشد، شناسه برنامه باید همانند پنجره در حال حاضر فوکوس‌شده باشد.\& ویژگی \fIapp_id\fR مخصوص برنامه‌های ویلند است.\& .PP .RE \fBclass\fR .RS 4 مقدار را با کلاس پنجره مقایسه می‌کند.\& می‌تواند یک عبارت باقاعده باشد.\& اگر مقدار __focused__ باشد، کلاس پنجره باید همانند پنجره در حال حاضر فوکوس‌شده باشد.\& ویژگی \fIclass\fR مخصوص برنامه‌های X11 است و نیازمند XWayland است.\& .PP .RE \fBcon_id\fR .RS 4 با شناسه ظرف داخلی مقایسه می‌کند که می‌توانید آن را از طریق IPC بیابید.\& اگر مقدار __focused__ باشد، شناسه باید همانند پنجره در حال حاضر فوکوس‌شده باشد.\& .PP .RE \fBcon_mark\fR .RS 4 با نشانه‌های پنجره مقایسه می‌کند.\& می‌تواند یک عبارت باقاعده باشد.\& .PP .RE \fBfloating\fR .RS 4 با پنجره‌های شناور مطابقت دارد.\& .PP .RE \fBid\fR .RS 4 مقدار را با شناسه پنجره X11 مقایسه می‌کند.\& باید عددی باشد.\& شناسه id مخصوص برنامه‌های X11 است و نیازمند XWayland است.\& .PP .RE \fBinstance\fR .RS 4 مقدار را با نمونه پنجره (window instance) مقایسه می‌کند.\& می‌تواند یک عبارت باقاعده باشد.\& اگر مقدار __focused__ باشد، نمونه پنجره باید همانند پنجره در حال حاضر فوکوس‌شده باشد.\& ویژگی instance مخصوص برنامه‌های X11 است و نیازمند XWayland است.\& .PP .RE \fBpid\fR .RS 4 مقدار را با شناسه فرآیند (PID) پنجره مقایسه می‌کند.\& باید عددی باشد.\& .PP .RE \fBshell\fR .RS 4 مقدار را با شل پنجره مقایسه می‌کند، مانند "xdg_shell" یا "xwayland".\& می‌تواند یک عبارت باقاعده باشد.\& اگر مقدار __focused__ باشد، شل باید همانند پنجره در حال حاضر فوکوس‌شده باشد.\& .PP .RE \fBtag\fR .RS 4 مقدار را با برچسب (tag) مقایسه می‌کند.\& ویژگی \fItag\fR مخصوص برنامه‌های ویلند است.\& .PP .RE \fBtiling\fR .RS 4 با پنجره‌های کاشی‌کاری‌شده مطابقت دارد.\& .PP .RE \fBtitle\fR .RS 4 با عنوان پنجره مقایسه می‌کند.\& می‌تواند یک عبارت باقاعده باشد.\& اگر مقدار __focused__ باشد، عنوان پنجره باید همانند پنجره در حال حاضر فوکوس‌شده باشد.\& .PP .RE \fBurgent\fR .RS 4 وضعیت اضطراری پنجره را مقایسه می‌کند.\& می‌تواند \fIfirst\fR، \fIlast\fR، \fIlatest\fR، \fInewest\fR، \fIoldest\fR یا \fIrecent\fR باشد.\& .PP .RE \fBwindow_role\fR .RS 4 با نقش پنجره (WM_WINDOW_ROLE) مقایسه می‌کند.\& می‌تواند یک عبارت باقاعده باشد.\& اگر مقدار __focused__ باشد، نقش پنجره باید همانند پنجره در حال حاضر فوکوس‌شده باشد.\& ویژگی window_role مخصوص برنامه‌های X11 است و نیازمند XWayland است.\& .PP .RE \fBwindow_type\fR .RS 4 با نوع پنجره (_NET_WM_WINDOW_TYPE) مقایسه می‌کند.\& مقادیر ممکن عبارتند از normal، dialog، utility، toolbar، splash، menu، dropdown_menu، popup_menu، tooltip و notification.\& ویژگی window_type مخصوص برنامه‌های X11 است و نیازمند XWayland است.\& .PP .RE \fBworkspace\fR .RS 4 با نام فضای کاری برای این پنجره مقایسه می‌کند.\& می‌تواند یک عبارت باقاعده باشد.\& اگر مقدار __focused__ باشد، تمام پنجره‌های موجود در فضای کاری در حال حاضر فوکوس‌شده مطابقت دارند.\& .PP .RE \fBsandbox_engine\fR .RS 4 با موتور ایزوله‌سازی (sandbox) مرتبط مقایسه می‌کند.\& می‌تواند یک عبارت باقاعده باشد.\& اگر مقدار __focused__ باشد، موتور ایزوله‌سازی باید همانند پنجره در حال حاضر فوکوس‌شده باشد.\& .PP .RE \fBsandbox_app_id\fR .RS 4 با شناسه برنامه ارائه‌شده توسط موتور ایزوله‌سازی مرتبط مقایسه می‌کند.\& می‌تواند یک عبارت باقاعده باشد.\& اگر مقدار __focused__ باشد، شناسه برنامه ایزوله‌شده باید همانند پنجره در حال حاضر فوکوس‌شده باشد.\& .PP .RE \fBsandbox_instance_id\fR .RS 4 با شناسه نمونه ارائه‌شده توسط موتور ایزوله‌سازی مرتبط مقایسه می‌کند.\& می‌تواند یک عبارت باقاعده باشد.\& اگر مقدار __focused__ باشد، شناسه نمونه ایزوله‌شده باید همانند پنجره در حال حاضر فوکوس‌شده باشد.\& .PP .RE .SH "همچنین ببینید (SEE ALSO)" .PP \fBsway\fR(1) \fBsway-input\fR(5) \fBsway-output\fR(5) \fBsway-bar\fR(5) \fBsway-ipc\fR(7) \fBpcre2pattern\fR(3) \fBpcre2syntax\fR(3)