【第23章】Vue实战篇之文章-CSDN博客

本文链接：https://blog.csdn.net/qq_44824164/article/details/139663544

前言

这里来做文章的增删改查功能，其中涉及到图片上传和vue-quill富文本组件的使用。

一、搭建界面

<script setup>
import {
    Edit,
    Delete
} from '@element-plus/icons-vue'

import { ref,onMounted } from 'vue'
import articleCategoryListService from '@/api/article.js'

//文章分类数据模型
const categorys = ref([])

onMounted(async() => {
    let result = await articleCategoryListService();
    if (result.code == 0) {
        categorys.value = result.data
    }
}) 

//用户搜索时选中的分类id
const categoryId=ref('')

//用户搜索时选中的发布状态
const state=ref('')

//文章列表数据模型
const articles = ref([
    {
        "id": 5,
        "title": "陕西旅游攻略",
        "content": "兵马俑,华清池,法门寺,华山...爱去哪去哪...",
        "coverImg": "https://big-event-gwd.oss-cn-beijing.aliyuncs.com/9bf1cf5b-1420-4c1b-91ad-e0f4631cbed4.png",
        "state": "草稿",
        "categoryId": 2,
        "createTime": "2023-09-03 11:55:30",
        "updateTime": "2023-09-03 11:55:30"
    },
    {
        "id": 5,
        "title": "陕西旅游攻略",
        "content": "兵马俑,华清池,法门寺,华山...爱去哪去哪...",
        "coverImg": "https://big-event-gwd.oss-cn-beijing.aliyuncs.com/9bf1cf5b-1420-4c1b-91ad-e0f4631cbed4.png",
        "state": "草稿",
        "categoryId": 2,
        "createTime": "2023-09-03 11:55:30",
        "updateTime": "2023-09-03 11:55:30"
    },
    {
        "id": 5,
        "title": "陕西旅游攻略",
        "content": "兵马俑,华清池,法门寺,华山...爱去哪去哪...",
        "coverImg": "https://big-event-gwd.oss-cn-beijing.aliyuncs.com/9bf1cf5b-1420-4c1b-91ad-e0f4631cbed4.png",
        "state": "草稿",
        "categoryId": 2,
        "createTime": "2023-09-03 11:55:30",
        "updateTime": "2023-09-03 11:55:30"
    },
])

//分页条数据模型
const pageNum = ref(1)//当前页
const total = ref(20)//总条数
const pageSize = ref(3)//每页条数

//当每页条数发生了变化，调用此函数
const onSizeChange = (size) => {
    pageSize.value = size
}
//当前页码发生变化，调用此函数
const onCurrentChange = (num) => {
    pageNum.value = num
}
</script>
<template>
    <el-card class="page-container">
        <template #header>
            <div class="header">
                <span>文章管理</span>
                <div class="extra">
                    <el-button type="primary">添加文章</el-button>
                </div>
            </div>
        </template>
        <!-- 搜索表单 -->
        <el-form inline>
            <el-form-item label="文章分类：">
                <el-select placeholder="请选择" v-model="categoryId" style="width: 240px">
                    <el-option 
                        v-for="c in categorys" 
                        :key="c.id" 
                        :label="c.categoryName"
                        :value="c.id">
                    </el-option>
                </el-select>
            </el-form-item>

            <el-form-item label="发布状态：">
                <el-select placeholder="请选择" v-model="state" style="width: 240px">
                    <el-option label="已发布" value="已发布"></el-option>
                    <el-option label="草稿" value="草稿"></el-option>
                </el-select>
            </el-form-item>
            <el-form-item>
                <el-button type="primary">搜索</el-button>
                <el-button>重置</el-button>
            </el-form-item>
        </el-form>
        <!-- 文章列表 -->
        <el-table :data="articles" style="width: 100%">
            <el-table-column label="文章标题" width="400" prop="title"></el-table-column>
            <el-table-column label="分类" prop="categoryId"></el-table-column>
            <el-table-column label="发表时间" prop="createTime"> </el-table-column>
            <el-table-column label="状态" prop="state"></el-table-column>
            <el-table-column label="操作" width="100">
                <template #default="{ row }">
                    <el-button :icon="Edit" circle plain type="primary"></el-button>
                    <el-button :icon="Delete" circle plain type="danger"></el-button>
                </template>
            </el-table-column>
            <template #empty>
                <el-empty description="没有数据" />
            </template>
        </el-table>
        <!-- 分页条 -->
        <el-pagination v-model:current-page="pageNum" v-model:page-size="pageSize" :page-sizes="[3, 5 ,10, 15]"
            layout="jumper, total, sizes, prev, pager, next" background :total="total" @size-change="onSizeChange"
            @current-change="onCurrentChange" style="margin-top: 20px; justify-content: flex-end" />
    </el-card>
