uview-ultra-plus 1.0.0

package/uview-ultra/components/up-swiper/up-swiper.vue

@@ -0,0 +1,269 @@
+<template>
+	<view
+		class="up-swiper"
+		:style="{
+			backgroundColor: bgColor,
+			height: addUnit(height),
+			borderRadius: addUnit(radius)
+		}"
+	>
+		<view
+			class="up-swiper__loading"
+			v-if="loading"
+		>
+			<up-loading-icon mode="circle"></up-loading-icon>
+		</view>
+		<swiper
+			v-else
+			class="up-swiper__wrapper"
+			:style="{
+				flex: '1',
+				height: addUnit(height)
+			}"
+			@change="change"
+			:circular="circular"
+			:interval="interval"
+			:duration="duration"
+			:autoplay="autoplay"
+			:current="current"
+			:currentItemId="currentItemId"
+			:previousMargin="addUnit(previousMargin)"
+			:nextMargin="addUnit(nextMargin)"
+			:acceleration="acceleration"
+			:displayMultipleItems="list.length > 0 ? displayMultipleItems : 0"
+			:easingFunction="easingFunction"
+		>
+			<swiper-item
+				class="up-swiper__wrapper__item"
+				v-for="(item, index) in list"
+				:key="index"
+			>
+				<slot :item="item" :index="index">
+					<view
+						class="up-swiper__wrapper__item__wrapper"
+						:style="[itemStyle(index)]"
+					>
+						<!-- 在nvue中，image图片的宽度默认为屏幕宽度，需要通过flex:1撑开，另外必须设置高度才能显示图片 -->
+						<image
+							class="up-swiper__wrapper__item__wrapper__image"
+							v-if="getItemType(item) === 'image'"
+							:src="getSource(item)"
+							:mode="imgMode"
+							@tap="clickHandler(index)"
+							:style="{
+								height: addUnit(height),
+								borderRadius: addUnit(radius)
+							}"
+						></image>
+						<video
+							class="up-swiper__wrapper__item__wrapper__video"
+							v-if="getItemType(item) === 'video'"
+							:id="`video-${index}`"
+							:enable-progress-gesture="false"
+							:src="getSource(item)"
+							:poster="getPoster(item)"
+							:title="showTitle && testObject(item) && item.title ? item.title : ''"
+							:style="{
+								height: addUnit(height)
+							}"
+							controls
+							@tap="clickHandler(index)"
+						></video>
+						<view v-if="showTitle && testObject(item) && item.title && testImage(getSource(item))"
+							class="up-swiper__wrapper__item__wrapper__title">
+							<text class="up-line-1">{{ item.title }}</text>
+						</view>
+					</view>
+				</slot>
+			</swiper-item>
+		</swiper>
+		<view class="up-swiper__indicator" :style="[addStyle(indicatorStyle)]">
+			<slot name="indicator">
+				<up-swiper-indicator
+					v-if="!loading && indicator && !showTitle"
+					:indicatorActiveColor="indicatorActiveColor"
+					:indicatorInactiveColor="indicatorInactiveColor"
+					:length="list.length"
+					:current="currentIndex"
+					:indicatorMode="indicatorMode"
+				></up-swiper-indicator>
+			</slot>
+		</view>
+	</view>
+</template>
+<script>
+	import { props } from './props.js';
+	import { mpMixin } from '../../libs/mixin/mpMixin';
+	import { mixin } from '../../libs/mixin/mixin';
+	import { addUnit, addStyle, error } from '../../libs/function/index';
+	import test from '../../libs/function/test';
+	/**
+	 * Swiper 轮播图
+	 * @description 该组件一般用于导航轮播，广告展示等场景,可开箱即用，
+	 * @tutorial https://uview-plus.jiangruyi.com/components/swiper.html
+	 * @property {Array}			list					轮播图数据
+	 * @property {Boolean}			indicator				是否显示面板指示器（默认 false ）
+	 * @property {String}			indicatorActiveColor	指示器非激活颜色（默认 '#FFFFFF' ）
+	 * @property {String}			indicatorInactiveColor	指示器的激活颜色（默认 'rgba(255, 255, 255, 0.35)' ）
+	 * @property {String | Object}	indicatorStyle			指示器样式，可通过bottom，left，right进行定位
+	 * @property {String}			indicatorMode			指示器模式（默认 'line' ）
+	 * @property {Boolean}			autoplay				是否自动切换（默认 true ）
+	 * @property {String | Number}	current					当前所在滑块的 index（默认 0 ）
+	 * @property {String}			currentItemId			当前所在滑块的 item-id ，不能与 current 被同时指定
+	 * @property {String | Number}	interval				滑块自动切换时间间隔（ms）（默认 3000 ）
+	 * @property {String | Number}	duration				滑块切换过程所需时间（ms）（默认 300 ）
+	 * @property {Boolean}			circular				播放到末尾后是否重新回到开头（默认 false ）
+	 * @property {String | Number}	previousMargin			前边距，可用于露出前一项的一小部分，nvue和支付宝不支持（默认 0 ）
+	 * @property {String | Number}	nextMargin				后边距，可用于露出后一项的一小部分，nvue和支付宝不支持（默认 0 ）
+	 * @property {Boolean}			acceleration			当开启时，会根据滑动速度，连续滑动多屏，支付宝不支持（默认 false ）
+	 * @property {Number}			displayMultipleItems	同时显示的滑块数量，nvue、支付宝小程序不支持（默认 1 ）
+	 * @property {String}			easingFunction			指定swiper切换缓动动画类型， 只对微信小程序有效（默认 'default' ）
+	 * @property {String}			keyName					list数组中指定对象的目标属性名（默认 'url' ）
+	 * @property {String}			imgMode					图片的裁剪模式（默认 'aspectFill' ）
+	 * @property {String | Number}	height					组件高度（默认 130 ）
+	 * @property {String}			bgColor					背景颜色（默认 	'#f3f4f6' ）
+	 * @property {String | Number}	radius					组件圆角，数值或带单位的字符串（默认 4 ）
+	 * @property {Boolean}			loading					是否加载中（默认 false ）
+	 * @property {Boolean}			showTitle				是否显示标题，要求数组对象中有title属性（默认 false ）
+	 * @event {Function(index)}	click	点击轮播图时触发	index：点击了第几张图片，从0开始
+	 * @event {Function(index)}	change	轮播图切换时触发(自动或者手动切换)	index：切换到了第几张图片，从0开始
+	 * @example	<up-swiper :list="list4" keyName="url" :autoplay="false"></up-swiper>
+	 */
+	export default {
+		name: 'up-swiper',
+		mixins: [mpMixin, mixin, props],
+		data() {
+			return {
+				currentIndex: 0
+			}
+		},
+		watch: {
+			current(val, preVal) {
+				if(val === preVal) return;
+				this.currentIndex = val; // 和上游数据关联上
+			}
+		},
+		emits: ["click", "change", "update:current"],
+		computed: {
+			itemStyle() {
+				return index => {
+					const style = {}
+					// #ifndef APP-NVUE || MP-TOUTIAO
+					// 左右流出空间的写法不支持nvue和头条
+					// 只有配置了此二值，才加上对应的圆角，以及缩放
+					if (this.nextMargin && this.previousMargin) {
+						style.borderRadius = addUnit(this.radius)
+						if (index !== this.currentIndex) style.transform = 'scale(0.92)'
+					}
+					// #endif
+					return style
+				}
+			}
+		},
+		methods: {
+			addStyle,
+			addUnit,
+			testObject: test.object,
+			testImage: test.image,
+			getItemType(item) {
+				if (typeof item === 'string') return test.video(this.getSource(item)) ? 'video' : 'image'
+				if (typeof item === 'object' && this.keyName) {
+				if (!item.type) return test.video(this.getSource(item)) ? 'video' : 'image'
+				if (item.type === 'image') return 'image'
+				if (item.type === 'video') return 'video'
+				return 'image'
+				}
+			},
+			// 获取目标路径，可能数组中为字符串，对象的形式，额外可指定对象的目标属性名keyName
+			getSource(item) {
+				if (typeof item === 'string') return item
+				if (typeof item === 'object' && this.keyName) return item[this.keyName]
+				else error('请按格式传递列表参数')
+				return ''
+			},
+			// 轮播切换事件
+			change(e) {
+				// 当前的激活索引
+				const {
+					current
+				} = e.detail
+				this.pauseVideo(this.currentIndex)
+				this.currentIndex = current
+				this.$emit('update:current', this.currentIndex)
+				this.$emit('change', e.detail)
+			},
+			// 切换轮播时，暂停视频播放
+			pauseVideo(index) {
+				const lastItem = this.getSource(this.list[index])
+				if (test.video(lastItem)) {
+					// 当视频隐藏时，暂停播放
+					const video = uni.createVideoContext(`video-${index}`, this)
+					video.pause()
+				}
+			},
+			// 当一个轮播item为视频时，获取它的视频海报
+			getPoster(item) {
+				return typeof item === 'object' && item.poster ? item.poster : ''
+			},
+			// 点击某个item
+			clickHandler(index) {
+				this.$emit('click', index)
+			}
+		},
+	}
+</script>
+
+<style lang="scss" scoped>
+	
+	.up-swiper__wrapper {
+		flex: 1;
+	}
+	.up-swiper {
+		@include flex;
+		justify-content: center;
+		align-items: center;
+		position: relative;
+		overflow: hidden;
+
+		&__wrapper {
+			flex: 1;
+
+			&__item {
+				flex: 1;
+
+				&__wrapper {
+					@include flex;
+					position: relative;
+					overflow: hidden;
+					transition: transform 0.3s;
+					flex: 1;
+
+					&__image {
+						flex: 1;
+					}
+
+					&__video {
+						flex: 1;
+					}
+
+					&__title {
+						position: absolute;
+						background-color: rgba(0, 0, 0, 0.3);
+						bottom: 0;
+						left: 0;
+						right: 0;
+						font-size: 28rpx;
+						padding: 12rpx 24rpx;
+						color: #FFFFFF;
+						flex: 1;
+					}
+				}
+			}
+		}
+
+		&__indicator {
+			position: absolute;
+			bottom: 10px;
+		}
+	}
+</style>

