@10yun/cv-mobile-ui 0.5.53 → 0.5.55

package/other/xt-parse/u-parse.vue

@@ -0,0 +1,510 @@
+<template>
+  <view id="_root" :class="(selectable ? '_select ' : '') + '_root'" :style="containerStyle">
+    <slot v-if="!nodes[0]" />
+    <!-- #ifndef APP-PLUS-NVUE -->
+    <node v-else :childs="nodes" :opts="[lazyLoad, loadingImg, errorImg, showImgMenu, selectable]" name="span" />
+    <!-- #endif -->
+    <!-- #ifdef APP-PLUS-NVUE -->
+    <web-view
+      ref="web"
+      src="/uni_modules/xt-parse/static/app-plus/xt-parse/local.html"
+      :style="'margin-top:-2px;height:' + height + 'px'"
+      @onPostMessage="_onMessage"
+    />
+    <!-- #endif -->
+  </view>
+</template>
+
+<script>
+/**
+ * Parse 富文本解析组件
+ * @description 本组件是基于mp-html封装的富文本解析器，感谢开源,更多信息请查看mp-html文档
+ * @tutorial https://ext.dcloud.net.cn/plugin?name=xt-parse
+ *
+ * @property {String} 					containerStyle			容器的样式
+ * @property {String} 					content 				用于渲染的 html 字符串
+ * @property {Boolean} 					copyLink				是否允许外部链接被点击时自动复制
+ * @property {String} 					domain 					主域名，用于拼接链接
+ * @property {String} 					errorImg 				图片出错时的占位图链接
+ * @property {Boolean} 					lazyLoad 				是否开启图片懒加载
+ * @property {string} 					loadingImg 				图片加载过程中的占位图链接
+ * @property {Boolean} 					pauseVideo 				是否在播放一个视频时自动暂停其他视频
+ * @property {Boolean} 					previewImg 				是否允许图片被点击时自动预览
+ * @property {Boolean} 					scrollTable 			是否给每个表格添加一个滚动层使其能单独横向滚动
+ * @property {Boolean | String} 		selectable 				是否开启长按复制
+ * @property {Boolean} 					setTitle 				是否将 title 标签的内容设置到页面标题
+ * @property {Boolean} 					showImgMenu 			是否允许图片被长按时显示菜单
+ * @property {Object.<String, String>}  tagStyle 				标签的默认样式
+ * @property {Boolean | Number} 		useAnchor 				是否使用锚点链接
+ * @event {Function} 					load 					dom 结构加载完毕时触发
+ * @event {Function} 					ready 					所有图片加载完毕时触发
+ * @event {Function} 					imgtap 					图片被点击时触发
+ * @event {Function} 					linktap 				链接被点击时触发
+ * @event {Function} 					play 					音视频播放时触发
+ * @event {Function} 					error 					媒体加载出错时触发
+ */
+import props from './props.js';
+// #ifndef APP-PLUS-NVUE
+import node from './node/node';
+// #endif
+import Parser from './parser';
+const plugins = [];
+// #ifdef APP-PLUS-NVUE
+const dom = weex.requireModule('dom');
+// #endif
+
+export default {
+  name: 'up-parse',
+  data() {
+    return {
+      nodes: [],
+      // #ifdef APP-PLUS-NVUE
+      height: 3
+      // #endif
+    };
+  },
+  mixins: [props],
+  // #ifdef VUE3
+  emits: ['load', 'ready', 'imgtap', 'linktap', 'play', 'error'],
+  // #endif
+  // #ifndef APP-PLUS-NVUE
+  components: {
+    node
+  },
+  // #endif
+  watch: {
+    content(content) {
+      this.setContent(this.handelBlank(content));
+    }
+  },
+  created() {
+    this.plugins = [];
+    for (let i = plugins.length; i--; ) {
+      this.plugins.push(new plugins[i](this));
+    }
+  },
+  mounted() {
+    if (this.content && !this.nodes.length) {
+      this.setContent(this.handelBlank(this.content));
+    }
+  },
+  beforeDestroy() {
+    this._hook('onDetached');
+  },
+  methods: {
+    /**
+     * @description
+     * 该函数主要用于处理传入的字符串，首先将连续的空格（两个及以上）替换为 `&nbsp;`，
+     * 然后将空的段落标签 `<p></p>` 替换为 `<p><br></p>`。常用于处理 HTML 内容中的空白字符和空段落。
+     * @param {string} e - 需要处理的字符串，可能包含空白字符和空段落标签
+     * @returns {string} - 处理后的字符串，空格已替换为 `&nbsp;`，空段落标签已替换为 `<p><br></p>`
+     */
+    handelBlank(e) {
+      if (!e) return; // 如果传入的参数为空，则直接返回
+      let temp;
+      // 替换连续空格（两个及以上）为 &nbsp;
+      temp = e.replace(/(\s{2,})(?![^<>]*>)/g, function (match) {
+        return match.replace(/ /g, '&nbsp;'); // 将匹配到的空格替换为 &nbsp;
+      });
+      // 替换空的段落标签 <p></p> 为 <p><br></p>
+      temp = temp.replace(/<p><\/p>/g, '<p><br></p>');
+      return temp; // 返回处理后的字符串
+    },
+
+    /**
+     * @description 将锚点跳转的范围限定在一个 scroll-view 内
+     * @param {Object} page scroll-view 所在页面的示例
+     * @param {String} selector scroll-view 的选择器
+     * @param {String} scrollTop scroll-view scroll-top 属性绑定的变量名
+     */
+    in(page, selector, scrollTop) {
+      // #ifndef APP-PLUS-NVUE
+      if (page && selector && scrollTop) {
+        this._in = {
+          page,
+          selector,
+          scrollTop
+        };
+      }
+      // #endif
+    },
+
+    /**
+     * @description 锚点跳转
+     * @param {String} id 要跳转的锚点 id
+     * @param {Number} offset 跳转位置的偏移量
+     * @returns {Promise}
+     */
+    navigateTo(id, offset) {
+      return new Promise((resolve, reject) => {
+        if (!this.useAnchor) {
+          reject(Error('Anchor is disabled'));
+          return;
+        }
+        offset = offset || parseInt(this.useAnchor) || 0;
+        // #ifdef APP-PLUS-NVUE
+        if (!id) {
+          dom.scrollToElement(this.$refs.web, {
+            offset
+          });
+          resolve();
+        } else {
+          this._navigateTo = {
+            resolve,
+            reject,
+            offset
+          };
+          this.$refs.web.evalJs(
+            'uni.postMessage({data:{action:"getOffset",offset:(document.getElementById(' + id + ')||{}).offsetTop}})'
+          );
+        }
+        // #endif
+        // #ifndef APP-PLUS-NVUE
+        let deep = ' ';
+        // #ifdef MP-WEIXIN || MP-QQ || MP-TOUTIAO
+        deep = '>>>';
+        // #endif
+        const selector = uni
+          .createSelectorQuery()
+          // #ifndef MP-ALIPAY
+          .in(this._in ? this._in.page : this)
+          // #endif
+          .select((this._in ? this._in.selector : '._root') + (id ? `${deep}#${id}` : ''))
+          .boundingClientRect();
+        if (this._in) {
+          selector.select(this._in.selector).scrollOffset().select(this._in.selector).boundingClientRect();
+        } else {
+          // 获取 scroll-view 的位置和滚动距离
+          selector.selectViewport().scrollOffset(); // 获取窗口的滚动距离
+        }
+        selector.exec((res) => {
+          if (!res[0]) {
+            reject(Error('Label not found'));
+            return;
+          }
+          const scrollTop = res[1].scrollTop + res[0].top - (res[2] ? res[2].top : 0) + offset;
+          if (this._in) {
+            // scroll-view 跳转
+            this._in.page[this._in.scrollTop] = scrollTop;
+          } else {
+            // 页面跳转
+            uni.pageScrollTo({
+              scrollTop,
+              duration: 300
+            });
+          }
+          resolve();
+        });
+        // #endif
+      });
+    },
+
+    /**
+     * @description 获取文本内容
+     * @return {String}
+     */
+    getText(nodes) {
+      let text = '';
+      (function traversal(nodes) {
+        for (let i = 0; i < nodes.length; i++) {
+          const node = nodes[i];
+          if (node.type === 'text') {
+            text += node.text.replace(/&amp;/g, '&');
+          } else if (node.name === 'br') {
+            text += '\n';
+          } else {
+            // 块级标签前后加换行
+            const isBlock =
+              node.name === 'p' ||
+              node.name === 'div' ||
+              node.name === 'tr' ||
+              node.name === 'li' ||
+              (node.name[0] === 'h' && node.name[1] > '0' && node.name[1] < '7');
+            if (isBlock && text && text[text.length - 1] !== '\n') {
+              text += '\n';
+            }
+            // 递归获取子节点的文本
+            if (node.children) {
+              traversal(node.children);
+            }
+            if (isBlock && text[text.length - 1] !== '\n') {
+              text += '\n';
+            } else if (node.name === 'td' || node.name === 'th') {
+              text += '\t';
+            }
+          }
+        }
+      })(nodes || this.nodes);
+      return text;
+    },
+
+    /**
+     * @description 获取内容大小和位置
+     * @return {Promise}
+     */
+    getRect() {
+      return new Promise((resolve, reject) => {
+        uni
+          .createSelectorQuery()
+          // #ifndef MP-ALIPAY
+          .in(this)
+          // #endif
+          .select('#_root')
+          .boundingClientRect()
+          .exec((res) => (res[0] ? resolve(res[0]) : reject(Error('Root label not found'))));
+      });
+    },
+
+    /**
+     * @description 暂停播放媒体
+     */
+    pauseMedia() {
+      for (let i = (this._videos || []).length; i--; ) {
+        this._videos[i].pause();
+      }
+      // #ifdef APP-PLUS
+      const command = 'for(var e=document.getElementsByTagName("video"),i=e.length;i--;)e[i].pause()';
+      // #ifndef APP-PLUS-NVUE
+      let page = this.$parent;
+      while (!page.$scope) page = page.$parent;
+      page.$scope.$getAppWebview().evalJS(command);
+      // #endif
+      // #ifdef APP-PLUS-NVUE
+      this.$refs.web.evalJs(command);
+      // #endif
+      // #endif
+    },
+
+    /**
+     * @description 设置媒体播放速率
+     * @param {Number} rate 播放速率
+     */
+    setPlaybackRate(rate) {
+      this.playbackRate = rate;
+      for (let i = (this._videos || []).length; i--; ) {
+        this._videos[i].playbackRate(rate);
+      }
+      // #ifdef APP-PLUS
+      const command = 'for(var e=document.getElementsByTagName("video"),i=e.length;i--;)e[i].playbackRate=' + rate;
+      // #ifndef APP-PLUS-NVUE
+      let page = this.$parent;
+      while (!page.$scope) page = page.$parent;
+      page.$scope.$getAppWebview().evalJS(command);
+      // #endif
+      // #ifdef APP-PLUS-NVUE
+      this.$refs.web.evalJs(command);
+      // #endif
+      // #endif
+    },
+
+    /**
+     * @description 设置内容
+     * @param {String} content html 内容
+     * @param {Boolean} append 是否在尾部追加
+     */
+    setContent(content, append) {
+      if (!append || !this.imgList) {
+        this.imgList = [];
+      }
+      const nodes = new Parser(this).parse(content);
+      // #ifdef APP-PLUS-NVUE
+      if (this._ready) {
+        this._set(nodes, append);
+      }
+      // #endif
+      this.$set(this, 'nodes', append ? (this.nodes || []).concat(nodes) : nodes);
+
+      // #ifndef APP-PLUS-NVUE
+      this._videos = [];
+      this.$nextTick(() => {
+        this._hook('onLoad');
+        this.$emit('load');
+      });
+
+      if (this.lazyLoad || this.imgList._unloadimgs < this.imgList.length / 2) {
+        // 设置懒加载，每 350ms 获取高度，不变则认为加载完毕
+        let height = 0;
+        const callback = (rect) => {
+          if (!rect || !rect.height) rect = {};
+          // 350ms 总高度无变化就触发 ready 事件
+          if (rect.height === height) {
+            this.$emit('ready', rect);
+          } else {
+            height = rect.height;
+            setTimeout(() => {
+              this.getRect().then(callback).catch(callback);
+            }, 350);
+          }
+        };
+        this.getRect().then(callback).catch(callback);
+      } else {
+        // 未设置懒加载，等待所有图片加载完毕
+        if (!this.imgList._unloadimgs) {
+          this.getRect()
+            .then((rect) => {
+              this.$emit('ready', rect);
+            })
+            .catch(() => {
+              this.$emit('ready', {});
+            });
+        }
+      }
+      // #endif
+    },
+
+    /**
+     * @description 调用插件钩子函数
+     */
+    _hook(name) {
+      for (let i = plugins.length; i--; ) {
+        if (this.plugins[i][name]) {
+          this.plugins[i][name]();
+        }
+      }
+    },
+
+    // #ifdef APP-PLUS-NVUE
+    /**
+     * @description 设置内容
+     */
+    _set(nodes, append) {
+      this.$refs.web.evalJs(
+        'setContent(' +
+          JSON.stringify(nodes).replace(/%22/g, '') +
+          ',' +
+          JSON.stringify([
+            this.containerStyle.replace(/(?:margin|padding)[^;]+/g, ''),
+            this.errorImg,
+            this.loadingImg,
+            this.pauseVideo,
+            this.scrollTable,
+            this.selectable
+          ]) +
+          ',' +
+          append +
+          ')'
+      );
+    },
+
+    /**
+     * @description 接收到 web-view 消息
+     */
+    _onMessage(e) {
+      const message = e.detail.data[0];
+      switch (message.action) {
+        // web-view 初始化完毕
+        case 'onJSBridgeReady':
+          this._ready = true;
+          if (this.nodes) {
+            this._set(this.nodes);
+          }
+          break;
+        // 内容 dom 加载完毕
+        case 'onLoad':
+          this.height = message.height;
+          this._hook('onLoad');
+          this.$emit('load');
+          break;
+        // 所有图片加载完毕
+        case 'onReady':
+          this.getRect()
+            .then((res) => {
+              this.$emit('ready', res);
+            })
+            .catch(() => {
+              this.$emit('ready', {});
+            });
+          break;
+        // 总高度发生变化
+        case 'onHeightChange':
+          this.height = message.height;
+          break;
+        // 图片点击
+        case 'onImgTap':
+          this.$emit('imgtap', message.attrs);
+          if (this.previewImg) {
+            uni.previewImage({
+              current: parseInt(message.attrs.i),
+              urls: this.imgList
+            });
+          }
+          break;
+        // 链接点击
+        case 'onLinkTap': {
+          const href = message.attrs.href;
+          this.$emit('linktap', message.attrs);
+          if (href) {
+            // 锚点跳转
+            if (href[0] === '#') {
+              if (this.useAnchor) {
+                dom.scrollToElement(this.$refs.web, {
+                  offset: message.offset
+                });
+              }
+            } else if (href.includes('://')) {
+              // 打开外链
+              if (this.copyLink) {
+                plus.runtime.openWeb(href);
+              }
+            } else {
+              uni.navigateTo({
+                url: href,
+                fail() {
+                  uni.switchTab({
+                    url: href
+                  });
+                }
+              });
+            }
+          }
+          break;
+        }
+        case 'onPlay':
+          this.$emit('play');
+          break;
+        // 获取到锚点的偏移量
+        case 'getOffset':
+          if (typeof message.offset === 'number') {
+            dom.scrollToElement(this.$refs.web, {
+              offset: message.offset + this._navigateTo.offset
+            });
+            this._navigateTo.resolve();
+          } else {
+            this._navigateTo.reject(Error('Label not found'));
+          }
+          break;
+        // 点击
+        case 'onClick':
+          this.$emit('tap');
+          this.$emit('click');
+          break;
+        // 出错
+        case 'onError':
+          this.$emit('error', {
+            source: message.source,
+            attrs: message.attrs
+          });
+      }
+    }
+    // #endif
+  }
+};
+</script>
+
+<style>
+/* #ifndef APP-PLUS-NVUE */
+/* 根节点样式 */
+._root {
+  padding: 1px 0;
+  overflow-x: auto;
+  overflow-y: hidden;
+  -webkit-overflow-scrolling: touch;
+}
+
+/* 长按复制 */
+._select {
+  user-select: text;
+}
+
+/* #endif */
+</style>