</template>
<style lang="scss" scoped>
.page-container {
    min-height: 100%;
    box-sizing: border-box;

    .header {
        display: flex;
        align-items: center;
        justify-content: space-between;
    }
}
</style>

二、加载文章列表

1.界面

<!-- 文章列表 -->
 <el-table :data="articles" style="width: 100%">
     <el-table-column label="文章标题" width="400" prop="title"></el-table-column>
     <el-table-column label="分类" prop="categoryName"></el-table-column>
     <el-table-column label="发表时间" prop="createTime"> </el-table-column>
     <el-table-column label="状态" prop="state"></el-table-column>
     <el-table-column label="操作" width="100">
         <template #default="{ row }">
             <el-button :icon="Edit" circle plain type="primary"></el-button>
             <el-button :icon="Delete" circle plain type="danger"></el-button>
         </template>
     </el-table-column>
     <template #empty>
         <el-empty description="没有数据" />
     </template>
 </el-table>

2.请求脚本

export const articleListService = (params)=>{
    return request.get('/article/page',{params:params})
}

3. 加载事件

import { articleListService } from '@/api/article.js'

onMounted(async () => {
    let result = await articleCategoryListService();
    if (result.code == 0) {
        categorys.value = result.data
    }
    loadArticles()
})
//获取文章列表
const loadArticles = async () => {
    var params = new URLSearchParams()
    params.append('pageNum', pageNum.value)
    params.append('pageSize', pageSize.value)
    if (categoryId.value) params.append('categoryId', categoryId.value)
    if (state.value) params.append('state', state.value)
    const result = await articleListService(params)
    if (result.code == 0) {
        total.value = result.data.total
        articles.value = result.data.items
    }
    articles.value.forEach(article => {
        categorys.value.forEach(category => {
            if (article.categoryId == category.id) {
                article.categoryName=category.categoryName
            }
        });
    });
}

4. 搜索和重置

<el-form-item>
   <el-button type="primary" @click="loadArticles">搜索</el-button>
    <el-button @click="reset">重置</el-button>
</el-form-item>

//重置
const reset = () => {
    categoryId.value=''
    state.value=''
    loadArticles()
}

5. 分页事件

//当每页条数发生了变化，调用此函数
const onSizeChange = (size) => {
    pageSize.value = size
    loadArticles()
}
//当前页码发生变化，调用此函数
const onCurrentChange = (num) => {
    pageNum.value = num
    loadArticles()
}

三、添加文章

1. 富文本编辑器

1.1 安装

npm install @vueup/vue-quill@latest --save

1.2 导入组件

import { QuillEditor } from '@vueup/vue-quill'
import '@vueup/vue-quill/dist/vue-quill.snow.css'

1.3 使用

<quill-editor theme="snow" v-model:content="articleModel.content"
    contentType="html">
</quill-editor></div>

1.4 样式美化

.editor {
  width: 100%;
  :deep(.ql-editor) {
    min-height: 200px;
  }
}

2. 页面搭建

2.1 数据绑定

//添加文章
//控制抽屉是否显示
const visibleDrawer = ref(false)
//添加表单数据模型
const articleModel = ref({
    title: '',
    categoryId: '',
    coverImg: '',
    content: '',
    state: ''
})

2.2 界面

<el-button type="primary" @click="visibleDrawer = true">添加文章</el-button>