package/uview-ultra/components/up-swiper-indicator/props.js

@@ -0,0 +1,31 @@
+import { defineMixin } from '../../libs/vue'
+import defProps from '../../libs/config/props.js'
+export const props = defineMixin({
+    props: {
+        // 轮播的长度
+        length: {
+            type: [String, Number],
+            default: () => defProps.swiperIndicator.length
+        },
+        // 当前处于活动状态的轮播的索引
+        current: {
+            type: [String, Number],
+            default: () => defProps.swiperIndicator.current
+        },
+        // 指示器非激活颜色
+        indicatorActiveColor: {
+            type: String,
+            default: () => defProps.swiperIndicator.indicatorActiveColor
+        },
+        // 指示器的激活颜色
+        indicatorInactiveColor: {
+            type: String,
+            default: () => defProps.swiperIndicator.indicatorInactiveColor
+        },
+		// 指示器模式，line-线型，dot-点型
+		indicatorMode: {
+		    type: String,
+		    default: () => defProps.swiperIndicator.indicatorMode
+		}
+    }
+})

package/uview-ultra/components/up-swiper-indicator/props.uts

@@ -0,0 +1,41 @@
+/*
+ * @Author       : jry
+ * @Description  : uview-plus component's props mixin file
+ * @version      : 4.0
+ * @Date         : 2024-04-22 16:44:21
+ * @LastAuthor   : jry
+ * @lastTime     : 2025-12-21 23:26:00
+ */
+import { defineMixin } from '../../libs/vue.uts'
+import defProps from './swipterIndicator.uts'
+let swiperIndicatorProp = defProps['swiperIndicator'] as UTSJSONObject
+
+export const propsSwiperIndicator = defineMixin({
+    props: {
+        // 轮播的长度
+        length: {
+            type: [String, Number],
+            default: swiperIndicatorProp['length']
+        },
+        // 当前处于活动状态的轮播的索引
+        current: {
+            type: [String, Number],
+            default: swiperIndicatorProp['current']
+        },
+        // 指示器非激活颜色
+        indicatorActiveColor: {
+            type: String,
+            default: swiperIndicatorProp['indicatorActiveColor']
+        },
+        // 指示器的激活颜色
+        indicatorInactiveColor: {
+            type: String,
+            default: swiperIndicatorProp['indicatorInactiveColor']
+        },
+        // 指示器模式，line-线型，dot-点型
+        indicatorMode: {
+            type: String,
+            default: swiperIndicatorProp['indicatorMode']
+        }
+    }
+})

