new

src/views/sms/new/index.vue

@@ -1,9 +1,14 @@
-<template> 
+<template>
+  <!-- 整个页面的容器 -->
   <div class="app-container">
+    <!-- 筛选搜索区域的卡片 -->
     <el-card class="filter-container" shadow="never">
       <div>
+        <!-- 搜索图标 -->
         <i class="el-icon-search"></i>
+        <!-- 显示“筛选搜索”文字 -->
         <span>筛选搜索</span>
+        <!-- 查询搜索按钮，点击触发handleSearchList方法，按钮样式为小型、主色调 -->
         <el-button
           style="float:right"
           type="primary"
@@ -11,6 +16,7 @@
           size="small">
           查询搜索
         </el-button>
+        <!-- 重置按钮，点击触发handleResetSearch方法，按钮样式为小型，与查询搜索按钮有一定间隔 -->
         <el-button
           style="float:right;margin-right: 15px"
           @click="handleResetSearch()"
@@ -19,12 +25,18 @@
         </el-button>
       </div>
       <div style="margin-top: 15px">
+        <!-- 内联表单，绑定数据模型为listQuery，表单尺寸为小，标签宽度为140px -->
         <el-form :inline="true" :model="listQuery" size="small" label-width="140px">
+          <!-- 商品名称表单项 -->
           <el-form-item label="商品名称：">
+            <!-- 输入框，双向绑定listQuery.productName，设置了占位提示文字 -->
             <el-input v-model="listQuery.productName" class="input-width" placeholder="商品名称"></el-input>
           </el-form-item>
+          <!-- 推荐状态表单项 -->
           <el-form-item label="推荐状态：">
+            <!-- 下拉选择框，双向绑定listQuery.recommendStatus，有清除功能，设置了占位提示文字 -->
             <el-select v-model="listQuery.recommendStatus" placeholder="全部" clearable class="input-width">
+              <!-- 循环生成下拉选项，每个选项的key、label、value根据recommendOptions中的数据来设置 -->
               <el-option v-for="item in recommendOptions"
                          :key="item.value"
                          :label="item.label"
@@ -35,26 +47,37 @@
         </el-form>
       </div>
     </el-card>
+    <!-- 操作区域的卡片 -->
     <el-card class="operate-container" shadow="never">
+      <!-- 图标 -->
       <i class="el-icon-tickets"></i>
+      <!-- 显示“数据列表”文字 -->
       <span>数据列表</span>
+      <!-- 选择商品按钮，点击触发handleSelectProduct方法，按钮尺寸为迷你型 -->
       <el-button size="mini" class="btn-add" @click="handleSelectProduct()">选择商品</el-button>
     </el-card>
+    <!-- 表格容器 -->
     <div class="table-container">
+      <!-- el-table组件，绑定数据为list，设置宽度为100%，监听选择变化事件，根据listLoading状态显示加载动画，有边框 -->
       <el-table ref="newProductTable"
                 :data="list"
                 style="width: 100%;"
                 @selection-change="handleSelectionChange"
                 v-loading="listLoading" border>
+        <!-- 选择列，宽度为60px，内容居中 -->
         <el-table-column type="selection" width="60" align="center"></el-table-column>
+        <!-- 编号列，宽度为120px，内容居中，通过插槽作用域展示对应行的id数据 -->
         <el-table-column label="编号" width="120" align="center">
           <template slot-scope="scope">{{scope.row.id}}</template>
         </el-table-column>
+        <!-- 商品名称列，内容居中，通过插槽作用域展示对应行的productName数据 -->
         <el-table-column label="商品名称" align="center">
           <template slot-scope="scope">{{scope.row.productName}}</template>
         </el-table-column>
+        <!-- 是否推荐列，宽度为200px，内容居中，包含一个开关组件 -->
         <el-table-column label="是否推荐" width="200" align="center">
           <template slot-scope="scope">
