Vistes
Una vista és una manera de personalitzar com es mostra un model segons la situació: crear una nova instància, editar-ne una d'existent o llistar-ne moltes alhora. Cada vista té el seu propi conjunt de restriccions (regles de visualització i validacions) sobre el mateix model.
Per què existeixen les vistes
Un mateix model sovint s'utilitza en contextos molt diferents:
- En un formulari de creació potser només vols veure els camps mínims necessaris.
- En el formulari d'edició pot interessar-te veure'ls tots, amb els camps d'auditoria només de lectura.
- En un llistat en forma de taula només vols un grapat de columnes — les més identificatives.
Sense vistes, hauries d'escollir una sola configuració per a totes les situacions. Les vistes et permeten adaptar cada context de manera independent.
Vistes predefinides
Yellow reconeix tres etiquetes de vista predefinides. Cadascuna es consumeix per la pantalla corresponent:
| Etiqueta | On s'utilitza |
|---|---|
create |
El formulari que es mostra en crear una nova instància. |
update |
El formulari que es mostra en editar una instància existent. |
table |
Les columnes mostrades en llistar instàncies en forma de taula. |
També hi ha la vista per defecte (default), que és la que edites quan obres un model i no hi ha cap etiqueta de vista seleccionada. Actua com a fallback per a qualsevol situació en què no s'hagi definit una vista amb etiqueta.
El fallback a la vista per defecte
Si una pantalla demana una vista amb etiqueta (per exemple create) i aquesta vista no està configurada per al model, Yellow utilitza automàticament la vista per defecte. Això vol dir:
- Pots deixar només la vista per defecte si ja produeix el formulari que vols.
- Només cal definir una vista amb etiqueta quan ha de diferir de la per defecte.
- Un model sense cap vista configurada continua funcionant — Yellow fa servir directament les propietats del model.
Vistes personalitzades
A banda de les tres etiquetes predefinides, pots crear vistes personalitzades amb el nom que vulguis. Les vistes personalitzades, ara per ara, només existeixen com a dades — cap pantalla integrada les consumeix automàticament, però són útils per:
- Documentar la intenció de disseny sobre un model.
- Alimentar integracions o widgets a mida que llegeixen restriccions d'una etiqueta concreta.
Editar vistes
Obre un model des de l'Explorador i busca el selector de Vistes a l'editor de propietats. Pots:
- Canviar entre vistes per veure'n i editar-ne les restriccions.
- Crear una vista nova (d'un dels tipus predefinits o amb un nom propi).
- Definir restriccions de visualització per vista (ordre, visibilitat, només lectura, layout
flex) i restriccions de validació per vista.
Els canvis es desen juntament amb el model. Consulta Restriccions per a la llista completa de regles de validació configurables per vista.