[函数]UI\Menu::append()函数—用法及示例

函数名称：UI\Menu::append()

函数描述：在UI菜单中添加一个子菜单项

函数版本：PHP 7.4.0+

函数用法：

UI\Menu::append(string $label, string $type, int $index = -1): UI\MenuItem

参数说明：

• $label：子菜单项的标签，用于显示在菜单中
• $type：子菜单项的类型，可以是"menu"或"item"，分别表示子菜单和普通菜单项
• $index（可选）：子菜单项的插入位置索引，如果不指定，默认为-1，表示添加到末尾

返回值：UI\MenuItem 对象，表示添加的子菜单项

函数示例：

// 创建一个菜单对象
$menu = new UI\Menu("主菜单");

// 添加一个子菜单项
$item1 = $menu->append("子菜单项1", "menu");

// 添加一个普通菜单项
$item2 = $menu->append("菜单项2", "item");

// 在指定位置插入一个子菜单项
$item3 = $menu->append("子菜单项3", "menu", 1);

// 打印菜单项的标签和类型
echo $item1->getLabel();  // 输出：子菜单项1
echo $item1->getType();   // 输出：menu

echo $item2->getLabel();  // 输出：菜单项2
echo $item2->getType();   // 输出：item

echo $item3->getLabel();  // 输出：子菜单项3
echo $item3->getType();   // 输出：menu

注意事项：

• UI\Menu::append() 函数需要在安装了 PHP-UI 扩展的环境中使用，该扩展提供了创建用户界面的功能。
• 参数 $label 和 $type 都需要传入字符串类型的值。
• 返回的 UI\MenuItem 对象可以用于进一步操作，例如获取标签、类型等信息。