uview-ultra-plus 1.0.0

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

@@ -0,0 +1,394 @@
+<template>
+    <view class="up-input" :class="inputClass" :style="[wrapperStyle]">
+        <view class="up-input__content">
+            <view
+                class="up-input__content__prefix-icon"
+                v-if="prefixIcon || $slots.prefix"
+            >
+                <slot name="prefix">
+                    <up-icon
+                        :name="prefixIcon"
+                        size="18"
+                        :customStyle="prefixIconStyle"
+                    ></up-icon>
+                </slot>
+            </view>
+            <view class="up-input__content__field-wrapper" @tap="clickHandler">
+				<!-- 根据uni-app的input组件文档，H5和APP中只要声明了password参数(无论true还是false)，type均失效，此时
+					为了防止type=number时，又存在password属性，type无效，此时需要设置password为undefined
+				 -->
+            	<input
+                    ref="input-native"
+            	    class="up-input__content__field-wrapper__field"
+            	    :style="[inputStyle]"
+            	    :type="type"
+            	    :focus="focus"
+            	    :cursor="cursor"
+            	    :value="innerValue"
+            	    :auto-blur="autoBlur"
+            	    :disabled="disabled || readonly"
+            	    :maxlength="maxlength"
+            	    :placeholder="placeholder"
+            	    :placeholder-style="placeholderStyle"
+            	    :placeholder-class="placeholderClass"
+            	    :confirm-type="confirmType"
+            	    :confirm-hold="confirmHold"
+            	    :hold-keyboard="holdKeyboard"
+            	    :cursor-spacing="cursorSpacing"
+            	    :adjust-position="adjustPosition"
+            	    :selection-end="selectionEnd"
+            	    :selection-start="selectionStart"
+            	    :password="password || type === 'password' || false"
+                    :ignoreCompositionEvent="ignoreCompositionEvent"
+            	    @input="onInput"
+            	    @blur="onBlur"
+            	    @focus="onFocus"
+            	    @confirm="onConfirm"
+            	    @keyboardheightchange="onkeyboardheightchange"
+            	/>
+            </view>
+            <view
+                class="up-input__content__clear"
+                v-if="isShowClear"
+                @click="onClear"
+            >
+                <up-icon
+                    name="close"
+                    size="11"
+                    color="#ffffff"
+                    customStyle="line-height: 12px"
+                ></up-icon>
+            </view>
+            <view
+                class="up-input__content__subfix-icon"
+                v-if="suffixIcon || $slots.suffix"
+            >
+                <slot name="suffix">
+                    <up-icon
+                        :name="suffixIcon"
+                        size="18"
+                        :customStyle="suffixIconStyle"
+                    ></up-icon>
+                </slot>
+            </view>
+        </view>
+    </view>
+</template>
+
+<script>
+import { props } from "./props.js";
+import { mpMixin } from '../../libs/mixin/mpMixin.js';
+import { mixin } from '../../libs/mixin/mixin.js';
+import { debounce } from '../../libs/function/debounce.js';
+import { addStyle, addUnit, deepMerge, formValidate, $parent, sleep, os } from '../../libs/function/index.js';
+/**
+ * Input 输入框
+ * @description  此组件为一个输入框，默认没有边框和样式，是专门为配合表单组件up-form而设计的，利用它可以快速实现表单验证，输入内容，下拉选择等功能。
+ * @tutorial https://uview-plus.jiangruyi.com/components/input.html
+ * @property {String | Number}	value					输入的值
+ * @property {String}			type					输入框类型，见上方说明 （ 默认 'text' ）
+ * @property {Boolean}			fixed					如果 textarea 是在一个 position:fixed 的区域，需要显示指定属性 fixed 为 true，兼容性：微信小程序、百度小程序、字节跳动小程序、QQ小程序 （ 默认 false ）
+ * @property {Boolean}			disabled				是否禁用输入框 （ 默认 false ）
+ * @property {String}			disabledColor			禁用状态时的背景色（ 默认 '#f5f7fa' ）
+ * @property {Boolean}			clearable				是否显示清除控件 （ 默认 false ）
+ * @property {Boolean}			password				是否密码类型 （ 默认 false ）
+ * @property {Number}       	maxlength				最大输入长度，设置为 -1 的时候不限制最大长度 （ 默认 -1 ）
+ * @property {String}			placeholder				输入框为空时的占位符
+ * @property {String}			placeholderClass		指定placeholder的样式类，注意页面或组件的style中写了scoped时，需要在类名前写/deep/ （ 默认 'input-placeholder' ）
+ * @property {String | Object}	placeholderStyle		指定placeholder的样式，字符串/对象形式，如"color: red;"
+ * @property {Boolean}			showWordLimit			是否显示输入字数统计，只在 type ="text"或type ="textarea"时有效 （ 默认 false ）
+ * @property {String}			confirmType				设置右下角按钮的文字，兼容性详见uni-app文档 （ 默认 'done' ）
+ * @property {Boolean}			confirmHold				点击键盘右下角按钮时是否保持键盘不收起，H5无效 （ 默认 false ）
+ * @property {Boolean}			holdKeyboard			focus时，点击页面的时候不收起键盘，微信小程序有效 （ 默认 false ）
+ * @property {Boolean}			focus					自动获取焦点，在 H5 平台能否聚焦以及软键盘是否跟随弹出，取决于当前浏览器本身的实现。nvue 页面不支持，需使用组件的 focus()、blur() 方法控制焦点 （ 默认 false ）
+ * @property {Boolean}			autoBlur				键盘收起时，是否自动失去焦点，目前仅App3.0.0+有效 （ 默认 false ）
+ * @property {Boolean}			disableDefaultPadding	是否去掉 iOS 下的默认内边距，仅微信小程序，且type=textarea时有效 （ 默认 false ）
+ * @property {String ｜ Number}	cursor					指定focus时光标的位置（ 默认 140 ）
+ * @property {String ｜ Number}	cursorSpacing			输入框聚焦时底部与键盘的距离 （ 默认 30 ）
+ * @property {String ｜ Number}	selectionStart			光标起始位置，自动聚集时有效，需与selection-end搭配使用 （ 默认 -1 ）
+ * @property {String ｜ Number}	selectionEnd			光标结束位置，自动聚集时有效，需与selection-start搭配使用 （ 默认 -1 ）
+ * @property {Boolean}			adjustPosition			键盘弹起时，是否自动上推页面 （ 默认 true ）
+ * @property {String}			inputAlign				输入框内容对齐方式（ 默认 'left' ）
+ * @property {String | Number}	fontSize				输入框字体的大小 （ 默认 '15px' ）
+ * @property {String}			color					输入框字体颜色	（ 默认 '#303133' ）
+ * @property {Function}			formatter			    内容式化函数
+ * @property {String}			prefixIcon				输入框前置图标
+ * @property {String | Object}	prefixIconStyle			前置图标样式，对象或字符串
+ * @property {String}			suffixIcon				输入框后置图标
+ * @property {String | Object}	suffixIconStyle			后置图标样式，对象或字符串
+ * @property {String}			border					边框类型，surround-四周边框，bottom-底部边框，none-无边框 （ 默认 'surround' ）
+ * @property {Boolean}			readonly				是否只读，与disabled不同之处在于disabled会置灰组件，而readonly则不会 （ 默认 false ）
+ * @property {String}			shape					输入框形状，circle-圆形，square-方形 （ 默认 'square' ）
+ * @property {Object}			customStyle				定义需要用到的外部样式
+ * @property {Boolean}			ignoreCompositionEvent	是否忽略组件内对文本合成系统事件的处理。
+ * @example <up-input v-model="value" :password="true" suffix-icon="lock-fill" />
+ */
+export default {
+    name: "up-input",
+    mixins: [mpMixin, mixin, props],
+    data() {
+        return {
+            // 清除操作
+            clearInput: false,
+            // 输入框的值
+            innerValue: "",
+            // 是否处于获得焦点状态
+            focused: false,
+            // value是否第一次变化，在watch中，由于加入immediate属性，会在第一次触发，此时不应该认为value发生了变化
+            firstChange: true,
+            // value绑定值的变化是由内部还是外部引起的
+            changeFromInner: false,
+			// 过滤处理方法
+			innerFormatter: value => value
+        };
+    },
+    created() {
+        // 格式化过滤方法
+        if (this.formatter) {
+            this.innerFormatter = this.formatter;
+        }
+    },
+    watch: {
+        modelValue: {
+            immediate: true,
+            handler(newVal, oldVal) {
+                // console.log(newVal, oldVal)
+                if (this.changeFromInner || this.innerValue === newVal) {
+                    this.changeFromInner = false; // 重要否则会出现双向绑定失效问题https://github.com/ijry/uview-plus/issues/419
+                    return;
+                }
+                this.innerValue = newVal;
+                // 在H5中，外部value变化后，修改input中的值，不会触发@input事件，此时手动调用值变化方法
+                if (
+                    this.firstChange === false &&
+					this.changeFromInner === false
+                ) {
+                    this.valueChange(this.innerValue, true);
+                } else {
+					// 尝试调用up-form的验证方法
+                    if(!this.firstChange) formValidate(this, "change");
+				}
+                this.firstChange = false;
+                // 重置changeFromInner的值为false，标识下一次引起默认为外部引起的
+                this.changeFromInner = false;
+            }
+        }
+    },
+    computed: {
+        // 是否显示清除控件
+        isShowClear() {
+            const { clearable, readonly, focused, innerValue } = this;
+            return !!clearable && !readonly && !!focused && innerValue !== "";
+        },
+        // 组件的类名
+        inputClass() {
+            let classes = [],
+                { border, disabled, shape } = this;
+            border === "surround" &&
+                (classes = classes.concat(["up-border", "up-input--radius"]));
+            classes.push(`up-input--${shape}`);
+            border === "bottom" &&
+                (classes = classes.concat([
+                    "up-border-bottom",
+                    "up-input--no-radius",
+                ]));
+            return classes.join(" ");
+        },
+        // 组件的样式
+        wrapperStyle() {
+            const style = {};
+            // 禁用状态下，被背景色加上对应的样式
+            if (this.disabled) {
+                style.backgroundColor = this.disabledColor;
+            }
+            // 无边框时，去除内边距
+            if (this.border === "none") {
+                style.padding = "0";
+            } else {
+                // 由于uni-app的iOS开发者能力有限，导致需要分开写才有效
+                style.paddingTop = "6px";
+                style.paddingBottom = "6px";
+                style.paddingLeft = "9px";
+                style.paddingRight = "9px";
+            }
+            return deepMerge(style, addStyle(this.customStyle));
+        },
+        // 输入框的样式
+        inputStyle() {
+            const style = {
+                color: this.color,
+                fontSize: addUnit(this.fontSize),
+				textAlign: this.inputAlign
+            };
+            return style;
+        },
+    },
+    // #ifdef VUE3
+    emits: ['update:modelValue', 'focus', 'blur', 'change', 'confirm', 'clear', 'keyboardheightchange'],
+    // #endif
+    methods: {
+		// 在微信小程序中，不支持将函数当做props参数，故只能通过ref形式调用
+		setFormatter(e) {
+			this.innerFormatter = e
+		},
+        // 当键盘输入时，触发input事件
+        onInput(e) {
+            let { value = "" } = e.detail || {};
+            // 为了避免props的单向数据流特性，需要先将innerValue值设置为当前值，再在$nextTick中重新赋予设置后的值才有效
+            // console.log('onInput', value, this.innerValue)
+            this.innerValue = value;
+            this.$nextTick(() => {
+                let formatValue = this.innerFormatter(value);
+            	this.innerValue = formatValue;
+                this.valueChange(formatValue);
+            })
+        },
+        // 输入框失去焦点时触发
+        onBlur(event) {
+            this.$emit("blur", event.detail.value);
+            // H5端的blur会先于点击清除控件的点击click事件触发，导致focused
+            // 瞬间为false，从而隐藏了清除控件而无法被点击到
+            sleep(150).then(() => {
+                this.focused = false;
+            });
+            // 尝试调用up-form的验证方法
+            formValidate(this, "blur");
+        },
+        // 输入框聚焦时触发
+        onFocus(event) {
+            this.focused = true;
+            this.$emit("focus");
+        },
+        doFocus() {
+            this.$refs['input-native'].focus();
+        },
+        doBlur() {
+            this.$refs['input-native'].blur();
+        },
+        // 点击完成按钮时触发
+        onConfirm(event) {
+            this.$emit("confirm", this.innerValue);
+        },
+        // 键盘高度发生变化的时候触发此事件
+        // 兼容性：微信小程序2.7.0+、App 3.1.0+
+		onkeyboardheightchange(event) {
+            this.$emit("keyboardheightchange", event);
+        },
+        // 内容发生变化，进行处理
+        valueChange(value, isOut = false) {
+            if(this.clearInput) {
+                this.innerValue = '';
+                this.clearInput = false;
+            }
+            this.$nextTick(() => {
+                if (!isOut || this.clearInput) {
+                    // 标识value值的变化是由内部引起的
+                    this.changeFromInner = true;
+                    this.$emit("change", value);
+
+                    // #ifdef VUE3
+                    this.$emit("update:modelValue", value);
+                    // #endif
+                    // #ifdef VUE2
+                    this.$emit("input", value);
+                    // #endif
+                }
+
+                // 尝试调用up-form的验证方法
+                formValidate(this, "change");
+            });
+        },
+        // 点击清除控件
+        onClear() {
+            this.clearInput = true;
+            this.innerValue = "";
+            this.$nextTick(() => {
+                this.valueChange("");
+                this.$emit("clear");
+            });
+        },
+        /**
+         * 在安卓nvue上，事件无法冒泡
+         * 在某些时间，我们希望监听up-from-item的点击事件，此时会导致点击up-form-item内的up-input后
+         * 无法触发up-form-item的点击事件，这里通过手动调用up-form-item的方法进行触发
+         */
+        clickHandler() {
+            // #ifdef APP-NVUE
+            if (os() === "android") {
+                const formItem = $parent.call(this, "up-form-item");
+                if (formItem) {
+                    formItem.clickHandler();
+                }
+            }
+            // #endif
+        },
+    },
+};
+</script>
+
+<style lang="scss" scoped>
+@import "../../libs/css/components.scss";
+
+.up-input {
+    @include flex(row);
+    align-items: center;
+    justify-content: space-between;
+    flex: 1;
+
+    &--radius,
+    &--square {
+        border-radius: 4px;
+    }
+
+    &--no-radius {
+        border-radius: 0;
+    }
+
+    &--circle {
+        border-radius: 100px;
+    }
+
+    &__content {
+        flex: 1;
+        @include flex(row);
+        align-items: center;
+        justify-content: space-between;
+
+        &__field-wrapper {
+            position: relative;
+            @include flex(row);
+            margin: 0;
+            flex: 1;
+			
+			&__field {
+				line-height: 26px;
+				text-align: left;
+				color: $up-main-color;
+				height: 24px;
+				font-size: 15px;
+				flex: 1;
+			}
+        }
+
+        &__clear {
+            width: 20px;
+            height: 20px;
+            border-radius: 100px;
+            background-color: #c6c7cb;
+            @include flex(row);
+            align-items: center;
+            justify-content: center;
+            transform: scale(0.82);
+            margin-left: 4px;
+        }
+
+        &__subfix-icon {
+            margin-left: 4px;
+        }
+
+        &__prefix-icon {
+            margin-right: 4px;
+        }
+    }
+}
+</style>

