更新记录

1.2(2024-11-06) 下载此版本

  1. 修正user_id和id的字面逻辑
  2. 完善删除细节

1.0(2024-11-05) 下载此版本

  1. 大家期待已久的vue3迁移版来啦

平台兼容性

Vue2 Vue3
×
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
× × × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序
× × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × ×

介绍

感谢大家的支持, 此次从vue3.2版本迁移到vue2以此来匹配大家的vue2需求. 有使用问题请留言, 第一时间修复.

如果有vue3.2的需求, 可以点击下方传送门下载组件 cc-comment 评论列表,回复,点赞,删除组件 vue3.2+uni-ui 传送门

环境

基于 vue2 和 uni-ui 开发; 环境参考如下:

  • 小程序调试基础库: 3.3.0
  • node版本: ^18.15.0

场景

即拿即用, 组件有详细注释内容, 方便二次开发; 目前仅在小程序使用, 其他平台能否使用请评论留言反馈谢谢, 祝大家使用愉快.

附言

  1. 起因是插件市场没找到合适满意的, BUG多功能异常改一出二, 遂只能自己从0开发, 便有了cc-comment
  2. 如有Bug请留言或Email, 开源不易且用且珍惜, 感谢使用.
  3. 关于功能样式, 主打一个借鉴如下:
    • 参考[小红书]App的评论回复功能: 点击评论内容展示回复弹窗, 二级评论默认显示一 条, 点击展开查看更多.
    • 参考[什么值得买]App的多层级回复评论title显示效果
    • 参考uni插件市场[dr3am]作者的代码思路, [kitrig]作者的markdown

功能

已实现

  • 无评论显示占位场景 √
  • 显示评论数量(新增和删除动态更新数量) √
  • 发起新评论 √
  • 点击评论内容回复 √
  • 回复一级评论 √
  • 回复二级评论 √
  • 折叠过多的二级评论 √
  • 收起展开的二级评论 √
  • 展开超长评论内容 √
  • 收起超长评论内容 √
  • 不能回复自身评论 √
  • 删除 √
  • 仅可删除自身评论 √
  • 可选三类删除模式 √
  • 点赞 √
  • 点赞大于100显示99+ √

props 属性

属性名 说明 类型 默认值 必填 说明
ref 实例 Object - true
tableData 评论列表 Array [ ] true
tableTotal 评论总数 Number 0 true
deleteMode 评论删除模式 String all false bind-当被删除的一级评论存在回复评论, 那么该评论内容变更显示为[当前评论内容已被移除] only-仅删除当前评论(后端删除相关联的回复评论, 否则总数显示不对) all-删除所有评论包括回复评论

event 事件

属性名 说明 参数 说明
likeClick 点赞事件 { {params}, callback} { params: 评论id }, callback回调函数, 请求后端接口后调用, 执行后续逻辑
replyClick 回复事件 { {params}, callback} { params: 评论参数 }, callback回调函数, 请求后端接口后调用, 执行后续逻辑
deleteClick 删除事件 { {params, mode}, callback} { params: 评论数组id, mode: 删除模式[all, bind, only] }, callback回调函数, 请求后端接口后调用, 执行后续逻辑

ref 实例可调用属性&事件

属性名 说明 回调参数 说明 平台差异说明
newCommentFun 发起新评论 - event -

数据说明

// 用户信息
type userInfoKeys = {
      user_id: number // 用户id
      user_name: string // 用户名
      user_avatar: string // 用户头像地址
}
// 评论表
type tableDataKeys = {
      id: number // 评论id
      parent_id: number // 评论父级的id
      reply_id: number // 被回复评论的id
      reply_name: string // 被回复人名称
      user_id: number // 用户id
      user_name: string // 用户名
      user_avatar: string // 用户头像地址
      user_content: string // 用户评论内容
      is_like: boolean // 用户是否点赞
      like_count: number // 点赞数统计
      create_time: string // 创建时间
}

使用方法

// 复制整页代码配合下载的插件, 可正常运作(如有报错信息请留言, 第一时间回复)
<template>
  <view>
    <CComment
      ref="ccRef"
      :myInfo="myInfo"
      :userInfo="userInfo"
      :tableData="tableData"
      :tableTotal.sync="tableTotal"
      :deleteMode="deleteMode"
      @likeFun="likeFun"
      @replyFun="replyFun"
      @deleteFun="deleteFun"
    ></CComment>
    <view class="btn" @tap="openComment">发表新评论</view>
  </view>
</template>

