نام (NAME)

waybar-network - ماژول شبکه در waybar

توضیحات (DESCRIPTION)

ماژول network اطلاعات مربوط به اتصالات شبکه جاری را نمایش می‌دهد.

پیکربندی (CONFIGURATION)

مخاطب با network

interface:
typeof: string
استفاده از رابط تعریف‌شده به‌جای تشخیص خودکار. کاراکترهای عمومی (wildcard) را می‌پذیرد.

rfkill:
typeof: bool
default: true
در صورت فعال بودن، زمانی که rfkill رابط‌های wlan را مسدود کرده باشد، قالب disabled استفاده خواهد شد.

interval:
typeof: integer
default: 60
فاصله زمانی که اطلاعات شبکه دریافت می‌شود (مثلاً قدرت سیگنال).

family:
typeof: string
default: ipv4
خانواده آدرسی که برای جایگزینی قالب {ipaddr} و تعیین وجود اتصال شبکه استفاده می‌شود. برای نمایش هر دو، آن را روی ipv4_6 تنظیم کنید.

format:
typeof: string
default: {ifname}
قالب، نحوه نمایش اطلاعات. این قالب زمانی استفاده می‌شود که قالب‌های دیگر مشخص نشده باشند.

format-ethernet:
typeof: string
این قالب زمانی استفاده می‌شود که یک رابط اترنت نمایش داده شود.

format-wifi:
typeof: string
این قالب زمانی استفاده می‌شود که یک رابط بی‌سیم نمایش داده شود.

format-linked:
typeof: string
این قالب زمانی استفاده می‌شود که یک رابط متصل بدون آدرس IP نمایش داده شود.

format-disconnected:
typeof: string
این قالب زمانی استفاده می‌شود که رابط نمایش‌داده‌شده قطع باشد.

format-disabled:
typeof: string
این قالب زمانی استفاده می‌شود که rfkill رابط‌های wlan را مسدود کرده باشد.

format-icons:
typeof: array/object
بر اساس قدرت سیگنال فعلی، نماد مربوطه انتخاب می‌شود.
ترتیب از کم به زیاد است. یا در صورتی که یک شیء باشد بر اساس وضعیت.

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

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

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

align:
typeof: float
تراز برچسب درون ماژول، که در آن ۰ چپ‌چین و ۱ راست‌چین است. اگر ماژول چرخانده شود، از جهت جریان متن پیروی خواهد کرد.

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

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

on-click-middle:
typeof: string
دستوری که هنگام کلیک وسط روی ماژول با استفاده از چرخ ماوس اجرا می‌شود.

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

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

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

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

smooth-scrolling-threshold:
typeof: double
آستانه‌ای که هنگام پیمایش استفاده می‌شود.

tooltip:
typeof: bool
default: true
گزینه‌ای برای غیرفعال کردن راهنمای شناور هنگام قرار گرفتن نشانگر ماوس روی آن.

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

tooltip-format-ethernet:
typeof: string
این قالب زمانی استفاده می‌شود که یک رابط اترنت نمایش داده شود.

tooltip-format-wifi:
typeof: string
این قالب زمانی استفاده می‌شود که یک رابط بی‌سیم نمایش داده شود.

tooltip-format-disconnected:
typeof: string
این قالب زمانی استفاده می‌شود که رابط نمایش‌داده‌شده قطع باشد.

tooltip-format-disabled:
typeof: string
این قالب زمانی استفاده می‌شود که rfkill رابط‌های wlan را مسدود کرده باشد.

menu:
typeof: string
کنشی که منو را باز می‌کند.

menu-file:
typeof: string
محل پرونده توصیف‌گر منو. باید عنصری از نوع GtkMenu با شناسه menu وجود داشته باشد.

menu-actions:
typeof: array
کنش‌های متناظر با دکمه‌های منو.

expand:
typeof: bool
default: false
به این ماژول امکان می‌دهد تا تمام فضای باقی‌مانده را به‌طور پویا مصرف کند.

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

{ifname}: نام رابط شبکه.

{ipaddr}: نخستین IP رابط.

{gwaddr}: درگاه پیش‌فرض برای رابط

{netmask}: ماسک زیرشبکه متناظر با IP(V4).

{netmask6}: ماسک زیرشبکه متناظر با IP(V6).

{cidr}: ماسک زیرشبکه متناظر با IP(V4) در نماد CIDR.

{cidr6}: ماسک زیرشبکه متناظر با IP(V6) در نماد CIDR.

{essid}: نام (SSID) شبکه بی‌سیم.

{bssid}: آدرس MAC (یا BSSID) نقطه دسترسی بی‌سیم.

{signalStrength}: قدرت سیگنال شبکه بی‌سیم.

{signaldBm}: قدرت سیگنال شبکه بی‌سیم برحسب dBm.

{frequency}: فرکانس شبکه بی‌سیم برحسب گیگاهرتز (GHz).

{bandwidthUpBits}: سرعت لحظه‌ای بارگذاری برحسب بیت/ثانیه.

{bandwidthDownBits}: سرعت لحظه‌ای بارگیری برحسب بیت/ثانیه.

{bandwidthTotalBits}: مجموع سرعت لحظه‌ای برحسب بیت/ثانیه.

{bandwidthUpOctets}: سرعت لحظه‌ای بارگذاری برحسب هشت‌بایت/ثانیه.

{bandwidthDownOctets}: سرعت لحظه‌ای بارگیری برحسب هشت‌بایت/ثانیه.

{bandwidthTotalOctets}: مجموع سرعت لحظه‌ای برحسب هشت‌بایت/ثانیه.

{bandwidthUpBytes}: سرعت لحظه‌ای بارگذاری برحسب بایت/ثانیه.

{bandwidthDownBytes}: سرعت لحظه‌ای بارگیری برحسب بایت/ثانیه.

{bandwidthTotalBytes}: مجموع سرعت لحظه‌ای برحسب بایت/ثانیه.

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

مثال‌ها (EXAMPLES)

"network": {
	"interface": "wlp2s0",
	"format": "{ifname}",
	"format-wifi": "{essid} ({signalStrength}%) ",
	"format-ethernet": "{ifname} ",
	"format-disconnected": "", //یک قالب خالی ماژول را پنهان می‌کند.
	"format-disconnected": "",
	"tooltip-format": "{ifname}",
	"tooltip-format-wifi": "{essid} ({signalStrength}%) ",
	"tooltip-format-ethernet": "{ifname} ",
	"tooltip-format-disconnected": "Disconnected",
	"max-length": 50
}

استایل (STYLE)

• #network
• #network.disconnected
• #network.disabled
• #network.linked
• #network.ethernet
• #network.wifi