@arcgis/common-components 5.1.0-next.14 → 5.1.0-next.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -18,17 +18,19 @@ import type { Popover as Popover } from "@esri/calcite-components/components/cal
18
18
  * </arcgis-slider>
19
19
  * ```
20
20
  *
21
- * ### Which slider should you use: arcgis-slider or calcite-slider?
21
+ * > ### Which slider should you use: `arcgis-slider` or `calcite-slider`?
22
22
  * >
23
- * > In general, use [calcite-slider](https://developers.arcgis.com/calcite-design-system/components/slider/) over `arcgis-slider`.
24
- * > It covers common slider use cases and works well in most scenarios.
23
+ * > It is recommended to use [`calcite-slider`](https://developers.arcgis.com/calcite-design-system/components/slider/) for most use cases, as the component
24
+ * > offers a consistent UI/UX and accommodates the majority of implementations.
25
25
  * >
26
- * > Use `arcgis-slider` only when you need functionality that `calcite-slider` does not provide, such as:
27
- * > * [layout](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#layout): `arcgis-slider` supports `layout="vertical"`.
28
- * > * Custom range display: `arcgis-slider` supports [fullRangeMin](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#fullRangeMin) and [fullRangeMax](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#fullRangeMax) for displaying a wider
29
- * > range than the interactive range.
30
- * > * More than two values: `arcgis-slider` supports an arbitrary number of slider values, beyond single-value or range (two-value) sliders.
31
- * > * Slot support: Use the `content-start`, `content-end`, and `popover` slots to render custom content before the track, after the track, or inside the popover.
26
+ * > Use `arcgis-slider` for advanced use cases, where solutions seek the following:
27
+ * >
28
+ * > * [layout](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#layout): configurations, where `arcgis-slider` offers a `layout` of `"vertical"`.
29
+ * > * Display more than two values in the component.
30
+ * > * A custom range display, where `arcgis-slider` supports [fullRangeMin](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#fullRangeMin) and
31
+ * > [fullRangeMax](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#fullRangeMax) for displaying a wider range than the interactive range.
32
+ * > * Additional slot configurations for adding elements within or over the component, where `arcgis-slider` can slot
33
+ * > content using the `content-start`, `content-end`, and `popover` slots.
32
34
  *
33
35
  * @slot [content-start] - A slot for elements before the track.
34
36
  * @slot [content-end] - A slot for elements after the track.