diff options
Diffstat (limited to 'site/content/docs/4.3/utilities/image-replacement.md')
-rw-r--r-- | site/content/docs/4.3/utilities/image-replacement.md | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/site/content/docs/4.3/utilities/image-replacement.md b/site/content/docs/4.3/utilities/image-replacement.md new file mode 100644 index 0000000000..e172872fa1 --- /dev/null +++ b/site/content/docs/4.3/utilities/image-replacement.md @@ -0,0 +1,35 @@ +--- +layout: docs +title: Image replacement +description: Swap text for background images with the image replacement class. +group: utilities +--- + +{{< callout warning >}} +##### Warning + +The `text-hide()` class and mixin has been deprecated as of v4.1. It will be removed entirely in v5. +{{< /callout >}} + +Utilize the `.text-hide` class or mixin to help replace an element's text content with a background image. + +{{< highlight html >}} +<h1 class="text-hide">Custom heading</h1> +{{< /highlight >}} + +{{< highlight scss >}} +// Usage as a mixin +.heading { + @include text-hide; +} +{{< /highlight >}} + +Use the `.text-hide` class to maintain the accessibility and SEO benefits of heading tags, but want to utilize a `background-image` instead of text. + +<div class="bd-example"> + <h1 class="text-hide" style="background-image: url('/docs/{{< param docs_version >}}/assets/brand/bootstrap-solid.svg'); width: 50px; height: 50px;">Bootstrap</h1> +</div> + +{{< highlight html >}} +<h1 class="text-hide" style="background-image: url('...');">Bootstrap</h1> +{{< /highlight >}} |