diff --git a/source b/source index bf3eac79bcc..a818432365e 100644 --- a/source +++ b/source @@ -2187,6 +2187,7 @@ a.setAttribute('href', 'https://example.com/'); // change the content attribute
  • skip ASCII whitespace
  • The ordered map data structure and the associated definitions for value, + empty, entry, exists, getting the value of an entry, @@ -79757,9 +79758,36 @@ popup4.close(); export>top-level browsing context for itself and all of the browsing contexts for which it is an ancestor browsing context.

    +
    +

    A top-level browsing context has an associated group (null or a browsing context group). It is initially null.

    +

    A top-level browsing context has an is popup boolean. It is initially + false.

    + +
    +

    The only mandatory impact in this specification of is popup is on the + visible getter of the relevant BarProp + objects. However, user agents might also use it in the following ways:

    + + + +

    In both cases user agents might additionally incorporate user preferences, or present a choice + as to whether to go down the popup route.

    + +

    User agents that provides a minimal web browser user interface for such popups are encouraged + to not hide the browser's location bar.

    +
    + +
    +

    It is possible to create new browsing contexts that are related to a top-level browsing context while their container is null. Such browsing contexts are called WindowPostMessageOptions : StructuredSeri data-x="">new with no opener", then:

      +

    1. Set the target browsing context's is popup to the result of + checking if a popup window is requested, given + tokenizedFeatures.

      2. +

    2. Set up browsing context features for target browsing context given tokenizedFeatures.

      3. @@ -81268,6 +81300,68 @@ dictionary WindowPostMessageOptions : StructuredSeri

    3. Return tokenizedFeatures.

    +

    To check if a window feature is set, given + tokenizedFeatures, featureName, and defaultValue:

    + +
      +

    1. If tokenizedFeatures[featureName] exists, then return the result of parsing + tokenizedFeatures[featureName] as a boolean feature.

      2. + +

    2. Return defaultValue.

      3. +
    + +

    To check if a popup window is requested, given + tokenizedFeatures:

    + +
      +

    1. If tokenizedFeatures is empty, then return + false.

      2. + +

    2. If tokenizedFeatures["popup"] exists, then return the result of parsing + tokenizedFeatures["popup"] as a boolean + feature.

      3. + +

    3. Let location be the result of checking if + a window feature is set, given tokenizedFeatures, "location", and false.

      4. + +

    4. Let toolbar be the result of checking if + a window feature is set, given tokenizedFeatures, "toolbar", and false.

      5. + +

    5. If location and toolbar are both false, then return true.

      6. + +

    6. Let menubar be the result of checking if + a window feature is set, given tokenizedFeatures, menubar", and false.

      7. + +

    7. If menubar is false, then return true.

      8. + +

    8. Let resizable be the result of checking if + a window feature is set, given tokenizedFeatures, "resizable", and true.

      9. + +

    9. If resizable is false, then return true.

      10. + +

    10. Let scrollbars be the result of checking + if a window feature is set, given tokenizedFeatures, "scrollbars", and false.

      11. + +

    11. If scrollbars is false, then return true.

      12. + +

    12. Let status be the result of checking if + a window feature is set, given tokenizedFeatures, "status", and false.

      13. + +

    13. If status is false, then return true.

      14. + +

    14. Return false.

      15. +
    +

    A code point is a feature separator if it is ASCII whitespace, U+003D (=), or U+002C (,).

    @@ -81646,8 +81740,12 @@ dictionary WindowPostMessageOptions : StructuredSeri

    Browser interface elements

    -

    To allow web pages to integrate with web browsers, certain web browser interface elements are - exposed in a limited way to scripts in web pages.

    +

    For historical reasons, the Window interface had some attributes that represented + the visibility of certain web browser interface elements.

    + +

    For privacy and interoperability reasons, those attributes now return values that represent + whether the Window's browsing context's is + popup property is true or false.

    Each interface element is represented by a BarProp object:

    @@ -81658,75 +81756,59 @@ interface BarProp {
    window.locationbar.visible
    -

    Returns true if the location bar is visible; otherwise, returns false.

    -
    window.menubar.visible
    -

    Returns true if the menu bar is visible; otherwise, returns false.

    -
    window.personalbar.visible
    -

    Returns true if the personal bar is visible; otherwise, returns false.

    -
    window.scrollbars.visible
    -

    Returns true if the scrollbars are visible; otherwise, returns false.

    -
    window.statusbar.visible
    -

    Returns true if the status bar is visible; otherwise, returns false.

    -
    window.toolbar.visible
    -

    Returns true if the toolbar is visible; otherwise, returns false.

    +

    Returns true if the top-level browsing context is not a popup; otherwise, + returns false.

    -

    The visible attribute's getter - must run these steps:

    +

    The visible getter steps + are:

      -

    1. If this BarProp object's relevant global object's browsing context is null, then return false.

      2. +

    2. Let browsingContext be this's relevant global + object's browsing context.

      3. -

    3. If the user agent does not have a user interface element that the object represents, as - described below, then return true.

      4. +

    4. If browsingContext is null, then return true.

      5. -

    5. Return true or a value determined by the user agent to most accurately represent the - visibility state of the user interface element that the object represents, as described - below.

      6. +

    6. Return the negation of browsingContext's top-level browsing + context's is popup.

    The following BarProp objects must exist for each Window object:

    The location bar BarProp object
    -
    Represents the user interface element that contains a control that displays the - URL of the active document, or some similar interface concept.
    +
    Historically represented the user interface element that contains a control that displays the + browser's location bar.
    The menu bar BarProp object
    -
    Represents the user interface element that contains a list of commands in menu form, or some - similar interface concept.
    +
    Historically represented the user interface element that contains a list of commands in menu + form, or some similar interface concept.
    The personal bar BarProp object
    -
    Represents the user interface element that contains links to the user's favorite pages, or - some similar interface concept.
    +
    Historically represented the user interface element that contains links to the user's + favorite pages, or some similar interface concept.
    The scrollbar BarProp object
    -
    Represents the user interface element that contains a scrolling mechanism, or some similar - interface concept.
    +
    Historically represented the user interface element that contains a scrolling mechanism, or + some similar interface concept.
    The status bar BarProp object
    -
    Represents a user interface element found immediately below or after the document, as - appropriate for the user's media, which typically provides information about ongoing network - activity or information about elements that the user's pointing device is current indicating. If - the user agent has no such user interface element, then the object may act as if the - corresponding user interface element was absent (i.e. its visible attribute may return false).
    +
    Historically represented a user interface element found immediately below or after the + document, as appropriate for the user's media, which typically provides information about ongoing + network activity or information about elements that the user's pointing device is currently + indicating.
    The toolbar BarProp object
    -
    Represents the user interface element found immediately above or before the document, as - appropriate for the user's media, which typically provides session history traversal - controls (back and forward buttons, reload buttons, etc.). If the user agent has no such user - interface element, then the object may act as if the corresponding user interface element was - absent (i.e. its visible attribute may return - false).
    +
    Historically represented the user interface element found immediately above or before the + document, as appropriate for the user's media, which typically provides session + history traversal controls (back and forward buttons, reload buttons, etc.).

    The locationbar