kopia lustrzana https://github.com/shoelace-style/shoelace
178 wiersze
4.6 KiB
Markdown
178 wiersze
4.6 KiB
Markdown
# Tooltip
|
|
|
|
[component-header:sl-tooltip]
|
|
|
|
Tooltips display additional information based on a specific action.
|
|
|
|
A tooltip's target is its _first child element_, so you should only wrap one element inside of the tooltip. If you need the tooltip to show up for multiple elements, nest them inside a container first.
|
|
|
|
Tooltips use `display: contents` so they won't interfere with how elements are positioned in a flex or grid layout.
|
|
|
|
```html preview
|
|
<sl-tooltip content="This is a tooltip">
|
|
<sl-button>Hover Me</sl-button>
|
|
</sl-tooltip>
|
|
```
|
|
|
|
## Examples
|
|
|
|
### Placement
|
|
|
|
Use the `placement` attribute to set the preferred placement of the tooltip.
|
|
|
|
```html preview
|
|
<div class="tooltip-placement-example">
|
|
<div class="tooltip-placement-example-row">
|
|
<sl-tooltip content="top-start" placement="top-start">
|
|
<sl-button></sl-button>
|
|
</sl-tooltip>
|
|
|
|
<sl-tooltip content="top" placement="top">
|
|
<sl-button></sl-button>
|
|
</sl-tooltip>
|
|
|
|
<sl-tooltip content="top-end" placement="top-end">
|
|
<sl-button></sl-button>
|
|
</sl-tooltip>
|
|
</div>
|
|
|
|
<div class="tooltip-placement-example-row">
|
|
<sl-tooltip content="left-start" placement="left-start">
|
|
<sl-button></sl-button>
|
|
</sl-tooltip>
|
|
|
|
<sl-tooltip content="right-start" placement="right-start" style="margin-left: 400px;">
|
|
<sl-button></sl-button>
|
|
</sl-tooltip>
|
|
</div>
|
|
|
|
<div class="tooltip-placement-example-row">
|
|
<sl-tooltip content="left" placement="left">
|
|
<sl-button></sl-button>
|
|
</sl-tooltip>
|
|
|
|
<sl-tooltip content="right" placement="right">
|
|
<sl-button></sl-button>
|
|
</sl-tooltip>
|
|
</div>
|
|
|
|
<div class="tooltip-placement-example-row">
|
|
<sl-tooltip content="left-end" placement="left-end">
|
|
<sl-button></sl-button>
|
|
</sl-tooltip>
|
|
|
|
<sl-tooltip content="right-end" placement="right-end">
|
|
<sl-button></sl-button>
|
|
</sl-tooltip>
|
|
</div>
|
|
|
|
<div class="tooltip-placement-example-row">
|
|
<sl-tooltip content="bottom-start" placement="bottom-start">
|
|
<sl-button></sl-button>
|
|
</sl-tooltip>
|
|
|
|
<sl-tooltip content="bottom" placement="bottom">
|
|
<sl-button></sl-button>
|
|
</sl-tooltip>
|
|
|
|
<sl-tooltip content="bottom-end" placement="bottom-end">
|
|
<sl-button></sl-button>
|
|
</sl-tooltip>
|
|
</div>
|
|
</div>
|
|
|
|
<style>
|
|
.tooltip-placement-example {
|
|
width: 250px;
|
|
}
|
|
|
|
.tooltip-placement-example-row:after {
|
|
content: '';
|
|
display: table;
|
|
clear: both;
|
|
}
|
|
|
|
.tooltip-placement-example sl-button {
|
|
float: left;
|
|
width: 2.5rem;
|
|
margin-right: 0.25rem;
|
|
margin-bottom: 0.25rem;
|
|
}
|
|
|
|
.tooltip-placement-example [placement='top-start'] sl-button,
|
|
.tooltip-placement-example [placement='bottom-start'] sl-button {
|
|
margin-left: calc(40px + 0.25rem);
|
|
}
|
|
|
|
.tooltip-placement-example [placement^='right'] sl-button {
|
|
margin-left: calc((40px * 3) + (0.25rem * 3));
|
|
}
|
|
</style>
|
|
```
|
|
|
|
### Click Trigger
|
|
|
|
Set the `trigger` attribute to `click` to toggle the tooltip on click instead of hover.
|
|
|
|
```html preview
|
|
<sl-tooltip content="Click again to dismiss" trigger="click">
|
|
<sl-button>Click to Toggle</sl-button>
|
|
</sl-tooltip>
|
|
```
|
|
|
|
### Manual Trigger
|
|
|
|
Tooltips can be controller programmatically by setting the `trigger` attribute to `manual`. Use the `open` attribute to control when the tooltip is shown.
|
|
|
|
```html preview
|
|
<sl-button style="margin-right: 4rem;">Toggle Manually</sl-button>
|
|
|
|
<sl-tooltip content="This is an avatar" trigger="manual" class="manual-tooltip">
|
|
<sl-avatar></sl-avatar>
|
|
</sl-tooltip>
|
|
|
|
<script>
|
|
const tooltip = document.querySelector('.manual-tooltip');
|
|
const toggle = tooltip.previousElementSibling;
|
|
|
|
toggle.addEventListener('click', () => (tooltip.open = !tooltip.open));
|
|
</script>
|
|
```
|
|
|
|
### Remove Arrows
|
|
|
|
You can control the size of tooltip arrows by overriding the `--sl-tooltip-arrow-size` design token.
|
|
|
|
```html preview
|
|
<div style="--sl-tooltip-arrow-size: 0;">
|
|
<sl-tooltip content="This is a tooltip">
|
|
<sl-button>Above</sl-button>
|
|
</sl-tooltip>
|
|
|
|
<sl-tooltip content="This is a tooltip" placement="bottom">
|
|
<sl-button>Below</sl-button>
|
|
</sl-tooltip>
|
|
</div>
|
|
```
|
|
|
|
To override it globally, set it in a root block in your stylesheet after the Shoelace stylesheet is loaded.
|
|
|
|
```css
|
|
:root {
|
|
--sl-tooltip-arrow-size: 0;
|
|
}
|
|
```
|
|
|
|
### HTML in Tooltips
|
|
|
|
Use the `content` slot to create tooltips with HTML content. Tooltips are designed only for text and presentational elements. Avoid placing interactive content, such as buttons, links, and form controls, in a tooltip.
|
|
|
|
```html preview
|
|
<sl-tooltip>
|
|
<div slot="content">I'm not <strong>just</strong> a tooltip, I'm a <em>tooltip</em> with HTML!</div>
|
|
<sl-button>Hover me</sl-button>
|
|
</sl-tooltip>
|
|
```
|
|
|
|
[component-metadata:sl-tooltip]
|