@wemake4u/form-controls 2.0.2 → 2.0.3

package/README.md

@@ -51,6 +51,31 @@ opzione, o si azzera da codice. Con `clearable` il pulsante viene mostrato e svu
 ```
 
 
+## Valore nullo: `nullable` e `nullOptionLabel`
+
+Di default i controlli si comportano come sempre. Con `nullable` textbox, number, date, time, datetime e select
+singola mostrano dentro il campo il pulsante "X" del kit (`sirio-btn-reset`), che porta il valore a `null`.
+Il pulsante compare solo quando il campo ha un valore e non è obbligatorio, in sola lettura o disabilitato; dopo
+il clic il focus torna al campo. Il nome per i lettori di schermo è `nullLabel` seguito dalla label
+("Nessun valore per Codice fiscale"). Nella textbox con `nullable` anche il testo cancellato arriva come `null`.
+
+Il radio group con `nullable` aggiunge un'ultima opzione con valore `null` (in corsivo, testo `nullOptionLabel`,
+default "Nessuna scelta"), non mostrata se il campo è obbligatorio.
+
+La checkbox con `nullable` diventa un gruppo di radio Sì / No / Nessuna scelta (valori `true`, `false`, `null`),
+con la label come nome del gruppo; i testi si cambiano con `trueLabel`, `falseLabel` e `nullOptionLabel`, e
+l'opzione nulla non compare se il campo è obbligatorio.
+
+```html
+<wm-sirio-textbox label="Codice fiscale" nullable formControlName="cf" />
+<wm-sirio-checkbox label="Ricevere la newsletter" nullable formControlName="newsletter" />
+<wm-sirio-radio-group label="Tipo" [options]="tipi" nullable formControlName="tipo" />
+```
+
+In `wm-sirio-schema-form` i campi il cui tipo ammette `null` (es. `"type": ["string", "null"]`) sono `nullable`: la
+"X" del campo scrive `null` nel JSON, mentre la gomma accanto alla label toglie la proprietà (non passata). I booleani
+che ammettono `null` mostrano Sì / No / null, gli altri solo Sì / No.
+
 ## Select: opzioni in caricamento
 
 Con `loading` la select mostra che le opzioni stanno arrivando (es. da un servizio): il campo chiuso mostra
@@ -155,6 +180,21 @@ Import unico: `imports: [SIRIO_DATA_GRID]`.
   - **Errori**: oltre a `(loadError)`, la tabella mostra `loadErrorText` ("Non è stato possibile caricare i dati.") con
     il pulsante "Riprova" (`retryLabel`), che richiama il data source; la paginazione resta per tornare indietro. Con
     `<ng-template wmSirioGridError let-error let-retry="retry">` il contenuto è personalizzato.
+  - **Server OData** (`sirioRemoteGridSource`): trasforma la query della tabella in opzioni di query lato server
+    (`$top`, `$skip`, `$count`, `$orderby` e filtri nel modello di ag-grid), il formato di `@wemake4u/remoting`:
+    ```ts
+    readonly source = sirioRemoteGridSource(options => this.service.getItems(options), {
+      filterTypes: { version: 'number', created: 'date', state: 'select' },
+      extraFilter: () => ({ state: sirioAnyOf(this.states()) })
+    });
+    ```
+    La libreria non dipende da remoting: `SirioRemoteQueryOptions` ha la stessa forma di `QueryOptions`, quindi una
+    funzione di caricamento tipizzata con `QueryOptions` si passa così com'è. Il totale è quello che il caricamento
+    scrive in `options.totalCount` (remoting vi copia il `$count` della risposta). `filterTypes` indica il tipo dei
+    filtri non di testo (il `filter` delle colonne); `extraFilter`, letto a ogni query, aggiunge filtri che non sono
+    colonne (es. stati scelti con i chip). Le chiavi sono `field` / `sortKey` / `filterKey` delle colonne con i punti
+    (`properties.name`), che remoting trasforma nel path OData; le date dei filtri coprono l'intero giorno.
+    `sirioToQueryOptions` e `sirioToFilterModel` fanno la sola conversione.
 - **Filtri per colonna** (`filter` sulla colonna): pulsante nell'intestazione che apre il popover del kit con i
   controlli della libreria. Tipi: `text` (contiene, senza distinzione di maiuscole e accenti), `number` e `date`
   (intervallo Da / A), `select` (con `filterOptions`, anche `filterMultiple`; **senza `filterOptions` la scelta è tra i