From 291910c2e4884e613b7ff3ce6dbc9e153267f527 Mon Sep 17 00:00:00 2001 From: Henrik Skupin Date: Tue, 16 Apr 2024 20:23:15 +0000 Subject: [PATCH] Clarify when an element is disabled (#1807) SHA: 98140eacf446d22030c9eaf65d67fb9dcb212a12 Reason: push, by pull[bot] Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- index.html | 214 ++++++++++++++++++++++++++++++++--------------------- 1 file changed, 130 insertions(+), 84 deletions(-) diff --git a/index.html b/index.html index 00555202..661a037b 100644 --- a/index.html +++ b/index.html @@ -188,7 +188,7 @@ .mdn .samsunginternet_android::before{background-image:url(https://www.w3.org/assets/logos/browser-logos/samsung-internet/samsung-internet.svg)} .mdn .webview_android::before{background-image:url(https://www.w3.org/assets/logos/browser-logos/android-webview/android-webview.png)} - +

WebDriver

-

W3C Editor's Draft

+

W3C Editor's Draft

More details about this document
@@ -5160,8 +5160,8 @@

WebDriver

Mutable form control elements

Denotes input elements - that are mutable (e.g. that are not read only or actually disabled) - and whose type attribute + that are mutable (e.g. that are not read only or + disabled) and whose type attribute is in one of the following states:

On the other hand, the center point of the following select - list is the third option element, because unlike + list is the third option element, because unlike a drop-down list, <select multiple>'s options are individually visible and painted. Because the option is a descendant - of the select element, + of the select element, it is not obscured:

@@ -5310,7 +5326,7 @@

WebDriver

-

An element's +

An element's pointer-interactable paint tree is produced this way: @@ -5489,7 +5505,7 @@

WebDriver

An element location strategy is an enumerated attribute deciding what technique should be used - to search for elements in session's current + to search for elements in session's current browsing context. The following table of location strategies lists the keywords and states defined for this attribute: @@ -5663,7 +5679,7 @@

WebDriver

evaluateResult as this and index as the argument. -

  • If node is not an element return an error +

  • If node is not an element return an error with error code invalid selector.

  • Append node to result. @@ -5694,7 +5710,7 @@

    WebDriver

    Note

  • If active element is a non-null element, +

  • If active element is a non-null element, return success with data set to web element reference object for session and active element. @@ -6113,12 +6129,12 @@

    WebDriver

    otherwise return false.

    • -

    An element's container is: +

    An element's container is:

    -
    option element in a valid element context -
    optgroup element in a valid element context -

    The element's element context, +

    option element in a valid element context +
    optgroup element in a valid element context +

    The element's element context, which is determined by:

      @@ -6128,7 +6144,7 @@

      WebDriver

      or undefined if the root of the tree is reached.

    1. Let select parent be the - first select element reached + first select element reached by traversing the tree in reverse order from element, or undefined if the root of the tree is reached. @@ -6137,11 +6153,11 @@

      WebDriver

      Otherwise, the element context is datalist parent.

    -
    option element in an invalid element context +
    option element in an invalid element context

    The element does not have a container.

    Otherwise -

    The container is the element itself. +

    The container is the element itself.

    12.4.1 Is Element Selected

    @@ -6160,10 +6176,10 @@

    WebDriver

    Note

    The Is Element Selected command -determines if the referenced element is selected or not. +determines if the referenced element is selected or not. This operation only makes sense on input elements of the Checkbox- and Radio Button states, -or on option elements. +or on option elements.

    The remote end steps, given session, URL variables and parameters are: @@ -6190,7 +6206,7 @@

    WebDriver

    The result of element's checkedness.

    element is - an option element + an option element

    The result of element's selectedness.

    Otherwise @@ -6446,8 +6462,8 @@

    WebDriver

    Note
    @@ -11617,7 +11633,7 @@

    WebDriver

    WebDriver provides the Take Screenshot command to capture the top-level browsing context's initial viewport, and a command Take Element Screenshot - for doing the same with the visible region of an element's + for doing the same with the visible region of an element's bounding rectangle after it has been scrolled into view.

    In order to draw a bounding box from the framebuffer, @@ -11667,7 +11683,7 @@

    WebDriver

    To encode a canvas as - Base64 a canvas element: + Base64 a canvas element:

    1. If the canvas element's bitmap's @@ -11756,7 +11772,7 @@

      WebDriver

      Note

      The Take Element Screenshot command takes a screenshot of the visible region encompassed -by the bounding rectangle of an element. +by the bounding rectangle of an element.

      The remote end steps, given session, URL variables and parameters are: @@ -12121,24 +12137,24 @@

      WebDriver

      Although WebDriver does not define a primitive - to ascertain the visibility of an element in the viewport, + to ascertain the visibility of an element in the viewport, we acknowledge that it is an important feature for many users. Here we include a recommended approach - which will give a simplified approximation of an element's visibility, + which will give a simplified approximation of an element's visibility, but please note that it relies only on tree-traversal, and only covers a subset of visibility checks. -

      The visibility of an element is guided +

      The visibility of an element is guided by what is perceptually visible to the human eye. - In this context, an element's displayedness + In this context, an element's displayedness does not relate to the visibility or display style properties.

      The approach recommended to implementors to ascertain - an element's visibility was originally developed by + an element's visibility was originally developed by the Selenium project, and is - based on crude approximations about an element's nature and - relationship in the tree. An element is in general to be + based on crude approximations about an element's nature and + relationship in the tree. An element is in general to be considered visible if any part of it is drawn on the canvas within the boundaries of the viewport. @@ -12957,6 +12973,8 @@

      WebDriver

      §E.
    2. Dirty value flag §E.
    3. + disabled + §12.1
    4. dismiss §16.
    5. Dismiss Alert @@ -13982,6 +14000,8 @@

      WebDriver

      hasAttribute() (for Element)
    6. HTMLCollection interface +
    7. + inclusive ancestor (for tree)
    8. inclusive descendant (for tree)
    9. @@ -14160,7 +14180,7 @@

      WebDriver

      [accname-1.1]
      Accessible Name and Description Computation 1.1. Joanmarie Diggs; Bryan Garaventa; Michael Cooper. W3C. 18 December 2018. W3C Recommendation. URL: https://www.w3.org/TR/accname-1.1/
      [CSP3]
      - Content Security Policy Level 3. Mike West; Antonio Sartori. W3C. 21 February 2024. W3C Working Draft. URL: https://www.w3.org/TR/CSP3/ + Content Security Policy Level 3. Mike West; Antonio Sartori. W3C. 12 April 2024. W3C Working Draft. URL: https://www.w3.org/TR/CSP3/
      [CSS-CASCADE-4]
      CSS Cascading and Inheritance Level 4. Elika Etemad; Tab Atkins Jr.. W3C. 13 January 2022. W3C Candidate Recommendation. URL: https://www.w3.org/TR/css-cascade-4/
      [CSS-DEVICE-ADAPT]
      @@ -14168,7 +14188,7 @@

      WebDriver

      [CSS21]
      Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification. Bert Bos; Tantek Çelik; Ian Hickson; Håkon Wium Lie. W3C. 7 June 2011. W3C Recommendation. URL: https://www.w3.org/TR/CSS21/
      [CSS3-BOX]
      - CSS Box Model Module Level 3. Elika Etemad. W3C. 6 April 2023. W3C Recommendation. URL: https://www.w3.org/TR/css-box-3/ + CSS Box Model Module Level 3. Elika Etemad. W3C. 11 April 2024. W3C Recommendation. URL: https://www.w3.org/TR/css-box-3/
      [CSS3-DISPLAY]
      CSS Display Module Level 3. Elika Etemad; Tab Atkins Jr.. W3C. 30 March 2023. W3C Candidate Recommendation. URL: https://www.w3.org/TR/css-display-3/
      [CSS3-VALUES]
      @@ -18597,6 +18617,22 @@

      WebDriver

    10. § 15.5 Processing actions
      11. + +