vue

Création d’une vue avec Laravel

21 avril 2017 par Christiane Lagacé

Sous Laravel, pour afficher correctement une page Web dans le navigateur, il faut utiliser une vue. C'est la vue qui est en charge de générer le code HTML. Elle utilisera pour cela, en plus des balises HTML, des directives et instructions que le moteur d'affichage Blade met à sa disposition.

Contrairement aux modèles et aux contrôleurs, il n'y a pas de commande artisan, livrée avec Laravel, permettant de créer le squelette d'une vue. Notez qu'il est possible de créer vos propres commandes artisan pour générer un squelette répondant à vos besoins mais ceci dépasse le sujet du présent article.

Les vues sous Laravel sont placées dans le dossier resources\views.

Les bonnes pratiques veulent qu'on crée un sous-dossier pour chacun des contrôleurs. Le nom du sous-dossier correspondra à la première partie du nom du contrôleur, tout en minuscules (ex : pour les vues utilisées par ProduitsController : resources\views\produits).

Le nom de la vue, quant à lui, correspondra généralement au nom de la méthode d'action à laquelle la vue est associée et se terminera par .blade.php (ex : index.blade.php, create.blade.php, edit.blade.php).

Une première vue

Une fois que vous avez créé une route et un contrôleur, vous êtes prêts à créer une première vue.

Pour l'instant, la vue n'affichera qu'un texte statique à propos des produits que vous avez à vendre. Éventuellement, elle pourra afficher des listes ou tableaux à partir des données lues dans la base de données, des formulaires pour modifier ces données, etc.

Le code présenté ici permettra de créer une vue assez minimaliste mais tout de même professionnelle :

Visuel d'une première vue minimaliste

D'abord, créez un dossier nommé produits sous ressources\views.

Dans ce dossier, créez le fichier index.blade.php et copiez-y le code suivant :

Vue Laravel (Blade)

<!DOCTYPE html>

<head>

<title>Produits à vendre chez Mon Entreprise Inc.</title>

</head>

<body>

{{-- ******************************************************************************************** --}}

</button>

</div>

<li class="active"><a href="#">Accueil</a></li>

</ul>

</li>

</ul>

</li>

</ul>

</div>

</nav>

{{-- ******************************************************************************************** --}}

</a>

<div class="souslogo">Projet de test - données fictives</div>

</div>

</header>

{{-- ******************************************************************************************** --}}

<h1>Nos produits</h1>

<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean felis sapien, faucibus in congue eu, consequat eu nibh. Quisque sit amet felis feugiat, adipiscing lorem sit amet, blandit tortor.</p>

<p>Suspendisse vitae aliquam dolor, eu ultrices magna. Aenean dignissim nulla vitae hendrerit mattis. Morbi magna ipsum, malesuada in tempus quis, rutrum quis velit. Donec scelerisque scelerisque sapien

sit amet venenatis. Sed tristique turpis sapien, at volutpat est vulputate a.</p>

</div>

</div>

{{-- ******************************************************************************************** --}}

<br /><br />Ce site est un projet de test réalisé à partir d'un tutoriel sur <a href="http://christianelagace.com">localhost/bloguechristiane</a>.

<br />Toutes les données présentées sur ce site sont fictives.

</div>

</footer>

{{-- ******************************************************************************************** --}}

</body>

</html>

Où placer les images, les feuilles de style et les scripts ?

Laravel vous permet de travailler efficacement avec les différents fichiers qui accompagnent l'application, comme les images, les feuilles de style et les scripts, grâce à Laravel Mix (avant Laravel5.4, on utilisait plutôt Elixir). Mais avant de vous lancer dans l'apprentissage de cet outil, il est possible de travailler simplement avec vos fichiers comme vous le faisiez auparavant. L'apprentissage de Laravel Mix pourra se faire plus tard.

Puisque la racine du site Web est le dossier public de votre projet, les fichiers qui doivent être lus par le navigateurs seront placés dans un sous-dossier de public :

les images seront placées dans le sous-dossier medias, qui contiendra à son tour les sous-dossiers en, fr et commun;
les feuilles de style seront placées dans le sous-dossier css;
les scripts, quant à eux, seront placés dans le sous-dossier js.

Pour terminer le rendu de votre vue, vous devez placer votre logo dans le dossier à cet effet. Vous pouvez utiliser celui-ci à titre d'exemple ou encore le vrai logo de votre entreprise.

Vous devez ensuite copier la feuille de style suivante à l'endroit prévu. Libre à vous d'y apporter les modifications de votre choix pour répondre à vos besoins.

CSS

body {

margin: 0;

padding: 0;

color: black;

font-family: Tahoma, Verdana, Arial, Helvetica, sans-serif;

padding-top: 70px;

}

p {

text-align: justify;

}

/* ************************************************************************** */

/* *** entête *************************************************************** */

/* ************************************************************************** */

header {

min-height: 90px;

}

header a, header a:hover, header a:visited {

text-decoration: none;

color: black;

}

header h1 {

font-size: 3em;

}

.souslogo {

margin-top: 10px;

font-size: 0.8em;

color: #92B54C; /* vert olive */

}

/* ************************************************************************** */

/* *** contenu ************************************************************** */

/* ************************************************************************** */

#contenu {

min-height: 700px;

}

/* ************************************************************************** */

/* *** contenu principal **************************************************** */

/* ************************************************************************** */

#principal h1 {

font-size: 2em;

}

#principal h2 {

font-size: 1.5em;

}

/* ************************************************************************** */

/* *** pied de page ********************************************************* */

/* ************************************************************************** */

#piedpage {

background-image: none;

border: none;

padding: 15px;

color: #777;

}

Afficher la vue à l'aide du contrôleur

Laravel s'attend à ce que les vues soient placées dans le dossier resources\views et portent un nom se terminant par .blade.php. Il est donc inutile de spécifier ces informations. Cependant, il faudra indiquer dans quel sous-dossier (ici : produits) la vue est placée ainsi que son nom (ici : index).

Remplacez donc le code de la méthode index, dans le contrôleur ProduitsController, par le code suivant.

Remarquez que dans l'entête de la méthode, le type de la valeur de retour a été ajusté pour indiquer ce que la méthode retourne vraiment.

Contrôleur Laravel (PHP)

/**

* Affiche la liste des produits.

* @return \Illuminate\View\View

public function index()

{

return View('produits.index');

}

Tester le tout

Après avoir copié les fichiers requis dans les dossiers prévus et avoir, au besoin, ajusté le code HTML et CSS pour bien y référer, lancez votre application en entrant l'URL qui correspond à votre méthode d'action :

URL

http://monprojet.app/produits