package/uview-ultra/components/up-keyboard/keyboard.js

@@ -0,0 +1,30 @@
+/*
+ * @Author       : LQ,jry
+ * @Description  :
+ * @version      : 3.0
+ * @Date         : 2021-08-20 16:44:21
+ * @LastAuthor   : jry
+ * @lastTime     : 2024-08-20 14:20:58
+ * @FilePath     : /uview-ultra/libs/config/props/keyboard.js
+ */
+export default {
+    // 键盘组件
+    keyboard: {
+        mode: 'number',
+        dotDisabled: false,
+        tooltip: true,
+        showTips: true,
+        tips: '',
+        showCancel: true,
+        showConfirm: true,
+        random: false,
+        safeAreaInsetBottom: true,
+        closeOnClickOverlay: true,
+        show: false,
+        overlay: true,
+        zIndex: 10075,
+        cancelText: '取消',
+        confirmText: '确定',
+        autoChange: false
+    }
+}

package/uview-ultra/components/up-keyboard/keyboard.uts

@@ -0,0 +1,30 @@
+/*
+ * @Author       : jry
+ * @Description  :
+ * @version      : 4.0
+ * @Date         : 2025-12-17 08:48:27
+ * @LastAuthor   : jry
+ * @lastTime     : 2025-12-17 08:48:27
+ * @FilePath     : /uview-ultra/libs/config/props/keyboard.js
+ */
+export default {
+	// keyboard组件
+	keyboard: {
+		mode: 'number',
+		dotDisabled: false,
+		tooltip: true,
+		showTips: true,
+		tips: '',
+		showCancel: true,
+		showConfirm: true,
+		random: false,
+		safeAreaInsetBottom: true,
+		closeOnClickOverlay: true,
+		show: false,
+		overlay: true,
+		zIndex: 1075,
+		cancelText: '取消',
+		confirmText: '确认',
+		autoChange: false
+	}
+} as UTSJSONObject

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

