@opencitylabs/bootstrap-italia 0.4.7 → 0.4.9

package/Readme.md

@@ -1,26 +1,55 @@
-# Form.io Bootstrap Templates
+# **Template Form.io Bootstrap Italia**
 
-This repository will change the rendering of forms in formio.js so that it uses html and classes compatible with [Bootstrap 5](https://getbootstrap.com/docs/5.3/) framework.
+Questo repository modifica il rendering dei moduli in **formio.js** per utilizzare **HTML** e classi compatibili con il framework [Bootstrap Italia](https://italia.github.io/bootstrap-italia/docs/come-iniziare/introduzione/).
+La versione pubblica della demo è disponibile [qui](https://formbuilder-bootstrap-italia-opencity-labs-a93e4b76e725c1a5db50.gitlab.io) per l'ultima release stabile pubblicata.
 
-### Using Bootstrap Italia
 
-```javascript
-import bootstrapItalia from '@formio/bootstrap/bootstrapItalia';
-import { Formio } from 'formiojs';
-Formio.use(bootstrapItalia);
+## 🚀 **Installazione**
+
+Per installare le dipendenze necessarie in un'applicazione **React**, eseguire i seguenti comandi:
+
+```sh
+npm i @opencitylabs/bootstrap-italia
+npm i @formio/js
 ```
 
-## Script
+## 🚀 **Utilizzo con Bootstrap Italia**
 
+Per utilizzare **Bootstrap Italia** in Form.io, importa il modulo e abilitalo con il seguente codice:
 
 ```javascript
-Formio.Templates.framework = "bootstrapItalia"
+import { Formio, Templates } from "@formio/js";
+import bootstrapItalia from "@opencitylabs/bootstrap-italia/bootstrapItalia";
+import "@opencitylabs/bootstrap-italia/dist/ocl.min.css"
 ```
-If icon is not show
+
+## ⚙️ **Configurazione dello Script**
+
+Per impostare **Bootstrap Italia** come framework predefinito in Form.io:
 
 ```javascript
+Formio.use(bootstrapItalia);
+Templates.framework = bootstrapItalia;
+```
+
+## 📋 **Componenti Form.io Accessibili**
+
+Di seguito è riportata una tabella con la lista dei componenti accessibili in Form.io:
+
+| **Categoria**  | **Componenti**                                                              |
+|--------------|-----------------------------------------------------------------------------|
+| **Base**    | Textfield, Text Area, Number, Password, Checkbox, Select Box, Radio, Button |
+| **Avanzati** | Email, Phone Number, Time, Currency, Select                                 |
+
+## 🎨 **Risoluzione problemi icone mancanti**
+
+Se le icone non vengono visualizzate correttamente, aggiungi **Font Awesome** al tuo progetto con il seguente codice:
+
+```html
 <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css">
 <script>
-  Formio.icons = "fontawesome"
+  Formio.icons = "fontawesome";
 </script>
 ```
+
+📌 **Nota:** Assicurati di caricare il file **CSS** prima di inizializzare Form.io.