<!-- 抽屉 -->
<el-drawer v-model="visibleDrawer" title="添加文章" direction="rtl" size="50%">
     <!-- 添加文章表单 -->
     <el-form :model="articleModel" label-width="100px">
         <el-form-item label="文章标题">
             <el-input v-model="articleModel.title" placeholder="请输入标题"></el-input>
         </el-form-item>
         <el-form-item label="文章分类">
             <el-select placeholder="请选择" v-model="articleModel.categoryId">
                 <el-option v-for="c in categorys" :key="c.id" :label="c.categoryName" :value="c.id">
                 </el-option>
             </el-select>
         </el-form-item>
         <el-form-item label="文章封面">

             <el-upload class="avatar-uploader" :auto-upload="false" :show-file-list="false">
                 <img v-if="articleModel.coverImg" :src="articleModel.coverImg" class="avatar" />
                 <el-icon v-else class="avatar-uploader-icon">
                     <Plus />
                 </el-icon>
             </el-upload>
         </el-form-item>
         <el-form-item label="文章内容">
             <div class="editor">
                 <quill-editor theme="snow" v-model:content="articleModel.content"
                     contentType="html">
                 </quill-editor></div>
         </el-form-item>
         <el-form-item>
             <el-button type="primary">发布</el-button>
             <el-button type="info">草稿</el-button>
         </el-form-item>
     </el-form>
 </el-drawer>

3. 图片上传

我这里把文件放到public目录下，方便动态返显图片。

3.1 数据绑定

import {useTokenStore} from '@/stores/token.js';

//图片上传
const token=ref('')
const updateBefore=()=>{
    const tokenStore=useTokenStore()
    if(tokenStore.getToken()){
        token.value={'Authorization':'Bearer '+tokenStore.getToken()}
    }
}
const uploadSuccess=(response)=>{
    console.log(response)
    articleModel.value.coverImg='/image/'+response.data
}

3.2 界面

<el-upload class="avatar-uploader" :auto-upload="true" action="/api/file/upload" :name="file" :headers="token" :before-upload="updateBefore" :on-success="uploadSuccess"
:show-file-list="false">
    <el-image v-if="articleModel.coverImg" :src="articleModel.coverImg" class="avatar" :fit="fit" />
    <el-icon v-else class="avatar-uploader-icon">
        <Plus />
    </el-icon>
</el-upload>

4. 表单校验

4.1 脚本

//添加表单校验
const articleFormRef = ref(null)
const rules = {
    title: [
        { required: true, message: '请输入文章标题', trigger: 'blur' }
    ],
    categoryId: [
        { required: true, message: '请选择文章分类', trigger: 'change' }
    ],
    coverImg: [
        { required: true, message: '请上传文章封面', trigger: 'blur' }
    ],
    content: [
        { required: true, message: '请输入文章内容', trigger: 'blur' }
    ]
}

4.2 表单

<!-- 添加文章表单 -->
<el-form :model="articleModel" label-width="100px" ref="articleFormRef" :rules="rules">
     <el-form-item label="文章标题" prop="title">
         <el-input v-model="articleModel.title" placeholder="请输入标题"></el-input>
     </el-form-item>
     <el-form-item label="文章分类" prop="categoryId">
         <el-select placeholder="请选择文章分类" v-model="articleModel.categoryId">
             <el-option v-for="c in categorys" :key="c.id" :label="c.categoryName" :value="c.id">
             </el-option>
         </el-select>
     </el-form-item>
     <el-form-item label="文章封面" prop="coverImg">

         <el-upload class="avatar-uploader" :auto-upload="true" action="/api/file/upload" :name="file" :headers="token" :before-upload="updateBefore" :on-success="uploadSuccess"
         :show-file-list="false">
             <el-image v-if="articleModel.coverImg" :src="articleModel.coverImg" class="avatar" :fit="fit" />
             <el-icon v-else class="avatar-uploader-icon">
                 <Plus />
             </el-icon>
         </el-upload>
     </el-form-item>
     <el-form-item label="文章内容" prop="content">
         <div class="editor">
             <quill-editor theme="snow" v-model:content="articleModel.content"
             contentType="html" placeholder="请输入文章内容">
             </quill-editor></div>
     </el-form-item>
     <el-form-item>
         <el-button type="primary" @click="addArticle('已发布')">发布</el-button>
         <el-button type="info" @click="addArticle('草稿')">草稿</el-button>
     </el-form-item>
 </el-form>

