La seguente repository serve per la creazione di widget compatibili per il nuovo sistema dashboard sviluppato da Sense Square.
-> Nel caso specifico bisognerà eseguire un "fork" della repository e successivamente un "clone" della repository
Esegui il fork usando il tasto in alto a destra denominato "fork" (clonera la repository sul tuo profilo)
Successivamente per iniziare a lavorare al progetto esegui il seguente comando da terminale (copierà il tuo fork sul computer che stai usando)
git clone https://github.com/Sense-Square/template-widget-container.git
Installa le dipendenze...
cd svelte-app
npm install
...dopo esegui Rollup:
npm run dev
Vai all'indirizzo localhost:5000. Dovresti poter vedere il contenuto di default del template.
Per procedere modifica il contenuto del file Widget.svelte e osserva i cambiamenti nel browser (esso è presente al path /src/Content).
Per modificare le configurazioni del widget (dimensioni, nome, id, ...), modifica il file Constants.js
Attenzione! Cancella esclusivamente le parti che fanno parte dell'esempio
All'interno del widget saranno presenti delle funzionalità di base, esse sono relative ai caricamenti e a svariati messaggi informativi.
Questo comando consentirà di mostrare il contenuto del file widget.svelte, esso servirà alla fine di ogni caricamento
Questo comando consentirà in caso di errore di spiegare all'utente cosa è successo (usare solo se l'errore verificatosi non consente il funzionamento del widget)
Questo comando consentirà in caso di manutenzione di spiegare all'utente cosa sta succedendo
Questo comando mostrerà all'utente una barra di caricamento generica (non mostra il progresso del caricamento)
Questo comando mostrerà la barra di caricamento (mostra il progresso del caricamento), il parametro "value" indica il valore iniziale del caricamento
Questo comando consentirà di eseguire un update della barra di caricamento (in modo tale da aggiornare il progresso)
Questo comando consentirà di salvare lo "stato interno" del widget, in modo tale da recuperare al prossimo riavvio la stessa visualizzazione
Questo props che viene passato al widget contiene se presente lo "stato interno" precedentemente salvato dal widget
All'interno del file "Constants.js" vi sono svariate costanti che possono essere modificate a seconda del widget che si vuole sviluppare
la costante "THEME" non deve essere modificata, essa contiene i colori da usare nel widget (è importata di default nel file Widget.svelte)
Le costanti presenti in questa sezione si riferiscono alla dimensione che il widget può assumere all'interno della griglia (prova a modificarli ed osserva i cambiamenti sul browser)
Se impostata a false renderà il widget fisso, esso non potrà essere spostato o modificato nella pagina
Indica la dimensione di default del widget nella griglia
Indica la dimensione massima del widget nella griglia
Indica la dimensione minima del widget nella griglia