更新记录

0.1.4（2026-08-01） 下载此版本

• package：安装依赖增加 nax-ui-theme（运行时仍弱依赖 + fallback）

平台兼容性

uni-app x(4.25)

其他

nax-swiper

nax-ui 轮播组件（uni-app x / uvue）。

基于原生 swiper / swiper-item 封装，提供统一 API、主题圆角与数字指示器。

安装

uni_modules/nax-swiper

easycom 自动生效。

推荐同时安装主题包

uni_modules/nax-ui-theme

并在 App.uvue 引入：

@import "@/uni_modules/nax-ui-theme/theme/default.css";

页面根节点加 class="nax-theme"。

依赖

安装 theme 后仍需：App.uvue @import + 应用 layout/页面 一处 class="nax-theme"。详见 uni_modules/nax-ui-theme/readme.md（L0/L1/L2）。

基础用法

<nax-swiper :list="banners" height="180" indicator></nax-swiper>

const banners = ref([
  'https://example.com/1.jpg',
  'https://example.com/2.jpg',
  'https://example.com/3.jpg'
] as string[])

自动播放 / 循环

<nax-swiper
  :list="banners"
  autoplay
  :interval="3000"
  circular
  height="180"
></nax-swiper>

受控 current

<nax-swiper
  :list="banners"
  v-model:current="current"
  height="180"
  @change="onChange"
></nax-swiper>

数字指示器

<nax-swiper
  :list="banners"
  indicator
  indicator-type="number"
  indicator-position="bottom-right"
  height="180"
></nax-swiper>

色块 / 文案项（推荐，微信小程序友好）

<nax-swiper :list="panels" height="140"></nax-swiper>

const panels = ref([
  { bg: '#18a058', text: '页 1' } as UTSJSONObject,
  { bg: '#18a058', text: '页 2' } as UTSJSONObject
] as UTSJSONObject[])

自定义 swiper-item（默认插槽）

list 为空时可用默认插槽。微信小程序必须传 itemCount（等于你写的 swiper-item 个数），否则可能报：

display-multiple-items 不能大于 swiper-item 数量

<nax-swiper height="160" :list="[]" :item-count="2" :indicator="false">
  <swiper-item>
    <view class="slide"><text>自定义 1</text></view>
  </swiper-item>
  <swiper-item>
    <view class="slide"><text>自定义 2</text></view>
  </swiper-item>
</nax-swiper>

小程序端更推荐用 list + bg/text，避免 slot 投影导致 item 计数异常。

Props

Events

Slots

主题