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 物件可以用於進一步操作，例如獲取標籤、型別等資訊。