design-react-kit
Advanced tools
Design React Kit è un toolkit basato su Bootstrap Italia
per la creazione di applicazioni web sviluppate con React.
italia.github.io/design-react-kit
Read this in other languages: English 🇬🇧.
⚠️ Attenzione: questo kit è stato progettato per funzionare con la versione 2.x di Bootstrap Italia. Il kit per la versione 1.x di Bootstrap Italia è stato deprecato e si trova sul branch 4.x.
Design React kit è un set di componenti React che implementa Bootstrap Italia e gli stili presenti su Design UI Kit. Per navigare la libreria e visualizzare i componenti, è stato utilizzato Storybook. La versione pubblica dello Storybook è disponibile qui per l'ultima release stabile pubblicata. Per giocare con la libreria è disponibile il Playground React Kit.
Per utilizzare Design React come dipendenza in un'app è possibile installarla da npm. Suggeriamo di usare create vite per creare una nuova webapp React, come segue:
yarn create vite nome-app --template react
cd nome-app
yarn add design-react-kit --save
Maggiori informazioni per crere una nuova app con React:
Il design-react-kit non include il CSS ed i file font, ed è quindi necessario installarli a parte:
yarn add bootstrap-italia typeface-lora typeface-roboto-mono typeface-titillium-web --save
A questo punto, è sufficiente importare esplicitamente nella app CSS e font se si è usato create vite all'interno del file ./src/App.js:
import React from 'react';
import './App.css';
import { Alert } from 'design-react-kit';
import 'bootstrap-italia/dist/css/bootstrap-italia.min.css';
import 'typeface-titillium-web';
import 'typeface-roboto-mono';
import 'typeface-lora';
function App() {
return <Alert>This is an Alert</Alert>;
}
export default App;
Puoi consultare questo template web con StackBlitz: Template web
Il tema Bootstrap Italia utilizza un set specifico di font typeface: titillium-web, roboto-mono e lora. Il caricamento di questi font è lasciato al browser ma, volendo può essere controllato tramite l'apposito componente FontLoader.
È sufficiente dichiarare il componente FontLoader in cima all'app react per permettere il caricamento.
In alternativa è necessario gestire il caricamento dei font manualmente mediante il pacchetto webfontloader:
const WebFont = require('webfontloader');
WebFont.load({
custom: {
families: ['Titillium Web:300,400,600,700:latin-ext', 'Lora:400,700:latin-ext', 'Roboto Mono:400,700:latin-ext']
}
});
La libreria non include react e react-dom, evitando clashing di versioni e aumento inutile delle dimensioni del bundle.
Per questo motivo per lo sviluppo in locale sarà necessario installare manualmente le dipendenze.
Il comando da eseguire è
yarn install --peers
oppure in alternativa manualmente
yarn install react react-dom
👉🏻 È possibile contribuire alla libreria in vari modi:
Vorresti dare una mano su Design React Kit? Sei nel posto giusto!
Se non l'hai già fatto, inizia spendendo qualche minuto per approfondire la tua conoscenza sulle linee guida di design per i servizi web della PA, e fai riferimento alle indicazioni su come contribuire a Design React Kit.
I requisiti minimi del tuo ambiente locale devono essere:
Clona il repository ed esegui yarn per installare le dipendenze.
Quindi esegui
yarn storybook:serve
per avviare il server di sviluppo.
Storybook sarà quindi disponibile all'indirizzo http://localhost:9001/
Storybook è stato arricchito con alcuni addons che lo rendono più parlante.
Questa sezione guiderà alla creazione di nuovi componenti nel repository.
Tutti i componenti risiedono nella cartella src: ogni componente possiede una sua cartella con tutto ciò che è necessario per farlo funzionare.
Le storie Storybook invece sono sotto stories.
I test unitari risiedono nella cartella test.
Il componente Button ad esempio è presente sotto il percorso src/Button e la sua struttura è la seguente:
├── src
│ └── Button
│ └── Button.tsx
├── stories
│ ├── Components
│ │ └── Button.stories.tsx
│ └── Documentation
│ └── Button.mdx
└── test
└── Button.test.tsx
Alcune regole di base per strutturare i componenti:
.stories.tsx dovrebbero contenere solo quanto relativo al componente stesso..mdx dovrebbero contenere solo documentazione relativa al componente stesso.test.tsx dovrebbero contenere solo test relativi al componente stesso.Una volta creato un nuovo componente, con la sua story, avviando Storybook sarà possibile controllare che tutto funzioni come dovrebbe.
Documentazione:
Il sistema di testing prevede un controllo delle storie presenti, mediante una tecnica chiamata "snapshot" testing: il contenuto della storia Storybook verrà copiato in un file speciale e preservato per notificare eventuali cambiamenti in futuro. Questo fa si che l'aggiunta di nuove storie potrebbe risultare in un fallimento del task "test" in una PR. Qualora fosse stata aggiunta una nuova storia o modificata una già presente, sarà necessario aggiornare il file di snapshot come segue:
yarn test -u
A questo punto creare un nuovo commit ed aggiornare la PR con il file di snapshot aggiornato. Controllare che le modifiche apportate siano corrette prima di aggiornare la PR.
Per compilare la libreria e generare i file nella cartella dist, è sufficiente lanciare il comando dedicato:
yarn build
Il kit segue le indicazioni riportate nelle Linee Guida di Design per i servizi web della Pubblica Amministrazione, sezione 6.3.1.2.1. Supporto browser mediante l'utilizzo del pacchetto browserslist-config-design-italia.
La libreria è stata portata a Typescript ed i tipi sono esportati con essa.
Un grazie speciale a chi ha reso possibile lo sviluppo di questa libreria!
 |  |  |  |
|---|---|---|---|
| Sabatino Galasso | Marco Liberati | Matteo Avesani | Federico Turbino |
e al contributo di OpenCity Labs
Tutti i contributor (made with contributors-img)
FAQs
Componenti React per Bootstrap 5
The npm package design-react-kit receives a total of 924 weekly downloads. As such, design-react-kit popularity was classified as not popular.
We found that design-react-kit demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Ransomware payment rates hit an all-time low in 2024 as law enforcement crackdowns, stronger defenses, and shifting policies make attacks riskier and less profitable.
Security News
require(esm) backported to Node.js 20, easing the transition to ESM-only packages and reducing complexity for developers as Node 18 nears end-of-life.
Security News
PyPI now supports iOS and Android wheels, making it easier for Python developers to distribute mobile packages.