package/uview-ultra/components/up-swiper-indicator/swipterIndicator.js

@@ -0,0 +1,19 @@
+/*
+ * @Author       : LQ
+ * @Description  :
+ * @version      : 3.0
+ * @Date         : 2021-08-20 16:44:21
+ * @LastAuthor   : jry
+ * @lastTime     : 2025-12-19 08:55:21
+ * @FilePath     : /uview-ultra/libs/config/props/swiperIndicator.js
+ */
+export default {
+    // swiperIndicator 组件
+    swiperIndicator: {
+        length: 0,
+        current: 0,
+        indicatorActiveColor: '',
+        indicatorInactiveColor: '',
+		indicatorMode: 'line'
+    }
+}

package/uview-ultra/components/up-swiper-indicator/swipterIndicator.uts

@@ -0,0 +1,19 @@
+/*
+ * @Author       : LQ
+ * @Description  :
+ * @version      : 3.0
+ * @Date         : 2021-08-20 16:44:21
+ * @LastAuthor   : jry
+ * @lastTime     : 2025-12-21 23:25:00
+ * @FilePath     : /uview-ultra/libs/config/props/swiperIndicator.uts
+ */
+export default {
+    // swiperIndicator 组件
+    swiperIndicator: {
+        length: 0,
+        current: 0,
+        indicatorActiveColor: '',
+        indicatorInactiveColor: '',
+        indicatorMode: 'line'
+    }
+} as UTSJSONObject

