跳至主要内容
版本:5.1

用户组列表表单字段

**usergrouplist** 表单字段类型提供一个用户组的下拉选择框。

  • **type** (必填) 必须为 _usergrouplist_。
  • **name** (必填) 是字段的唯一名称。
  • **label** (必填) (可翻译) 是字段的 HTML 标签。
  • **description** (可选) (可翻译) 是 字段描述
  • **default** (可选) (不可翻译) 是下拉列表中默认选择的用户组 ID。
  • **layout** (可选) (可翻译) 是布局,例如 joomla.form.field.list-fancy-select。
  • **checksuperusergroup** (可选) 是布尔值,用于省略超级用户组。值为 1 或 0。
  • **multiple** (可选) 如果设置为 true,则允许选择多个用户组。

由以下实现:libraries/src/Form/Field/UsergrouplistField.php

示例 XML 参数定义

<field
name="usergroup"
type="UserGroupList"
label="MOD_EXAMPLE_USERGROUP_LABEL"
description="MOD_EXAMPLE_USERGROUP_DESC"
layout="joomla.form.field.list-fancy-select"
checksuperusergroup="1"
default=""
multiple="0"
>
<option value="0">MOD_EXAMPLE_SELECT</option>
</field>