Skip to content
This repository has been archived by the owner on Jul 30, 2019. It is now read-only.

Commit

Permalink
Merge of changes in attributes include file
Browse files Browse the repository at this point in the history
  • Loading branch information
adanilo committed May 2, 2016
2 parents 2fce202 + fc14a1e commit 6905d82
Show file tree
Hide file tree
Showing 8 changed files with 72 additions and 354 deletions.
6 changes: 0 additions & 6 deletions sections/attributes.include
View file
Original file line number Diff line number Diff line change
Expand Up @@ -674,12 +674,6 @@
<td>Specifies which cells the header cell applies to</td>
<td>"<code>row</code>"; "<code>col</code>"; "<code>rowgroup</code>"; "<code>colgroup</code>"</td>
</tr>
<tr>
<th><code>seamless</code></th>
<td><{iframe}></td>
<td>Whether to apply the document's styles to the nested content</td>
<td><a>Boolean attribute</a></td>
</tr>
<tr>
<th><code>selected</code></th>
<td><{option}></td>
Expand Down
113 changes: 5 additions & 108 deletions sections/browsers.include
View file
Original file line number Diff line number Diff line change
Expand Up @@ -188,9 +188,6 @@
context</a>. User agents must not allow the user to interact with <a>child browsing contexts</a> of elements that are in <code>Document</code>s that are
not themselves <a>fully active</a>.

A <a>nested browsing context</a> can have a <a>seamless browsing context flag</a>
set, if it is embedded through an <{iframe}> element with a <code>seamless</code> attribute.

A <a>nested browsing context</a> can be put into a <dfn>delaying <code>load</code> events mode</dfn>. This is used when it is <a>navigated</a>, to <a>delay the load event</a> of the <a>browsing
context container</a> before the new <code>Document</code> is created.

Expand Down Expand Up @@ -426,9 +423,7 @@
These values have different meanings based on whether the page is sandboxed or not, as
summarized in the following (non-normative) table. In this table, "current" means the
<a>browsing context</a> that the link or script is in, "parent" means the <a>parent
browsing context</a> of the one the link or script is in, "master" means the nearest
<a>ancestor browsing context</a> of the one the link or script is in that is not itself in a
<a>seamless iframe</a>, "top" means the <a>top-level
browsing context</a> of the one the link or script is in, "top" means the <a>top-level
browsing context</a> of the one the link or script is in, "new" means a new <a>top-level
browsing context</a> or <a>auxiliary browsing context</a> is to be created, subject to
various user preferences and user agent policies, "none" means that nothing will happen, and
Expand All @@ -443,37 +438,25 @@
<th rowspan=2>Ordinary effect
<th colspan=5>Effect in an <code>iframe</code> with...
<tr>
<th><code>seamless=""</code>
<th><code>sandbox=""</code>
<th><code>sandbox="" seamless=""</code>
<th><code>sandbox="allow-top-navigation"</code>
<th><code>sandbox="allow-top-navigation" seamless=""</code>

<tbody>
<tr>
<td>none specified, for links and form submissions
<td>current
<td>master
<td>current
<td>master
<td>current
<td>master

<tr>
<td>empty string
<td>current
<td>master
<td>current
<td>master
<td>current
<td>master

<tr>
<td><code>_blank</code>
<td>new
<td>new
<td>maybe new
<td>maybe new
<td>maybe new
<td>maybe new

Expand All @@ -482,34 +465,22 @@
<td>current
<td>current
<td>current
<td>current
<td>current
<td>current

<tr>
<td><code>_parent</code> if there isn't a parent
<td>current
<td>current
<td>current
<td>current
<td>current
<td>current

<tr>
<td><code>_parent</code> if parent is also top
<td>parent/top
<td>parent/top
<td>none
<td>none
<td>parent/top
<td>parent/top

<tr>
<td><code>_parent</code> if there is one and it's not top
<td>parent
<td>parent
<td>none
<td>none
<td>none
<td>none

Expand All @@ -518,25 +489,16 @@
<td>current
<td>current
<td>current
<td>current
<td>current
<td>current

<tr>
<td><code>_top</code> if top is not current
<td>top
<td>top
<td>none
<td>none
<td>top
<td>top

<tr>
<td>name that doesn't exist
<td>new
<td>new
<td>maybe new
<td>maybe new
<td>maybe new
<td>maybe new

Expand All @@ -545,43 +507,28 @@
<td>specified descendant
<td>specified descendant
<td>specified descendant
<td>specified descendant
<td>specified descendant
<td>specified descendant

<tr>
<td>name that exists and is current
<td>current
<td>current
<td>current
<td>current
<td>current
<td>current

<tr>
<td>name that exists and is an ancestor that is top
<td>specified ancestor
<td>specified ancestor
<td>none
<td>none
<td>specified ancestor/top
<td>specified ancestor/top