+            <!-- 开关组件，监听状态改变事件，设置了激活和未激活的值，双向绑定对应行的recommendStatus数据 -->
             <el-switch
               @change="handleRecommendStatusStatusChange(scope.$index, scope.row)"
               :active-value="1"
@@ -63,18 +86,23 @@
             </el-switch>
           </template>
         </el-table-column>
+        <!-- 排序列，宽度为160px，内容居中，通过插槽作用域展示对应行的sort数据 -->
         <el-table-column label="排序" width="160" align="center">
           <template slot-scope="scope">{{scope.row.sort}}</template>
         </el-table-column>
+        <!-- 状态列，宽度为160px，内容居中，通过管道（formatRecommendStatus）格式化对应行的recommendStatus数据来展示 -->
         <el-table-column label="状态" width="160" align="center">
           <template slot-scope="scope">{{scope.row.recommendStatus | formatRecommendStatus}}</template>
         </el-table-column>
+        <!-- 操作列，宽度为180px，内容居中，包含设置排序和删除两个按钮 -->
         <el-table-column label="操作" width="180" align="center">
           <template slot-scope="scope">
+            <!-- 设置排序按钮，点击触发handleEditSort方法，按钮尺寸为迷你型，文本样式 -->
             <el-button size="mini"
                        type="text"
                        @click="handleEditSort(scope.$index, scope.row)">设置排序
             </el-button>
+            <!-- 删除按钮，点击触发handleDelete方法，按钮尺寸为迷你型，文本样式 -->
             <el-button size="mini"
                        type="text"
                        @click="handleDelete(scope.$index, scope.row)">删除
@@ -83,10 +111,13 @@
         </el-table-column>
       </el-table>
     </div>
+    <!-- 批量操作容器 -->
     <div class="batch-operate-container">
+      <!-- 下拉选择框，用于选择批量操作类型，双向绑定operateType，设置了占位提示文字 -->
       <el-select
         size="small"
         v-model="operateType" placeholder="批量操作">
+        <!-- 循环生成下拉选项，每个选项的key、label、value根据operates中的数据来设置 -->
         <el-option
           v-for="item in operates"
           :key="item.value"
@@ -94,6 +125,7 @@
           :value="item.value">
         </el-option>
       </el-select>
+      <!-- 确定按钮，点击触发handleBatchOperate方法，按钮样式为小型、主色调，与下拉选择框有一定间隔 -->
       <el-button
         style="margin-left: 20px"
         class="search-button"
@@ -103,7 +135,9 @@
         确定
       </el-button>
     </div>
+    <!-- 分页容器 -->
     <div class="pagination-container">
+      <!-- el-pagination分页组件，设置了背景色，监听页面尺寸改变和当前页改变事件，配置了布局、页面尺寸、可选页面尺寸列表、当前页、总数据量等属性 -->
       <el-pagination
         background
         @size-change="handleSizeChange"
@@ -115,27 +149,36 @@
         :total="total">
       </el-pagination>
     </div>
+    <!-- 选择商品的对话框 -->
     <el-dialog title="选择商品" :visible.sync="selectDialogVisible" width="50%">
+      <!-- 输入框，双向绑定dialogData.listQuery.keyword，设置了宽度、样式、占位提示文字，包含一个搜索按钮 -->
       <el-input v-model="dialogData.listQuery.keyword"
                 style="width: 250px;margin-bottom: 20px"
                 size="small"
                 placeholder="商品名称搜索">
         <el-button slot="append" icon="el-icon-search" @click="handleSelectSearch()"></el-button>
       </el-input>
+      <!-- el-table组件，用于对话框内展示数据，绑定数据为dialogData.list，监听选择变化事件，有边框 -->
       <el-table :data="dialogData.list"
                 @selection-change="handleDialogSelectionChange" border>
+        <!-- 选择列，宽度为60px，内容居中 -->
         <el-table-column type="selection" width="60" align="center"></el-table-column>
+        <!-- 商品名称列，内容居中，通过插槽作用域展示对应行的name数据 -->
         <el-table-column label="商品名称" align="center">
           <template slot-scope="scope">{{scope.row.name}}</template>
         </el-table-column>
