Skip to content

Commit 7b3d7e0

Browse files
authored
Merge pull request #715 from patrickhlauke/mediaqueries4-pointer-hover
[mediaqueries-4] expand/change emphasis of advice for use of pointer/hover/any-pointer/any-hover
2 parents b58a3d3 + 580529b commit 7b3d7e0

File tree

1 file changed

+17
-11
lines changed

1 file changed

+17
-11
lines changed

mediaqueries/Overview.bs

Lines changed: 17 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1607,7 +1607,7 @@ Pointing Device Quality: the 'pointer' feature</h3>
16071607
Type: discrete
16081608
</pre>
16091609

1610-
The 'pointer' media feature is used to query about the presence and accuracy of a pointing device such as a mouse.
1610+
The 'pointer' media feature is used to query the presence and accuracy of a pointing device such as a mouse.
16111611
If a device has multiple input mechanisms,
16121612
the 'pointer' media feature must reflect the characteristics of the “primary” input mechanism,
16131613
as determined by the user agent.
@@ -1646,6 +1646,10 @@ Pointing Device Quality: the 'pointer' feature</h3>
16461646
even on devices whose pointing device can be described as ''fine'',
16471647
the UA may give a value of ''coarse'' or ''pointer/none'' to this media query,
16481648
to indicate that the user has difficulties manipulating the pointing device accurately or at all.
1649+
In addition, even if the primary input mechanism has ''fine'' pointing accuracy,
1650+
there may be additional ''coarse'' input mechanisms available to the user. Authors may
1651+
wish to query the 'any-pointer' media feature to take these other ''coarse'' potential
1652+
input mechanisms into account.
16491653

16501654
<div class="example">
16511655
<pre>
@@ -1709,6 +1713,8 @@ Hover Capability: the 'hover' feature</h3>
17091713
For accessibility reasons, even on devices that do support hovering,
17101714
the UA may give a value of ''hover: none'' to this media query,
17111715
to opt into layouts that work well without hovering.
1716+
Note that even if the primary input mechanism has 'hover: hover' capability,
1717+
there may be additional input mechanisms available to the user that do not provide hover capabilities.
17121718

17131719
<div class="example">
17141720
<pre>
@@ -1723,7 +1729,7 @@ Hover Capability: the 'hover' feature</h3>
17231729
</div>
17241730

17251731
<h3 id='any-input'>
1726-
Rare Interaction Capabilities: the 'any-pointer' and 'any-hover' features</h3>
1732+
All Available Interaction Capabilities: the 'any-pointer' and 'any-hover' features</h3>
17271733

17281734
<pre class='descdef mq'>
17291735
Name: any-pointer
@@ -1747,17 +1753,17 @@ Rare Interaction Capabilities: the 'any-pointer' and 'any-hover' features</h3>
17471753
or there are no pointing devices at all.
17481754

17491755
<div class="note">
1750-
These two media features are best suited to provide refinements over 'hover' and 'pointer',
1751-
and it is rarely appropriate to use them
1752-
without having first designed the main style and interaction mode of the page
1753-
to suit the primary input mechanism.
1754-
Once that has been taken into account, 'any-hover' and 'any-pointer' can be used
1755-
to see if some extra conveniences or non essential controls
1756-
can be offered to users who have additional ways to interact.
1756+
While 'pointer' and 'hover' can be used to design the main style and interaction
1757+
mode of the page to suit the primary input mechanism, 'any-pointer' and 'any-hover'
1758+
can be used to potentially take into account all possible types of pointers
1759+
that have been detected.
17571760

17581761
Designing a page that relies on hovering or accurate pointing
1759-
only because 'any-hover' or 'any-pointer' indicate that an input mechanism with these capabilities is available,
1760-
is likely to result in a poor experience.
1762+
only because 'any-hover' or 'any-pointer' indicate that at least one of the available
1763+
input mechanisms has these capabilities is likely to result in a poor experience.
1764+
However, authors may use this information to inform their decision about the style and
1765+
functionality they wish to provide based on additional input mechanisms that
1766+
are available to the user.
17611767
</div>
17621768

17631769
<div class="example">

0 commit comments

Comments
 (0)