Documentazione · src/admin
L’AdminBar
Quindici file per modificare il contenuto stando sopra il sito pubblico. Non è un’anteprima del risultato: è il risultato, con sopra un livello che sa cosa si può toccare.
Dal DOM al blocco
Il problema di modificare stando sulla pagina è che si clicca su un nodo del DOM e bisogna sapere quale blocco è. La risposta è un attributo data-uims-id messo dal renderer: chi non ce l’ha non è selezionabile, ed è corretto — non tutto quello che si vede è un blocco.
Da lì si ricostruisce il percorso del blocco dentro la struttura (content.0.x), e c’è un dettaglio che sembra pedante e non lo è: un segmento fatto di sole cifre è un INDICE, non una chiave chiamata «0». Confonderli produce scritture nel posto sbagliato.
la mappa fra nodi del DOM e blocchi; l’etichetta leggibile di una sezione
l’albero dei blocchi selezionabili
il percorso di un blocco dentro la struttura
L'indirizzo di un blocco dentro il layout
'layout.2.content.0' // terza sezione → primo figlio // e una stringa, quindi si confronta e si passa in un evento
applica una modifica al percorso giusto, distinguendo indici e chiavi
Lo stato dell’editor
L’editor ha un proprio store, con la stessa idea di quello del sito: stato, dispatch, sottoscrizione per chiave. Separato perché le due cose non devono interferire — modificare la selezione dell’editor non è un evento del sito.
Il ponte fra i due esiste ed è esplicito: un file solo, che sa quali eventi passano da una parte all’altra.
lo store dell’editor
gli eventi dell’editor: selezione, modifica, riordino
il ponte fra il bus del sito e quello dell’editor
i tab e i campi, LETTI dalla definizione del blocco — mai inventati
Riordinare e vedere subito
Il riordino si applica al DOM immediatamente, e insieme si conserva la via del ritorno: i nodi nell’ordine in cui erano. Se il salvataggio fallisce si torna indietro senza ricaricare.
Lo spostamento è di un passo alla volta, e ai bordi restituisce lo stesso array — non un errore. Una lista che non può salire più in alto non è un caso eccezionale.
sposta di un passo; ai bordi non cambia niente
applica al DOM e conserva la via del ritorno
la barra: pannelli, selezione, comandi
Si compone come una pagina
// tre slot, riempiti con blocchi normali dal global «AdminBar». // Slot vuoti = i default della barra: matita, albero, gestore elementi.
le classi dell’editor
i dati che l’editor legge dagli store
converte solo i nodi che l’editor sa modificare: convertire il resto sarebbe mentire
la porta dell’area
Continua
Altro in «La forma · studio e baseline»
Lo StudioTutte le diciassette pagineindice