跳至主要内容
版本:5.1

Category表单字段

**类别**表单字段类型提供了一个下拉列表,其中包含某个扩展的所有已发布类别。如果参数具有已保存的值,则在页面首次加载时会选择此值。否则,将选择默认值(如果有)。如果show_root属性为1,则列表中的第一个选项将是表示根类别的字符串(这是一个可翻译的字符串),并赋予其值0。

  • **type**(必填)必须为category
  • **name**(必填)是字段的唯一名称。
  • **label**(必填)(可翻译)是字段的HTML标签。
  • **extension**(必填)是要为其检索类别的扩展的名称。例如,要列出内容类别,请使用值“com_content”。
  • **scope**(可选)是extension的别名。
  • **show_root**(可选)是是否显示表示根类别的选项。
  • **default**(可选)是默认类别ID号。
  • **description**(可选)(可翻译)是字段描述
  • **class**(可选)允许您设置用于显示的CSS类。如果省略,则默认为“inputbox”
  • **multiple**(可选)如果设置为true,则允许同时选择多个项目。设置为false以允许单选。

由以下文件实现:libraries/src/Form/Field/CategoryField.php

XML参数定义示例

<field
name="mycategory"
type="category"
extension="com_content"
label="Select a category"
description=""
/>