waybar-wlr-taskbar(5)         File Formats Manual        waybar-wlr-taskbar(5)

نام (NAME)
       waybar - ماژول نوار وظیفه wlr (wlr taskbar module)

توضیحات (DESCRIPTION)
       ماژول taskbar برنامه‌های در حال حاضر باز را نمایش می‌دهد. این ماژول
       نیازمند یک کامپوزیتور است که رابط foreign-toplevel-manager را پیاده‌سازی
       کرده باشد.

پیکربندی (CONFIGURATION)
       با نام wlr/taskbar آدرس‌دهی می‌شود

       all-outputs:
       نوع: bool
       پیش‌فرض: false
       اگر روی false تنظیم شود، برنامه‌های موجود در خروجی فعلی waybar نمایش
       داده می‌شوند. در غیر این صورت، همه برنامه‌ها نشان داده خواهند شد.

       format:
       نوع: string
       پیش‌فرض: {icon}
       قالب نحوه نمایش اطلاعات.

       icon-theme:
       نوع: array|string
       نام‌های تم‌های آیکون که باید برای یافتن یک آیکون استفاده شوند. فهرست از
       چپ به راست پیمایش خواهد شد. در صورت تعیین نشدن، پیش‌فرض سیستم استفاده
       خواهد شد.

       icon-size:
       نوع: integer
       پیش‌فرض: 16
       اندازه آیکون.

       markup:
       نوع: bool
       پیش‌فرض: false
       اگر روی true تنظیم شود، نشانه‌گذاری پانگو (pango markup) در format و
       tooltip-format پذیرفته می‌شود.

       tooltip:
       نوع: bool
       پیش‌فرض: true
       اگر روی false تنظیم شود، هیچ تول‌تیپی نمایش داده نخواهد شد.

       tooltip-format:
       نوع: string
       پیش‌فرض: {title}
       قالب نحوه نمایش اطلاعات در تول‌تیپ.

       active-first:
       نوع: bool
       پیش‌فرض: false
       اگر روی true تنظیم شود، همیشه وظایف در نوار وظیفه به‌گونه‌ای مرتب می‌شوند
       که برنامه فعال فعلی اول باشد. در غیر این صورت مرتب‌سازی مجدد انجام
       نمی‌شود.

       sort-by-app-id:
       نوع: bool
       پیش‌فرض: false
       اگر روی true تنظیم شود، وظایف بر اساس app_id خود گروه‌بندی می‌شوند.
       نمی‌تواند همراه با 'active-first' استفاده شود.

       on-click:
       نوع: string
       عملیاتی که باید هنگام کلیک با کلید چپ ماوس روی دکمه برنامه اجرا شود.

       on-click-middle:
       نوع: string
       عملیاتی که باید هنگام کلیک با کلید میانی ماوس روی دکمه برنامه اجرا شود.

       on-click-right:
       نوع: string
       عملیاتی که باید هنگام کلیک با کلید راست ماوس روی دکمه برنامه اجرا شود.

       on-update:
       نوع: string
       دستوری که هنگام به‌روزرسانی ماژول اجرا می‌شود.

       ignore-list:
       نوع: array
       فهرستی از app_idها/عنوان‌ها که باید پنهان باشند.

       app_ids-mapping:
       نوع: object
       دیکشنری از app_id برای جایگزینی.

       rewrite:
       نوع: object
       قوانین بازنویسی قالب خروجی ماژول. بخش قوانین بازنویسی (REWRITE RULES)
       را ببینید.

جایگزین‌های قالب (FORMAT REPLACEMENTS)
       {icon}: آیکون برنامه.

       {name}: نام برنامه مطابق با فایل desktop در صورتی که فایل desktop مناسب
       یافت شود، در غیر این صورت مشابه {app_id} است.

       {title}: عنوان برنامه.

       {app_id}: شناسه برنامه (app_id == نام برنامه).

       {state}: وضعیت برنامه (minimized، maximized، active، fullscreen).

       {short_state}: وضعیت برنامه (minimize == m، maximized == M، active ==
       A، fullscreen == F) که به‌صورت یک کاراکتر نمایش داده می‌شود.

عملیات‌های کلیک (CLICK ACTIONS)
       activate: آوردن برنامه به پیش‌زمینه.

       minimize: تغییر وضعیت کمینه‌سازی برنامه.

       minimize-raise: آوردن برنامه به پیش‌زمینه یا تغییر وضعیت کمینه‌سازی آن.

       maximize: تغییر وضعیت بیشینه‌سازی برنامه.

       fullscreen: تغییر وضعیت تمام‌صفحه برنامه.

       close: بستن برنامه.

قوانین بازنویسی (REWRITE RULES)
       گزینه rewrite یک شیء است که در آن کلیدها عبارت‌های منظم (regex) و مقادیر
       قوانین بازنویسی در صورت تطابق عبارت هستند. قوانین می‌توانند شامل ارجاع
       به بخش‌های منطبق‌شده (captures) عبارت باشند.

       عبارات منظم و جایگزینی از قوانین ECMA-script پیروی می‌کنند.

       اگر هیچ عبارتی مطابقت نداشته باشد، قالب خروجی بدون تغییر باقی می‌ماند.

       عبارت‌های نامعتبر (مانند پرانتزهای جفت‌نشده) نادیده گرفته می‌شوند.

مثال‌ها (EXAMPLES)
           "wlr/taskbar": {
                "format": "{icon}",
                "icon-size": 14,
                "icon-theme": "Numix-Circle",
                "tooltip-format": "{title}",
                "on-click": "activate",
                "on-click-middle": "close",
                "ignore-list": [
                    "Alacritty"
                ],
                "app_ids-mapping": {
                     "firefoxdeveloperedition": "firefox-developer-edition"
                },
                "rewrite": {
                     "Firefox Web Browser": "Firefox",
                     "Foot Server": "Terminal"
                }
           }

استایل (STYLE)
       •   #taskbar
       •   #taskbar button
       •   #taskbar button.maximized
       •   #taskbar button.minimized
       •   #taskbar button.active
       •   #taskbar button.fullscreen

                                  2026-08-31             waybar-wlr-taskbar(5)