package/uview-ultra/components/up-swiper-indicator/up-swiper-indicator.uvue

@@ -0,0 +1,123 @@
+<template>
+	<view class="up-swiper-indicator">
+		<view
+			class="up-swiper-indicator__wrapper"
+			v-if="indicatorMode === 'line'"
+			:class="[`up-swiper-indicator__wrapper--${indicatorMode}`]"
+			:style="{
+				width: addUnit(lineWidth * (length as number)),
+				backgroundColor: indicatorInactiveColor
+			}"
+		>
+			<view
+				class="up-swiper-indicator__wrapper--line__bar"
+				:style="[lineStyle]"
+			></view>
+		</view>
+		<view
+			class="up-swiper-indicator__wrapper"
+			v-if="indicatorMode === 'dot'"
+		>
+			<view
+				class="up-swiper-indicator__wrapper__dot"
+				v-for="(item, index) in lengthArray"
+				:key="index"
+				:class="[index === (current as number) ? 'up-swiper-indicator__wrapper__dot--active' : '']"
+				:style="[dotStyle(index)]"
+			>
+			</view>
+		</view>
+	</view>
+</template>
+
+<script lang="uts">
+	import { propsSwiperIndicator } from './props.uts';
+	import { mpMixin } from '../../libs/mixin/mpMixin.uts';
+	import { mixin } from '../../libs/mixin/mixin.uts';
+	import { addUnit } from '../../libs/function/index.uts';
+	/**
+	 * SwiperIndicator 轮播图指示器
+	 * @description 该组件一般用于导航轮播，广告展示等场景,可开箱即用，
+	 * @tutorial https://uview-plus.jiangruyi.com/components/swiper.html
+	 * @property {String | Number}	length					轮播的长度（默认 0 ）
+	 * @property {String | Number}	current					当前处于活动状态的轮播的索引（默认 0 ）
+	 * @property {String}			indicatorActiveColor	指示器非激活颜色
+	 * @property {String}			indicatorInactiveColor	指示器的激活颜色
+	 * @property {String}			indicatorMode			指示器模式（默认 'line' ）
+	 * @example	<up-swiper :list="list4" indicator keyName="url" :autoplay="false"></up-swiper>
+	 */
+	export default {
+		name: 'up-swiper-indicator',
+		mixins: [mpMixin, mixin, propsSwiperIndicator],
+		data() {
+			return {
+				lineWidth: 22
+			}
+		},
+		computed: {
+			lengthArray(): Array<string> {
+				let list: Array<string> = []
+				// @ts-ignore
+				for (var index = 0; index < this.$props['length'] as number; index++) {
+					list.push(index.toString())
+				}
+				return list
+			},
+			// 指示器为线型的样式
+			lineStyle(): any {
+				let style = {}
+				style['width'] = addUnit(this.lineWidth)
+				style['transform'] = `translateX(${ addUnit(this.current as number * this.lineWidth) })`
+				style['backgroundColor'] = this.indicatorActiveColor
+				return style
+			}
+		},
+		methods: {
+			addUnit(val: any): string {
+				return addUnit(val)
+			},
+			// 指示器为点型的样式
+			dotStyle(index: number): any {
+				let style = {}
+				style['backgroundColor'] = index === this.current ? this.indicatorActiveColor : this.indicatorInactiveColor
+				return style
+			}
+		}
+	}
+</script>
+
+<style lang="scss" scoped>
+	@import '../../libs/css/components.scss';
+
+	.up-swiper-indicator {
+
+		&__wrapper {
+			@include flex;
+
+			&--line {
+				border-radius: 100px;
+				height: 4px;
+
+				&__bar {
+					width: 22px;
+					height: 4px;
+					border-radius: 100px;
+					background-color: #FFFFFF;
+					transition: transform 0.3s;
+				}
+			}
+
+			&__dot {
+				width: 5px;
+				height: 5px;
+				border-radius: 100px;
+				margin: 0 4px;
+
+				&--active {
+					width: 12px;
+				}
+			}
+
+		}
+	}
+</style>

