TienChin 渠道管理-前端展示渠道信息

在编写 Vue 项目的时候我们可以使用 IDEA 当中提供的一个工具叫做 structure，也就是说可以很轻松的列举出当前 Vue 文件的大致结构，点那个就会跳转到对应的地方。

简简单单介绍一个编写Vue时的一个小技巧，那么接下来进入核心内容，展示渠道信息的开发。

在 api 文件夹模块当中新建一个 tienchin 的文件夹，在当中编写一个 channel.js:

channel.js:

import request from '@/utils/request'

/**
 * 查询渠道列表
 * @param query 查询条件参数
 * @returns {*} 查询结果
 */
export function listChannel(query) {
    return request({
        url: '/tienchin/channel/list',
        method: 'get',
        params: query
    })
}

// 查询渠道详细
export function getInfo(channelId) {
    return request({
        url: '/tienchin/channel/' + channelId,
        method: 'get'
    })
}

// 新增渠道
export function addChannel(data) {
    return request({
        url: '/tienchin/channel',
        method: 'post',
        data: data
    })
}

// 修改渠道
export function updateChannel(data) {
    return request({
        url: '/tienchin/channel',
        method: 'put',
        data: data
    })
}

// 删除渠道
export function delChannel(channelIds) {
    return request({
        url: '/tienchin/channel/' + channelIds,
        method: 'delete'
    })
}

主要的就是编写了一下对接后台的 api。

接下来就是页面的调用代码：

index.vue:

