diff --git a/site/content/docs/5.3/components/progress.md b/site/content/docs/5.3/components/progress.md index 73f131589763..80b1df44990c 100644 --- a/site/content/docs/5.3/components/progress.md +++ b/site/content/docs/5.3/components/progress.md @@ -75,13 +75,15 @@ Add labels to your progress bars by placing text within the `.progress-bar`. {{< /example >}} -Note that by default, the content inside the `.progress-bar` is controlled with `overflow: hidden`, so it doesn't bleed out of the bar. If your progress bar is shorter than its label, the content will be capped and may become unreadable. To change this behavior, you can use `.overflow-visible` from the [overflow utilities]({{< docsref "/utilities/overflow" >}}), but make sure to also define an explicit [text color]({{< docsref "/utilities/colors#colors" >}}) so the text remains readable. Be aware though that currently this approach does not take into account [color modes]({{< docsref "/customize/color-modes" >}}). +### Long labels -{{< example >}} -
-
Long label text for the progress bar, set to a dark color
-
-{{< /example >}} +Note that by default, the content inside the `.progress-bar` is controlled with `overflow: hidden`, so it doesn't bleed out of the bar. If your progress bar is shorter than its label, the content will be capped and may become unreadable. To change this behavior, you can use `.overflow-visible` from the [overflow utilities]({{< docsref "/utilities/overflow" >}}). + +{{< callout warning >}} +**Accessibility warning:** Long labels may not be fully accessible with this method. As it relies on the text color having the right contrast ratio with both the `.progress` and `.progress-bar` background colors, your color palette could be incompatible with this approach. + +If the text can overlap the progress bar, we often recommend displaying the label outside of the progress bar for better accessibility. +{{< /callout >}} ## Backgrounds @@ -106,28 +108,20 @@ Use background utility classes to change the appearance of individual progress b {{< partial "callouts/warning-color-assistive-technologies.md" >}} {{< /callout >}} -If you're adding labels to progress bars with a custom background color, make sure to also set an appropriate [text color]({{< docsref "/utilities/colors#colors" >}}), so the labels remain readable and have sufficient contrast. +If you're adding labels to progress bars with a custom background color, make sure to also set an appropriate [text color]({{< docsref "/utilities/colors#colors" >}}), so the labels remain readable and have sufficient contrast. We recommend using the [color and background]({{< docsref "/helpers/color-background" >}}) helper classes. {{< example >}}
-
25%
+
25%
-
50%
+
50%
-
75%
+
75%
-
100%
-
-{{< /example >}} - -Alternatively, you can use the new combined [color and background]({{< docsref "/helpers/color-background" >}}) helper classes. - -{{< example >}} -
-
75%
+
100%
{{< /example >}}