更新记录

0.0.2（2025-04-25） 下载此版本

• feat: 兼容uniappx 鸿蒙next

0.0.1（2025-02-28） 下载此版本

• init

平台兼容性

uni-app(4.44)

uni-app x(4.61)

其他

lime-swiper-dot 轮播图指示点

• 自定义轮播图指示点组件
• 插件依赖lime-style,lime-shared不喜勿下

文档

🚀 swiper-dot【站点1】 🌍 swiper-dot【站点2】 🔥 swiper-dot【站点3】

安装

插件市场导入即可，首次导入可能需要重新编译

代码演示

基础使用

使用 position: relative 的容器包裹轮播组件和指示器组件，通过type：指定指示器类型，可选值：

• dot：圆形指示点
• dot-bar：条形指示器
• index：数字索引（如 1/5）
• title：文字标题模式
• fraction：分式指示器（如 1/5） 通过 total 属性设置指示点总数或者使用 list 属性设置指示文本

  <view style="position: relative">
  <swiper style="height: 300rpx" :current="current" @change="onChange" :autoplay="true" :interval="3000">
      <swiper-item class="slide slide1"><text class="text">1</text></swiper-item>
      <swiper-item class="slide slide2"><text class="text">2</text></swiper-item>
      <swiper-item class="slide slide3"><text class="text">3</text></swiper-item>
  </swiper>
  <l-swiper-dot :current="current" type="dot" :total="3" />
  </view>

  const current = ref(0)
  const type = ref('dot')
  const onChange = (e: UniSwiperChangeEvent) => {
  current.value = e.detail.current
  }

自定义颜色

使用 color可设置文本颜色， activeColor可设置激活状态指示点颜色，inactiveColor默认背景色

<view style="position: relative">
    <swiper style="height: 300rpx" :current="current" @change="onChange" :autoplay="true" :interval="3000">
        <swiper-item class="slide slide1"><text class="text">1</text></swiper-item>
        <swiper-item class="slide slide2"><text class="text">2</text></swiper-item>
        <swiper-item class="slide slide3"><text class="text">3</text></swiper-item>
    </swiper>
    <l-swiper-dot  activeColor="#ff6b6b" inactiveColor="#ffe66d" color="#2d3436"  :current="current" type="title" :list="list" field="title" />
</view>

const current = ref(0)
const type = ref('dot')
const onChange = (e: UniSwiperChangeEvent) => {
    current.value = e.detail.current
}
const list = [
    {
        title: '人生得意须尽欢，莫使金樽空对月。天生我材必有用，千金散尽还复来。',
    },
    {
        title: '但愿人长久，千里共婵娟。',
    },
    {
        title: '无边落木萧萧下，不尽长江滚滚来。万里悲秋常作客，百年多病独登台。',
    },
]

查看示例

• 导入后直接使用这个标签查看演示效果

<!-- // 代码位于 uni_modules/lime-swiper-dot/compoents/lime-swiper-dot -->
<lime-swiper-dot />

插件标签

• 默认 l-swiper-dot 为 component
• 默认 lime-swiper-dot 为 demo

关于vue2的使用方式

• 插件使用了composition-api, 如果你希望在vue2中使用请按官方的教程vue-composition-api配置
• 关键代码是: 在main.js中 在vue2部分加上这一段即可

  // vue2
  import Vue from 'vue'
  import VueCompositionAPI from '@vue/composition-api'
  Vue.use(VueCompositionAPI)

API

Props

主题定制

样式变量

组件提供了下列 CSS 变量，可用于自定义样式，uvue app不支持。

打赏

如果你觉得本插件，解决了你的问题，赠人玫瑰，手留余香。