Skip to content

Commit bd0d906

Browse files
committed
Change "input mechanism" to "pointing device"
As `pointer`, `hover`, `any-pointer`, `any-hover` are only concerned with pointing devices, don't use the more generic/all-encompassing "input mechanism" (as that *would* cover things like keyboard, d-pads, etc) Also includes some very minor tweaks/corrections to existing wording/formatting
1 parent d9c2b5a commit bd0d906

1 file changed

Lines changed: 32 additions & 29 deletions

File tree

mediaqueries/Overview.bs

Lines changed: 32 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1597,15 +1597,15 @@ Interaction Media Features</h2>
15971597
</style>
15981598
</div>
15991599

1600-
The 'pointer' and 'hover' features relate to the characteristics of the “primary” input mechanism,
1601-
while 'any-pointer' and 'any-hover' can be used to query the properties of all potentially available input mechanisms.
1600+
The 'pointer' and 'hover' features relate to the characteristics of the “primary” pointing device,
1601+
while 'any-pointer' and 'any-hover' can be used to query the properties of all potentially available pointing devices.
16021602

1603-
Note: While this specification does not define how User Agents should decide what the “primary” input is,
1603+
Note: While this specification does not define how User Agents should decide what the “primary” pointing device is,
16041604
the expectation is that User Agents should make this determination
16051605
by combining knowledge about the device/environment they are running on,
1606-
the number and type of input mechanisms available,
1607-
and a notion of which of these inputs is generally and/or currently being used.
1608-
User Agents may also decide to dynamically change what type of input is deemed to be primary,
1606+
the number and type of pointing devices available,
1607+
and a notion of which of these is generally and/or currently being used.
1608+
User Agents may also decide to dynamically change what type of pointing device is deemed to be primary,
16091609
in response to changes in the user environment
16101610
or in the way the user is interacting with the UA.
16111611

@@ -1620,10 +1620,10 @@ Pointing Device Quality: the 'pointer' feature</h3>
16201620
</pre>
16211621

