跳过至主要内容
版本:5.1

菜单项表单字段

菜单项表单字段类型提供 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>

另请参阅