0
0
mirror of https://github.com/twbs/bootstrap.git synced 2025-01-10 03:46:13 +01:00
Bootstrap/site/content/docs/4.5/utilities/image-replacement.md
XhmikosR b46f05a948 Switch to Hugo
This commit includes all the needed workarounds and most changes from the main branch for everything to work, like:

* removing empty lines in raw HTML that break output
* read .browserslistrc, CSS variables from disk instead of duplicating it
* using Hugo mounts
* using Hugo for the docs CSS/JS
* move ToC Sass code to a separate file while adapting it for Hugo

Thus, this patch makes our npm scripts faster since lint runs on one step and there's no separate docs assets processing.
2020-11-19 11:22:22 +02:00

36 lines
968 B
Markdown

---
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.
```html
<h1 class="text-hide">Custom heading</h1>
```
```scss
// Usage as a mixin
.heading {
@include text-hide;
}
```
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>
```html
<h1 class="text-hide" style="background-image: url('...');">Bootstrap</h1>
```