Skip to content

Commit eda85e9

Browse files
committed
[css-display-3] Clarify that 'display' has no effect on semantics. w3c#2355
1 parent bd6fc02 commit eda85e9

1 file changed

Lines changed: 12 additions & 1 deletion

File tree

css-display-3/Overview.bs

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,7 @@ Introduction</h2>
126126
Note: Further information on the “aural” box tree
127127
and its interaction with the 'display' property
128128
can be found in the <a href="https://www.w3.org/TR/css3-speech/#aural-model">CSS Speech Module</a>.
129-
[[!CSS3-SPEECH]]
129+
[[!CSS-SPEECH-1]]
130130

131131
<h3 id="placement">
132132
Module interactions</h3>
@@ -177,6 +177,17 @@ Box Layout Modes: the 'display' property</h2>
177177
such as ''list-item'', which also generates a ''::marker'' pseudo-element,
178178
and ''display/none'', which causes the element's entire subtree to be left out of the box tree.
179179

180+
<div class="advisement">
181+
The 'display' property has no effect on an element’s semantics:
182+
these are defined by the <a>document language</a> and <em>are not affected by CSS</em>.
183+
Aside from the ''display/none'' value,
184+
which also affects aural/speech output [[!CSS-SPEECH-1]],
185+
the 'display' property only affects visual layout:
186+
its purpose is to allow designers freedom
187+
to change the layout behavior of an element
188+
<em>without</em> affecting the underlying document semantics.
189+
</div>
190+
180191
Values are defined as follows:
181192

182193
<pre class='prod'>

0 commit comments

Comments
 (0)