Appium-Location in view(视图中的位置)

梦里梦外; 2022-11-19 04:15 35阅读 0赞

### Get Element Location in View ###

*   *   *   *   *  Example Usage
                 *  Description
                 *  Support
                 *   *  Appium Server
                     *  Appium Clients
                 *  HTTP API Specifications
                 *   *  Endpoint
                     *  URL Parameters
                     *  JSON Parameters
                     *  Response

Determine an element’s location on the screen once it has been scrolled into view (mainly an internal command and not supported by all clients) //一旦元素被滚动到视图中，就确定它在屏幕上的位置（主要是内部命令，并非所有客户端都支持）

##### Example Usage #####

<table> 
 <thead> 
  <tr> 
   <th></th> 
   <th align="left"></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Java</td> 
   <td align="left">// Not supported</td> 
  </tr> 
  <tr> 
   <td>Python</td> 
   <td align="left">element = self.driver.find_element_by_accessibility_id(<code>'SomeAccessibilityID'</code>)<br>element.location_in_view</td> 
  </tr> 
  <tr> 
   <td>Javascript</td> 
   <td align="left">// webdriver.io example<br>let element = $(<code>"~SomeAccessibilityId"</code>)<br>let location = driver.getElementLocationInView(element.elementId);<br><br>// wd example<br>let element = await driver.elementByAccessibilityId(<code>"SomeAccessibilityID"</code>);<br>let location = await element.getLocationInView();</td> 
  </tr> 
  <tr> 
   <td>Ruby</td> 
   <td align="left"># Not supported<br># Not supported</td> 
  </tr> 
  <tr> 
   <td>C#</td> 
   <td align="left">// Not supported</td> 
  </tr> 
  <tr> 
   <td>PHP</td> 
   <td align="left">// Not supported</td> 
  </tr> 
 </tbody> 
</table>

##### Description #####

The CSS property to query should be specified using the CSS property name, not the JavaScript property name (e.g. background-color instead of backgroundColor). //要查询的CSS属性应该使用CSS属性名而不是JavaScript属性名（例如background color而不是backgroundColor）来指定

This command only applies to webview contexts //此命令仅适用于webview上下文

##### Support #####

###### Appium Server ######

<table> 
 <thead> 
  <tr> 
   <th>Platform</th> 
   <th>Driver</th> 
   <th>Platform Versions</th> 
   <th>Appium Version</th> 
   <th>Driver Version</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>iOS</td> 
   <td>XCUITest</td> 
   <td>9.3+</td> 
   <td>All</td> 
   <td>All</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>UIAutomation</td> 
   <td>8.0 to 9.3</td> 
   <td>All</td> 
   <td>All</td> 
  </tr> 
  <tr> 
   <td>Android</td> 
   <td>Espresso</td> 
   <td>?+</td> 
   <td>1.9.0+</td> 
   <td>All</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>UiAutomator2</td> 
   <td>?+</td> 
   <td>1.6.0+</td> 
   <td>All</td> 
  </tr> 
  <tr> 
   <td></td> 
   <td>UiAutomator</td> 
   <td>4.3+</td> 
   <td>All</td> 
   <td>All</td> 
  </tr> 
  <tr> 
   <td>Mac</td> 
   <td>Mac</td> 
   <td>?+</td> 
   <td>1.6.4+</td> 
   <td>All</td> 
  </tr> 
  <tr> 
   <td>Windows</td> 
   <td>Windows</td> 
   <td>10+</td> 
   <td>1.6.0+</td> 
   <td>All</td> 
  </tr> 
 </tbody> 
</table>

###### Appium Clients ######

<table> 
 <thead> 
  <tr> 
   <th>Language</th> 
   <th>Support</th> 
   <th>Documentation</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>Java</td> 
   <td>All</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>Python</td> 
   <td>All</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>Javascript (WebdriverIO)</td> 
   <td>All</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>Javascript (WD)</td> 
   <td>All</td> 
   <td>github.com</td> 
  </tr> 
  <tr> 
   <td>Ruby</td> 
   <td>All</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>PHP</td> 
   <td>All</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>C#</td> 
   <td>All</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

##### HTTP API Specifications #####

###### Endpoint ######

`GET /session/:session_id/elements/:element_id/location_in_view`

###### URL Parameters ######

<table> 
 <thead> 
  <tr> 
   <th>name</th> 
   <th>description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>session_id</td> 
   <td>ID of the session to route the command to</td> 
  </tr> 
  <tr> 
   <td>element_id</td> 
   <td>ID of the element to get the location-in-view of</td> 
  </tr> 
 </tbody> 
</table>

###### JSON Parameters ######

None

###### Response ######

<table> 
 <thead> 
  <tr> 
   <th>name</th> 
   <th>type</th> 
   <th>description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>x</td> 
   <td><code>number</code></td> 
   <td>X coordinate</td> 
  </tr> 
  <tr> 
   <td>y</td> 
   <td><code>number</code></td> 
   <td>Y coordinate</td> 
  </tr> 
 </tbody> 
</table>