.\" 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
.\" Begin generated content:
.TH "waybar\-hyprland\-workspaces" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
waybar\-hyprland\-workspaces \- ماژول فضاهای کاری hyprland در waybar
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
ماژول
\fBworkspaces\fR
فضاهای کاری در حال استفاده فعلی را در کامپوزیتور Hyprland نمایش می‌دهد.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
با شناسه
\fBhyprland/workspaces\fR
آدرس‌دهی می‌شود.\&
.PP
\fBformat\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: {id}
.br
قالب، نحوه نمایش اطلاعات.\&
.PP
\fBformat\-icons\fR:
.br
نوع: آرایه (array)
.br
بر اساس شناسه و وضعیت فضای کاری، آیکون متناظر انتخاب می‌شود.\& بخش \fBآیکون‌ها (ICONS)\fR را ببینید.\&
.PP
\fBwindow\-rewrite\fR:
.br
نوع: شیء (object)
.br
قواعد عبارت باقاعده (Regex) برای نگاشت کلاس پنجره به یک آیکون یا روش ترجیحی نمایش برای پنجره‌های یک فضای کاری.\&
.RS 4
کلیدها همان قواعد هستند، در حالی که مقادیر روش‌های نمایش می‌باشند.\& مقادیر می‌توانند از جای‌نگه‌دارهای {class} و {title} به ترتیب برای استفاده از کلاس و/یا عنوان اصلی پنجره بهره ببرند.\&
قواعد می‌توانند `class<.\&.\&.\&>`، `title<.\&.\&.\&>`، یا هر دو را برای تنظیم دقیق‌تر تطبیق مشخص کنند.\&
می‌توانید یک مقدار خالی به یک قاعده اختصاص دهید تا از تولید هرگونه بازنمایی در فضاهای کاری نادیده گرفته شود.\&
.br
اگر \fBworkspace\-taskbar.\&enable\fR روی true تنظیم شده باشد، این تنظیم نادیده گرفته می‌شود.\&
.PP
.RE
\fBwindow\-rewrite\-default\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: "?\&"
.br
روش پیش‌فرض نمایش برای پنجره یک فضای کاری.\& این مقدار برای پنجره‌هایی استفاده می‌شود که کلاس آن‌ها با هیچ‌یک از قواعد در \fBwindow\-rewrite\fR مطابقت ندارد.\&
.br
اگر \fBworkspace\-taskbar.\&enable\fR روی true تنظیم شده باشد، این تنظیم نادیده گرفته می‌شود.\&
.PP
\fBformat\-window\-separator\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: " "
.br
جداکننده‌ای که بین پنجره‌ها در یک فضای کاری استفاده می‌شود.\&
.br
اگر \fBworkspace\-taskbar.\&enable\fR روی true تنظیم شده باشد، این تنظیم نادیده گرفته می‌شود.\&
.PP
\fBworkspace\-taskbar\fR:
.br
نوع: شیء (object)
.br
شامل تنظیمات نوار وظیفه فضای کاری است؛ حالتی جایگزین برای ماژول فضاهای کاری که آیکون‌های پنجره را به جای متن به صورت تصویر نمایش می‌دهد.\&
.RS 4
.PP
.RS 4
\fBenable\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
حالت نوار وظیفه فضای کاری را فعال می‌کند.\&
.PP
\fBupdate\-active\-window\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
اگر true باشد، پنجره فعال/دارای تمرکز دارای کلاس '\&active'\& خواهد بود.\& ممکن است به دلیل بازترسیم‌های مکررتر باعث مصرف بیشتر CPU شود.\&
.PP
\fBreverse\-direction\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
اگر true باشد، پنجره‌های نوار وظیفه به ترتیب معکوس اضافه می‌شوند (اگر جهت‌گیری افقی باشد از راست به چپ، و اگر عمودی باشد از پایین به بالا).\&
.PP
\fBactive\-window\-position\fR:
.br
نوع: "none" | "first" | "last"
.br
پیش‌فرض: "none"
.br
اگر روی "first" تنظیم شود، پنجره فعال به ابتدای نوار وظیفه منتقل می‌شود.\& اگر روی "last" تنظیم شود، به انتهای آن منتقل خواهد شد.\& این گزینه تنها زمانی کار می‌کند که \fBupdate\-active\-window\fR روی true تنظیم شده باشد.\&
.PP
\fBformat\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: {icon}
.br
قالب مورد استفاده برای هر پنجره در نوار وظیفه فضای کاری.\& جای‌نگه‌دارهای موجود عبارتند از {icon} و {title}.\&
.PP
\fBicon\-size\fR:
.br
نوع: عدد صحیح (int)
.br
پیش‌فرض: 16
.br
اندازه آیکون‌ها در نوار وظیفه فضای کاری.\&
.PP
\fBicon\-theme\fR:
.br
نوع: رشته یا آرایه (string | array)
.br
پیش‌فرض: []
.br
تم آیکون مورد استفاده برای نوار وظیفه فضای کاری.\& اگر یک آرایه ارائه شود، اولین تم یافت‌شده برای یک آیکون مشخص استفاده خواهد شد.\& اگر تمی یافت نشود (یا آرایه خالی باشد)، تم آیکون پیش‌فرض استفاده می‌شود.\&
.PP
\fBorientation\fR:
.br
نوع: "horizontal" | "vertical"
.br
پیش‌فرض: horizontal
.br
جهتی که نوار وظیفه فضای کاری در آن نمایش داده می‌شود.\&
.PP
\fBignore\-list\fR:
.br
نوع: آرایه (array)
.br
پیش‌فرض: []
.br
الگوهای عبارت باقاعده (Regex) برای تطبیق با کلاس پنجره یا عنوان پنجره.\& اگر کلاس یا عنوان یک پنجره با هر یک از الگوها مطابقت داشته باشد، نمایش داده نخواهد شد.\&
.PP
\fBon\-click\-window\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: ""
.br
دستوری که هنگام کلیک روی یک پنجره اجرا می‌شود.\& جای‌نگه‌دارهای موجود عبارتند از:
.br
\- {address} آدرس هایپرلند پنجره کلیک‌شده.\&
.br
\- {button} شماره دکمه فشرده‌شده، نشانی https://api.\&gtkd.\&org/gdk.\&c.\&types.\&GdkEventButton.\&button.\&html را ببینید.\&
.br
برای مشاهده یک مثال کامل نشانی https://github.\&com/Alexays/Waybar/wiki/Module:\-Hyprland#workspace\-taskbars\-example را ببینید.\&
.PP
.RE
.RE
\fBshow\-special\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
اگر روی true تنظیم شود، فضاهای کاری ویژه (special) نمایش داده می‌شوند.\&
.PP
\fBspecial\-visible\-only\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
اگر این گزینه و show\-special هر دو روی true تنظیم شوند، فضاهای کاری ویژه تنها در صورت مرئی بودن نمایش داده خواهند شد.\&
.PP
\fBpersistent\-only\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
اگر روی true تنظیم شود، فقط فضاهای کاری ماندگار (persistent) روی نوار نمایش داده می‌شوند.\&
.PP
\fBall\-outputs\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
اگر روی false تنظیم شود، گروه فضاهای کاری تنها در خروجی اختصاص‌یافته نمایش داده می‌شود.\& در غیر این صورت، تمام گروه‌های فضای کاری نمایش داده می‌شوند.\&
.PP
\fBactive\-only\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
اگر روی true تنظیم شود، فقط فضای کاری فعال نمایش داده خواهد شد.\&
.PP
\fBmove\-to\-monitor\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
اگر روی true تنظیم شود، هنگام کلیک روی دکمه یک فضای کاری، آن فضای کاری روی مانیتور فعلی باز می‌شود.\&
.RS 4
در غیر این صورت، فضای کاری روی مانیتوری باز خواهد شد که پیش‌تر به آن اختصاص داده شده بود.\&
مشابه با استفاده از توزیع‌کننده `focusworkspaceoncurrentmonitor` به جای `workspace` در Hyprland.\&
.PP
.RE
\fBignore\-workspaces\fR:
.br
نوع: آرایه (array)
.br
پیش‌فرض: []
.br
عبارات باقاعده برای تطبیق با نام‌های فضاهای کاری.\& در صورت تطبیق، فضای کاری نمایش داده نخواهد شد.\& این گزینه بر \fBshow\-special\fR، \fBall\-outputs\fR و \fBactive\-only\fR اولویت دارد.\&
.PP
\fBsort\-by\fR:
.br
نوع: رشته (string)
.br
پیش‌فرض: "default"
.br
اگر روی number تنظیم شود، فضاهای کاری بر اساس شماره مرتب می‌شوند.\&
.RS 4
اگر روی name تنظیم شود، فضاهای کاری بر اساس نام مرتب می‌شوند.\&
اگر روی id تنظیم شود، فضاهای کاری بر اساس شناسه مرتب می‌شوند.\&
اگر روی special\-centered تنظیم شود، فضاهای کاری بر اساس رفتار پیش‌فرض همراه با قرارگیری فضاهای کاری ویژه در مرکز مرتب می‌شوند.\&
اگر هیچ‌کدام از این‌ها نباشد، فضاهای کاری با رفتار پیش‌فرض مرتب خواهند شد.\&
.PP
.RE
\fBexpand\fR:
.br
نوع: بولی (bool)
.br
پیش‌فرض: false
.br
به این ماژول امکان می‌دهد تا تمام فضای باقی‌مانده را به صورت پویا مصرف کند.\&
.PP
.SH "جایگزین‌های قالب (FORMAT REPLACEMENTS)"
.PP
\fB{id}\fR: شناسه فضای کاری اختصاص‌یافته توسط کامپوزیتور
.PP
\fB{name}\fR: نام فضای کاری اختصاص‌یافته توسط کامپوزیتور
.PP
\fB{icon}\fR: آیکون، طبق تعریف در \fBformat\-icons\fR.\&
.PP
.SH "آیکون‌ها (ICONS)"
.PP
علاوه بر تطبیق نام فضای کاری، مقادیر زیر برای \fBformat\-icons\fR قابل تنظیم هستند.\&
.PP
.PD 0
.IP \(bu 4
\fBdefault\fR: زمانی نشان داده می‌شود که هیچ تطبیق رشته‌ای پیدا نشود و هیچ‌یک از شرایط زیر آیکون تعریف‌شده‌ای نداشته باشند.\&
.IP \(bu 4
\fBactive\fR: زمانی نشان داده می‌شود که فضای کاری فعال باشد
.IP \(bu 4
\fBspecial\fR: روی فضاهای کاری ویژه غیرفعال نشان داده خواهد شد
.IP \(bu 4
\fBempty\fR: روی فضاهای کاری ماندگار خالیِ غیرفعال و غیرویژه نشان داده خواهد شد
.IP \(bu 4
\fBvisible\fR: روی فضاهای کاری که مرئی اما غیرفعال هستند نشان داده خواهد شد.\& برای نمونه: اگر بخواهید فضاهای کاری مرئی در سایر مانیتورها ظاهری مشابه با حالت فعال داشته باشند، مفید است.\&
.IP \(bu 4
\fBpersistent\fR: روی فضاهای کاری ماندگار غیرخالی نشان داده خواهد شد
.PD
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
.nf
.RS 4
"hyprland/workspaces": {
	"format": "{name}: {icon}",
	"format\-icons": {
		"1": "",
		"2": "",
		"3": "",
		"4": "",
		"5": "",
		"active": "",
		"default": ""
	},
	"persistent\-workspaces": {
		"*": 5, // 5 workspaces by default on every monitor
		"HDMI\-A\-1": 3 // but only three on HDMI\-A\-1
	}
}
.fi
.RE
.PP
.nf
.RS 4
"hyprland/workspaces": {
	"format": "{name}: {icon}",
	"format\-icons": {
		"1": "",
		"2": "",
		"3": "",
		"4": "",
		"5": "",
		"active": "",
		"default": ""
	},
	"persistent\-workspaces": {
		"*": [ 2,3,4,5 ], // 2\-5 on every monitor
		"HDMI\-A\-1": [ 1 ] // but only workspace 1 on HDMI\-A\-1
	}
}
.fi
.RE
.PP
.nf
.RS 4
"hyprland/workspaces": {
	"format": "{name}n{windows}",
	"format\-window\-separator": "n",
	"window\-rewrite\-default": "",
	"window\-rewrite": {
		"title<\&.*youtube\&.*>": "", // Windows whose titles contain "youtube"
		"class<firefox>": "", // Windows whose classes are "firefox"
		"class<firefox> title<\&.*github\&.*>": "", // Windows whose class is "firefox" and title contains "github"\&. Note that "class" always comes first\&.
		"foot": "", // Windows that contain "foot" in either class or title\&. For optimization reasons, it will only match against a title if at least one other window explicitly matches against a title\&.
		"code": "󰨞",
		"title<\&.* \- (\&.*) \- VSCodium>": "codium $1"  // captures part of the window title and formats it into output
	}
}
.fi
.RE
.PP
.nf
.RS 4
"hyprland/workspaces": {
	// Formatting omitted for brevity
	"ignore\-workspaces": [
		"(special:)?chrome\-sharing\-indicator"
	]
}
.fi
.RE
.PP
.SH "استایل (STYLE)"
.PP
.PD 0
.IP \(bu 4
\fB#workspaces\fR
.IP \(bu 4
\fB#workspaces button\fR
.IP \(bu 4
\fB#workspaces button.\&active\fR
.IP \(bu 4
\fB#workspaces button.\&empty\fR
.IP \(bu 4
\fB#workspaces button.\&visible\fR
.IP \(bu 4
\fB#workspaces button.\&persistent\fR
.IP \(bu 4
\fB#workspaces button.\&special\fR
.IP \(bu 4
\fB#workspaces button.\&urgent\fR
.IP \(bu 4
\fB#workspaces button.\&hosting\-monitor\fR (در صورتی اعمال می‌شود که workspace\-monitor == waybar\-monitor باشد)
.IP \(bu 4
\fB#workspaces .\&workspace\-label\fR
.IP \(bu 4
\fB#workspaces .\&taskbar\-window\fR (هر پنجره در نوار وظیفه، فقط در صورتی که '\&workspace\-taskbar.\&enable'\& مقدار true داشته باشد)
.IP \(bu 4
\fB#workspaces .\&taskbar\-window.\&active\fR (بر پنجره دارای تمرکز اعمال می‌شود، فقط در صورتی که '\&workspace\-taskbar.\&update\-active\-window'\& مقدار true داشته باشد)