package/uview-ultra/components/up-swiper-indicator/up-swiper-indicator.vue

@@ -0,0 +1,114 @@
+<template>
+	<view class="up-swiper-indicator">
+		<view
+			class="up-swiper-indicator__wrapper"
+			v-if="indicatorMode === 'line'"
+			:class="[`up-swiper-indicator__wrapper--${indicatorMode}`]"
+			:style="{
+				width: addUnit(lineWidth * length),
+				backgroundColor: indicatorInactiveColor
+			}"
+		>
+			<view
+				class="up-swiper-indicator__wrapper--line__bar"
+				:style="[lineStyle]"
+			></view>
+		</view>
+		<view
+			class="up-swiper-indicator__wrapper"
+			v-if="indicatorMode === 'dot'"
+		>
+			<view
+				class="up-swiper-indicator__wrapper__dot"
+				v-for="(item, index) in length"
+				:key="index"
+				:class="[index === current && 'up-swiper-indicator__wrapper__dot--active']"
+				:style="[dotStyle(index)]"
+			>
+			</view>
+		</view>
+	</view>
+</template>
+
+<script>
+	import { props } from './props';
+	import { mpMixin } from '../../libs/mixin/mpMixin';
+	import { mixin } from '../../libs/mixin/mixin';
+	import { addUnit } from '../../libs/function/index';
+	/**
+	 * SwiperIndicator 轮播图指示器
+	 * @description 该组件一般用于导航轮播，广告展示等场景,可开箱即用，
+	 * @tutorial https://uview-plus.jiangruyi.com/components/swiper.html
+	 * @property {String | Number}	length					轮播的长度（默认 0 ）
+	 * @property {String | Number}	current					当前处于活动状态的轮播的索引（默认 0 ）
+	 * @property {String}			indicatorActiveColor	指示器非激活颜色
+	 * @property {String}			indicatorInactiveColor	指示器的激活颜色
+	 * @property {String}			indicatorMode			指示器模式（默认 'line' ）
+	 * @example	<up-swiper :list="list4" indicator keyName="url" :autoplay="false"></up-swiper>
+	 */
+	export default {
+		name: 'up-swiper-indicator',
+		mixins: [mpMixin, mixin, props],
+		data() {
+			return {
+				lineWidth: 22
+			}
+		},
+		computed: {
+			// 指示器为线型的样式
+			lineStyle() {
+				let style = {}
+				style.width = addUnit(this.lineWidth)
+				style.transform = `translateX(${ addUnit(this.current * this.lineWidth) })`
+				style.backgroundColor = this.indicatorActiveColor
+				return style
+			},
+			// 指示器为点型的样式
+			dotStyle() {
+				return index => {
+					let style = {}
+					style.backgroundColor = index === this.current ? this.indicatorActiveColor : this.indicatorInactiveColor
+					return style
+				}
+			}
+		},
+		methods: {
+			addUnit
+		}
+	}
+</script>
+
+<style lang="scss" scoped>
+
+	.up-swiper-indicator {
+
+		&__wrapper {
+			@include flex;
+
+			&--line {
+				border-radius: 100px;
+				height: 4px;
+
+				&__bar {
+					width: 22px;
+					height: 4px;
+					border-radius: 100px;
+					background-color: #FFFFFF;
+					transition: transform 0.3s;
+				}
+			}
+
+			&__dot {
+				width: 5px;
+				height: 5px;
+				border-radius: 100px;
+				margin: 0 4px;
+
+				&--active {
+					width: 12px;
+				}
+			}
+
+		}
+	}
+</style>

