CNCEC_APP/uni_modules/uview-pro/components/u-number-box/u-number-box.vue

322 lines
11 KiB
Vue
Raw Normal View History

2026-03-25 14:54:15 +08:00
<template>
<view class="u-numberbox">
<view
class="u-icon-minus"
@touchstart.stop.prevent="btnTouchStart('minus')"
@touchend.stop.prevent="clearTimer"
:class="{ 'u-icon-disabled': disabled || inputVal <= min }"
:style="{
background: bgColor,
height: inputHeight + 'rpx',
color: color
}"
>
<u-icon name="minus" :size="size"></u-icon>
</view>
<input
:disabled="disabledInput || disabled"
:cursor-spacing="getCursorSpacing"
:class="{ 'u-input-disabled': disabled }"
v-model="inputVal"
class="u-number-input"
@blur="onBlur"
@focus="onFocus"
type="digit"
:style="{
color: color,
fontSize: size + 'rpx',
background: bgColor,
height: inputHeight + 'rpx',
width: inputWidth + 'rpx'
}"
/>
<view
class="u-icon-plus"
@touchstart.stop.prevent="btnTouchStart('plus')"
@touchend.stop.prevent="clearTimer"
:class="{ 'u-icon-disabled': disabled || inputVal >= max }"
:style="{
background: bgColor,
height: inputHeight + 'rpx',
color: color
}"
>
<u-icon name="plus" :size="size"></u-icon>
</view>
</view>
</template>
<script lang="ts">
export default {
name: 'u-number-box',
options: {
addGlobalClass: true,
// #ifndef MP-TOUTIAO
virtualHost: true,
// #endif
styleIsolation: 'shared'
}
};
</script>
<script setup lang="ts">
import { ref, watch, computed, nextTick } from 'vue';
import { NumberBoxProps } from './types';
/**
* numberBox 步进器
* @description 该组件一般用于商城购物选择物品数量的场景注意该输入框只能输入大于或等于0的整数不支持小数输入
* @tutorial https://uviewpro.cn/zh/components/numberBox.html
* @property {Number} modelValue 输入框初始值默认1
* @property {String} bg-color 输入框和按钮的背景颜色默认var(--u-bg-gray-light)
* @property {Number} min 用户可输入的最小值默认0
* @property {Number} max 用户可输入的最大值默认99999
* @property {Number} step 步长每次加或减的值默认1
* @property {Boolean} disabled 是否禁用操作禁用后无法加减或手动修改输入框的值默认false
* @property {Boolean} disabled-input 是否禁止输入框手动输入值默认false
* @property {Boolean} positive-integer 是否只能输入正整数默认true
* @property {String | Number} size 输入框文字和按钮字体大小单位rpx默认26
* @property {String} color 输入框文字和加减按钮图标的颜色默认var(--u-main-color)
* @property {String | Number} input-width 输入框宽度单位rpx默认80
* @property {String | Number} input-height 输入框和按钮的高度单位rpx默认50
* @property {String | Number} index 事件回调时用以区分当前发生变化的是哪个输入框
* @property {Boolean} long-press 是否开启长按连续递增或递减(默认true)
* @property {String | Number} press-time 开启长按触发后每触发一次需要多久单位ms(默认250)
* @property {String | Number} cursor-spacing 指定光标于键盘的距离避免键盘遮挡输入框单位rpx默认200
* @event {Function} change 输入框内容发生变化时触发对象形式
* @event {Function} blur 输入框失去焦点时触发对象形式
* @event {Function} minus 点击减少按钮时触发(按钮可点击情况下)对象形式
* @event {Function} plus 点击增加按钮时触发(按钮可点击情况下)对象形式
* @example <u-number-box :min="1" :max="100"></u-number-box>
*/
const props = defineProps(NumberBoxProps);
const emit = defineEmits(['update:modelValue', 'change', 'blur', 'focus', 'minus', 'plus']);
// 响应式变量
const inputVal = ref<number>(props.modelValue); // 输入框中的值不能直接使用props中的value因为应该改变props的状态
const timer = ref<any>(null); // 用作长按的定时器
const changeFromInner = ref(false); // 值发生变化,是来自内部还是外部
const innerChangeTimer = ref<any>(null); // 内部定时器
// 计算属性
const getCursorSpacing = computed(() => {
const spacing = typeof props.cursorSpacing === 'string' ? Number(props.cursorSpacing) : props.cursorSpacing;
return Number(uni.upx2px(spacing));
});
// 监听外部 value 变化
watch(
() => props.modelValue,
(v1, v2) => {
// 只有value的改变是来自外部的时候才去同步inputVal的值否则会造成循环错误
if (!changeFromInner.value) {
inputVal.value = v1;
// 延时保证 changeFromInner 在运行周期最后处重置
// 因为inputVal变化后会触发this.handleChange()在其中changeFromInner会再次被设置为true
// 造成外面修改值也导致被认为是内部修改的混乱这里进行this.$nextTick延时保证在运行周期的最后处
// 将changeFromInner设置为false
nextTick(() => {
changeFromInner.value = false;
});
}
}
);
// 监听 inputVal 变化
watch(inputVal, (v1, v2) => {
// 为了让用户能够删除所有输入值,重新输入内容,删除所有值后,内容为空字符串
if (typeof v1 !== 'number' || isNaN(v1)) return;
let value = 0;
// 首先判断是否数值并且在min和max之间如果不是使用原来值
let tmp = typeof v1 === 'number' && !isNaN(v1);
if (tmp && v1 >= props.min && v1 <= props.max) value = Number(v1);
else value = Number(v2);
// 判断是否只能输入大于等于0的整数
if (props.positiveInteger) {
// 小于0或者带有小数点
if (value < 0 || String(v1).indexOf('.') !== -1) {
value = Number(v2);
// 双向绑定input的值必须要使用$nextTick修改显示的值
nextTick(() => {
inputVal.value = value;
});
}
}
// 发出change事件
handleChange(value, 'change');
});
function btnTouchStart(callback: 'minus' | 'plus') {
// 先执行一遍方法否则会造成松开手时就执行了clearTimer导致无法实现功能
if (callback === 'minus') minus();
else plus();
// 如果没开启长按功能,直接返回
if (!props.longPress) return;
// 再次清空定时器,防止重复注册定时器
clearInterval(timer.value);
timer.value = setInterval(() => {
// 执行加或减函数
if (callback === 'minus') minus();
else plus();
}, Number(props.pressTime));
}
function clearTimer() {
// 清除长按定时器
nextTick(() => {
clearInterval(timer.value);
timer.value = null;
});
}
function minus() {
// 执行减法操作
computeVal('minus');
}
function plus() {
// 执行加法操作
computeVal('plus');
}
// 为了保证小数相加减出现精度溢出的问题
function calcPlus(num1: number, num2: number) {
let baseNum, baseNum1, baseNum2;
try {
baseNum1 = num1.toString().split('.')[1].length;
} catch (e) {
baseNum1 = 0;
}
try {
baseNum2 = num2.toString().split('.')[1].length;
} catch (e) {
baseNum2 = 0;
}
baseNum = Math.pow(10, Math.max(baseNum1, baseNum2));
let precision = baseNum1 >= baseNum2 ? baseNum1 : baseNum2; //精度
return Number(((num1 * baseNum + num2 * baseNum) / baseNum).toFixed(precision));
}
// 为了保证小数相加减出现精度溢出的问题
function calcMinus(num1: number, num2: number) {
let baseNum, baseNum1, baseNum2;
try {
baseNum1 = num1.toString().split('.')[1].length;
} catch (e) {
baseNum1 = 0;
}
try {
baseNum2 = num2.toString().split('.')[1].length;
} catch (e) {
baseNum2 = 0;
}
baseNum = Math.pow(10, Math.max(baseNum1, baseNum2));
let precision = baseNum1 >= baseNum2 ? baseNum1 : baseNum2;
return Number(((num1 * baseNum - num2 * baseNum) / baseNum).toFixed(precision));
}
// 处理加减按钮点击逻辑
function computeVal(type: 'minus' | 'plus') {
uni.hideKeyboard();
if (props.disabled) return;
let value = 0;
// 减
if (type === 'minus') {
value = calcMinus(Number(inputVal.value), props.step);
} else if (type === 'plus') {
value = calcPlus(Number(inputVal.value), props.step);
}
// 判断是否小于最小值和大于最大值
if (value < props.min || value > props.max) return;
inputVal.value = value;
handleChange(value, type);
}
// 处理用户手动输入的情况
function onBlur(event: any) {
let val = 0;
let value = event.detail.value;
// 如果为非0-9数字组成或者其第一位数值为0直接让其等于min值
// 这里不直接判断是否正整数是因为用户传递的props min值可能为0
if (!/(^\d+$)/.test(value) || value[0] == 0) val = props.min;
else val = +value;
if (val > props.max) val = props.max;
else if (val < props.min) val = props.min;
nextTick(() => {
inputVal.value = val;
});
handleChange(val, 'blur');
}
// 输入框获得焦点事件
function onFocus() {
emit('focus');
}
// 处理值变化的统一逻辑
function handleChange(value: number, type: 'update:modelValue' | 'change' | 'blur' | 'focus' | 'minus' | 'plus') {
if (props.disabled) return;
// 清除定时器,避免造成混乱
if (innerChangeTimer.value) {
clearTimeout(innerChangeTimer.value);
innerChangeTimer.value = null;
}
// 发出input事件修改通过v-model绑定的值达到双向绑定的效果
changeFromInner.value = true;
// 一定时间内清除changeFromInner标记否则内部值改变后外部通过程序修改value值将会无效
innerChangeTimer.value = setTimeout(() => {
changeFromInner.value = false;
}, 150);
emit('update:modelValue', Number(value));
emit(type, {
// 转为Number类型
value: Number(value),
index: props.index
});
}
</script>
<style lang="scss" scoped>
@import '../../libs/css/style.components.scss';
.u-numberbox {
display: inline-flex;
align-items: center;
}
.u-number-input {
position: relative;
text-align: center;
padding: 0;
margin: 0 6rpx;
@include vue-flex;
align-items: center;
justify-content: center;
}
.u-icon-plus,
.u-icon-minus {
width: 60rpx;
@include vue-flex;
justify-content: center;
align-items: center;
}
.u-icon-plus {
border-radius: 0 8rpx 8rpx 0;
}
.u-icon-minus {
border-radius: 8rpx 0 0 8rpx;
}
.u-icon-disabled {
color: var(--u-type-info-disabled) !important;
background: var(--u-bg-gray-light) !important;
}
.u-input-disabled {
color: var(--u-type-info-disabled) !important;
background-color: var(--u-bg-gray-light) !important;
}
</style>