نام (NAME)

waybar-bluetooth - ماژول بلوتوث در waybar

توضیحات (DESCRIPTION)

ماژول bluetooth اطلاعات مربوط به کنترل‌کننده بلوتوث و اتصالات آن را نمایش می‌دهد.

پیکربندی (CONFIGURATION)

با bluetooth فراخوانی می‌شود

controller:
نوع: رشته (string)
استفاده از کنترل‌کننده با نام مستعار (alias) تعریف‌شده. در غیر این صورت، یک کنترل‌کننده به‌صورت تصادفی استفاده می‌شود. توصیه می‌شود در صورتی که بیش از ۱ کنترل‌کننده در سیستم موجود است، تعریف شود.

format-device-preference:
نوع: آرایه (array)
رتبه‌بندی دستگاه‌های بلوتوث، آدرس‌دهی شده با نام مستعار آن‌ها. ترتیب از نخستین نمایش داده‌شده تا آخرین نمایش داده‌شده است.
اگر این گزینه پیکربندی تعریف نشده باشد یا هیچ‌یک از دستگاه‌های موجود در فهرست متصل نباشند، به نمایش آخرین دستگاه متصل بازمی‌گردد.

format:
نوع: رشته (string)
پیش‌فرض:  {status}
قالب نحوه نمایش اطلاعات. این قالب زمانی استفاده می‌شود که سایر قالب‌ها مشخص نشده باشند.

format-disabled:
نوع: رشته (string)
این قالب زمانی استفاده می‌شود که کنترل‌کننده نمایش داده‌شده غیرفعال باشد.

format-off:
نوع: رشته (string)
این قالب زمانی استفاده می‌شود که کنترل‌کننده نمایش داده‌شده خاموش باشد.

format-on:
نوع: رشته (string)
این قالب زمانی استفاده می‌شود که کنترل‌کننده نمایش داده‌شده روشن باشد اما هیچ دستگاهی متصل نباشد.

format-connected:
نوع: رشته (string)
این قالب زمانی استفاده می‌شود که کنترل‌کننده نمایش داده‌شده حداقل به ۱ دستگاه متصل باشد.

format-no-controller:
نوع: رشته (string)
این قالب زمانی استفاده می‌شود که هیچ کنترل‌کننده بلوتوثی یافت نشود.

format-icons:
نوع: آرایه/شیء (array/object)
بر اساس درصد کنونی باتری (بخش ویژگی آزمایشی درصد باتری (EXPERIMENTAL BATTERY PERCENTAGE FEATURE) را ببینید)، آیکون مربوطه انتخاب می‌شود.
ترتیب از low (کم) به high (زیاد) است. آیکون درصد کنونی باتری فقط در گزینه‌های پیکربندی *-connected-battery نمایش داده خواهد شد.
یا بر اساس وضعیت در صورتی که یک شیء باشد. اگر مشتقات آن (on، off، connected) تعریف نشده باشند، به وضعیت فعال (enabled) بازمی‌گردد.

rotate:
نوع: عدد صحیح (integer)
مقدار مثبت برای چرخاندن برچسب متنی (در گام‌های ۹۰ درجه).

max-length:
نوع: عدد صحیح (integer)
حداکثر طول بر حسب کاراکتر که ماژول باید نمایش دهد.

min-length:
نوع: عدد صحیح (integer)
حداقل طول بر حسب کاراکتر که ماژول باید بپذیرد.

align:
نوع: ممیز شناور (float)
تراز برچسب درون ماژول، که در آن 0 چپ‌چین و 1 راست‌چین است. اگر ماژول چرخانده شود، از جهت متن پیروی می‌کند.

justify:
نوع: رشته (string)
تراز متن درون برچسب ماژول، که گزینه‌های 'left' (چپ)، 'right' (راست) یا 'center' (وسط) را برای تعیین موقعیت می‌پذیرد.

on-click:
نوع: رشته (string)
دستوری که هنگام کلیک روی ماژول اجرا می‌شود.

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

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

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

on-scroll-down:
نوع: رشته (string)
دستوری که هنگام اسکرول به پایین روی ماژول اجرا می‌شود.

smooth-scrolling-threshold:
نوع: ممیز شناور با دقت مضاعف (double)
آستانه مورد استفاده هنگام اسکرول.

tooltip:
نوع: بولی (bool)
پیش‌فرض: true
گزینه‌ای برای غیرفعال کردن راهنمای شناور (tooltip) در هنگام نگه داشتن ماوس.

tooltip-format:
نوع: رشته (string)
قالب نحوه نمایش اطلاعات در راهنمای شناور. این قالب زمانی استفاده می‌شود که سایر قالب‌ها مشخص نشده باشند.