16221622
The 'pointer' media feature is used to query the presence and accuracy of a pointing device such as a mouse.
1623-
If a device has multiple input mechanisms,
1624-
the 'pointer' media feature must reflect the characteristics of the “primary” input mechanism,
1623+
If multiple pointing devices are present,
1624+
the 'pointer' media feature must reflect the characteristics of the “primary” pointing device,
16251625
as determined by the user agent.
1626-
(To query the capabilities of <em>any</em> available input mechanism,
1626+
(To query the capabilities of <em>any</em> available pointing devices,
16271627
see the 'any-pointer' media feature.)
16281628

16291629
<dl dfn-type=value dfn-for="@media/pointer">
@@ -1658,14 +1658,14 @@ Pointing Device Quality: the 'pointer' feature</h3>
16581658
even on devices whose pointing device can be described as ''fine'',
16591659
the UA may give a value of ''coarse'' or ''pointer/none'' to this media query,
16601660
to indicate that the user has difficulties manipulating the pointing device accurately or at all.
1661-
In addition, even if the primary input mechanism has ''fine'' pointing accuracy,
1662-
there may be additional ''coarse'' input mechanisms available to the user. Authors may
1661+
In addition, even if the primary pointing device has ''fine'' pointing accuracy,
1662+
there may be additional ''coarse'' pointing devices available to the user. Authors may
16631663
wish to query the 'any-pointer' media feature to take these other ''coarse'' potential
1664-
input mechanisms into account.
1664+
pointing devicess into account.
16651665

16661666
<div class="example">
16671667
<pre>
1668-
/* Make radio buttons and check boxes larger if we have an inaccurate pointing device */
1668+
/* Make radio buttons and check boxes larger if we have an inaccurate primary pointing device */
16691669
@media (pointer:coarse) {
16701670
input[type="checkbox"], input[type="radio"] {
16711671
min-width:30px;
@@ -1686,39 +1686,41 @@ Hover Capability: the 'hover' feature</h3>
16861686
Type: discrete
16871687
</pre>
16881688

1689-
The 'hover' media feature is used to query the user's ability to hover over elements on the page.
1690-
If a device has multiple input mechanisms,
1691-
the 'hover' media feature must reflect the characteristics of the “primary” input mechanism,
1689+
The 'hover' media feature is used to query the user's ability to hover over elements on the page
1690+
with the primary pointing device.
1691+
If a device has multiple pointing devices,
1692+
the 'hover' media feature must reflect the characteristics of the “primary” pointing device,
16921693
as determined by the user agent.
1693-
(To query the capabilities of <em>any</em> available input mechanism,
1694+
(To query the capabilities of <em>any</em> available pointing devices,
16941695
see the 'any-hover' media feature.)
16951696

16961697
<dl dfn-type=value dfn-for="@media/hover">
16971698
<dt><dfn>none</dfn>
16981699
<dd>
1699-
Indicates that the primary pointing system can't hover,
1700-
or there is no pointing system.
1701-
Examples include touchscreens and screens that use a drawing stylus.
1700+
Indicates that the primary pointing device can't hover,
1701+
or that there is no pointing device.
1702+
Examples include touchscreens and screens that use a basic drawing stylus.
17021703

1703-
Pointing systems that can hover,
1704+
Pointing devices that can hover,
17041705
but for which doing so is inconvenient and not part of the normal way they are used,
17051706
also match this value.
17061707
For example, a touchscreen where a long press is treated as hovering
17071708
would match ''hover: none''.
17081709

17091710
<dt><dfn>hover</dfn>
17101711
<dd>
1711-
Indicates that the primary pointing system can easily hover over parts of the page.
1712+
Indicates that the primary pointing device can easily hover over parts of the page.
17121713
Examples include mice and devices that physically point at the screen, like the Nintendo Wii controller.
17131714
</dl>
17141715

17151716
<div class='example'>
17161717
For example, on a touch screen device that can also be controlled by an optional mouse,
1717-
the 'hover' <a>media feature</a> should match ''hover/none'',
1718-
as the primary interaction mode (touching the screen) can't hover.
1718+
the 'hover' <a>media feature</a> should match ''hover: none'',
1719+
as the primary pointing device (the touch screen) does not allow the user to hover.
17191720

1721+
However, despite this, the optional mouse does allow users to hover.
17201722
Authors should therefore be careful not to assume that the ':hover' pseudo class
1721-
will never match on device where 'hover:none' is true,
1723+
will never match on a device where 'hover:none' is true,
17221724
but they should design layouts that do not depend on hovering to be fully usable.
17231725
</div>
17241726

@@ -1797,15 +1799,16 @@ All Available Interaction Capabilities: the 'any-pointer' and 'any-hover' featur
17971799

17981800
<div class="note">
17991801
While 'pointer' and 'hover' can be used to design the main style and interaction
1800-
mode of the page to suit the primary input mechanism, 'any-pointer' and 'any-hover'
1801-
can be used to potentially take into account all possible types of pointers
1802+
mode of the page to suit the primary input mechanism (based on the characteristics, or complete absence,
1803+
of the primary pointing device), 'any-pointer' and 'any-hover'
1804+
can be used to potentially take into account all possible types of pointing devices
18021805
that have been detected.
18031806

18041807
Designing a page that relies on hovering or accurate pointing
18051808
only because 'any-hover' or 'any-pointer' indicate that at least one of the available
18061809
input mechanisms has these capabilities is likely to result in a poor experience.
18071810
However, authors may use this information to inform their decision about the style and
1808-
functionality they wish to provide based on additional input mechanisms that
1811+
functionality they wish to provide based on any additional pointing devices that
18091812
are available to the user.
18101813
</div>
18111814

@@ -1818,7 +1821,7 @@ All Available Interaction Capabilities: the 'any-pointer' and 'any-hover' featur
18181821

18191822
The user may also have paired a Bluetooth mouse with the TV,
18201823
and occasionally use it for extra convenience,
1821-
but such the mouse is not the main way the TV is operated.
1824+
but this mouse is not the main way the TV is operated.
18221825
'pointer' still matches ''coarse'', while 'any-pointer' now both matches ''coarse'' and ''fine''.
18231826

18241827
Switching to small click targets based on the fact that ''(any-pointer: fine)'' is now true

0 commit comments

Comments
 (0)