L'11 gennaio 2026, Clooos ha rilasciato Bubble Card v3.1.0, una delle custom card più importanti per Home Assistant. Dopo quattro mesi di intenso sviluppo, questa major release introduce funzionalità che cambiano radicalmente il modo di progettare le dashboard domotiche.
Questa versione non è solo un aggiornamento di compatibilità per Home Assistant 2026.1, ma rappresenta un salto qualitativo enorme in termini di personalizzazione e prestazioni. Con miglioramenti che rendono l'editor fino a 100 volte più veloce e nuove opzioni di layout che aprono possibilità di design prima impensabili, Bubble Card 3.1.0 si conferma come riferimento essenziale per chi vuole creare interfacce domotiche moderne e funzionali.
In questo articolo analizzeremo tutte le novità principali, con particolare attenzione alle funzionalità più utili per migliorare la tua dashboard di Home Assistant.
Bubble Card Tools: Il Nuovo Backend
Una delle modifiche più significative di questa release è l'integrazione con Bubble Card Tools, un nuovo componente personalizzato che gestisce il backend di Bubble Card.
Cosa cambia nella pratica
I moduli precedentemente salvati come entità vengono ora archiviati in singoli file YAML all'interno della configurazione di Home Assistant. Questo approccio offre diversi vantaggi concreti:
- Backup semplificato: i moduli sono inclusi automaticamente nei backup della configurazione
- Condivisione facilitata: è possibile esportare e condividere singoli file YAML
- Modifica manuale: chi preferisce può editare direttamente i file YAML senza passare dall'interfaccia grafica
- Migrazione automatica: tutti i moduli esistenti vengono convertiti automaticamente al nuovo formato
L'installazione di Bubble Card Tools è consigliata per continuare a installare nuovi moduli, ma non è un cambiamento breaking: puoi decidere di migrare quando vuoi.
Come installare Bubble Card Tools
Bubble Card Tools è disponibile su HACS e l'installazione segue la procedura standard:
- Apri HACS > Integrazioni
- Cerca "Bubble Card Tools"
- Installa e riavvia Home Assistant
La migrazione dei moduli esistenti avviene in automatico al primo avvio.
Esempio di Bubble Card: Editor di Configurazione di una entità tipo climate
Esempio: Sub-button pagina di configurazione
Layout Personalizzabili: Progetta la Tua Card Ideale
Bubble Card 3.1.0 introduce un sistema di layout completamente nuovo che offre controllo totale sulla disposizione degli elementi.
Sub-Button Groups
I gruppi di sub-button permettono di organizzare pulsanti correlati visivamente. Ogni gruppo può avere il proprio layout, dimensioni e stile.
Esempio: crea un gruppo per i controlli luce (accensione, luminosità, colore) e un altro gruppo separato per le scene, tutto nella stessa card.
Posizionamento "Below"
Una delle funzionalità più rivoluzionarie è la possibilità di posizionare sub-button e button sotto gli altri elementi della card. Questo apre possibilità di design completamente nuove:
- Slider che occupano tutta la larghezza sotto l'icona principale
- Griglia di pulsanti disposti sotto le informazioni dell'entità
- Layout a più livelli con diversi tipi di controlli
Dimensioni Personalizzabili
Ogni sub-button può ora avere altezza e larghezza indipendenti. Questo permette di:
- Creare pulsanti piccoli per azioni secondarie
- Dare più spazio a controlli importanti
- Ottimizzare lo spazio disponibile in base alle tue esigenze
Posizionamento Icone
Le icone nei sub-button possono essere posizionate in quattro modi:
- Top: icona sopra il testo (impostazione classica)
- Bottom: icona sotto il testo
- Left: icona a sinistra (ottimo per elenchi)
- Right: icona a destra
Copy & Paste
L'editor permette ora di copiare e incollare singoli sub-button o interi gruppi. Questa funzione fa risparmiare moltissimo tempo quando devi creare configurazioni simili o replicare layout tra diverse card.
Prestazioni dell'Editor: 100x Più Veloce
Uno dei problemi più sentiti nelle versioni precedenti era la lentezza dell'editor su dashboard con molti pop-up. Bubble Card 3.1.0 risolve definitivamente questa criticità.
Come è stato risolto
La soluzione implementata è elegante: durante la modifica, il contenuto dei pop-up viene nascosto. Questo riduce drasticamente il carico di rendering, rendendo l'editor:
- Fino a 100 volte più veloce su dashboard complesse
- Completamente responsive anche su dispositivi meno potenti
- Più piacevole da usare con decine di pop-up configurati
Ottimizzazioni Globali
Oltre al fix dei pop-up, sono state implementate numerose ottimizzazioni:
- Caching CSS: gli stili vengono pre-caricati e memorizzati
- Gestione memoria migliorata: risolti i memory leak nei sub-button
- Caricamento dashboard più veloce: ottimizzazioni generali del rendering
- Minor uso CPU: dashboard con molti moduli custom consumano meno risorse
Miglioramenti agli Slider
Gli slider hanno ricevuto un overhaul completo che risolve tutti i problemi noti delle versioni precedenti.
Nuove Opzioni di Layout
Ora puoi controllare:
- Orientamento riempimento: da sinistra, destra, alto, basso
- Posizione valore: a destra, sinistra, centro o nascosto
- Direzione invertita: 100% può rappresentare il valore minimo
Gestione Colori Migliorata
I colori degli slider, specialmente per luci RGB, sono ora più vividi e rappresentativi. La gestione dei pack di icone custom è stata corretta.
Scrolling Mobile Corretto
Un bug fastidioso che impediva lo scroll verticale della pagina quando si toccava uno slider su mobile è stato risolto. Ora l'interazione è fluida e naturale.
Snap ai Step
Quando rilasci lo slider, il valore ora rispetta automaticamente gli step configurati. Se imposti step di 10%, il valore finale sarà sempre un multiplo di 10.
Bubble slider alcune novità
Altre Novità Importanti
Supporto Timer
Finalmente Bubble Card supporta completamente le entità timer con visualizzazione del countdown in tempo reale. Perfetto per timer della cucina, promemoria o automazioni temporizzate.
Entity Pictures nei Sub-Button
I sub-button ora supportano le entity pictures, permettendo di usare immagini personalizzate invece delle icone. Utile per foto di persone, loghi di servizi o icone personalizzate.
CSS Classes Personalizzate
Ogni sub-button può ora essere targettizzato con classi CSS basate sul nome. Se il
tuo sub-button si chiama "Luce Camera", la classe sarà .luce-camera.
Questo semplifica enormemente l'applicazione di stili custom.
Colori Lock ed Error State
Le entità lock ora usano:
- Rosso quando sono sbloccate (stato di attenzione)
- Colore principale quando sono bloccate (stato sicuro)
Lo stesso comportamento si applica agli stati di errore, per una maggiore chiarezza visiva.
Module Editor Migliorato
L'editor dei moduli ha ricevuto diversi upgrade:
- Barra di ricerca: trova rapidamente i tuoi moduli
- Ordinamento multiplo: alfabetico, per data, per attivi
- Opzione "All cards": rendi i moduli compatibili con futuri tipi di card
- Anteprima live: vedi le modifiche ai moduli in tempo reale nei pop-up
Compatibilità Home Assistant 2026.1
Home Assistant 2026.1 aveva introdotto un bug critico che impediva di creare nuove card dall'editor (dropdown mancanti). Bubble Card 3.1.0 risolve completamente questo problema, garantendo piena compatibilità con l'ultima versione.
Migrazione e Retrocompatibilità
Bubble Card 3.1.0 è progettato per essere non-breaking:
- Le configurazioni esistenti continuano a funzionare
- La migrazione a Bubble Card Tools è automatica
- Puoi decidere tu quando installare il nuovo componente
- L'editor ristrutturato migra automaticamente le vecchie configurazioni
Non ci sono azioni obbligatorie: puoi aggiornare e continuare a usare Bubble Card come sempre.
Come Aggiornare
Via HACS (consigliato)
Se non hai ancora installato HACS, segui la nostra guida dedicata. Una volta configurato:
- Apri HACS > Frontend
- Cerca "Bubble Card"
- Clicca su "Aggiorna"
- Ricarica la pagina (CTRL+F5)
Installare Bubble Card Tools (opzionale ma consigliato)
- HACS > Integrazioni
- Cerca "Bubble Card Tools"
- Installa e riavvia Home Assistant
Confronto con la Versione 3.0
Se hai seguito il nostro articolo precedente su Bubble Card 3.0, noterai che la versione 3.1.0 si concentra principalmente su:
- Usabilità migliorata: editor più veloce e intuitivo
- Flessibilità: nuovi tipi di sub-button e layout
- Stabilità: risoluzione di tutti i bug noti degli slider
- Prestazioni: ottimizzazioni complessive del codice
La versione 3.0 aveva introdotto il concetto di moduli e pop-up avanzati, mentre la 3.1.0 perfeziona questi concetti e aggiunge strumenti di personalizzazione ancora più potenti.
Conclusioni
Bubble Card 3.1.0 rappresenta un punto di svolta per le dashboard di Home Assistant. Le nuove funzionalità di layout, gli slider nei sub-button e le prestazioni drasticamente migliorate rendono questa release una delle più importanti dell'intero progetto.
Clooos ha lavorato quattro mesi su questa versione, e l'impegno si vede in ogni dettaglio. L'attenzione alla user experience, la retrocompatibilità e l'introduzione di funzionalità richieste dalla community dimostrano quanto questo progetto sia maturo e ben gestito.
Per chi usa Home Assistant e vuole creare dashboard moderne, funzionali e belle esteticamente, Bubble Card è ormai diventato uno strumento indispensabile. Questa versione 3.1.0 lo conferma ancora una volta.
Crediti
- Sviluppatore principale: Clooos
- Contributor: @nomis52 per i fix al calendario
- Repository GitHub: Bubble Card
- Patreon: Supporta il progetto
- YouTube: Canal Clooos
- Reddit: r/BubbleCard
Risorse Utili
Se usi Bubble Card e questa release ti è stata utile, considera di supportare Clooos tramite Patreon o Buy Me a Coffee. Lo sviluppo di progetti open source di questa qualità richiede tempo e dedizione.
Hai già provato Bubble Card 3.1.0? Condividi la tua esperienza !