<template>
  <div class="app-container">
    <el-form :model="queryParams" ref="queryRef" v-show="showSearch" :inline="true">
      <el-form-item label="渠道名称" prop="channelName">
        <el-input
            v-model="queryParams.channelName"
            placeholder="请输入渠道名称"
            clearable
            style="width: 240px"
            @keyup.enter="handleQuery"
        />
      </el-form-item>
      <el-form-item label="渠道状态" prop="status">
        <el-select
            v-model="queryParams.status"
            placeholder="渠道状态"
            clearable
            style="width: 240px"
        >
          <el-option
              v-for="dict in channel_status"
              :key="dict.value"
              :label="dict.label"
              :value="dict.value"
          />
        </el-select>
      </el-form-item>
      <el-form-item label="渠道类型" prop="type">
        <el-select
            v-model="queryParams.type"
            placeholder="渠道类型"
            clearable
            style="width: 240px"
        >
          <el-option
              v-for="dict in channel_type"
              :key="dict.value"
              :label="dict.label"
              :value="dict.value"
          />
        </el-select>
      </el-form-item>
      <el-form-item label="创建时间" style="width: 308px">
        <el-date-picker
            v-model="dateRange"
            value-format="YYYY-MM-DD"
            type="daterange"
            range-separator="-"
            start-placeholder="开始日期"
            end-placeholder="结束日期"
        ></el-date-picker>
      </el-form-item>
      <el-form-item>
        <el-button type="primary" icon="Search" @click="handleQuery">搜索</el-button>
        <el-button icon="Refresh" @click="resetQuery">重置</el-button>
      </el-form-item>
    </el-form>
    <el-row :gutter="10" class="mb8">
      <el-col :span="1.5">
        <el-button
            type="primary"
            plain
            icon="Plus"
            @click="handleAdd"
            v-hasPermi="['tienchin:channel:create']"
        >新增
        </el-button>
      </el-col>
      <el-col :span="1.5">
        <el-button
            type="success"
            plain
            icon="Edit"
            :disabled="single"
            @click="handleUpdate"
            v-hasPermi="['tienchin:channel:edit']"
        >修改
        </el-button>
      </el-col>
      <el-col :span="1.5">
        <el-button
            type="danger"
            plain
            icon="Delete"
            :disabled="multiple"
            @click="handleDelete"
            v-hasPermi="['tienchin:channel:remove']"
        >删除
        </el-button>
      </el-col>
      <el-col :span="1.5">
        <el-button
            type="info"
            plain
            icon="Upload"
            @click="handleImport"
            v-hasPermi="['tienchin:channel:import']"
        >导入
        </el-button>
      </el-col>
      <el-col :span="1.5">
        <el-button
            type="warning"
            plain
            icon="Download"
            @click="handleExport"
            v-hasPermi="['tienchin:channel:export']"
        >导出
        </el-button>
      </el-col>
      <right-toolbar v-model:showSearch="showSearch" @queryTable="getList"></right-toolbar>
    </el-row>

    <!-- 表格数据 -->
    <el-table v-loading="loading" :data="channelList" @selection-change="handleSelectionChange">
      <el-table-column type="selection" width="55" align="center"/>
      <el-table-column label="渠道编号" prop="channelId" width="120"/>
      <el-table-column label="渠道名称" prop="channelName" :show-overflow-tooltip="true" width="150"/>
      <el-table-column label="渠道类型" :show-overflow-tooltip="true" width="100">
        <template #default="scope">
          <template
              v-for="(type, index) in channel_type"
          >
            <el-tag
                :key="index"
                v-if="type.value === scope.row.type + ''"
                :type="type.elTagType"
            >
              {{ type.label }}
            </el-tag>
          </template>
        </template>
      </el-table-column>
      <el-table-column label="渠道状态" :show-overflow-tooltip="true" width="100">
        <template #default="scope">
          <template
              v-for="(status, index) in channel_status"
          >
            <el-tag
                :key="index"
                v-if="status.value === scope.row.status + ''"
                :type="status.elTagType"
            >
              {{ status.label }}
            </el-tag>
          </template>
        </template>
      </el-table-column>
      <el-table-column label="创建人" prop="createBy" :show-overflow-tooltip="true" width="100"/>
      <el-table-column label="创建时间" align="center" prop="createTime">
        <template #default="scope">
          <span>{{ parseTime(scope.row.createTime) }}</span>
        </template>
      </el-table-column>
      <el-table-column label="备注信息" prop="remark" :show-overflow-tooltip="true" width="100"/>
      <el-table-column label="操作" align="center" class-name="small-padding fixed-width">
        <template #default="scope">
          <el-tooltip content="修改" placement="top" v-if="scope.row.channelId !== 1">
            <el-button
                type="text"
                icon="Edit"
                @click="handleUpdate(scope.row)"
                v-hasPermi="['tienchin:channel:edit']"
            ></el-button>
          </el-tooltip>
          <el-tooltip content="删除" placement="top" v-if="scope.row.channelId !== 1">
            <el-button
                type="text"
                icon="Delete"
                @click="handleDelete(scope.row)"
                v-hasPermi="['tienchin:channel:remove']"
            ></el-button>
          </el-tooltip>
        </template>
      </el-table-column>
    </el-table>

    <pagination
        v-show="total > 0"
        :total="total"
        v-model:page="queryParams.pageNum"
        v-model:limit="queryParams.pageSize"
        @pagination="getList"
    />

    <!-- 添加或修改渠道配置对话框 -->
    <el-dialog :title="title" v-model="open" width="500px" append-to-body>
      <el-form ref="channelRef" :model="form" :rules="rules" label-width="100px">
        <el-form-item label="渠道名称" prop="channelName">
          <el-input v-model="form.channelName" placeholder="请输入渠道名称"/>
        </el-form-item>
        <el-form-item label="渠道状态" prop="status">
          <el-radio-group v-model="form.status">
            <el-radio
                v-for="dict in channel_status"
                :key="dict.value"
                :label="parseInt(dict.value)"
            >{{ dict.label }}
            </el-radio>
          </el-radio-group>
        </el-form-item>
        <el-form-item label="渠道类型" prop="type">
          <el-radio-group v-model="form.type">
            <el-radio
                v-for="dict in channel_type"
                :key="dict.value"
                :label="parseInt(dict.value)"
            >{{ dict.label }}
            </el-radio>
          </el-radio-group>
        </el-form-item>
        <el-form-item label="备注">
          <el-input v-model="form.remark" type="textarea" placeholder="请输入内容"></el-input>
        </el-form-item>
      </el-form>
      <template #footer>
        <div class="dialog-footer">
          <el-button type="primary" @click="submitForm">确 定</el-button>
          <el-button @click="cancel">取 消</el-button>
        </div>
      </template>
    </el-dialog>

    <!-- 渠道导入对话框 -->
    <el-dialog :title="upload.title" v-model="upload.open" width="400px" append-to-body>
      <el-upload
          ref="uploadRef"
          :limit="1"
          accept=".xlsx, .xls"
          :headers="upload.headers"
          :action="upload.url + '?updateSupport=' + upload.updateSupport"
          :disabled="upload.isUploading"
          :on-progress="handleFileUploadProgress"
          :on-success="handleFileSuccess"
          :auto-upload="false"
          drag
      >
        <el-icon class="el-icon--upload">
          <upload-filled/>
        </el-icon>
        <div class="el-upload__text">将文件拖到此处，或<em>点击上传</em></div>
        <template #tip>
          <div class="el-upload__tip text-center">
            <div class="el-upload__tip">
              <el-checkbox v-model="upload.updateSupport"/>
              是否更新已经存在的渠道数据
            </div>
            <span>仅允许导入xls、xlsx格式文件。</span>
            <el-link type="primary" :underline="false" style="font-size:12px;vertical-align: baseline;"
                     @click="importTemplate">下载模板
            </el-link>
          </div>
        </template>
      </el-upload>
      <template #footer>
        <div class="dialog-footer">
          <el-button type="primary" @click="submitFileForm">确 定</el-button>
          <el-button @click="upload.open = false">取 消</el-button>
        </div>
      </template>
    </el-dialog>
  </div>
