From b83ca363a5a3946594266ca9bb9dc01184306bb4 Mon Sep 17 00:00:00 2001 From: Jason Ren <40999116+jasonren0403@users.noreply.github.com> Date: Sat, 5 Nov 2022 20:03:34 +0800 Subject: [PATCH 1/5] docs(zh-cn): update elements/information --- .../webdriver/elements/information.zh-cn.md | 51 +++++++------------ 1 file changed, 17 insertions(+), 34 deletions(-) diff --git a/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md b/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md index f1d30fa33e32..803fe7d78e19 100644 --- a/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md +++ b/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md @@ -6,23 +6,13 @@ description: > 元素相关的知识. --- -您可以查询有关特定元素的许多详细信息. +您可以查询有关特定元素的许多详细信息。 ## 是否显示 -此方法用于检查连接的元素是否正确 -显示在网页上. 返回一个 `Boolean` 值, -如果连接的元素显示在当前的浏览器上下文中, 则为True -否则返回false. +此方法用于检查连接的元素是否正确显示在网页上. 返回一个 `Boolean` 值,如果连接的元素显示在当前的浏览器上下文中,则为True,否则返回false。 -此功能[提及于](https://w3c.github.io/webdriver/#element-displayedness), -但是未定义于w3c规范中, -因为[无法覆盖所有潜在条件](https://www.youtube.com/watch?v=LAD_XPGP_kk). -因此,Selenium不能期望驱动程序 -直接实现这种功能,现在依赖于 -直接执行大量JavaScript函数. -此函数界定了元素树中的许多本身属性以及关系, -并以值的形式返回. +此功能[于W3C规范中提及](https://w3c.github.io/webdriver/#element-displayedness),但由于[无法覆盖所有潜在条件](https://www.youtube.com/watch?v=LAD_XPGP_kk)而无法定义。因此,Selenium不能期望驱动程序直接实现这种功能,现在依赖于直接执行大量JavaScript函数。这个函数对一个元素的性质和在树中的关系做了许多近似的判断,以返回一个值。 {{< tabpane langEqualsHeader=true >}} {{< tab header="Java" >}} @@ -66,14 +56,11 @@ for element displayedness {{< /alert-code >}} -## 元素是否被选定 +## 是否被选定 -此方法确定是否 _已选择_ 引用的元素. -此方法广泛用于复选框, 单选按钮, 输入元素和选项元素. +此方法确认相关的元素是否 _已选定_,常用于复选框、单选框、输入框和选择元素中。 -返回一个布尔值, -如果在当前浏览上下文中 **已选择** 引用的元素, -则返回 **True**, 否则返回 **False**. +该方法返回一个布尔值,如果在当前浏览上下文中 **选择了** 引用的元素,则返回 **True**,否则返回 **False**。 {{< tabpane langEqualsHeader=true >}} {{< tab header="Java" >}} @@ -122,9 +109,7 @@ val attr = driver.findElement(By.cssSelector("input[type='checkbox']:first-of-t ## 获取元素标签名 -此方法用于获取在当前浏览上下文中 -具有焦点的被引用元素的 -[TagName](https://www.w3.org/TR/webdriver/#dfn-get-element-tag-name) . +此方法用于获取在当前浏览上下文中具有焦点的被引用元素的[TagName](https://www.w3.org/TR/webdriver/#dfn-get-element-tag-name)。 {{< tabpane langEqualsHeader=true >}} {{< tab header="Java" >}} @@ -171,15 +156,15 @@ val attr = driver.findElement(By.cssSelector("h1")).getTagName() {{< /tab >}} {{< /tabpane >}} -## 获取元素矩形 +## 位置和大小 -用于获取参考元素的尺寸和坐标. +用于获取参照元素的尺寸和坐标。 -提取的数据主体包含以下详细信息: +提取的数据主体包含以下详细信息: * 元素左上角的X轴位置 * 元素左上角的y轴位置 * 元素的高度 -* 元素宽度 +* 元素的宽度 {{< tabpane langEqualsHeader=true >}} {{< tab header="Java" >}} @@ -237,7 +222,7 @@ println(res.getX()) ## 获取元素CSS值 -获取当前浏览上下文中元素的特定计算样式属性的值. +获取当前浏览上下文中元素的特定计算样式属性的值。 {{< tabpane langEqualsHeader=true >}} {{< tab header="Java" >}} @@ -294,9 +279,9 @@ val cssValue = driver.findElement(By.linkText("More information...")).getCssValu {{< /tab >}} {{< /tabpane >}} -## 获取元素文本 +## 文本内容 -获取特定元素渲染后的文本. +获取特定元素渲染后的文本内容。 {{< tabpane langEqualsHeader=true >}} {{< tab header="Java" >}} @@ -343,11 +328,9 @@ val text = driver.findElement(By.cssSelector("h1")).getText() {{< /tab >}} {{< /tabpane >}} -## Fetching Attributes or Properties +## 获取属性 -Fetches the run time value associated with a -DOM attribute. It returns the data associated -with the DOM attribute or property of the element. +获取DOM属性相关的运行时值。它返回与该元素的DOM属性或属性相关的数据。 {{< tabpane langEqualsHeader=true >}} {{< tab header="Java" >}} @@ -382,4 +365,4 @@ String valueInfo = eleSelLink.GetAttribute("value"); {{< tab header="Kotlin" >}} // Help us with a PR for code sample {{< /tab >}} -{{< /tabpane >}} \ No newline at end of file +{{< /tabpane >}} From 8c3bb5dec54d5caf8d9ea2d5238baa04833569cb Mon Sep 17 00:00:00 2001 From: Jason Ren <40999116+jasonren0403@users.noreply.github.com> Date: Sat, 5 Nov 2022 20:10:56 +0800 Subject: [PATCH 2/5] Add back "Is Enabled" part --- .../webdriver/elements/information.zh-cn.md | 51 +++++++++++++++++++ 1 file changed, 51 insertions(+) diff --git a/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md b/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md index 803fe7d78e19..f724cd6ccccf 100644 --- a/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md +++ b/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md @@ -55,6 +55,57 @@ let result = await driver.findElement(By.name("email_input")).isDisplayed(); for element displayedness {{< /alert-code >}} +## 是否启用 + +此方法用于检查所连接的元素在网页上是启用还是禁用状态。返回一个布尔值,如果在当前浏览上下文中是 **启用** 状态,则返回 **true**,否则返回 **false**。 + +{{< tabpane langEqualsHeader=true >}} + {{< tab header="Java" >}} + //navigates to url + driver.get("https://www.google.com/"); + + //returns true if element is enabled else returns false + boolean value = driver.findElement(By.name("btnK")).isEnabled(); + {{< /tab >}} + {{< tab header="Python" >}} + # Navigate to url +driver.get("http://www.google.com") + + # Returns true if element is enabled else returns false +value = driver.find_element(By.NAME, 'btnK').is_enabled() + {{< /tab >}} + {{< tab header="CSharp" >}} +// Navigate to Url +driver.Navigate().GoToUrl("https://google.com"); + +// Store the WebElement +IWebElement element = driver.FindElement(By.Name("btnK")); + +// Prints true if element is enabled else returns false +System.Console.WriteLine(element.Enabled); + {{< /tab >}} + {{< tab header="Ruby" >}} + # Navigate to url +driver.get 'http://www.google.com/' + + # Returns true if element is enabled else returns false +ele = driver.find_element(name: 'btnK').enabled? + {{< /tab >}} + {{< tab header="JavaScript" >}} +// Navigate to url +await driver.get('https://www.google.com'); + +// Resolves Promise and returns boolean value +let element = await driver.findElement(By.name("btnK")).isEnabled(); + {{< /tab >}} + {{< tab header="Kotlin" >}} + //navigates to url + driver.get("https://www.google.com/") + + //returns true if element is enabled else returns false + val attr = driver.findElement(By.name("btnK")).isEnabled() + {{< /tab >}} +{{< /tabpane >}} ## 是否被选定 From 4d15c7a4131c9fe59b97de9c096ff16787caa034 Mon Sep 17 00:00:00 2001 From: Jason Ren <40999116+jasonren0403@users.noreply.github.com> Date: Sun, 13 Nov 2022 14:44:53 +0000 Subject: [PATCH 3/5] try wrap all line into 72 columns --- .../webdriver/elements/information.zh-cn.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md b/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md index f724cd6ccccf..6c1f5b119a19 100644 --- a/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md +++ b/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md @@ -10,9 +10,13 @@ description: > ## 是否显示 -此方法用于检查连接的元素是否正确显示在网页上. 返回一个 `Boolean` 值,如果连接的元素显示在当前的浏览器上下文中,则为True,否则返回false。 +此方法用于检查连接的元素是否正确显示在网页上. 返回一个 `Boolean` 值, +如果连接的元素显示在当前的浏览器上下文中,则为True,否则返回false。 -此功能[于W3C规范中提及](https://w3c.github.io/webdriver/#element-displayedness),但由于[无法覆盖所有潜在条件](https://www.youtube.com/watch?v=LAD_XPGP_kk)而无法定义。因此,Selenium不能期望驱动程序直接实现这种功能,现在依赖于直接执行大量JavaScript函数。这个函数对一个元素的性质和在树中的关系做了许多近似的判断,以返回一个值。 +此功能[于W3C规范中提及](https://w3c.github.io/webdriver/#element-displayedness), +但由于[无法覆盖所有潜在条件](https://www.youtube.com/watch?v=LAD_XPGP_kk)而无法定义。 +因此,Selenium不能期望驱动程序直接实现这种功能,现在依赖于直接执行大量JavaScript函数。 +这个函数对一个元素的性质和在树中的关系做了许多近似的判断,以返回一个值。 {{< tabpane langEqualsHeader=true >}} {{< tab header="Java" >}} @@ -57,7 +61,8 @@ for element displayedness ## 是否启用 -此方法用于检查所连接的元素在网页上是启用还是禁用状态。返回一个布尔值,如果在当前浏览上下文中是 **启用** 状态,则返回 **true**,否则返回 **false**。 +此方法用于检查所连接的元素在网页上是启用还是禁用状态。 +返回一个布尔值,如果在当前浏览上下文中是 **启用** 状态,则返回 **true**,否则返回 **false**。 {{< tabpane langEqualsHeader=true >}} {{< tab header="Java" >}} From 4eb6109d6e3f2a9a4831ae409269af6d420a9d2d Mon Sep 17 00:00:00 2001 From: Jason Ren <40999116+jasonren0403@users.noreply.github.com> Date: Tue, 15 Nov 2022 20:58:53 +0800 Subject: [PATCH 4/5] Update website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md --- .../documentation/webdriver/elements/information.zh-cn.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md b/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md index 4135aac31726..927e82ba1603 100644 --- a/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md +++ b/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md @@ -386,7 +386,8 @@ val text = driver.findElement(By.cssSelector("h1")).getText() ## 获取属性 -获取DOM属性相关的运行时值。它返回与该元素的DOM属性或属性相关的数据。 +获取与 DOM 属性关联的运行时的值。 +它返回与该元素的 DOM 特性或属性关联的数据。 {{< tabpane langEqualsHeader=true >}} {{< tab header="Java" >}} From 4ed20725094c5b8d0de05df6a11fecb63e5fd84f Mon Sep 17 00:00:00 2001 From: ian zhang Date: Tue, 15 Nov 2022 21:01:43 +0800 Subject: [PATCH 5/5] Update website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md Co-authored-by: Jason Ren <40999116+jasonren0403@users.noreply.github.com> --- .../documentation/webdriver/elements/information.zh-cn.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md b/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md index 927e82ba1603..a09c3e07fc22 100644 --- a/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md +++ b/website_and_docs/content/documentation/webdriver/elements/information.zh-cn.md @@ -384,7 +384,7 @@ val text = driver.findElement(By.cssSelector("h1")).getText() {{< /tab >}} {{< /tabpane >}} -## 获取属性 +## 获取特性或属性 获取与 DOM 属性关联的运行时的值。 它返回与该元素的 DOM 特性或属性关联的数据。