@@ -0,0 +1,86 @@
+import { defineMixin } from '../../libs/vue.js'
+import defProps from '../../libs/config/props.js'
+export const props = defineMixin({
+    props: {
+        // 键盘的类型，number-数字键盘，card-身份证键盘，car-车牌号键盘
+        mode: {
+            type: String,
+            default: () => defProps.keyboard.mode
+        },
+        // 是否显示键盘的"."符号
+        dotDisabled: {
+            type: Boolean,
+            default: () => defProps.keyboard.dotDisabled
+        },
+        // 是否显示顶部工具条
+        tooltip: {
+            type: Boolean,
+            default: () => defProps.keyboard.tooltip
+        },
+        // 是否显示工具条中间的提示
+        showTips: {
+            type: Boolean,
+            default: () => defProps.keyboard.showTips
+        },
+        // 工具条中间的提示文字
+        tips: {
+            type: String,
+            default: () => defProps.keyboard.tips
+        },
+        // 是否显示工具条左边的"取消"按钮
+        showCancel: {
+            type: Boolean,
+            default: () => defProps.keyboard.showCancel
+        },
+        // 是否显示工具条右边的"完成"按钮
+        showConfirm: {
+            type: Boolean,
+            default: () => defProps.keyboard.showConfirm
+        },
+        // 是否打乱键盘按键的顺序
+        random: {
+            type: Boolean,
+            default: () => defProps.keyboard.random
+        },
+        // 是否开启底部安全区适配，开启的话，会在iPhoneX机型底部添加一定的内边距
+        safeAreaInsetBottom: {
+            type: Boolean,
+            default: () => defProps.keyboard.safeAreaInsetBottom
+        },
+        // 是否允许通过点击遮罩关闭键盘
+        closeOnClickOverlay: {
+            type: Boolean,
+            default: () => defProps.keyboard.closeOnClickOverlay
+        },
+        // 控制键盘的弹出与收起
+        show: {
+            type: Boolean,
+            default: () => defProps.keyboard.show
+        },
+        // 是否显示遮罩，某些时候数字键盘时，用户希望看到自己的数值，所以可能不想要遮罩
+        overlay: {
+            type: Boolean,
+            default: () => defProps.keyboard.overlay
+        },
+        // z-index值
+        zIndex: {
+            type: [String, Number],
+            default: () => defProps.keyboard.zIndex
+        },
+        // 取消按钮的文字
+        cancelText: {
+            type: String,
+            default: () => defProps.keyboard.cancelText
+        },
+        // 确认按钮的文字
+        confirmText: {
+            type: String,
+            default: () => defProps.keyboard.confirmText
+        },
+        // 输入一个中文后，是否自动切换到英文
+        autoChange: {
+            type: Boolean,
+            default: () => defProps.keyboard.autoChange
+        }
+    }
+})