package/uview-ultra/components/up-switch/props.js

@@ -0,0 +1,64 @@
+import { defineMixin } from '../../libs/vue'
+import defProps from '../../libs/config/props.js'
+export const props = defineMixin({
+    props: {
+        // 是否为加载中状态
+        loading: {
+            type: Boolean,
+            default: () => defProps.switch.loading
+        },
+        // 是否为禁用装填
+        disabled: {
+            type: Boolean,
+            default: () => defProps.switch.disabled
+        },
+        // 开关尺寸，单位px
+        size: {
+            type: [String, Number],
+            default: () => defProps.switch.size
+        },
+        // 打开时的背景颜色
+        activeColor: {
+            type: String,
+            default: () => defProps.switch.activeColor
+        },
+        // 关闭时的背景颜色
+        inactiveColor: {
+            type: String,
+            default: () => defProps.switch.inactiveColor
+        },
+        // 通过v-model双向绑定的值
+        // #ifdef VUE3
+        modelValue: {
+            type: [Boolean, String, Number],
+            default: () => defProps.switch.value
+        },
+        // #endif
+        // #ifdef VUE2
+        value: {
+            type: [Boolean, String, Number],
+            default: () => defProps.switch.value
+        },
+        // #endif
+        // switch打开时的值
+        activeValue: {
+            type: [String, Number, Boolean],
+            default: () => defProps.switch.activeValue
+        },
+        // switch关闭时的值
+        inactiveValue: {
+            type: [String, Number, Boolean],
+            default: () => defProps.switch.inactiveValue
+        },
+        // 是否开启异步变更，开启后需要手动控制输入值
+        asyncChange: {
+            type: Boolean,
+            default: () => defProps.switch.asyncChange
+        },
+        // 圆点与外边框的距离
+        space: {
+            type: [String, Number],
+            default: () => defProps.switch.space
+        }
+    }
+})