Move To · Appium 官方文檔

# Move Mouse To 將鼠標移動指定元素的偏移量 ## 使用樣例 ```java // Java Actions action = new Actions(driver); action.moveTo(element, 10, 10); action.perform(); ``` ```python # Python actions = ActionChains(driver) actions.move_to(element, 10, 10) actions.perform() ``` ```javascript // Javascript // webdriver.io example $(element).moveTo(10, 10); // wd example await driver.moveTo(element, 10, 10); ``` ```ruby # Ruby # ruby_lib example mouse.move_to(element) mouse.move_to(element, 5, 5) # ruby_lib_core example @driver.mouse.move_to(element) @driver.mouse.move_to(element, 5, 5) ``` ```php # PHP // TODO PHP sample ``` ```csharp // C# Actions action = new Actions(driver); action.MoveToElement(element, 10, 10); action.Perform(); ``` ## 描述如果未指定任何元素，則移動是相對于當前鼠標光標的。如果提供了元素但沒有偏移，則鼠標將移動到元素的中心。如果該元素不可見，則將其滾動到視圖中。 ## 支持 ### Appium Server |平臺|Driver|平臺版本|Appium版本|Driver版本| |--------|----------------|------|--------------|--------------| | iOS | [XCUITest](../../drivers/ios-xcuitest.md) | None | None | None | | | [UIAutomation](../../drivers/ios-uiautomation.md) | None | None | None | | Android | [UiAutomator2](../../drivers/android-uiautomator2.md) | None | None | None | | | [Espresso](../../drivers/android-espresso.md) | None | None | None | | | [UiAutomator](../../drivers/android-uiautomator.md) | None | None | None | | Mac | [Mac](../../drivers/mac.md) | ?+ | 1.6.4+ | All | | Windows | [Windows](../../drivers/windows.md) | 10+ | 1.6.0+ | All | ### Appium 客戶端 |語言|支持|文檔| |--------|-------|-------------| |[Java](https://github.com/appium/java-client/releases/latest)| All | [seleniumhq.github.io](https://seleniumhq.github.io/selenium/docs/api/java/org/openqa/selenium/interactions/Actions.html#moveToElement-org.openqa.selenium.WebElement-) | |[Python](https://github.com/appium/python-client/releases/latest)| All | [selenium-python.readthedocs.io](http://selenium-python.readthedocs.io/api.html#selenium.webdriver.common.action_chains.ActionChains.move_to_element) | |[Javascript (WebdriverIO)](http://webdriver.io/index.html)| All | | |[Javascript (WD)](https://github.com/admc/wd/releases/latest)| All | [github.com](https://github.com/admc/wd/blob/master/lib/commands.js#L1600) | |[Ruby](https://github.com/appium/ruby_lib/releases/latest)| All | [www.rubydoc.info](https://www.rubydoc.info/gems/selenium-webdriver/Selenium/WebDriver/Mouse:move_to) | |[PHP](https://github.com/appium/php-client/releases/latest)| All | [github.com](https://github.com/appium/php-client/) | |[C#](https://github.com/appium/appium-dotnet-driver/releases/latest)| All | [github.com](https://github.com/appium/appium-dotnet-driver/) | ## HTTP API 規范 ### 終端 `POST /session/:session_id/moveto` ### URL 參數 |名稱|描述| |----|-----------| |session_id|將指令發往的會話（session）的ID| ### JSON 參數 |名稱|類型|描述| |----|----|-----------| | element | `string` | 要移動到的元素的ID。如果未指定，就是相對于鼠標位置 | | xoffset | `number` | 相對于元素左上角的X方向的偏移量。如果未指定，則鼠標將移動到元素的中間 | | yoffset | `number` | 相對于元素左上角的Y方向的偏移量。如果未指定，則鼠標將移動到元素的中間 | ### 響應 null ## 支持 * [W3C Specification](https://drafts.csswg.org/cssom-view/#dom-window-moveto) * [JSONWP Specification](https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol#post-sessionsessionidmoveto)