+        <!-- 货号列，宽度为160px，内容居中，通过插槽作用域展示对应行的productSn数据，格式化展示格式 -->
         <el-table-column label="货号" width="160" align="center">
           <template slot-scope="scope">NO.{{scope.row.productSn}}</template>
         </el-table-column>
+        <!-- 价格列，宽度为120px，内容居中，通过插槽作用域展示对应行的price数据，格式化展示格式 -->
         <el-table-column label="价格" width="120" align="center">
           <template slot-scope="scope">￥{{scope.row.price}}</template>
         </el-table-column>
       </el-table>
+      <!-- 对话框内的分页容器 -->
       <div class="pagination-container">
+        <!-- el-pagination分页组件，设置了背景色，监听对话框内页面尺寸改变和当前页改变事件，配置了布局、页面尺寸、可选页面尺寸列表、当前页、总数据量等属性 -->
         <el-pagination
           background
           @size-change="handleDialogSizeChange"
@@ -149,36 +192,48 @@
       </div>
       <div style="clear: both;"></div>
       <div slot="footer">
+        <!-- 取消按钮，点击隐藏对话框，按钮尺寸为小型 -->
         <el-button  size="small" @click="selectDialogVisible = false">取 消</el-button>
+        <!-- 确定按钮，点击触发handleSelectDialogConfirm方法，按钮尺寸为小型、主色调 -->
         <el-button  size="small" type="primary" @click="handleSelectDialogConfirm()">确 定</el-button>
       </div>
     </el-dialog>
+    <!-- 设置排序的对话框 -->
     <el-dialog title="设置排序"
                :visible.sync="sortDialogVisible"
                width="40%">
+      <!-- el-form表单组件，绑定数据模型为sortDialogData，设置标签宽度 -->
       <el-form :model="sortDialogData"
                label-width="150px">
+        <!-- 排序表单项 -->
         <el-form-item label="排序：">
+          <!-- 输入框，双向绑定sortDialogData.sort，设置了宽度 -->
           <el-input v-model="sortDialogData.sort" style="width: 200px"></el-input>
         </el-form-item>
       </el-form>
       <span slot="footer">
+        <!-- 取消按钮，点击隐藏对话框，按钮尺寸为小型 -->
         <el-button @click="sortDialogVisible = false" size="small">取 消</el-button>
+        <!-- 确定按钮，点击触发handleUpdateSort方法，按钮尺寸为小型、主色调 -->
         <el-button type="primary" @click="handleUpdateSort" size="small">确 定</el-button>
       </span>
     </el-dialog>
   </div>
 </template>
 <script>
+// 从'@/api/newProduct'模块中导入多个函数，用于获取列表、更新推荐状态、删除新产品、创建新产品、更新新产品排序等操作
 import {fetchList,updateRecommendStatus,deleteNewProduct,createNewProduct,updateNewProductSort} from '@/api/newProduct';
+// 从'@/api/product'模块中导入名为fetchList的函数，并将其重命名为fetchProductList，用于获取产品列表相关操作
 import {fetchList as fetchProductList} from '@/api/product';
 
+// 定义默认的列表查询参数对象，包含当前页码、每页数量、商品名称、推荐状态等初始值
 const defaultListQuery = {
   pageNum: 1,
   pageSize: 5,
   productName: null,
   recommendStatus: null
 };
+// 定义默认的推荐状态选项数组，每个选项包含显示的标签（如'未推荐'）和对应的值（如0）
 const defaultRecommendOptions = [
   {
     label: '未推荐',
@@ -189,16 +244,24 @@
     value: 1
   }
 ];
