列表(List)

CukeTest 为 ATK 应用中的列表控件提供了一系列 API，用于获取和操作列表数据。这些 API 可以帮助您轻松访问和控制列表中的各项内容。

方法名 描述
data 获取列表的所有数据。
getItem 根据名称或索引获取列表中的项。
select 选择列表中的某一项，并返回该项对象。
selectedIndex 获取当前选中的项的索引。
findItem 根据文本查找列表中的项，支持模糊匹配。
itemCount 获取列表中项的总数。

除上述列表控件特有的方法外，您还可以使用通用控件方法对列表控件进行更灵活的操作。

类型定义

JavaScript
Python
export interface IAtList extends IAtControl {
    data(): Promise<string[]>;
    getItem(nameOrIndex: number | string): IAtListItem;
    select(nameOrIndex: number | string): Promise<IAtListItem>;
    selectedIndex(): Promise<number>;
    findItem(text: string, options?: {exact?: boolean}): Promise<IAtListItem | null>;
    itemCount(): Promise<number>;
}
class AtList(AtControl):
	def data() -> List[str]
	def getItem(nameOrIndex: Union[str, int]) -> AtListItem
	def select(nameOrIndex: Union[str, int]) -> AtListItem
	def selectedIndex() -> int
	def findItem(text: str, options: Optional[FindItemOptional]=None) -> AtListItem
	def itemCount() -> int

data()

获取列表中所有项的内容。

返回值:

  • Promise<string[]>类型，异步返回列表中所有项的内容数组。

示例代码

获取列表中所有项的内容：

JavaScript
Python
let items = await model.getList("list").data();
console.log(`列表项内容: ${items.join(", ")}`);
items = model.getList("list").data()
print(f"列表项内容: {', '.join(items)}")

getItem(nameOrIndex)

根据名称或索引获取列表中的项。

参数:

  • nameOrIndex: number | string类型，可以是项的名称或索引。

返回值:

  • IAtListItem类型，返回列表中的项对象。

示例代码

根据名称获取列表项：

JavaScript
Python
let item = model.getList("list").getItem("项名称");
item = model.getList("list").getItem("项名称")

select(nameOrIndex)

选择列表中的某一项，并返回该项对象。

参数:

  • nameOrIndex: number | string类型，可以是项的名称或索引。

返回值:

  • Promise<IAtListItem>类型，异步返回选择的项对象。

示例代码

选择列表中的某一项：

JavaScript
Python
let selectedItem = await model.getList("list").select(0);
selectedItem = model.getList("list").select(0)

selectedIndex()

获取当前选中的项的索引。

返回值:

  • Promise<number>类型，异步返回当前选中的项的索引。

示例代码

获取当前选中的项的索引：

JavaScript
Python
let index = await model.getList("list").selectedIndex();
console.log(`当前选中的项索引: ${index}`);
index = model.getList("list").selectedIndex()
print(f"当前选中的项索引: {index}")

findItem(text, options)

根据文本查找列表中的项，支持模糊匹配。

参数:

  • text: string类型，表示要查找的文本。
  • options: Optional类型，可选参数，支持exact属性，用于指定是否精确匹配。

返回值:

  • Promise<IAtListItem | null>类型，异步返回找到的项对象或null。

示例代码

查找列表中的项：

JavaScript
Python
let foundItem = await model.getList("list").findItem("搜索文本", { exact: true });
foundItem = model.getList("list").findItem("搜索文本", {"exact": True})

itemCount()

获取列表中项的总数。

返回值:

  • Promise<number>类型，异步返回列表中项的总数。

示例代码

获取列表中项的总数：

JavaScript
Python
let count = await model.getList("list").itemCount();
console.log(`列表项总数: ${count}`);
count = model.getList("list").itemCount()
print(f"列表项总数: {count}")

results matching ""

全部 API Walkthrough 其他

    No results matching ""