tooltip-format-disabled:
نوع: رشته (string)
این قالب زمانی استفاده می‌شود که کنترل‌کننده نمایش داده‌شده غیرفعال باشد.

tooltip-format-off:
نوع: رشته (string)
این قالب زمانی استفاده می‌شود که کنترل‌کننده نمایش داده‌شده خاموش باشد.

tooltip-format-on:
نوع: رشته (string)
این قالب زمانی استفاده می‌شود که کنترل‌کننده نمایش داده‌شده روشن باشد اما هیچ دستگاهی متصل نباشد.

tooltip-format-connected:
نوع: رشته (string)
این قالب زمانی استفاده می‌شود که کنترل‌کننده نمایش داده‌شده حداقل به ۱ دستگاه متصل باشد.

tooltip-format-no-controller:
نوع: رشته (string)
این قالب زمانی استفاده می‌شود که هیچ کنترل‌کننده بلوتوثی یافت نشود.

tooltip-format-enumerate-connected:
نوع: رشته (string)
این قالب برای تعیین نحوه نمایش هر دستگاه متصل در جایگزین قالب device_enumerate در منوی راهنمای شناور استفاده می‌شود.

menu:
نوع: رشته (string)
عملیاتی که منو را باز می‌کند.

menu-file:
نوع: رشته (string)
محل فایل توصیف‌کننده منو. باید عنصری از نوع

menu-actions:
نوع: آرایه (array)
عملیات متناظر با دکمه‌های منو.

expand:
نوع: بولی (bool)
پیش‌فرض: false
امکان مصرف پویای تمامی فضای باقی‌مانده توسط این ماژول را فعال می‌کند.

جایگزین‌های قالب‌بندی (FORMAT REPLACEMENTS)

{status}: وضعیت دستگاه بلوتوث.

{icon}: آیکون، مطابق با تعریف در format-icons.

{num_connections}: تعداد اتصالات کنترل‌کننده نمایش داده‌شده.

{controller_address}: نشانی کنترل‌کننده نمایش داده‌شده.

{controller_address_type}: نوع نشانی کنترل‌کننده نمایش داده‌شده.

{controller_alias}: نام مستعار (alias) کنترل‌کننده نمایش داده‌شده.

{device_address}: نشانی دستگاه نمایش داده‌شده.

{device_address_type}: نوع نشانی دستگاه نمایش داده‌شده.

{device_alias}: نام مستعار (alias) دستگاه نمایش داده‌شده.

{device_enumerate}: نمایش فهرستی از تمام دستگاه‌های متصل، هر کدام در یک خط جداگانه. قالب هر دستگاه را با گزینه‌های پیکربندی tooltip-format-enumerate-connected
و/یا tooltip-format-enumerate-connected-battery تعیین کنید. فقط در گزینه‌های قالب مربوط به راهنمای شناور (tooltip) قابل استفاده است.

ویژگی آزمایشی درصد باتری (EXPERIMENTAL BATTERY PERCENTAGE FEATURE)

در زمان نگارش، ویژگی‌های آزمایشی BlueZ باید برای کارکرد گزینه‌های درصد باتری ذکر شده در زیر، فعال باشند.

مثال‌ها (EXAMPLES)

"bluetooth": {
	// "controller": "controller1", // در صورت وجود بیش از ۱ کنترل‌کننده در سیستم، نام مستعار آن را مشخص کنید
	"format": " {status}",
	"format-disabled": "", // یک قالب خالی ماژول را پنهان می‌کند
	"format-connected": " {num_connections} connected",
	"tooltip-format": "{controller_alias}\t{controller_address}",
	"tooltip-format-connected": "{controller_alias}\t{controller_address}\n\n{device_enumerate}",
	"tooltip-format-enumerate-connected": "{device_alias}\t{device_address}"
}

"bluetooth": {
	"format": " {status}",
	"format-connected": " {device_alias}",
	"format-connected-battery": " {device_alias} {device_battery_percentage}%",
	// "format-device-preference": [ "device1", "device2" ], // فهرست اولویت برای تعیین دستگاه نمایش داده‌شده
	"tooltip-format": "{controller_alias}\t{controller_address}\n\n{num_connections} connected",
	"tooltip-format-connected": "{controller_alias}\t{controller_address}\n\n{num_connections} connected\n\n{device_enumerate}",
	"tooltip-format-enumerate-connected": "{device_alias}\t{device_address}",
	"tooltip-format-enumerate-connected-battery": "{device_alias}\t{device_address}\t{device_battery_percentage}%"
}

استایل (STYLE)

• #bluetooth
• #bluetooth.disabled
• #bluetooth.off
• #bluetooth.on
• #bluetooth.connected
• #bluetooth.discoverable
• #bluetooth.discovering
• #bluetooth.pairable