</template>

<script setup name="Channel">
import {getToken} from "@/utils/auth";
import {listChannel, addChannel, getInfo, updateChannel, delChannel} from "@/api/tienchin/channel";

const {proxy} = getCurrentInstance();
const {
  channel_type,
  channel_status
} = proxy.useDict("channel_type", "channel_status");

const channelList = ref([]);
const open = ref(false);
const loading = ref(true);
const showSearch = ref(true);
const ids = ref([]);
const single = ref(true);
const multiple = ref(true);
const total = ref(0);
const title = ref("");
const dateRange = ref([]);

const data = reactive({
  form: {},
  queryParams: {
    pageNum: 1,
    pageSize: 10,
    channelName: undefined,
    type: undefined,
    status: undefined
  },
  rules: {
    channelName: [{required: true, message: "渠道名称不能为空", trigger: "blur"}],
    status: [{required: true, message: "渠道状态不能为空", trigger: "blur"}],
    type: [{required: true, message: "渠道类型不能为空", trigger: "blur"}]
  },
});

/*** 渠道导入参数 */
const upload = reactive({
  // 是否显示弹出层（渠道导入）
  open: false,
  // 弹出层标题（渠道导入）
  title: "",
  // 是否禁用上传
  isUploading: false,
  // 是否更新已经存在的渠道数据
  updateSupport: 0,
  // 设置上传的请求头部
  headers: {Authorization: "Bearer " + getToken()},
  // 上传的地址
  url: import.meta.env.VITE_APP_BASE_API + "tienchin/channel/importData"
});

const {queryParams, form, rules} = toRefs(data);

/**
 * 查询渠道列表
 */
function getList() {
  loading.value = true;
  listChannel(proxy.addDateRange(queryParams.value, dateRange.value)).then(response => {
    channelList.value = response.rows;
    total.value = response.total;
    loading.value = false;
  });
}

/** 搜索按钮操作 */
function handleQuery() {
  queryParams.value.pageNum = 1;
  getList();
}

/** 重置按钮操作 */
function resetQuery() {
  dateRange.value = [];
  proxy.resetForm("queryRef");
  handleQuery();
}

/** 删除按钮操作 */
function handleDelete(row) {
  const channelIds = row.channelId || ids.value;
  proxy.$modal.confirm('是否确认删除渠道编号为"' + channelIds + '"的数据项?').then(function () {
    return delChannel(channelIds);
  }).then(() => {
    getList();
    proxy.$modal.msgSuccess("删除成功");
  }).catch(() => {
  });
}

/**
 * 导入按钮操作
 **/
function handleImport() {
  upload.title = "渠道导入";
  upload.open = true;
};