package/uview-ultra/components/up-keyboard/props.uts

@@ -0,0 +1,97 @@
+/*
+ * @Author       : jry
+ * @Description  : uview-plus component's props mixin file
+ * @version      : 4.0
+ * @Date         : 2025-12-17 08:48:27
+ * @LastAuthor   : jry
+ * @lastTime     : 2025-12-17 08:48:27
+ */
+import { defineMixin } from '../../libs/vue.uts'
+import defProps from './keyboard.uts'
+
+let keyboardProp = defProps['keyboard'] as UTSJSONObject
+
+export const propsKeyboard = defineMixin({
+	props: {
+		// 键盘类型，见官网基本使用的说明
+		mode: {
+			type: String,
+			default: keyboardProp['mode']
+		},
+		// 是否显示"."按键，只在mode=number时有效
+		dotDisabled: {
+			type: Boolean,
+			default: keyboardProp['dotDisabled']
+		},
+		// 是否显示键盘顶部工具条
+		tooltip: {
+			type: Boolean,
+			default: keyboardProp['tooltip']
+		},
+		// 是否显示工具条中间的提示
+		showTips: {
+			type: Boolean,
+			default: keyboardProp['showTips']
+		},
+		// 工具条中间的提示文字，见上方基本使用的说明，如不需要，请传""空字符
+		tips: {
+			type: String,
+			default: keyboardProp['tips']
+		},
+		// 是否显示工具条左边的"取消"按钮
+		showCancel: {
+			type: Boolean,
+			default: keyboardProp['showCancel']
+		},
+		// 是否显示工具条右边的"完成"按钮
+		showConfirm: {
+			type: Boolean,
+			default: keyboardProp['showConfirm']
+		},
+		// 是否打乱键盘按键的顺序
+		random: {
+			type: Boolean,
+			default: keyboardProp['random']
+		},
+		// 是否开启底部安全区适配
+		safeAreaInsetBottom: {
+			type: Boolean,
+			default: keyboardProp['safeAreaInsetBottom']
+		},
+		// 是否允许点击遮罩收起键盘
+		closeOnClickOverlay: {
+			type: Boolean,
+			default: keyboardProp['closeOnClickOverlay']
+		},
+		// 控制键盘的弹出与收起
+		show: {
+			type: Boolean,
+			default: keyboardProp['show']
+		},
+		// 是否显示遮罩
+		overlay: {
+			type: Boolean,
+			default: keyboardProp['overlay']
+		},
+		// 弹出键盘的z-index值
+		zIndex: {
+			type: [String, Number],
+			default: keyboardProp['zIndex']
+		},
+		// 取消按钮的文字
+		cancelText: {
+			type: String,
+			default: keyboardProp['cancelText']
+		},
+		// 确认按钮的文字
+		confirmText: {
+			type: String,
+			default: keyboardProp['confirmText']
+		},
+        // 输入一个中文后，是否自动切换到英文
+        autoChange: {
+            type: Boolean,
+            default: keyboardProp['autoChange']
+        }
+	}
+});