0.0.3 • Published 10 months ago

water-fall3 v0.0.3

Weekly downloads
-
License
MIT
Repository
-
Last release
10 months ago

waterFall3 瀑布流组件

介绍

基于vue3+typesscript+rollup构建的瀑布流列表组件,在pc端能够根据屏幕宽度做自适应变化调整。

效果查看地址

http://waterfall3.top/

安装

npm i water-fall3 --save-dev 
或
yarn install water-fall3 --save-dev

引入

全局注册组件

import { createApp } from 'vue';
import waterFall3 from 'water-fall3';

const app = createApp();
app.use(waterFall3);

局部注册组件

<script setup lang="ts">
import  waterFall3  from "../../src/";
</script>
<template>
<water-fall3></water-fall3> 
</template>

代码演示

基础用法

  <water-fall3
    ref="waterfall"
    :lists="lists"
    @onBottom="getLists"
    @click="clickFn"
    @imgError="imgErrorFn"
  >
  </water-fall3>
<script setup lang="ts">
import  waterFall3  from "../../src/";
import axios from "axios";
import { ref, onMounted } from "vue";
let lists = ref([]);
let waterfall = ref<HTMLElement | null>();
let page =ref<number>(0)
const getLists = () => {
  axios
    .get("./src/mock/list.json" )
    .then((res) => {
      // 加载到底部数据了
      if (page.value.length>10) {
       waterfall.value.onFinish();
        waterfall;
        return;
      }
      lists.value = lists.value.concat(res.data);
      page.value++
    });
};

getLists();
const clickFn = ({ item,index,  isTapImg }) => {
  console.log(item,index,  isTapImg)
};

const imgErrorFn = (imgItem) => {
  console.log("图片加载错误", imgItem);
};
</script>

API

CouponList Props

参数说明类型默认值
width容器宽度number-
height容器高度number-
lists列表数据array[]
itemWidth每一项列表的宽度number240
bottomOffset滚动条与底部距离小于 bottomOffset 时触发新的加载number50
maxCols在当前容器宽度内最多可以容纳多少列number5
horizontalGap水平列表项之间的间距number10
verticalGap纵向列表项之间的间距number10
srcKey列表项显示图片的key字段stringsrc
offsetBottom列表项显示图片的key字段stringsrc
srcKey列表项显示图片的key字段stringsrc
finishGap列表和滚动到底部文字距离number20

Events

事件名说明回调参数
onBottom与底部距离小于 bottomOffset 时触发该事件-
click点击列表项触发item:列表数据;index:列表项:isTapImg:点击的是图片还是整个列表项;

Slots

名称说明
loading加载数据动画
head列表头部项内容
default列表项默认描述内容
finish列表项底部描述尼尔
0.0.3

10 months ago

0.0.2

11 months ago

0.0.1

11 months ago

0.0.0

11 months ago