/**文件上传中处理 */
const handleFileUploadProgress = (event, file, fileList) => {
  upload.isUploading = true;
};
/** 文件上传成功处理 */
const handleFileSuccess = (response, file, fileList) => {
  upload.open = false;
  upload.isUploading = false;
  proxy.$refs["uploadRef"].clearFiles();
  proxy.$alert("<div style='overflow: auto;overflow-x: hidden;max-height: 70vh;padding: 10px 20px 0;'>" + response.msg + "</div>", "导入结果", {dangerouslyUseHTMLString: true});
  getList();
};

/** 提交上传文件 */
function submitFileForm() {
  proxy.$refs["uploadRef"].submit();
};

/** 下载模板操作 */
function importTemplate() {
  proxy.download("tienchin/channel/importTemplate", {}, `channel_template_${new Date().getTime()}.xlsx`);
};

/** 导出按钮操作 */
function handleExport() {
  proxy.download("tienchin/channel/export", {
    ...queryParams.value,
  }, `channel_${new Date().getTime()}.xlsx`);
}

/**
 * 多选框选中数据
 * 点击表格中的第一列的多选框，会触发这个方法
 * @param selection 选中的数据
 */
function handleSelectionChange(selection) {
  ids.value = selection.map(item => item.channelId);
  single.value = selection.length != 1;
  multiple.value = !selection.length;
}

/** 重置新增的表单以及其他数据  */
function reset() {
  form.value = {
    // 渠道名称
    channelName: undefined,
    status: undefined,
    type: undefined,
    // 备注
    remark: undefined
  };
  proxy.resetForm("channelRef");
}

/** 添加渠道 */
function handleAdd() {
  reset();
  // 打开对话框
  open.value = true;
  // 对话框的标题
  title.value = "添加渠道";
}

/**
 * 修改渠道
 * 无论是点击最上面的修改按钮，还是点击表格中的修改按钮，都会调用这个方法
 * 不同的是，如果是点击表格中的修改按钮，会把当前行的数据传递过来
 * @param row 行数据
 * @returns {Promise<void>}
 */
function handleUpdate(row) {
  reset();
  // 这个渠道ID有两种来源：如果是点击表格中的修改按钮，则通过row.channelId获取
  // 如果是点击最上面的修改按钮，则通过ids.value获取
  const channelId = row.channelId || ids.value;
  getInfo(channelId).then(response => {
    form.value = response.data;
    open.value = true;
    title.value = "修改渠道";
  });
}

/** 提交按钮 */
function submitForm() {
  proxy.$refs["channelRef"].validate(valid => {
    if (valid) {
      if (form.value.channelId != undefined) {
        updateChannel(form.value).then(response => {
          // 删除掉 form 中不需要提交的数据
          delete form.value.updateTime;
          delete form.value.createTime;

          proxy.$modal.msgSuccess("修改成功");
          open.value = false;
          getList();
        });
      } else {
        addChannel(form.value).then(response => {
          proxy.$modal.msgSuccess("新增成功");
          open.value = false;
          getList();
        });
      }
    }
  });
}

/** 取消按钮 */
function cancel() {
  open.value = false;
  reset();
}

getList();
</script>

!> 声明：本人在开发这个模块当中没有记录开发过程，我这里只是简简单单写一个文章来做个备份给新人看这个项目有个好的铺垫。

本栏目推荐文章
• openpyxl模块---------------------------------------------提取身份证信息及计算年龄
• 跟着阿灵学前端(1)——HTML 基础
• 跟着阿灵学前端(2)——CSS 基础
• JFinal学生信息管理系统
• 【LeetCode 2701. 连续递增交易】MySQL用户变量编程得到严格递增连续子序列的开始位置，结束位置，长度等统计信息
• 初中信息奥赛模拟测试
• Qt/C++编写视频监控系统83-自定义悬浮条信息
• 软件构造大作业 综合信息管理系统
• 基于融合语义信息改进的内容推荐算法。Improved content recommendation algorithm integrating semantic information.
• 提高人类获取信息的效率

渠道 前端 TienChin 信息渠道 前端tienchin信息 tienchin渠道 tienchin渠道 信息 渠道tienchin 渠道tienchin接口 渠道tienchin页面 渠道tienchin类型 tienchin渠道 权限 字典tienchin渠道 原理 tienchin渠道 工程