Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/twbs/bootstrap.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat (limited to 'docs/4.1/utilities/image-replacement.md')
-rw-r--r--docs/4.1/utilities/image-replacement.md27
1 files changed, 27 insertions, 0 deletions
diff --git a/docs/4.1/utilities/image-replacement.md b/docs/4.1/utilities/image-replacement.md
new file mode 100644
index 0000000000..dc0982d6e9
--- /dev/null
+++ b/docs/4.1/utilities/image-replacement.md
@@ -0,0 +1,27 @@
+---
+layout: docs
+title: Image replacement
+description: Swap text for background images with the image replacement class.
+group: utilities
+toc: true
+---
+
+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>
+{% endhighlight %}
+
+{% highlight scss %}
+// Usage as a mixin
+.heading {
+ @include text-hide;
+}
+{% endhighlight %}
+
+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.
+
+{% capture example %}
+<h1 class="text-hide" style="background-image: url('/assets/brand/bootstrap-solid.svg'); width: 50px; height: 50px;">Bootstrap</h1>
+{% endcapture %}
+{% include example.html content=example %}