package/other/z-paging/changelog.md

@@ -0,0 +1,52 @@
+## 2.8.6（2025-03-17）
+1.`新增` 聊天记录模式流式输出（类似chatGPT回答）演示demo。  
+2.`新增` z-paging及其公共子组件支持`HBuilderX`代码文档提示。  
+3.`新增` props：`virtual-in-swiper-slot`，用以解决vue3+(微信小程序或QQ小程序)中，使用非内置列表写法时，若z-paging在`swiper-item`中存在的无法获取slot插入的cell高度进而导致虚拟列表失败的问题。  
+4.`新增` `@scrolltolower`和@`scrolltoupper`支持nvue。  
+5.`修复` 由`v2.8.1`引出的方法`scrollIntoViewById`在微信小程序+vue3中无效的问题。  
+6.`修复` 由`v2.8.1`引出的在子组件内使用z-paging虚拟列表无效的问题。  
+7.`修复` 在微信小程序中基础库版本较高时`wx.getSystemInfoSync is deprecated`警告。  
+8.`优化` 提升下拉刷新在鸿蒙Next中的性能。  
+9.`优化` `@scrolltolower`和`@scrolltoupper`在倒置的聊天记录模式下的触发逻辑。  
+10.`优化` 其他细节调整。  
+## 2.8.5（2025-02-09）
+1.`新增` 方法`scrollToX`，支持控制x轴滚动到指定位置。  
+2.`修复` 快手小程序中报错`await isn't allowed in non-async function`的问题。  
+3.`修复` 在iOS+nvue中，设置了`:loading-more-enabled="false"`后，调用`scrollToBottom`无法滚动到底部的问题。  
+4.`修复` 在支付宝小程序+页面滚动中，数据为空时空数据图未居中的问题。  
+5.`优化` fetch types修改。  
+## 2.8.4（2024-12-02）
+1.`修复` 在虚拟列表+vue2中，顶部占位采用transformY方案；在虚拟列表+vue3中，顶部占位采用view占位方案。以解决在vue2+微信小程序+安卓+兼容模式中，可能出现的虚拟列表闪动的问题。  
+2.`修复` 在列表渲染时（尤其是在虚拟列表中）偶现的【点击加载更多】闪现的问题。   
+3.`优化` 统一在RefresherStatus枚举中Loading取值。    
+4.`优化` `defaultPageNo`&`defaultPageSize`修改为只允许number类型。  
+5.`优化` 提升兼容性&细节优化。  
+## 2.8.3（2024-11-27）
+1.`修复` `doInsertVirtualListItem`插入数据无效的问题。  
+2.`优化` 提升兼容性&细节优化。  
+## 2.8.2（2024-11-25）
+1.`优化` types中`ZPagingRef`和`ZPagingInstance`支持泛型。  
+## 2.8.1（2024-11-24）
+1.`新增` 完整的`props`、`slots`、`methods`、`events`的typescript types声明，可在ts中获得绝佳的代码提示体验。  
+2.`新增` `virtual-cell-id-prefix`：虚拟列表cell id的前缀，适用于一个页面有多个虚拟列表的情况，用以区分不同虚拟列表cell的id。  
+3.`修复` 在vue3+(微信小程序或QQ小程序)中，使用非内置列表写法时，若`z-paging`在`swiper-item`标签内的情况下存在的无法获取slot插入的cell高度的问题。  
+4.`修复` 在虚拟列表中分页数据小于1页时插入新数据，虚拟列表未生效的问题。  
+5.`修复` 在虚拟列表中调用`refresh`时，cell的index计算不正确的问题。  
+6.`修复` 在快手小程序中内容较少或空数据时`z-paging`未能铺满全屏的问题。  
+7.`优化` `events`中的参数涉及枚举的部分，统一由之前的number类型修改为string类型，展示更直观！涉及的events：`@query`中的`from`参数；`@refresherStatusChange`中的`status`参数；`@loadingStatusChange`中的`status`参数；`slot=refresher`中的`refresherStatus`参数；`slot=chatLoading`中的`loadingMoreStatus`参数。更新版本请特别留意！  
+## 2.8.0（2024-10-21）
+1.`新增` 全面支持鸿蒙Next。  
+2.`修复` 设置了`refresher-complete-delay`后，在下拉刷新期间调用reload导致的无法再次下拉刷新的问题。  
+3.`优化` 废弃虚拟列表transformY顶部占位方案，修改为空view占位。解决因使用旧方案导致的vue3中可能出现的虚拟列表闪动问题。提升虚拟列表的兼容性。  
+## 2.5.8（2023-05-03）
+1.`新增` props：`refresher-no-transform`，支持控制下拉刷新时是否禁止下拉刷新view跟随用户触摸竖直移动。  
+2.`新增` props：`refresher-refreshing-animated`，支持控制下拉刷新刷新中状态下是否展示旋转动画。  
+3.`新增` vue3中页面滚动hooks。  
+4.`新增` 全局拦截器-`@query`拦截器中回调函数添加当前列表最后一个item数据。  
+5.`修复` 在vue3+内置浏览器中，报错`SyntaxError: Unexpected token . at xxx`的问题。  
+6.`修复` 滑动切换选项卡简化写法queryList触发多次的问题。  
+7.`优化`  底部加载更多展示逻辑，在各个平台中过渡更加自然。  
+8.`优化` `@touchDirectionChange`触发逻辑，仅在值改变时触发，优化性能。  
+## 2.5.7（2023-03-14）
+1.`修复` 在nvue+安卓中，设置`empty-view-center`为false后空数据图被切割未能完整显示的问题。  
+2.`修复` 由`2.5.4`引出的在nvue中，使用`slot="top"`后下拉刷新失效的问题。