.\" 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\-menu" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
.PP
waybar \- ویژگی منو (menu)
.PP
.SH "نمای کلی (OVERVIEW)"
.PP
برخی پودمان‌ها از ویژگی '\&menu'\& پشتیبانی می‌کنند که امکان داشتن یک منوی پاپ‌آپ را هنگام انجام کلیک تعریف‌شده روی پودمان فراهم می‌سازد.\&
.PP
.SH "ویژگی‌ها (PROPERTIES)"
.PP
پودمانی که ویژگی '\&menu'\& را پیاده‌سازی می‌کند، نیازمند ۳ ویژگی تعریف‌شده در پیکربندی خود است:
.PP
\fBmenu\fR:
.br
نوع: رشته (string)
.br
رویدادی (اکشنی) که منو را باز می‌کند.\& اکشن‌های ممکن عبارتند از:
.PP
.TS
allbox;c c
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx.
T{
\fBگزینه (Option)\fR
T}	T{
\fBتوضیحات (Description)\fR
T}
T{
\fBon\-click\fR
T}	T{
هنگام کلیک چپ روی پودمان
T}
T{
\fBon\-click\-release\fR
T}	T{
هنگام رها کردن دکمه چپ ماوس روی پودمان
T}
T{
\fBon\-double\-click\fR
T}	T{
هنگام دو بار کلیک چپ روی پودمان
T}
T{
\fBon\-triple\-click\fR
T}	T{
هنگام سه بار کلیک چپ روی پودمان
T}
T{
\fBon\-click\-middle\fR
T}	T{
هنگام کلیک وسط روی پودمان با استفاده از چرخ ماوس
T}
T{
\fBon\-click\-middle\-release\fR
T}	T{
هنگام رها کردن دکمه چرخ ماوس روی پودمان
T}
T{
\fBon\-double\-click\-middle\fR
T}	T{
هنگام دو بار کلیک وسط روی پودمان
T}
T{
\fBon\-triple\-click\-middle\fR
T}	T{
هنگام سه بار کلیک وسط روی پودمان
T}
T{
\fBon\-click\-right\fR
T}	T{
هنگام راست‌کلیک روی پودمان
T}
T{
\fBon\-click\-right\-release\fR
T}	T{
هنگام رها کردن دکمه راست ماوس روی پودمان
T}
T{
\fBon\-double\-click\-right\fR
T}	T{
هنگام دو بار راست‌کلیک روی پودمان
T}
T{
\fBon\-triple\-click\-right\fR
T}	T{
هنگام سه بار راست‌کلیک روی پودمان
T}
T{
\fBon\-click\-backward\fR
T}	T{
هنگام کلیک روی پودمان با دکمه عقب (backward) ماوس
T}
T{
\fBon\-click\-backward\-release\fR
T}	T{
هنگام رها کردن دکمه عقب ماوس روی پودمان
T}
T{
\fBon\-double\-click\-backward\fR
T}	T{
هنگام دو بار کلیک روی پودمان با دکمه عقب ماوس
T}
T{
\fBon\-triple\-click\-backward\fR
T}	T{
هنگام سه بار کلیک روی پودمان با دکمه عقب ماوس
T}
T{
\fBon\-click\-forward\fR
T}	T{
هنگام کلیک روی پودمان با دکمه جلو (forward) ماوس
T}
T{
\fBon\-click\-forward\-release\fR
T}	T{
هنگام رها کردن دکمه جلو ماوس روی پودمان
T}
T{
\fBon\-double\-click\-forward\fR
T}	T{
هنگام دو بار کلیک روی پودمان با دکمه جلو ماوس
T}
T{
\fBon\-triple\-click\-forward\fR
T}	T{
هنگام سه بار کلیک روی پودمان با دکمه جلو ماوس
T}
.TE
.sp 1
\fBmenu\-file\fR:
.br
نوع: رشته (string)
.br
مکان فایل توصیف‌کننده منو.\& باید عنصری از نوع
.RS 4
GtkMenu با شناسه \fBmenu\fR وجود داشته باشد.\&
.PP
.RE
\fBmenu\-actions\fR:
.br
نوع: آرایه (array)
.br
عملیات متناظر با دکمه‌های منو.\& شناسه‌های هر یک از این
.RS 4
عملیات باید به عنوان یک id در '\&menu\-file'\& وجود داشته باشند تا پیوند به درستی برقرار شود.\&
.PP
.RE
.SH "فایل منو (MENU-FILE)"
.PP
فایل menu\-file یک فایل `.\&xml` است که یک GtkBuilder را نمایش می‌دهد.\& مستندات مربوط به آن را می‌توان در اینجا یافت: https://docs.\&gtk.\&org/gtk4/class.\&Builder.\&html
.PP
در اینجا، باید عنصری از نوع GtkMenu با شناسه "menu" وجود داشته باشد.\& هر یک از عملیات موجود در \fBmenu\-actions\fR از طریق شناسه (id) عناصر به عناصر موجود در فایل \fBmenu\-file\fR متصل می‌شوند.\&
.PP
.SH "مثال (EXAMPLE)"
.PP
پیکربندی پودمان (Module config):
.nf
.RS 4
"custom/power": {
	"format" : "⏻ ",
	"tooltip": false,
	"menu": "on\-click",
	"menu\-file": "~/\&.config/waybar/power_menu\&.xml",
	"menu\-actions": {
		"shutdown": "shutdown",
		"reboot": "reboot",
		"suspend": "systemctl suspend",
		"hibernate": "systemctl hibernate",
	},
},
.fi
.RE
.PP
\(ti/.\&config/waybar/power_menu.\&xml :
.nf
.RS 4
<?xml version="1\&.0" encoding="UTF\-8"?>
<interface>
  <object class="GtkMenu" id="menu">
		<child>
			<object class="GtkMenuItem" id="suspend">
				<property name="label">Suspend</property>
			</object>
		</child>
		<child>
			<object class="GtkMenuItem" id="hibernate">
				<property name="label">Hibernate</property>
			</object>
		</child>
    <child>
			<object class="GtkMenuItem" id="shutdown">
				<property name="label">Shutdown</property>
			</object>
    </child>
    <child>
      <object class="GtkSeparatorMenuItem" id="delimiter1"/>
    </child>
    <child>
			<object class="GtkMenuItem" id="reboot">
				<property name="label">Reboot</property>
			</object>
    </child>
  </object>
</interface>
.fi
.RE
.PP
.SH "استایل‌دهی به منوها (STYLING MENUS)"
.PP
.PD 0
.IP \(bu 4
\fBmenu\fR
استایل برای منو
.PD
.PP
.PD 0
.IP \(bu 4
\fBmenuitem\fR
استایل برای آیتم‌های درون منو
.PD
.PP
.SH "مثال (EXAMPLE)"
.PP
.nf
.RS 4
menu {
	border\-radius: 15px;
	background: #161320;
	color: #B5E8E0;
}
menuitem {
	border\-radius: 15px;
}
.fi
.RE