<tr>
<td>name that exists and is an ancestor that is not top
<td>specified ancestor
<td>specified ancestor
<td>none
<td>none
<td>none
<td>none

<tr>
<td>other name that exists with common top
<td>specified
<td>specified
<td>none
<td>none
<td>none
<td>none

Expand All @@ -590,25 +537,16 @@
<td>specified
<td>specified
<td>specified
<td>specified
<td>specified
<td>specified

<tr>
<td>name that exists with different top, if familiar but not <a>one permitted sandboxed navigator</a>
<td>specified
<td>specified
<td>none
<td>none
<td>none
<td>none

<tr>
<td>name that exists with different top, not familiar
<td>new
<td>new
<td>maybe new
<td>maybe new
<td>maybe new
<td>maybe new

Expand Down Expand Up @@ -671,16 +609,8 @@

<ol>

<li>

If the given browsing context name is the empty string or <code>_self</code>, then
the chosen browsing context must be the current one.

If the given browsing context name is <code>_self</code>, then this is an
<a>explicit self-navigation override</a>, which overrides the behavior of the
<a>seamless browsing context flag</a> set by the <code>seamless</code> attribute on <{iframe}> elements.

</li>
<li>If the given browsing context name is the empty string or <code>_self</code>, then
the chosen browsing context must be the current one.</li>

<li>If the given browsing context name is <code>_parent</code>, then the chosen
browsing context must be the <a><em>parent</em> browsing context</a> of the current one,
Expand All @@ -691,24 +621,16 @@
context must be the <a>top-level browsing context</a> of the current one, if there is one,
or else the current browsing context.</li>

<li>

If the given browsing context name is not <code>_blank</code> and there exists a
<li>If the given browsing context name is not <code>_blank</code> and there exists a
browsing context whose <a lt="browsing context name">name</a> is the same as the given
browsing context name, and the current browsing context is familiar with that
browsing context, and the user agent determines that the two browsing contexts are related
enough that it is ok if they reach each other, then that browsing context must be the chosen
one. If there are multiple matching browsing contexts, the user agent should select one in some
arbitrary consistent manner, such as the most recently opened, most recently focused, or more
closely related.

If the browsing context is chosen by this step to be the current browsing context, then this
is also an <a>explicit self-navigation override</a>.

</li>
closely related.</li>

<li>

Otherwise, a new browsing context is being requested, and what happens depends on the user
agent's configuration and abilities &mdash; it is determined by the rules given for the first
applicable option from the following list:
Expand Down Expand Up @@ -2169,21 +2091,6 @@

</dd>

<dt>The <dfn>sandboxed seamless iframes flag</dfn></dt>

<dd>

This flag prevents content from using the <code>seamless</code>
attribute on descendant <{iframe}> elements.

<p class="note">
This prevents a page inserted using the <code>allow-same-origin</code> keyword from using a
CSS-selector-based method of probing the DOM of other pages on the same site (in particular,
pages that contain user-sensitive information).
</p>

</dd>

<dt>The <dfn lt="sandboxed into a unique origin|sandboxed origin browsing context flag">sandboxed origin browsing context flag</dfn></dt>

<dd>
Expand Down Expand Up @@ -2310,8 +2217,6 @@

<li>The <a>sandboxed plugins browsing context flag</a>.</li>

<li>The <a>sandboxed seamless iframes flag</a>.</li>

<li>

The <a>sandboxed origin browsing context flag</a>, unless the <var>tokens</var> contains the <dfn><code>allow-same-origin</code></dfn>
Expand Down Expand Up @@ -3756,14 +3661,6 @@

</li>

<li><dfn lt="cause links to open in the parent browsing context"></dfn>If the <a>source browsing context</a> is the same as the
<a>browsing context</a> being navigated, and this browsing context has its <a>seamless
browsing context flag</a> set, and the <a>browsing context</a> being navigated was not
chosen using an <dfn>explicit self-navigation override</dfn>, then find the nearest
<a>ancestor browsing context</a> that does not have its <a>seamless browsing context
flag</a> set, and continue these steps as if <em>that</em> <a>browsing context</a> was
the one that was going to be <a>navigated</a> instead.</li>

<li>If there is a preexisting attempt to navigate the <a>browsing context</a>, and the
<a>source browsing context</a> is the same as the <a>browsing context</a> being
navigated, and that attempt is currently running the <a>unload a document</a> algorithm,
Expand Down
38 changes: 19 additions & 19 deletions sections/dom.include
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1197,10 +1197,10 @@

This specification includes extra constraints on the exact value of <code>Text</code> nodes and
attribute values depending on their precise context.
For elements in HTML, the constraints of the <a>Text</a> <a>content model</a> also depends on the

