更新记录

0.1.9（2026-08-18） 下载此版本

• 蒸汽模式兼容：移除 .nax-swiper__text、.nax-swiper__number-text 中已废弃的 lines: 1 声明（仅 VDOM 支持，Vapor 下告警），改用 <text> 的 :max-lines="1" 属性

0.1.8（2026-08-14） 下载此版本

• readme 新增“list 项”字段说明表（src/image/url、text/title、bg/background 及优先级）

0.1.5（2026-08-07） 下载此版本

• 兼容性声明：补充 iOS（APP-IOS）端支持，package.json 平台标记同步为 √

平台兼容性

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"。

主题

通过 CSS 变量覆盖：

依赖

安装 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

list 项

list 元素支持字符串（图片 url）或对象，对象字段如下：

Events

Slots