视图规范

统一布局

相似的页面下，必须使用 layouts 文件来统一页面头部与尾部。如：

layouts/app.blade.php

优先使用 Blade

视图文件必须优先考虑使用 .blade.php 后缀来指定使用 Blade 模板引擎。

保持目录清晰

• layouts - 页面布局文件必须放置于此目录下；

• common - 存放页面通用元素；

• pages - 简单的页面存放文件夹，如：about、contact 等；

• resources - 对应 Restful 路由的资源路径名称，以 URI photos/create 为例，对应 create.blade.php 文件，存放在文件夹 photo 下。

必须避免在 resources/views 目录下直接放置视图文件。

局部视图

局部视图文件必须使用 _ 前缀来命名，如：photo/_upload_form.blade.php

视图命名要释义

为了和 Restful 路由器和资源控制器保持一致，视图命名也必须使用资源视图的命名方式。以 photo 为例：

• photo/index.blade.php

  • 内容列表视图

  • 对应路由器 /photos，命名 photos.index

  • 控制器方法 PhotoController@index

• photo/show.blade.php

  • 单个内容视图

  • 对应路由器 /photos/{id}，命名 photos.show

  • 控制器方法 PhotoController@show

• photo/create.blade.php

  • 内容创建视图

  • 对应路由器 /photos/create，命名 photos.create

  • 控制器方法 PhotoController@create

• photo/edit.blade.php

  • 内容编辑的视图

  • 对应路由器 /photos/edit，命名 photos.edit

  • 控制器方法 PhotoController@edit

共用 _form.blade.php 视图

很多情况下，创建和编辑视图里的页面结构接近相似，在这种情况下，应该使用 _form.blade.php 视图来避免重复代码。

以 photo 为例：

• PhotoController@create - 对应视图：/photo/create.blade.php

• PhotoController@edit - 对应视图：/photo/edit.blade.php

edit.blade.php 和 create.blade.php 内部会使用 _form.blade.php 视图来加载表单。

一个完整的 photos 资源对应的视图文件为以下：

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