Tooltip
Visualizza suggerimenti o informazioni in prossimità di altri elementi.
Alcune cose da sapere quanto usi il plugin tooltip:
- I tooltip si basano sulla libreria di terze parti Popper.js.
Per fare in modo che i tooltip funzionino è quindi necessario usare la versione bundle che contiene già Popper.js o includere
popper.min.js
nel codice - I tooltip sono opt-in per ragioni di performance, quindi devi inizializzarli tu stesso con codice javascript, ad esempio:
var tooltipTriggerList = [].slice.call(document.querySelectorAll('[data-bs-toggle="tooltip"]'))
var tooltipList = tooltipTriggerList.map(function (tooltipTriggerEl) {
return new bootstrap.Tooltip(tooltipTriggerEl)
})
- I tooltip con titoli vuoti non saranno mai visualizzati.
- Specifica
container: 'body'
per evitare problemi di rendering in componenti più complessi (come nei gruppi di input, gruppi di bottoni, etc). - Attivare i tooltip su elementi nascosti non funzionerà.
- I tooltip per gli elementi
.disabled
odisabled
devono essere attivati da un elemento contenitore. - Quando attivati da collegamenti ipertestuali che si estendono su più righe, i tooltip verranno centrati. Usa
white-space: nowrap;
sui tuoi<a>
per evitare questo comportamento. - I tooltip devono essere nascosti prima che i loro elementi corrispondenti siano stati rimossi dal DOM.
- Puoi specificare con l'attributo
data-bs-placement
la posizione del tooltip rispetto al testo.
Esempio
Ecco un bianco scenario
per tratteggiarvi l’accompagnamento degli oggetti di sfondo che pur vivono. Non ne sarò l’artefice impaziente.
La mia lentezza? No, la mia fiducia. Per adesso è deserto.
Il mondo può rifarsi senza me,
E intanto gli altri mi denigreranno
Passa il mouse sopra i bottoni sottostanti per vedere le quattro direzioni dei tooltip: sopra, destra, sotto, e sinistra.
Accessibilità
I tooltip funzionano sia con la tastiera che per gli utenti dotati di tecnologia assistiva.
È importante aggiungere tooltip solo ad elementi HTML che sono tradizionalmente attivabili da tastiera e interattivi (link, bottoni, o elementi di form).
Sebbene arbitrariamente gli elementi HTML (come <span>
) possano essere resi attivabili tramite l’attributo tabindex="0"
,
ciò aggiungerà interruzioni di tabulazioni potenzialmente dannose per gli utenti che usano la tastiera per navigare.
Inoltre, la maggior parte delle tecnologie assistive in questa situazione non annuncia il tooltip come ci si potrebbe
invece attendere.
Infine, non fare affidamento esclusivamente sull’evento “mouse over” come innesco del tooltip, in quanto ciò renderà impossibile l’attivazione per gli utenti che usano la tastiera per navigare.