5. 添加文章

5.1 重置表单

<el-button type="primary" @click="visibleDrawer = true;resetForm()">添加文章</el-button>

const resetForm = () => {
    if (!articleFormRef.value) return
    articleFormRef.value.resetFields()
    articleModel.value.content=' '
}

5.2 事件

import { articleListService,articleAddService } from '@/api/article.js'

const addArticle = (articleState) => {
    console.log(articleModel)
    if(articleModel.value.content==="<p> </p>")articleModel.value.content=''
    articleFormRef.value.validate(async (valid) => {
        if (valid) {
            articleModel.value.state=articleState
            const result = await articleAddService(articleModel.value)
            const message = result.message
            if (result.code == 0) {
                ElMessage.success(message ? message : '新增成功!')
                loadArticles()
                visibleDrawer.value = false
            } else {
                ElMessage.error(message ? message : '新增失败,请稍后重试!')
            }
        }
    })
}

四、编辑文章

1. 脚本

export const editArticleService = (articleData)=>{
    return request.put('/article',articleData)
}

2. 界面

<el-button type="primary" @click="visibleDrawer = true;resetForm();index = 0">添加文章</el-button>

<!-- 文章列表 -->
<el-table :data="articles" style="width: 100%">
     <el-table-column label="文章标题" width="400" prop="title"></el-table-column>
     <el-table-column label="分类" prop="categoryName"></el-table-column>
     <el-table-column label="发表时间" prop="createTime"> </el-table-column>
     <el-table-column label="状态" prop="state"></el-table-column>
     <el-table-column label="操作" width="100">
         <template #default="{ row }">
             <el-button :icon="Edit" circle plain type="primary" @click="editClick(row)"></el-button>
             <el-button :icon="Delete" circle plain type="danger"></el-button>
         </template>
     </el-table-column>
     <template #empty>
         <el-empty description="没有数据" />
     </template>
 </el-table>

3. 事件

import { articleListService,articleAddService,editArticleService } from '@/api/article.js'

const index=ref(0)
//编辑文章
const editClick = (row) => {
    resetForm()
    index.value = 1
    //title.value = titleArray.value[index.value]
    visibleDrawer.value = true
    articleModel.value.id = row.id
    articleModel.value.title = row.title
    articleModel.value.categoryId = row.categoryId
    articleModel.value.coverImg = row.coverImg
    articleModel.value.content = row.content
    articleModel.value.state = row.state
}
const editArticle = (articleState) => {
    if(articleModel.value.state=='已发布'&&articleState==='草稿'){
        ElMessage.error( '当前文章已发布,不可再变更为草稿状态')
        return
    }
    articleFormRef.value.validate(async (valid) => {
        if (valid) {
            articleModel.value.state=articleState
            const result = await editArticleService(articleModel.value)
            const message = result.message
            if (result.code == 0) {
                ElMessage.success(message ? message : '更新成功!')
                loadArticles()
                visibleDrawer.value = false
            } else {
                ElMessage.error(message ? message : '更新失败,请稍后重试!')
            }
        }
    })
}

五、删除文章

1. 脚本

export const deleteArticleService = (articleData)=>{
    return request.delete('/article?id='+articleData)
}

2. 界面

<el-table-column label="操作" width="100">
   <template #default="{ row }">
        <el-button :icon="Edit" circle plain type="primary" @click="editClick(row)"></el-button>
        <el-popconfirm title="确认删除吗?" @confirm="deleteClick(row)">
            <template #reference>
                <el-button :icon="Delete" circle plain type="danger"></el-button>
            </template>
        </el-popconfirm>
    </template>
</el-table-column>

3. 事件

import { articleListService,articleAddService,editArticleService,deleteArticleService } from '@/api/article.js'

//删除文章
const deleteClick = async (row) => {
    const result = await deleteArticleService(row.id)
    const message = result.message
    if (result.code == 0) {
        ElMessage.success(message ? message : '删除成功!')
        loadArticles()
    } else {
        ElMessage.error(message ? message : '删除失败,请稍后重试!')
    }
}