菜单项表单字段
菜单项表单字段类型提供 Joomla! 网站上可用菜单的下拉列表。如果该字段已保存值,则在页面首次加载时会选择该值。如果没有,则选择默认值(如果有)。
- type(必需)必须为menuitem。
- name(必需)是该字段的唯一名称。
- label(必需)(可翻译)是该字段的 HTML 标签。
- description(可选)(可翻译)是字段描述。
- default(可选)是默认菜单项。请注意,这是菜单项的 ItemID 号码。
- published(可选)决定是否列出所有菜单项或仅列出已发布的菜单项。如果 state 为 '0',则列出所有菜单项。如果 state 为 '1',则仅列出已发布的菜单项。您也可以使用逗号分隔的值,例如 '1,2'。
- menu_type(可选)按数据库表
#__menu
中的menutype
值或菜单编辑表单中“菜单类型”表单字段的值进行过滤。 - client_id(可选)按数据库表
#__menu
中的client_id
值进行过滤。'0' 用于网站菜单项。'1' 用于管理员菜单项。默认值为 '0'。 - language(可选)按数据库表
#__menu
中的language
值(语言标签)进行过滤。您也可以使用逗号分隔的值,例如 'en-GB,de-DE'。
由以下实现:libraries/src/Form/MenuitemField.php
示例 XML 参数定义
<field
name="mymenuitem"
type="menuitem"
default="45"
label="Select a menu item"
description="Select a menu item"
/>
要添加带有可翻译字符串(如“选择”或“默认”)的附加行,请在 XML 中添加一个选项。例如
<option value="">JDEFAULT</option>