小編給大家分享一下基于Laravel+Vue組件實(shí)現(xiàn)文章發(fā)布、編輯和瀏覽功能的示例,希望大家閱讀完這篇文章之后都有所收獲,下面讓我們一起去探討吧!
創(chuàng)新互聯(lián)成立于2013年,是專業(yè)互聯(lián)網(wǎng)技術(shù)服務(wù)公司,擁有項(xiàng)目成都做網(wǎng)站、成都網(wǎng)站制作、成都外貿(mào)網(wǎng)站建設(shè)網(wǎng)站策劃,項(xiàng)目實(shí)施與項(xiàng)目整合能力。我們以讓每一個(gè)夢(mèng)想脫穎而出為使命,1280元龍馬潭做網(wǎng)站,已為上家服務(wù),為龍馬潭各地企業(yè)和個(gè)人服務(wù),聯(lián)系電話:18982081108
我們將基于 Laravel 提供后端接口,基于 Vue.js 作為前端 JavaScript 組件開發(fā)框架,基于 Bootstrap 作為 CSS 框架。
首先,我們基于上篇教程創(chuàng)建的資源控制器 PostController
快速編寫后端增刪改查接口實(shí)現(xiàn)代碼:
middleware('auth')->except('index', 'all', 'show', 'data'); } /** * Display a listing of the resource. * * @return Application|Factory|View|Response|\Illuminate\View\View */ public function index() { return view('posts.index', ['pageTitle' => '文章列表頁']); } /** * Show the form for creating a new resource. * * @return Application|Factory|View|Response|\Illuminate\View\View */ public function create() { return view('posts.create', ['pageTitle' => '發(fā)布新文章']); } /** * Store a newly created resource in storage. * * @param Request $request * @return array */ public function store(Request $request) { $data = $request->validate([ 'title' => 'required|max:128', 'content' => 'required' ]); $post = new Post($data); $post->status = 1; $post->user_id = Auth::user()->id; if ($post->save()) { return ['success' => true, 'message' => '文章發(fā)布成功']; } return ['success' => false, 'message' => '保存文章數(shù)據(jù)失敗']; } /** * Display the specified resource. * * @param Post $post * @return Application|Factory|View|Response|\Illuminate\View\View */ public function show(Post $post) { return view('posts.show', ['id' => $post->id, 'pageTitle' => $post->title]); } /** * Show the form for editing the specified resource. * * @param Post $post * @return Application|Factory|View|Response|\Illuminate\View\View */ public function edit(Post $post) { return view('posts.edit', ['pageTitle' => '編輯文章', 'id' => $post->id]); } /** * Update the specified resource in storage. * * @param Request $request * @param Post $post * @return array */ public function update(Request $request, Post $post) { $data = $request->validate([ 'title' => 'required|max:128', 'content' => 'required' ]); $post->fill($data); $post->status = 1; if ($post->save()) { return ['success' => true, 'message' => '文章更新成功']; } return ['success' => false, 'message' => '更新文章數(shù)據(jù)失?。?#39;]; } /** * Remove the specified resource from storage. * * @param Post $post * @return array * @throws Exception */ public function destroy(Post $post) { if ($post->delete()) { return ['success' => true, 'message' => '文章刪除成功']; } return ['success' => false, 'message' => '刪除文章失敗']; } /** * 獲取所有文章數(shù)據(jù) * * @return Collection */ public function all() { return Post::orderByDesc('created_at')->get(); } /** * 獲取單個(gè)文章數(shù)據(jù) * * @param Post $post * @return Post */ public function data(Post $post) { $post->author_name = $post->author->name; return $post; } }
除了 Laravel 資源控制器自帶的方法之外,我們額外提供了 all
和 data
兩個(gè)方法,分別用于在 Vue 組件中通過 AJAX 請(qǐng)求獲取文章列表數(shù)據(jù)和文章詳情數(shù)據(jù)。因此,需要在路由文件 routes/web.php
中注冊(cè)資源路由之前添加這兩個(gè)方法對(duì)應(yīng)的路由:
use App\Http\Controllers\PostController; Route::get('posts/all', [PostController::class, 'all']); Route::get('posts/{post}/data', [PostController::class, 'data']); Route::resource('posts', PostController::class);
注意這里我們使用了 Laravel 路由提供的隱式模型綁定功能快速獲取模型實(shí)例。此外,相應(yīng)的視圖模板路徑也做了調(diào)整,我們馬上會(huì)介紹這些視圖模板文件。
如果你在上篇教程填充的測(cè)試數(shù)據(jù)基礎(chǔ)上新增過其他數(shù)據(jù),可以運(yùn)行 php artisan migrate:refresh
命令重建數(shù)據(jù)表快速清空已有數(shù)據(jù)并重新填充。
如果你不想查看返回實(shí)例數(shù)據(jù)格式的細(xì)節(jié),可以在自帶填充器 database/seeders/DatabaseSeeder.php
中定義填充代碼:
create(); Post::factory(10)->create(); } }
然后運(yùn)行 php artisan migrate:refresh --seed
命令即可一步到位完成數(shù)據(jù)表重建、測(cè)試數(shù)據(jù)清空和重新填充:
cdn.xueyuanjun.com/storage/uploads/images/gallery/2020-10/16036945542122.jpg">
由于我們使用的是 Laravel 提供的 laravel/ui
擴(kuò)展包提供的 Bootstrap 和 Vue 前端腳手架代碼,該擴(kuò)展包還提供了用戶認(rèn)證相關(guān)腳手架代碼實(shí)現(xiàn),并且提供了一個(gè)視圖模板布局文件 resources/views/layouts/app.blade.php
,我們將通過模板繼承基于這個(gè)布局文件來重構(gòu)文章列表、表單、詳情頁相關(guān)視圖模板文件,讓整體 UI 統(tǒng)一。
我們前面在 PostController
中,為所有 GET 路由渲染的視圖文件傳遞了 pageTitle
值作為不同頁面的標(biāo)題,要實(shí)現(xiàn)該功能,需要修改 resources/views/layouts/app.blade.php
布局文件中 title
標(biāo)簽對(duì)應(yīng)的標(biāo)簽文本值:
{{ $pageTitle ?? config('app.name', 'Laravel') }}
接下來,將原來的文章相關(guān)視圖文件都移動(dòng)到 resources/views/posts
目錄下,改寫文章列表視圖文件模板代碼如下(將原來的 posts.blade.php
重命名為 index.blade.php
):
@extends('layouts.app') @section('content')@endsection
將原來的 form.blade.php
重命名為 create.blade.php
,并編寫文章發(fā)布表單頁面視圖文件模板代碼如下:
@extends('layouts.app') @section('content')
@endsection
由于文章發(fā)布和編輯表單共用一個(gè) Vue 表單組件,所以我們這里額外傳遞了一些 props 屬性到組件模板,包括表單標(biāo)題(title
)、操作類型(action
)、表單提交 URL(url
),后面馬上會(huì)介紹表單組件的調(diào)整。
在 resources/views/posts
目錄下新建一個(gè) edit.blade.php
作為文件編輯頁面視圖文件,并編寫模板代碼如下:
@extends('layouts.app') @section('content')
@endsection
$id]) }}">
同樣也使用 post-form
模板渲染文章編輯表單,只不過額外傳遞了一個(gè) id 屬性,用于在表單組件初始化待編輯的文章數(shù)據(jù)。
文章詳情頁視圖后面單獨(dú)介紹。
為了適配文章編輯表單,以及后端接口返回?cái)?shù)據(jù)格式的調(diào)整,我們需要修改 Vue 表單組件實(shí)現(xiàn)代碼:
{{ title }}
{{ form.message }}
文章發(fā)布和編輯頁面需要通過標(biāo)題予以區(qū)分,所以我們通過 title
屬性從父級(jí)作用域傳遞該標(biāo)題值。
對(duì)于文章編輯表單,首先,我們會(huì)根據(jù)父級(jí)作用域傳遞的 id
屬性值在 mounted
鉤子函數(shù)中調(diào)用新增的 load
方法從后端接口 /posts/{post}/data
加載對(duì)應(yīng)文章數(shù)據(jù)填充表單。
現(xiàn)在后端接口可以自動(dòng)獲取當(dāng)前認(rèn)證用戶的 ID,所以 author
字段就沒有必要填寫了,直接將其移除。
文章創(chuàng)建和編輯對(duì)應(yīng)的請(qǐng)求方式是不一樣的,操作成功后處理邏輯也是不一樣的(前者重定向到列表頁,后者重定向到詳情頁),所以根據(jù) action
屬性值分別進(jìn)行了處理。
此外,由于后端對(duì)表單數(shù)據(jù)進(jìn)行驗(yàn)證后,保存數(shù)據(jù)階段依然可能失敗,所以前端提交表單后返回的響應(yīng)狀態(tài)碼為 200 并不表示表單提交處理成功,還需要借助響應(yīng)實(shí)體(JSON 格式)中的 success
字段進(jìn)一步判斷,進(jìn)而通過 ToastMsg
子組件渲染成功或失敗的提示文本。
ToastMsg
是從之前的 SuccessMsg
組件升級(jí)而來,直接將 SuccessMsg
組件重命名為 ToastMsg
并改寫組件代碼如下:
可以看到,如果表單提交處理成功(依然基于父級(jí)作用域傳遞的 form.success
屬性)則顯示成功提示樣式及文案,否則顯示失敗提示樣式和文案,而是否渲染該組件取決于表單驗(yàn)證是否成功,該字段基于父級(jí)作用域傳遞的 form.validated
屬性,之前是沒有這個(gè)屬性的,所以我們需要額外添加,在 resources/js/form.js
中,調(diào)整相關(guān)代碼實(shí)現(xiàn)如下:
class Form { constructor(data) { ... this.validated = false; } ... /** * 表單提交處理 * * @param {string} url * @param {string} method */ submit(url, method) { return new Promise((resolve, reject) => { axios[method](url, this.data()) .then(response => { this.onSuccess(response.data); this.validated = true; if (this.success === true) { resolve(response.data); } else { reject(response.data); } }) .catch(error => { this.onFail(error.response.data.errors); reject(error.response.data); }); }); } /** * 處理表單提交成功 * * @param {object} data */ onSuccess(data) { this.success = data.success; this.message = data.message; this.reset(); } ... }
這樣一來,文章發(fā)布和編輯共用的 Vue 表單組件就重構(gòu)好了。
我們接著來實(shí)現(xiàn)文章詳情頁。
在 component-practice/resources/js/components
目錄下新建一個(gè) PostDetail.vue
文件作為渲染文章詳情的 Vue 單文件組件,并編寫組件代碼如下:
Loading...
{{ title }}
Created at {{ created_at | diff_for_human }} by {{ author_name }}, Status: {{ status | post_status_readable }}, Action: 編輯
{{ content }}
這個(gè)組件功能比較簡單,在 mounted
鉤子函數(shù)中通過父級(jí)作用域傳遞的 id
屬性值調(diào)用 load
函數(shù)加載后端接口返回的文章數(shù)據(jù),并通過數(shù)據(jù)綁定將其渲染到模板代碼中,在加載過程中,會(huì)有一個(gè)動(dòng)態(tài)的加載狀態(tài)提示用戶文章數(shù)據(jù)正在加載。
這里我們還使用了過濾器對(duì)數(shù)據(jù)進(jìn)行格式化,日期過濾器已經(jīng)是全局的了,狀態(tài)過濾器之前是本地的,這里我們將其從文章列表卡片組件 CardItem
中將其遷移到 app.js
中作為全局過濾器:
Vue.filter('post_status_readable', status => { switch(status) { case 0: return '草稿'; case 1: return '已發(fā)布'; default: return '未知狀態(tài)'; } });
然后就可以在任何 Vue 組件中調(diào)用它了(CardItem
中過濾器調(diào)用代碼做一下相應(yīng)調(diào)整)。
在 app.js
中注冊(cè)這個(gè)組件:
Vue.component('post-detail', require('./components/PostDetail.vue').default);
再到 component-practice/resources/views/posts
目錄下新建 show.blade.php
視圖文件引用 post-detail
組件即可:
@extends('layouts.app') @section('content')@endsection
最后,我們到文章列表組件中新增一個(gè)發(fā)布文章入口。
打開子組件 ListSection
,在視圖模式切換按鈕右側(cè)新增一個(gè)插槽,用于從父級(jí)作用域傳遞更多額外操作按鈕:
...
然后在 PostList
中將發(fā)布文章按鈕放到這個(gè)插槽中(樣式代碼也做了微調(diào)):
文章列表 新文章 {{ post.title }} ...
順便也為文章列表所有文章設(shè)置詳情頁鏈接,ListItem
鏈接是從 PostList 通過 props 屬性傳遞的,CardItem
需要去子組件中設(shè)置:
至此,我們就完成了文章列表、發(fā)布、編輯和詳情頁的所有前后端功能代碼編寫。
如果你已經(jīng)在本地運(yùn)行了 npm run watch
并且通過 php arstisan serve
啟動(dòng) PHP 內(nèi)置 Web 服務(wù)器的話,就可以在瀏覽器通過 http://127.0.0.1:3002/posts
(啟用了 BrowserSync 代理)訪問新的文章列表頁了:
點(diǎn)擊任意文章鏈接,即可進(jìn)入文章詳情頁,加載數(shù)據(jù)成功之前,會(huì)有如下動(dòng)態(tài)加載效果:
你可以點(diǎn)擊「編輯」鏈接對(duì)這篇文章進(jìn)行編輯:
更新成功后,會(huì)跳轉(zhuǎn)到文章詳情頁,對(duì)應(yīng)字段均已更新,并且狀態(tài)也從草稿變成了已發(fā)布:
當(dāng)然,文章發(fā)布和編輯功能需要用戶處于已登錄狀態(tài)(目前未做權(quán)限驗(yàn)證),如果未登錄的話,點(diǎn)擊編輯和新文章按鈕會(huì)先跳轉(zhuǎn)到登錄頁面(該功能由 PostController
控制器構(gòu)造函數(shù)中定義的中間件方法實(shí)現(xiàn)),我們?cè)谝训卿浨闆r下在文章列表頁點(diǎn)擊右上角的「新文章」按鈕進(jìn)入文章發(fā)布頁面:
發(fā)布成功后,頁面會(huì)跳轉(zhuǎn)到文章列表頁,并在列表中出現(xiàn)剛剛創(chuàng)建的文章:
增刪改查還剩下一個(gè)「刪」,下篇教程,就來給大家演示文章刪除功能實(shí)現(xiàn),為什么單獨(dú)介紹呢,因?yàn)槲蚁虢Y(jié)合刪除功能演示基于 Vue 組件的模態(tài)框、對(duì)話框以及過渡效果的實(shí)現(xiàn)。
看完了這篇文章,相信你對(duì)“基于Laravel+Vue組件實(shí)現(xiàn)文章發(fā)布、編輯和瀏覽功能的示例”有了一定的了解,如果想了解更多相關(guān)知識(shí),歡迎關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道,感謝各位的閱讀!