Laravel 項目開發(fā)規(guī)范 視圖規(guī)范

統(tǒng)一布局

相似的頁面下，必須 使用 layouts 文件來統(tǒng)一頁面頭部與尾部。如：

layouts/app.blade.php

優(yōu)先使用 Blade

視圖文件 必須 優(yōu)先考慮使用 .blade.php 后綴來指定使用 Blade 模板引擎。

保持目錄清晰

• layouts - 頁面布局文件 必須 放置于此目錄下；
• common - 存放頁面通用元素；
• pages - 簡單的頁面存放文件夾，如：about、contact 等；
• resources - 對應(yīng) Restful 路由的資源路徑名稱，以 URI photos/create 為例，對應(yīng) create.blade.php 文件，存放在文件夾 photos 下。

必須 避免在 resources/views 目錄下直接放置視圖文件。

局部視圖

局部視圖文件 必須 使用 _ 前綴來命名，如：photos/_upload_form.blade.php

視圖命名要釋義

為了和 Restful 路由器和資源控制器保持一致，視圖命名也 必須 使用資源視圖的命名方式。以 photos 為例：

• photos/index.blade.php
  • 內(nèi)容列表視圖
  • 對應(yīng)路由器 /photos，命名 photos.index
  • 控制器方法 PhotosController@index
• photos/show.blade.php
  • 單個內(nèi)容視圖
  • 對應(yīng)路由器 /photos/{id}，命名 photos.show
  • 控制器方法 PhotosController@show
• photos/create.blade.php
  • 內(nèi)容創(chuàng)建視圖
  • 對應(yīng)路由器 /photos/create，命名 photos.create
  • 控制器方法 PhotosController@create
• photos/edit.blade.php
  • 內(nèi)容編輯的視圖
  • 對應(yīng)路由器 /photos/edit，命名 photos.edit
  • 控制器方法 PhotosController@edit

共用 _form.blade.php 視圖

很多情況下，創(chuàng)建和編輯視圖里的頁面結(jié)構(gòu)接近相似，在這種情況下，應(yīng)該 使用 _form.blade.php 視圖來避免重復(fù)代碼。

以 photos 為例：

• PhotosController@create - 對應(yīng)視圖：/photos/create.blade.php
• PhotosController@edit - 對應(yīng)視圖：/photos/edit.blade.php

edit.blade.php 和 create.blade.php 內(nèi)部會使用 _form.blade.php 視圖來加載表單。

一個完整的 photos 資源對應(yīng)的視圖文件為以下：

├── photos
│   ├── _form.blade.php
│   ├── create.blade.php
│   ├── edit.blade.php
│   ├── index.blade.php
│   └── show.blade.php