Le chapitre précédent s’est terminé sur un défi : nos champs fichier et image sont obligatoires, donc quand on modifie un livre, EasyAdmin se plaint qu’ils sont vides, alors que les fichiers existent. C’est un piège classique d’EasyAdmin. On le corrige proprement, puis on nettoie le style de l’admin avec un fichier CSS personnalisé.
Pourquoi ça arrive
Sur la page de modification, un champ d’upload ne sait pas qu’un fichier est déjà enregistré pour cette entité. S’il est marqué comme obligatoire, le formulaire attend un nouveau fichier à chaque fois.
Ce qu’on veut :
- Obligatoire à la création d’un livre
- Facultatif à la modification, sans perdre le fichier existant
Utiliser $pageName
configureFields() reçoit la page en cours dans $pageName. Fais un dump sur la page de création et tu verras new ; sur la page de modification, edit. C’est tout ce qu’il nous faut. Au lieu de setRequired(true), on fait dépendre l’option de la page :
FileField::new('bookFileName', 'Livre')
// ... options d'upload ...
->setRequired($pageName === Crud::PAGE_NEW),
ImageField::new('coverImageName', 'Couverture')
// ... options d'upload ...
->setRequired($pageName === Crud::PAGE_NEW),
Teste : les deux champs sont obligatoires sur la page de création, et facultatifs sur la page de modification. Change le titre, enregistre, et le livre garde son PDF et sa couverture.
Nettoyer le style des erreurs
Essaie maintenant d’uploader un fichier trop lourd. Le message d’erreur apparaît, c’est bien, mais tout le bloc du formulaire prend une bordure rouge pas très jolie.
Inspecte la page pour trouver la classe : form-fieldset has-fieldset-error. Crée ensuite public/custom.css :
.form-fieldset.has-fieldset-error {
border: none;
box-shadow: none;
}
Charger du CSS dans EasyAdmin : configureAssets()
EasyAdmin n’utilise pas notre base.html.twig, on ajoute donc le fichier via le dashboard. Dans DashboardController, surcharge configureAssets() :
public function configureAssets(): Assets
{
return Assets::new()->addCssFile('custom.css');
}
Le chemin est relatif à public/. Reteste avec un gros fichier : le message d’erreur est toujours là, sans la bordure rouge.
Besoin de JavaScript aussi ? Utilise
addJsFile()de la même façon :Assets::new()->addJsFile('admin.js').
Récap
$pageName === Crud::PAGE_NEWrend les champs d’upload obligatoires uniquement à la création- Les styles globaux de l’admin vont dans un fichier CSS dans
public/ configureAssets()avecaddCssFile()ouaddJsFile()les charge dans EasyAdmin
Exercice · Un peu de JavaScript
Crée un fichier public/admin.js qui affiche « Admin chargée » dans la console du navigateur, et charge-le dans toute l’admin.
Voir la solution
// public/admin.js
console.log('Admin chargée');
public function configureAssets(): Assets
{
return Assets::new()
->addCssFile('custom.css')
->addJsFile('admin.js');
}
Ouvre la console du navigateur (F12) sur n’importe quelle page de l’admin : le message apparaît.
Ceci est le chapitre 12 du cours Mini Bibliothèque. Suis la série pour construire de zéro une application complète de bibliothèque numérique avec Symfony 8 et EasyAdmin.