Skip to content

Commit

Permalink
Slider (Multi-Thumb) Pattern: Revise description and add example link…
Browse files Browse the repository at this point in the history
… (pull #437)

For issue #221:

1. revised description to describe thumb dependencies.
2. Added link to example.
3. Removed link to example development issue.
4. Revise states and properties to describe when updates to maxvalue and minvalue are needed.
  • Loading branch information
jongund authored and mcking65 committed Aug 28, 2017
1 parent c91dc3d commit 90dca45
Showing 1 changed file with 10 additions and 8 deletions.
18 changes: 10 additions & 8 deletions aria-practices.html
Original file line number Diff line number Diff line change
Expand Up @@ -1722,23 +1722,24 @@ <h4>WAI-ARIA Roles, States, and Properties</h4>
<section class="widget" id="slidertwothumb">
<h3>Slider (Multi-Thumb)</h3>
<p>
Work on this design pattern is in progress and is tracked in
<strong>NOTE:</strong> Revisions to this pattern are in progress.
Please provide feedback in
<a href="https://github.com/w3c/aria-practices/issues/221">issue 221.</a>
Please provide any feedback in that issue.
</p>
<p>
A multi-thumb slider is a slider with two or more thumbs that each set a value in a group of related values.
A multi-thumb slider is a slider with two or more thumbs that each set a value in a group of related values, for example selecting a price range for a product or service.
Many two-thumb sliders set a maximum and minimum value for a range, and the thumbs are not allowed to pass one another.
That is, the mthumb that sets the upper value of the range can not be set lower than the thumb that controls the lower value of the range.
That is, the thumb that sets the upper value of the range can not be set lower than the thumb that controls the lower value of the range.
For example, in a price range selector the thumb for the maxmimum value of the lower price is determined by the current value of the maxmimum price.
Conversly the minimum value of the higher price thumb is determined by the current value of the lower price.
However, in some multi-thumb sliders, each thumb sets a value that does not depend on the other thumb values.
</p>

<section class="notoc">
<h4>Example</h4>
<p>
Work to develop an example multi-thumb slider is tracked in
<a href="https://github.com/w3c/aria-practices/issues/124">issue 124.</a>
</p>
<ul>
<li><a href="examples/slider/multithumb-slider.html">Multi-Thumb Slider Examples</a>: Demonstrates a two thumb silder to pick a price range for an airline flight and a hotel reservation.</li>
</ul>
</section>

<section class="notoc">
Expand All @@ -1759,6 +1760,7 @@ <h4>WAI-ARIA Roles, States, and Properties</h4>
<li>Each slider element has the <a class="property-reference" href="#aria-valuenow">aria-valuenow</a> property set to a decimal value representing the current value of the slider.</li>
<li>Each slider element has the <a class="property-reference" href="#aria-valuemin">aria-valuemin</a> property set to a decimal value representing the minimum allowed value of the slider.</li>
<li>Each slider element has the <a class="property-reference" href="#aria-valuemax">aria-valuemax</a> property set to a decimal value representing the maximum allowed value of the slider.</li>
<li>When the range (e.g. minimum and/or maximum value) of another slider is dependent on the current value of a slider, the values of <a class="property-reference" href="#aria-valuemin">aria-valuemin</a> or <a class="property-reference" href="#aria-valuemax">aria-valuemax</a> of the dependent sliders must be updated when the value changes.
<li>
If a value of <code>aria-valuenow</code> is not user-friendly, e.g., the day of the week is represented by a number, the
<a class="property-reference" href="#aria-valuetext">aria-valuetext</a>
Expand Down

0 comments on commit 90dca45

Please sign in to comment.