summaryrefslogtreecommitdiffstats
path: root/site/content/docs/5.2/forms/range.md
diff options
context:
space:
mode:
Diffstat (limited to 'site/content/docs/5.2/forms/range.md')
-rw-r--r--site/content/docs/5.2/forms/range.md49
1 files changed, 49 insertions, 0 deletions
diff --git a/site/content/docs/5.2/forms/range.md b/site/content/docs/5.2/forms/range.md
new file mode 100644
index 0000000..5c4f026
--- /dev/null
+++ b/site/content/docs/5.2/forms/range.md
@@ -0,0 +1,49 @@
+---
+layout: docs
+title: Range
+description: Use our custom range inputs for consistent cross-browser styling and built-in customization.
+group: forms
+toc: true
+---
+
+## Overview
+
+Create custom `<input type="range">` controls with `.form-range`. The track (the background) and thumb (the value) are both styled to appear the same across browsers. As only Firefox supports "filling" their track from the left or right of the thumb as a means to visually indicate progress, we do not currently support it.
+
+{{< example >}}
+<label for="customRange1" class="form-label">Example range</label>
+<input type="range" class="form-range" id="customRange1">
+{{< /example >}}
+
+## Disabled
+
+Add the `disabled` boolean attribute on an input to give it a grayed out appearance, remove pointer events, and prevent focusing.
+
+{{< example >}}
+<label for="disabledRange" class="form-label">Disabled range</label>
+<input type="range" class="form-range" id="disabledRange" disabled>
+{{< /example >}}
+
+## Min and max
+
+Range inputs have implicit values for `min` and `max`—`0` and `100`, respectively. You may specify new values for those using the `min` and `max` attributes.
+
+{{< example >}}
+<label for="customRange2" class="form-label">Example range</label>
+<input type="range" class="form-range" min="0" max="5" id="customRange2">
+{{< /example >}}
+
+## Steps
+
+By default, range inputs "snap" to integer values. To change this, you can specify a `step` value. In the example below, we double the number of steps by using `step="0.5"`.
+
+{{< example >}}
+<label for="customRange3" class="form-label">Example range</label>
+<input type="range" class="form-range" min="0" max="5" step="0.5" id="customRange3">
+{{< /example >}}
+
+## Sass
+
+### Variables
+
+{{< scss-docs name="form-range-variables" file="scss/_variables.scss" >}}