+
 export default {
   name: 'newProductList',
   data() {
     return {
+      // 列表查询参数对象，初始化为defaultListQuery的副本，后续会根据用户操作动态变化
       listQuery: Object.assign({}, defaultListQuery),
+      // 推荐状态选项数组，初始化为defaultRecommendOptions的副本，用于下拉选择等展示
       recommendOptions: Object.assign({}, defaultRecommendOptions),
+      // 用于存储获取到的列表数据，初始为null，会在获取数据后更新
       list: null,
+      // 用于存储列表数据的总条数，初始为null，会在获取数据后更新
       total: null,
+      // 表示列表数据是否正在加载的布尔值，用于控制加载动画显示等，初始为false
       listLoading: false,
+      // 存储用户多选的记录数据，初始为空数组，会根据用户选择操作更新
       multipleSelection: [],
+      // 定义可进行的批量操作选项数组，每个选项包含显示的标签（如'设为推荐'）和对应的值（如0）
       operates: [
         {
           label: "设为推荐",
@@ -213,28 +276,40 @@
           value: 2
         }
       ],
+      // 用于存储当前选择的批量操作类型，初始为null，用户选择后更新
       operateType: null,
+      // 控制选择商品对话框是否可见的布尔值，初始为false，点击相关按钮等操作可改变其值
       selectDialogVisible:false,
       dialogData:{
+        // 对话框中展示的列表数据，初始为null，获取后更新
         list: null,
+        // 对话框中列表数据的总条数，初始为null，获取后更新
         total: null,
+        // 对话框内用户多选的记录数据，初始为空数组，会根据用户选择操作更新
         multipleSelection:[],
         listQuery:{
+          // 对话框内用于搜索的关键字，初始为null，用户输入后更新
           keyword: null,
+          // 对话框内列表的当前页码，初始为1
           pageNum: 1,
+          // 对话框内列表每页的数量，初始为5
           pageSize: 5
         }
       },
+      // 控制设置排序对话框是否可见的布尔值，初始为false，点击相关按钮等操作可改变其值
       sortDialogVisible:false,
+      // 用于设置排序对话框的数据对象，包含排序值和对应的产品id等信息，初始值设置好相关属性
       sortDialogData:{sort:0,id:null}
     }
   },
   created() {
+    // 在组件创建时调用getList方法，用于获取初始的列表数据
     this.getList();
   },
   filters:{
+    // 定义名为formatRecommendStatus的过滤器函数
     formatRecommendStatus(status){
-        if(status===1){
+      if(status===1){ //根据传入的状态值（1或0）返回对应的文字描述（'推荐中'或'未推荐'）
         return '推荐中';
       }else{
         return '未推荐';
@@ -242,31 +317,39 @@
     }
   },
   methods: {
+    // 处理重置搜索的方法，将列表查询参数重置为默认值（即复制defaultListQuery的内容）
     handleResetSearch() {
       this.listQuery = Object.assign({}, defaultListQuery);
     },
+    // 处理查询搜索的方法，先将列表查询参数的当前页码重置为1，然后调用getList方法获取最新列表数据
     handleSearchList() {
       this.listQuery.pageNum = 1;
       this.getList();
     },
+    // 处理表格行选择变化的方法，将用户选择的行数据更新到multipleSelection数组中
     handleSelectionChange(val){
       this.multipleSelection = val;
     },
+    // 处理页面尺寸改变的方法，当用户切换每页显示数量时，先将当前页码重置为1，再更新列表查询参数中的每页数量，并调用getList方法获取新的数据
     handleSizeChange(val) {
       this.listQuery.pageNum = 1;
       this.listQuery.pageSize = val;
       this.getList();
     },
+    // 处理当前页码改变的方法，当用户切换页码时，更新列表查询参数中的当前页码，并调用getList方法获取对应页码的数据
     handleCurrentChange(val) {
       this.listQuery.pageNum = val;
       this.getList();
     },
+    // 处理推荐状态改变的方法，调用updateRecommendStatusStatus方法，传入对应行的id和推荐状态值，来更新推荐状态
     handleRecommendStatusStatusChange(index,row){
       this.updateRecommendStatusStatus(row.id,row.recommendStatus);
     },
+    // 处理删除操作的方法，调用deleteProduct方法，传入要删除的产品id，执行删除操作
     handleDelete(index,row){
       this.deleteProduct(row.id);
     },
+    // 处理批量操作的方法，首先判断用户是否至少选择了一条记录，如果没有则弹出提示并返回
     handleBatchOperate(){
       if (this.multipleSelection < 1) {
         this.$message({
@@ -276,7 +359,7 @@
         });
         return;
       }
-        let ids = [];
+      let ids = []; //然后根据用户选择的批量操作类型（设为推荐、取消推荐、删除等）执行相应的操作逻辑，如调用对应的更新或删除方法，并传递相应的参数
       for (let i = 0; i < this.multipleSelection.length; i++) {
         ids.push(this.multipleSelection[i].id);
       }
@@ -297,25 +380,31 @@
         });
       }
     },
+    // 处理选择商品操作的方法，将选择商品对话框设置为可见，并调用getDialogList方法获取对话框内要展示的列表数据
     handleSelectProduct(){
       this.selectDialogVisible=true;
       this.getDialogList();
     },
+    // 处理在选择商品对话框内进行搜索的方法，调用getDialogList方法获取符合搜索条件的列表数据
     handleSelectSearch(){
       this.getDialogList();
     },
+    // 处理选择商品对话框内页面尺寸改变的方法，当用户切换每页显示数量时，先将对话框内列表的当前页码重置为1，再更新对话框列表查询参数中的每页数量，并调用getDialogList方法获取新的数据
     handleDialogSizeChange(val) {
       this.dialogData.listQuery.pageNum = 1;
       this.dialogData.listQuery.pageSize = val;
       this.getDialogList();
     },
+    // 处理选择商品对话框内当前页码改变的方法，当用户切换页码时，更新对话框列表查询参数中的当前页码，并调用getDialogList方法获取对应页码的数据
     handleDialogCurrentChange(val) {
       this.dialogData.listQuery.pageNum = val;
       this.getDialogList();
     },
+    // 处理选择商品对话框内行选择变化的方法，将用户在对话框内选择的行数据更新到dialogData.multipleSelection数组中
     handleDialogSelectionChange(val){
       this.dialogData.multipleSelection = val;
     },
+    // 处理在选择商品对话框中点击确定按钮的方法，首先判断用户是否至少选择了一条记录，如果没有则弹出提示并返回；
     handleSelectDialogConfirm(){
       if (this.dialogData.multipleSelection < 1) {
         this.$message({
@@ -325,7 +414,7 @@
         });
         return;
       }
-        let selectProducts = [];
+      let selectProducts = []; //然后将用户选择的商品信息整理成数组格式，弹出确认框询问是否添加
       for (let i = 0; i < this.dialogData.multipleSelection.length; i++) {
         selectProducts.push({
           productId:this.dialogData.multipleSelection[i].id,
@@ -337,10 +426,10 @@
         cancelButtonText: '取消',
         type: 'warning'
       }).then(() => {
-          createNewProduct(selectProducts).then(response=>{
+        createNewProduct(selectProducts).then(response=>{ //用户确认后调用createNewProduct方法创建新产品，创建成功后关闭对话框、清空选择记录
           this.selectDialogVisible=false;
           this.dialogData.multipleSelection=[];
-            this.getList();
+          this.getList(); //并重新获取列表数据，同时弹出成功提示
           this.$message({
             type: 'success',
             message: '添加成功!'
@@ -348,20 +437,22 @@
         });
       });
     },
+    // 处理编辑排序操作的方法，将设置排序对话框设置为可见
     handleEditSort(index,row){
       this.sortDialogVisible=true;
       this.sortDialogData.sort=row.sort;
-        this.sortDialogData.id=row.id;
+      this.sortDialogData.id=row.id; //并将对应行的当前排序值和id赋值给对话框的数据对象，方便后续修改操作
     },
+    // 处理更新排序的方法
     handleUpdateSort(){
-        this.$confirm('是否要修改排序?', '提示', {
+      this.$confirm('是否要修改排序?', '提示', { //弹出确认框询问是否修改排序
         confirmButtonText: '确定',
         cancelButtonText: '取消',
         type: 'warning'
       }).then(() => {
-          updateNewProductSort(this.sortDialogData).then(response=>{
+        updateNewProductSort(this.sortDialogData).then(response=>{ //用户确认后调用updateNewProductSort方法传入排序对话框的数据对象进行排序更新，更新成功后关闭对话框
           this.sortDialogVisible=false;
-            this.getList();
+          this.getList(); //重新获取列表数据，同时弹出成功提示
           this.$message({
             type: 'success',
             message: '删除成功!'
@@ -369,48 +460,51 @@
         });
       })
     },
+    // 获取列表数据的方法
     getList() {
-        this.listLoading = true;
+      this.listLoading = true; //首先将列表加载状态设置为true，表示正在加载
-        fetchList(this.listQuery).then(response => {
+      fetchList(this.listQuery).then(response => { //然后调用fetchList方法传入列表查询参数获取数据
-          this.listLoading = false;
+        this.listLoading = false; //将列表加载状态设置为false
-          this.list = response.data.list;
+        this.list = response.data.list; //获取成功后更新列表数据、总条数
         this.total = response.data.total;
       })
     },
+    // 更新推荐状态的方法
     updateRecommendStatusStatus(ids,status){
-        this.$confirm('是否要修改推荐状态?', '提示', {
+      this.$confirm('是否要修改推荐状态?', '提示', { //弹出确认框询问是否修改推荐状态
         confirmButtonText: '确定',
         cancelButtonText: '取消',
         type: 'warning'
       }).then(() => {
-          let params=new URLSearchParams();
+        let params=new URLSearchParams(); //用户确认后将传入的产品id（或多个id组成的数组）和推荐状态值封装成URLSearchParams格式
         params.append("ids",ids);
         params.append("recommendStatus",status);
-          updateRecommendStatus(params).then(response=>{
+        updateRecommendStatus(params).then(response=>{ //调用updateRecommendStatus方法进行状态更新
-            this.getList();
+          this.getList(); //更新成功后重新获取列表数据，并弹出成功提示；
           this.$message({
             type: 'success',
             message: '修改成功!'
           });
         });
       }).catch(() => {
-          this.$message({
+        this.$message({ //如果用户取消操作，也会重新获取列表数据并弹出相应提示
           type: 'success',
           message: '已取消操作!'
         });
         this.getList();
       });
     },
+    // 删除产品的方法
     deleteProduct(ids){
-        this.$confirm('是否要删除该推荐?', '提示', {
+      this.$confirm('是否要删除该推荐?', '提示', { //弹出确认框询问是否删除
         confirmButtonText: '确定',
         cancelButtonText: '取消',
         type: 'warning'
       }).then(() => {
-          let params=new URLSearchParams();
+        let params=new URLSearchParams(); //用户确认后将传入的产品id（或多个id组成的数组）封装成URLSearchParams格式
         params.append("ids",ids);
-          deleteNewProduct(params).then(response=>{
+        deleteNewProduct(params).then(response=>{ //调用deleteNewProduct方法执行删除操作
-            this.getList();
+          this.getList(); //删除成功后重新获取列表数据，并弹出成功提示
           this.$message({
             type: 'success',
             message: '删除成功!'
@@ -418,9 +512,10 @@
         });
       })
     },
+    // 获取选择商品对话框内列表数据的方法
     getDialogList(){
-        fetchProductList(this.dialogData.listQuery).then(response=>{
+      fetchProductList(this.dialogData.listQuery).then(response=>{ //调用fetchProductList方法传入对话框的列表查询参数获取数据
-          this.dialogData.list=response.data.list;
+        this.dialogData.list=response.data.list; //获取成功后更新对话框内的列表数据和总条数
         this.dialogData.total=response.data.total;
       })
     }