查找多個 UI 元素 (ui_element.find_all)

該函式在 20260507 以後版本方可使用

聲明

元素清單 = ui_element.find_all(選擇器 [, 選項 ])

參數

• 選擇器 表型，用於描述要查找的 UI 元素，可參考 選擇器字段說明。
• 選項 可選參數，表型，可參考 通用選項說明。

回傳值

• 元素清單 表型，所有匹配元素組成的陣列。沒有匹配項時返回空陣列。

說明

find_all 適合枚舉同類控制項或先檢查匹配數量。 如果只需要第一個匹配項，使用 find 更直接。

範例

local ui_element = require("ui_element")

local items = ui_element.find_all({
    role = "button",
})

for i, item in ipairs(items) do
    nLog(i, item.text or "")
end

注：上述代碼中使用了非本章函式 nLog