Find Elements · Appium 官方文檔

[//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/element/find-elements.yml) # 元素查找多個元素的查找方法 [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/element/find-elements.yml) ## 用法示例 ```java // Java List<MobileElement> elementsOne = (List<MobileElement>) driver.findElementsByAccessibilityId("SomeAccessibilityID"); List<MobileElement> elementsTwo = (List<MobileElement>) driver.findElementsByClassName("SomeClassName"); ``` ```python # Python el = self.driver.find_elements_by_accessibility_id('SomeAccessibilityID') ``` ```javascript // Javascript // webdriver.io example $$("~SomeAccessibilityId"); // wd example let elementsOne = await driver.elementsByAccessibilityId("SomeAccessibilityID"); let elementsTwo = await driver.elements("id", "SomeID"); ``` ```ruby # Ruby # ruby_lib example find_elements(:accessibility_id, "~SomeAccessibilityID") # ruby_lib_core example @driver.find_elements(:accessibility_id, "~SomeAccessibilityID") ``` ```php # PHP $els = $this->elements($this->using('accessibility id')->value('SomeAccessibilityID')); ``` ```csharp // C# IEnumerable<AppiumWebElement> elementsOne = driver.FindElementsByAccessibilityId("SomeAccessibilityID"); IEnumerable<AppiumWebElement> elementsTwo = driver.FindElementsByClassName("SomeClassName"); ``` [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/element/find-elements.yml) ## 查找方法 |方法|描述| |--------|-----------| |Accessibility ID|一串從UI元素讀取到的特殊標志符。對于XCUITest來說，它對應元素的`accessibility-id`屬性。對于Android來說它則對應元素的`content-desc`屬性| |Class name|對于iOS應用來說，它以XCUI元素類型開頭,對應XCUI元素的完整名稱。反之，對于Android應用來說，它表示的是UIAutomator2類的完整類名(例如：android.widget.TextView)| |ID|元素的原始標志符. Android中對應`resource-id`字段; iOS中對應`name`字段。| |Name|元素的名稱| |XPath|使用xpath方法對app XML源文件進行檢索 (由于該方法會對系統性能有一定的影響，一般不推薦使用)| |Image|通過匹配元素對應的base 64圖像文件來進行元素定位| |Android UiAutomator (UiAutomator2 適用)|通過使用UI Automator應用接口, 特別是使用[UiSelector](https://developer.android.com/reference/android/support/test/uiautomator/UiSelector.html)類來進行元素的定位。你可以通過Appium發送一串字符型的Java代碼給到服務端，服務端將會在應用環境中去執行該代碼，并返回一個或多個元素| |Android View Tag (Espresso 適用)|通過元素的[view tag](https://developer.android.com/reference/android/support/test/espresso/matcher/ViewMatchers.html#withTagValue(org.hamcrest.Matcher%3Cjava.lang.Object%3E))來進行匹配| |Android Data Matcher (Espresso 適用)|適用[Espresso DataMatcher](https://developer.android.com/reference/android/support/test/espresso/Espresso#ondata)來進行元素匹配| |IOS UIAutomation|當對iOS應用進行自動化時, 可以使用蘋果的[Instruments](../drivers/ios-uiautomation.md) 框架來進行元素查找| [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/element/find-elements.yml) ## 返回結果描述獲取到一個與[定位器](../writing-running-appium/finding-elements.md)相匹配的元素列表 [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/element/find-elements.yml) ## 版本支持 [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/element/find-elements.yml) ### Appium服務端 |平臺|Driver|平臺版本|Appium版本|Driver版本| |--------|----------------|------|--------------|--------------| | iOS | [XCUITest](../drivers/ios-xcuitest.md) | 9.3+ | 1.6.0+ | 全部 | | | [UIAutomation](../drivers/ios-uiautomation.md) | 8.0 to 9.3 | 全部 | 全部 | | Android | [Espresso](../drivers/android-espresso.md) | ?+ | 1.9.0+ | 全部 | | | [UiAutomator2](../drivers/android-uiautomator2.md) | ?+ | 1.6.0+ | 全部 | | | [UiAutomator](../drivers/android-uiautomator.md) | 4.3+ | 全部 | 全部 | | Mac | [Mac](../drivers/mac.md) | ?+ | 1.6.4+ | 全部 | | Windows | [Windows](../drivers/windows.md) | 10+ | 1.6.0+ | 全部 | [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/element/find-elements.yml) ### Appium客戶端 |編程語言|支持版本|對應文檔| |--------|-------|-------------| |[Java](https://github.com/appium/java-client/releases/latest)| 全部 | [seleniumhq.github.io](https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/WebElement.html#findElements-org.openqa.selenium.By-) | |[Python](https://github.com/appium/python-client/releases/latest)| 全部 | [selenium-python.readthedocs.io](http://selenium-python.readthedocs.io/api.html#selenium.webdriver.remote.webdriver.WebDriver.find_elements) | |[Javascript (WebdriverIO)](http://webdriver.io/index.html)| 全部 | | |[Javascript (WD)](https://github.com/admc/wd/releases/latest)| 全部 | [github.com](https://github.com/admc/wd/blob/master/lib/commands.js#L798) | |[Ruby](https://github.com/appium/ruby_lib/releases/latest)| 全部 | [www.rubydoc.info](https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/SearchContext:find_elements) | |[PHP](https://github.com/appium/php-client/releases/latest)| 全部 | [github.com](https://github.com/appium/php-client/) | |[C#](https://github.com/appium/appium-dotnet-driver/releases/latest)| 全部 | [github.com](https://github.com/appium/appium-dotnet-driver/blob/master/src/Appium.Net/Appium/AppiumWebElement.cs) | [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/element/find-elements.yml) ## HTTP應用程序接口文檔 [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/element/find-elements.yml) ### 接口 `POST /session/:session_id/elements` [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/element/find-elements.yml) ### URL參數 |字段名|字段描述| |----|-----------| |session_id|執行命令所使用到的Session ID| [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/element/find-elements.yml) ### 參數 |字段名|字段類型|字段描述| |----|----|-----------| | using | `string` | 使用的定位方法 | | value | `string` | 查找對象 | [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/element/find-elements.yml) ### 返回結果定位到的元素所對應的JSON對象列表(`Array<String>`) [//]: # (DO NOT EDIT THIS FILE! This is an auto-generated file. Editing for this document happens in /commands-yml/commands/element/find-elements.yml) ## 其他鏈接 * [W3C 文檔](https://www.w3.org/TR/webdriver/#dfn-find-elements) * [JSONWP 文檔](https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#sessionsessionidelements)