Skip to content

Commit 8e1b30c

Browse files
author
jihyerish
committed
[css-round-display] Modify notes related to shape media feature
1 parent 727cf6b commit 8e1b30c

File tree

1 file changed

+15
-3
lines changed

1 file changed

+15
-3
lines changed

css-round-display/Overview.bs

Lines changed: 15 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -186,10 +186,22 @@ It accepts the following values:
186186
</figcaption>
187187
</div>
188188
</div>
189-
190-
<p class="note">Note: There are cases when the UA may know the shape even in the absence of OS APIs. For example, when rendering to PDF, the shape is known to be a rectangle, so 'shape: rect' evaluates to ''true'' while ''shape: round'' to ''false''
189+
<p class="note">
190+
Note: So far, the only standard APIs of Operating System which exposes
191+
information about the display's shape is
192+
<a href="http://developer.android.com/intl/es/reference/android/content/res/Configuration.html#isScreenRound%28%29">''isScreenRound()'' API</a>
193+
in Android.
194+
<a href="http://developer.android.com/intl/es/reference/android/content/res/Configuration.html#isScreenRound%28%29">''isScreenRound()'' API</a>
195+
returns a boolean that says round or not.<br>
196+
Refered the semantics of this API, when isScreenRound() returns ''true'', ''shape: round'' should evaluate
197+
to ''true''
198+
and ''shape: rect'' should evaluate to ''false'' when isScreenRound() returns ''false''.<br>
199+
'shape' is dealing with 2 shapes, but it can be extended if there are the needs about
200+
configuring other shapes from the developers.
191201
</p>
192-
<p class="note">Note: For other shapes, such as polygons, we need to extend the media features with additional parameters. The current features have limitations to support the diversity beyond round shapes. How can we express star-shaped polygons? (e.g. SVG syntax, etc.) Of course, there is a trade-off between simplicity and expressiveness.
202+
<p class="note">Note: There are cases when the UA may know the shape even in the absence of OS APIs.
203+
For example, when rendering to PDF, the shape is known to be a rectangle, so 'shape: rect' evaluates to
204+
''true'' while ''shape: round'' to ''false''
193205
</p>
194206

195207
Extending the @viewport rule {#extending-viewport-rule}

0 commit comments

Comments
 (0)