<script>
import CComment from "@/components/cc-comment/cc-comment.vue";
export default {
  components: {
    CComment,
  },
  // ----模拟数据------模拟数据------模拟数据----
  data() {
    return {
      // 当前登录用户信息(提示: 一般来自localstorage, 如果是实时获取的话, 那么获取到数据后再v-if显示评论组件)
      myInfo: {
        user_id: 1, // 用户id
        user_name: "cc", // 用户名
        user_avatar: "https://img0.baidu.com/it/u=2836960144,3650263035&fm=253&fmt=auto&app=138&f=JPEG?w=474&h=474", // 用户头像地址
      },
      // 文章作者信息(提示: 一般来自localstorage, 如果是实时获取的话, 那么获取到数据后再v-if显示评论组件)
      userInfo: {
        user_id: 2, // 用户id
        user_name: "ikun", // 用户名
        user_avatar: "https://pic1.zhimg.com/80/v2-a79071a705f55c5d88f6c74e6111fe84_720w.webp", // 用户头像地址
      },
      deleteMode: "all", //删除模式
      // 评论总数
      tableTotal: 4,
      // 评论表
      tableData: [
        {
          id: 120, // 评论id
          parent_id: null, // 评论父级的id
          reply_id: null, // 被回复评论的id
          reply_name: null, // 被回复人的名称
          user_id: 2, // 用户id
          user_name: "ikun", // 用户名
          user_avatar: "https://pic1.zhimg.com/80/v2-a79071a705f55c5d88f6c74e6111fe84_720w.webp", // 用户头像地址
          user_content: "唱,跳,rap,篮球", // 用户评论内容
          is_like: false, // 用户是否点赞
          like_count: 120, // 点赞数统计
          create_time: "2025-02-19 09:16", // 创建时间
        },
        {
          id: 130, // 评论id
          parent_id: 120, // 评论父级的id
          reply_id: 120, // 被回复评论的id
          reply_name: "ikun", // 被回复人的名称
          user_id: 3, // 用户id
          user_name: "小黑子", // 用户名
          user_avatar: "https://pic2.zhimg.com/80/v2-06eade66ec837713d765b1557bf20b25_720w.webp", // 用户头像地址
          user_content: "姬霓太美~祝自己生日快乐~~", // 用户评论内容
          is_like: false, // 用户是否点赞
          like_count: 67, // 点赞数统计
          create_time: "2025-03-07 00:06", // 创建时间
        },
        {
          id: 140, // 评论id
          parent_id: 120, // 评论父级的id
          reply_id: 130, // 被回复评论的id
          reply_name: "小黑子", // 被回复人的名称
          user_id: 4, // 用户id
          user_name: "守护宗主维护宗门", // 用户名
          user_avatar: "https://pic3.zhimg.com/80/v2-244696a62fa750b8570cf56bfaa5b26a_720w.webp", // 用户头像地址
          user_content: "你露出鸡脚了", // 用户评论内容
          is_like: false, // 用户是否点赞
          like_count: 16, // 点赞数统计
          create_time: "2025-05-10 17:08", // 创建时间
        },
        {
          id: 150, // 评论id
          parent_id: null, // 评论父级的id
          reply_id: null, // 被回复评论的id
          reply_name: null, // 被回复人的名称
          user_id: 5, // 用户id
          user_name: "音乐制作人", // 用户名
          user_avatar: "https://pic2.zhimg.com/80/v2-88ec6f8c6d3305122664dd18a28730e5_720w.webp", // 用户头像地址
          user_content:
            "只因你太美baby 只因你太美baby 只因你实在是太美baby 只因你太美baby 迎面走来的你让我如此蠢蠢欲动 这种感觉我从未有 Cause I got a crush on you who you 你是我的 我是你的 谁 再多一眼看一眼就会爆炸 再近一点靠近点快被融化", // 用户评论内容
          is_like: true, // 用户是否点赞
          like_count: 8, // 点赞数统计
          create_time: "2025-12-21 00:45", // 创建时间
        },
      ],
    };
  },
  created() {},
  mounted() {},
  methods: {
    // 唤起新评论弹框
    openComment() {
      let ccRef = this.$refs["ccRef"];
      ccRef.newCommentFun();
    },
    // 点赞回调事件
    likeFun({ params }, callback) {
      console.log("likeFun", params);
      // 当请求失败, 调用callback重置点赞效果;
      // Demo如下:
      // axios.post("http://xxx/like", { id: params }).then((res) => {
      //   if (res.code !== 0) {
      //     callback(res);
      //   }
      // });
    },
    // 评论回调事件
    replyFun({ params }, callback) {
      console.log("replyFun", params);
      // 当请求成功, 调用callback执行评论插入;
      // Demo如下:
      // axios.post("http://xxx/reply", { ...params }).then((res) => {
      //   if (res.code === 0) {
      //     callback(res);
      //   }
      // });
      const res = { id: Math.random() }; // 很重要的回参! 必须拿到后端返回评论id! 删除需要!
      setTimeout(() => callback(res), 500); // 目前为了展示效果, 直接执行callback
    },
    /** 删除回调事件
     * mode 删除模式
     * -- bind: 当被删除的一级评论存在回复评论, 那么该评论内容变更显示为[当前评论内容已被移除]
     * -- only: 仅删除当前评论(后端删除相关联的回复评论, 否则总数显示不对)
     * -- all : 删除所有评论包括回复评论 前端遍历子评论上报
     */

    deleteFun({ params, mode }, callback) {
      console.log("deleteFun", { params, mode });
      // 当请求成功, 调用callback执行评论删除;
      // Demo如下:
      // axios.post("http://xxx/delete", { ids: params, mode }).then((res) => {
      //   if (res.code === 0) {
      //     callback(res);
      //   }
      // });
      switch (mode) {
        case "bind":
          // 逻辑: 调用接口进行评论内容修改 update
          setTimeout(() => callback(), 500); // 目前为了展示效果, 直接执行callback
          break;
        case "only":
          // 逻辑: 调用接口删除一个评论 delete
          setTimeout(() => callback(), 500); // 目前为了展示效果, 直接执行callback
          break;
        default:
          // all
          // 逻辑: 调用接口删除多个评论 [delete]
          setTimeout(() => callback(), 500); // 目前为了展示效果, 直接执行callback
          break;
      }
    },
  },
};
</script>

<style lang="scss" scoped>
.btn {
  text-align: center;
  color: #fff;
  padding: 20rpx;
  margin: 50rpx;
  border-radius: 20rpx;
  background-color: #2979ff;
}
</style>

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问