For elements in HTML, the constraints of the <a>Text</a> <a>content model</a> also depends on the
<a>kind of element</a>. For instance, an "<code>&lt;</code>" inside a <{textarea}> element does
not need to be escaped in HTML because <{textarea}> is an <a>escapable raw text</a> element.
not need to be escaped in HTML because <{textarea}> is an <a>escapable raw text</a> element.
(This does not apply to XHTML. In XHTML, the <a>kind of element</a> doesn't affect the constraints
of <a>content model</a>: <a>Text</a>.)

Expand Down Expand Up @@ -1771,7 +1771,7 @@

<h5 id="the-title-attribute">The <code>title</code> attribute</h5>

The <dfn element-attr for="global,figure,div,img,textarea,meter"><code>title</code></dfn>
The <dfn element-attr for="global,figure,div,img,textarea,meter"><code>title</code></dfn>
attribute <a>represents</a> advisory information for the
element, such as would be appropriate for a tooltip. On a link, this could be the title or a
description of the target resource; on an image, it could be the image credit or a description of
Expand Down Expand Up @@ -1868,15 +1868,15 @@
The attribute in no namespace with no prefix and with the literal localname
"<{xml/lang|xml:lang}>" has no effect on language processing.
</p>

<p class="warning" id="lang-warning">
The language of <a>HTML documents</a> is indicated using a <{global/lang}> attribute (on the <{HTML}>
element itself, to indicate the primary language of the document, and on individual elements,
to indicate a change in language). It provides an explicit indication to user agents about the
language of content, so an appropriate language dictionary can be used and, in the case of screen
readers and similar assistive technologies with voice output, the content is pronounced using the
correct voice / language library (where available). <strong>Setting of a language using the <{global/lang}>
attribute which does not match the language of the document or document parts will result in some
The language of <a>HTML documents</a> is indicated using a <{global/lang}> attribute (on the <{HTML}>
element itself, to indicate the primary language of the document, and on individual elements,
to indicate a change in language). It provides an explicit indication to user agents about the
language of content, so an appropriate language dictionary can be used and, in the case of screen
readers and similar assistive technologies with voice output, the content is pronounced using the
correct voice / language library (where available). <strong>Setting of a language using the <{global/lang}>
attribute which does not match the language of the document or document parts will result in some
users being unable to understand the content</strong>.
</p>

Expand Down Expand Up @@ -1904,16 +1904,16 @@
and the corresponding language tag is the empty string.

<p class="example">
For example, if a document is delivered over HTTP and the <code>Content-Language</code> HTTP
header is specified with a value "<code>en</code>", then for any element in the document
that does not itself have a <{global/lang}> attribute nor any ancestor of that element, the
fallback language for the element will be English. If the value of the
For example, if a document is delivered over HTTP and the <code>Content-Language</code> HTTP
header is specified with a value "<code>en</code>", then for any element in the document
that does not itself have a <{global/lang}> attribute nor any ancestor of that element, the
fallback language for the element will be English. If the value of the
<code>Content-Language</code> header was "<code>de, fr, it</code>" then the language of the
node is unknown. <a href="http://www.w3.org/International/questions/qa-http-and-lang">This
article</a> provides some additional guidance on the use of HTTP headers, and <{meta}>
node is unknown. <a href="http://www.w3.org/International/questions/qa-http-and-lang">This
article</a> provides some additional guidance on the use of HTTP headers, and <{meta}>
elements for providing language information.
</p>

If the resulting value is not a recognized language tag, then it must be treated as an unknown
language having the given language tag, distinct from all other languages. For the purposes of
round-tripping or communicating with other services that expect language tags, user agents
Expand Down
7 changes: 2 additions & 5 deletions sections/rendering.include
View file
Original file line number Diff line number Diff line change
Expand Up @@ -143,9 +143,8 @@
For each property in the table below, given a <{body}> element, the first attribute
that exists <a>maps to the pixel length property</a> on the <{body}> element. If
none of the attributes for a property are found, or if the value of the attribute that was found
cannot be parsed successfully, then, if the <{body}> element's <a>node document</a>'s
<a>browsing context</a> does not have its <a>seamless browsing context flag</a> set, a
default value of 8px is expected to be used for that property instead.
cannot be parsed successfully, then, then a default value of 8px is expected to be used for that
property instead.

<table>
<thead>
Expand Down Expand Up @@ -1240,8 +1239,6 @@ path: includes/cldr.include
<pre highlight="css">
@namespace url(http://www.w3.org/1999/xhtml);

iframe:not([seamless]) { border: 2px inset; }
iframe[seamless] { display: block; }
video { object-fit: contain; }
</pre>

Expand Down
Loading

0 comments on commit 6905d82

Please sign in to comment.