update：z-paging from 2.7.11 => 2.8.6

2025-04-29 11:53:42 +08:00
parent c7d101cd05
commit 68ed6e1810
33 changed files with 3021 additions and 933 deletions
@@ -26,6 +26,23 @@

 <script>
 	import zPaging from '../z-paging/z-paging'
+	/**
+	 * z-paging-swiper-item 组件
+	 * @description swiper+list极简写法中使用到，实际上就是对普通的swiper+list中swiper-item的包装封装，用以简化写法，但个性化配置局限较多
+	 * @tutorial https://z-paging.zxlee.cn/api/sub-components/main.html#z-paging-swiper-item配置
+	 * @notice 以下为 z-paging-swiper-item 的配置项
+	 * @property {Number} tabIndex 当前组件的 index，也就是当前组件是 swiper 中的第几个，默认为 0
+	 * @property {Number} currentIndex 当前 swiper 切换到第几个 index，默认为 0
+	 * @property {Boolean} useVirtualList 是否使用虚拟列表，默认为 false
+	 * @property {Boolean} useInnerList 是否在 z-paging 内部循环渲染列表（内置列表），默认为 false。若 useVirtualList 为 true，则此项恒为 true
+	 * @property {String} cellKeyName 内置列表 cell 的 key 名称，仅 nvue 有效，在 nvue 中开启 useInnerList 时必须填此项，默认为 ''
+	 * @property {Object} innerListStyle innerList 样式，默认为 {}
+	 * @property {Number|String} preloadPage 预加载的列表可视范围（列表高度）页数，默认为 12。此数值越大，则虚拟列表中加载的 dom 越多，内存消耗越大（会维持在一个稳定值），但增加预加载页面数量可缓解快速滚动短暂白屏问题
+	 * @property {String} cellHeightMode 虚拟列表 cell 高度模式，默认为 'fixed'，也就是每个 cell 高度完全相同，将以第一个 cell 高度为准进行计算。可选值【dynamic】，即代表高度是动态非固定的，【dynamic】性能低于【fixed】
+	 * @property {Number|String} virtualListCol 虚拟列表列数，默认为 1。常用于每行有多列的情况，例如每行有 2 列数据，需要将此值设置为 2
+	 * @property {Number|String} virtualScrollFps 虚拟列表 scroll 取样帧率，默认为 60，过高可能出现卡顿等问题
+	 * @example <z-paging-swiper-item ref="swiperItem" :tabIndex="index" :currentIndex="current" @query="queryList" @updateList="updateList"></z-paging-swiper-item>
+	 */
 	export default {
 		name: "z-paging-swiper-item",
 		components: { zPaging },