Skip to content

Commit 36e9042

Browse files
committed
[css-ui-4] Add text-overflow:fade and text-overflow:fade()
1 parent b46351d commit 36e9042

File tree

1 file changed

+72
-0
lines changed

1 file changed

+72
-0
lines changed

css-ui-4/Overview.bs

+72
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,78 @@ Abstract: This is a delta specification over CSS-UI Level 3.
7070

7171
Issue: Add final level 3 content
7272

73+
This specification introduces a new value to the 'text-overflow' property:
74+
''text-overflow/fade'', as well as its functional notation variant ''fade()''.
75+
76+
<pre class='partial propdef'>
77+
Name: text-overflow
78+
New values: ''fade'' | <<fade()>>
79+
Computed value: As specified, with <<length>> converted to absolute units
80+
</pre>
81+
82+
<dl dfn-type=value dfn-for=text-overflow>
83+
<dt dfn-type=function><dfn>fade( <<length>> | <<percentage>> )</dfn></dt>
84+
<dd>Clip inline content that overflows its line box.
85+
Characters may be only partially rendered.
86+
In addition, the UA must apply a fade out effect
87+
near the edge of the line box,
88+
reaching complete transparency at the edge.
89+
90+
Issue: Do we need to define the way
91+
the fade out is calculated
92+
so that the fading is identical across browsers?
93+
It should probably be something like
94+
''mask-image: linear-gradient(to right, rgba(0,0,0,1), rgba(0,0,0,0))'',
95+
except applied to the relevant portion of the line only.
96+
97+
The argument determines the distance
98+
over which the fade effect is applied.
99+
The <<percentage>> is resolved against the width of the line box.
100+
Values lower than 0 are clipped to 0.
101+
Values greater than the width of the line box are clipped to the width of the line box.
102+
103+
Issue: If the line box is too short
104+
to display the fade effect at the desired length,
105+
should we drop the effect,
106+
or shrink the distance it is applied over until it fits,
107+
or clip the end of the fade?
108+
109+
<dt><dfn>fade</dfn></dt>
110+
<dd>Same as ''fade()'',
111+
but the distance over which the fading effect is applied
112+
is determined by the UA.
113+
''1em'' is suggested as a reasonable value.
114+
</dl>
115+
116+
<div class="example">
117+
118+
<style>
119+
</style>
120+
<table style="color:#000;background:#fff" id="awesome-table"><tbody>
121+
<tr><th>HTML</th><th>sample rendering</th><th>your browser</th></tr>
122+
123+
<tr>
124+
<td><pre><code class="lang-markup">&lt;div style="<strong>text-overflow:fade;</strong> overflow:hidden"&gt;
125+
CSS IS AWESOME, YES
126+
&lt;/div&gt;
127+
</code></pre></td>
128+
129+
<td>
130+
<object type="image/png" data="images/cssisfade.png">
131+
a box with the text fading out on overflow.
132+
</object></td>
133+
134+
<td>
135+
<div style="width:3.1em; border:solid .1em black; padding:.2em; font-family:Helvetica,sans-serif; line-height:1.1; overflow:hidden;text-overflow:clip;">CSS IS AWESOME, YES</div>
136+
</td>
137+
</tr>
138+
</table>
139+
140+
</div>
141+
142+
143+
144+
73145
<h2 id="pointing-keyboard">Pointing Devices and Keyboards</h2>
74146

75147
<h3 id="pointer-interaction">Pointer interaction</h3>

0 commit comments

Comments
 (0)