diff --git a/docs/guides/bs5migration/index.md b/docs/guides/bs5migration/index.md index b0981c6b0a..b96fda8585 100644 --- a/docs/guides/bs5migration/index.md +++ b/docs/guides/bs5migration/index.md @@ -402,3 +402,52 @@ The `.rounded-sm` and `.rounded-lg` classes have been replaced with `.rounded-1` ``` + +### Screen reader utilities + +"Screen reader" classes are now "visually hidden" classes. + +- Renamed `.sr-only` and `.sr-only-focusable` to `.visually-hidden` and `.visually-hidden-focusable`. +- Renamed `sr-only()` and `sr-only-focusable()` mixins to `visually-hidden()` and `visually-hidden-focusable()`. + + + +```html + + Visually hidden text + +``` + + + + + +```html + + Visually hidden text + +``` + + + + + +```scss +.my-hidden-text { + @include sr-only(); + @include sr-only-focusable(); +} +``` + + + + + +```scss +.my-hidden-text { + @include visually-hidden(); + @include visually-hidden-focusable(); +} +``` + +