0
0
mirror of https://github.com/twbs/bootstrap.git synced 2024-12-04 16:24:22 +01:00
Bootstrap/site/content/docs/5.3/helpers/stretched-link.md
Julien Déramond 8befabbde9
Docs: display examples based on the docs current color mode (#37562)
* Docs: display examples based on the docs current color mode

* Fix _default/examples.html
2022-12-28 22:58:35 -08:00

4.1 KiB

layout title description group
docs Stretched link Make any HTML element or Bootstrap component clickable by "stretching" a nested link via CSS. helpers

Add .stretched-link to a link to make its containing block clickable via a ::after pseudo element. In most cases, this means that an element with position: relative; that contains a link with the .stretched-link class is clickable. Please note given how CSS position works, .stretched-link cannot be mixed with most table elements.

Cards have position: relative by default in Bootstrap, so in this case you can safely add the .stretched-link class to a link in the card without any other HTML changes.

Multiple links and tap targets are not recommended with stretched links. However, some position and z-index styles can help should this be required.

{{< example >}}

{{< placeholder width="100%" height="180" class="card-img-top" text="false" title="Card image cap" >}}
Card with stretched link

Some quick example text to build on the card title and make up the bulk of the card's content.

Go somewhere
{{< /example >}}

Most custom components do not have position: relative by default, so we need to add the .position-relative here to prevent the link from stretching outside the parent element.

{{< example >}}

{{< placeholder width="144" height="144" class="flex-shrink-0 me-3" text="false" title="Generic placeholder image" >}}
Custom component with stretched link

This is some placeholder content for the custom component. It is intended to mimic what some real-world content would look like, and we're using it here to give the component a bit of body and size.

Go somewhere
{{< /example >}}

{{< example >}}

{{< placeholder width="100%" height="200" class="w-100" text="false" title="Generic placeholder image" >}}
Columns with stretched link

Another instance of placeholder content for this other custom component. It is intended to mimic what some real-world content would look like, and we're using it here to give the component a bit of body and size.

Go somewhere
{{< /example >}}

Identifying the containing block

If the stretched link doesn't seem to work, the containing block will probably be the cause. The following CSS properties will make an element the containing block:

  • A position value other than static
  • A transform or perspective value other than none
  • A will-change value of transform or perspective
  • A filter value other than none or a will-change value of filter (only works on Firefox)

{{< example >}}

{{< placeholder width="100%" height="180" class="card-img-top" text="false" title="Card image cap" >}}
Card with stretched links

Some quick example text to build on the card title and make up the bulk of the card's content.

Stretched link will not work here, because position: relative is added to the link

This stretched link will only be spread over the p-tag, because a transform is applied to it.

{{< /example >}}