uview-ultra 4.5.46

package/components/up-textarea/props.uts

@@ -0,0 +1,130 @@
+import { defineMixin } from '../../libs/vue'
+import defProps from './textarea'
+import defPropsInput from '../up-input/input'
+let crtProp = defProps['textarea'] as UTSJSONObject
+let crtPropInput = defPropsInput['input'] as UTSJSONObject
+
+export const propsTextarea = defineMixin({
+	props: {
+		// 输入框的内容
+		modelValue: {
+			type: [String, Number],
+			default: crtProp['value']
+		},
+		// 输入框为空时占位符
+		placeholder: {
+			type: [String],
+			default: crtProp['placeholder']
+		},
+		// 指定placeholder的样式类，注意页面或组件的style中写了scoped时，需要在类名前写::v-deep
+		placeholderClass: {
+			type: String,
+			default: crtPropInput['placeholderClass']
+		},
+		// 指定placeholder的样式
+		placeholderStyle: {
+			type: [String, Object],
+			default: crtPropInput['placeholderStyle']
+		},
+		// 输入框高度
+		height: {
+			type: [String, Number],
+			default: crtProp['height']
+		},
+		// 设置键盘右下角按钮的文字，仅微信小程序，App和H5有效
+		confirmType: {
+			type: String,
+			default: crtProp['confirmType']
+		},
+		// 点击键盘右下角按钮时是否保持键盘不收起，confirmType 非 return 时有效
+		confirmHold: {
+			type: Boolean,
+			default: crtProp['confirmHold']
+		},
+		// 是否禁用
+		disabled: {
+			type: Boolean,
+			default: crtProp['disabled']
+		},
+		// 是否显示统计字数
+		count: {
+			type: Boolean,
+			default: crtProp['count']
+		},
+		// 是否自动获取焦点，nvue不支持，H5取决于浏览器的实现
+		focus: {
+			type: Boolean,
+			default: crtProp['focus']
+		},
+		// 是否自动增加高度
+		autoHeight: {
+			type: Boolean,
+			default: crtProp['autoHeight']
+		},
+		// 如果textarea是在一个position:fixed的区域，需要显示指定属性fixed为true
+		fixed: {
+			type: Boolean,
+			default: crtProp['fixed']
+		},
+		// 指定光标与键盘的距离
+		cursorSpacing: {
+			type: Number,
+			default: crtProp['cursorSpacing']
+		},
+		// 指定focus时的光标位置
+		cursor: {
+			type: [String, Number],
+			default: crtProp['cursor']
+		},
+		// 是否显示键盘上方带有”完成“按钮那一栏，
+		showConfirmBar: {
+			type: Boolean,
+			default: crtProp['showConfirmBar']
+		},
+		// 光标起始位置，自动聚焦时有效，需与selection-end搭配使用
+		selectionStart: {
+			type: Number,
+			default: crtProp['selectionStart']
+		},
+		// 光标结束位置，自动聚焦时有效，需与selection-start搭配使用
+		selectionEnd: {
+			type: Number,
+			default: crtProp['selectionEnd']
+		},
+		// 键盘弹起时，是否自动上推页面
+		adjustPosition: {
+			type: Boolean,
+			default: crtProp['adjustPosition']
+		},
+		// 是否去掉 iOS 下的默认内边距，只微信小程序有效
+		disableDefaultPadding: {
+			type: Boolean,
+			default: crtProp['disableDefaultPadding']
+		},
+		// focus时，点击页面的时候不收起键盘，只微信小程序有效
+		holdKeyboard: {
+			type: Boolean,
+			default: crtProp['holdKeyboard']
+		},
+		// 最大输入长度，设置为 -1 的时候不限制最大长度
+		maxlength: {
+			type: [String, Number],
+			default: crtProp['maxlength']
+		},
+		// 边框类型，surround-四周边框，bottom-底部边框
+		border: {
+			type: String,
+			default: crtProp['border']
+		},
+		// 用于处理或者过滤输入框内容的方法
+		formatter: {
+			type: [Function],
+			default: crtProp['formatter']
+		},
+		// 是否忽略组件内对文本合成系统事件的处理
+		ignoreCompositionEvent: {
+			type: Boolean,
+			default: true
+		}
+	}
+})

package/components/up-textarea/textarea.js

@@ -0,0 +1,40 @@
+/*
+ * @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/textarea.js
+ */
+export default {
+	// textarea 组件
+	textarea: {
+		value: '',
+		placeholder: '',
+		placeholderClass: 'textarea-placeholder',
+		placeholderStyle: 'color: #c0c4cc',
+		height: 70,
+		// 与 uni-app textarea 原生默认值保持一致：return 表示回车换行；
+		// 取 done/go/next/search/send 时回车会触发 confirm 且不换行
+		confirmType: 'return',
+		// 点击键盘右下角按钮时是否保持键盘不收起，confirmType 非 return 时有效
+		confirmHold: false,
+		disabled: false,
+		count: false,
+		focus: false,
+		autoHeight: false,
+		fixed: false,
+		cursorSpacing: 0,
+		cursor: '',
+		showConfirmBar: true,
+		selectionStart: -1,
+		selectionEnd: -1,
+		adjustPosition: true,
+		disableDefaultPadding: false,
+		holdKeyboard: false,
+		maxlength: 140,
+		border: 'surround',
+		formatter: null
+	}
+}

package/components/up-textarea/textarea.uts

@@ -0,0 +1,40 @@
+/*
+ * @Author       : jry
+ * @Description  :
+ * @version      : 4.0
+ * @Date         : 2021-08-30 14:00:21
+ * @LastAuthor   : jry
+ * @lastTime     : 2024-08-30 14:00:58
+ * @FilePath     : /uview-ultra/libs/config/props/textarea
+ */
+export default {
+	// textarea 组件
+	textarea: {
+		value: '',
+		placeholder: '',
+		placeholderClass: 'textarea-placeholder',
+		placeholderStyle: 'color: #c0c4cc',
+		height: 70,
+		// 与 uni-app textarea 原生默认值保持一致：return 表示回车换行；
+		// 取 done/go/next/search/send 时回车会触发 confirm 且不换行
+		confirmType: 'return',
+		// 点击键盘右下角按钮时是否保持键盘不收起，confirmType 非 return 时有效
+		confirmHold: false,
+		disabled: false,
+		count: false,
+		focus: false,
+		autoHeight: false,
+		fixed: false,
+		cursorSpacing: 0,
+		cursor: '',
+		showConfirmBar: true,
+		selectionStart: -1,
+		selectionEnd: -1,
+		adjustPosition: true,
+		disableDefaultPadding: false,
+		holdKeyboard: false,
+		maxlength: 140,
+		border: 'surround',
+		formatter: function() {}
+	}
+} as UTSJSONObject

package/components/up-textarea/up-textarea.uvue

@@ -0,0 +1,440 @@
+<template>
+    <view class="up-textarea" :class="textareaClass" :style="textareaStyle">
+        <textarea
+            class="up-textarea__field"
+            :value="innerValue"
+            :style="fieldStyle"
+            :placeholder="placeholder"
+            :placeholder-style="placeholderStyleValue"
+            :placeholder-class="placeholderClass"
+            :disabled="disabled"
+            :focus="focus"
+            :autoHeight="autoHeight"
+            :fixed="fixed"
+            :cursorSpacing="cursorSpacing"
+            :cursor="cursorValue"
+            :showConfirmBar="showConfirmBar"
+            :selectionStart="selectionStart"
+            :selectionEnd="selectionEnd"
+            :adjustPosition="adjustPosition"
+            :disableDefaultPadding="disableDefaultPadding"
+            :holdKeyboard="holdKeyboard"
+            :maxlength="maxlength"
+            :confirm-type="confirmType"
+            :confirm-hold="confirmHold"
+            :ignoreCompositionEvent="ignoreCompositionEvent"
+            @focus="onFocus"
+            @blur="onBlur"
+            @linechange="onLinechange"
+            @input="onInput"
+            @confirm="onConfirm"
+            @keyboardheightchange="onKeyboardheightchange"
+        ></textarea>
+		<!-- #ifndef MP-ALIPAY -->
+        <text
+            class="up-textarea__count"
+            :style="countStyle"
+            v-if="count"
+            >{{ valueLength }}/{{ maxlength }}</text
+        >
+		<!-- #endif -->
+    </view>
+</template>
+
+<script setup lang="uts">
+import { computed, getCurrentInstance, nextTick, ref, watch } from 'vue'
+import defProps from './textarea.uts'
+import defPropsInput from '../up-input/input.uts'
+import { addStyle, addUnit, deepMerge, formValidate } from '../../libs/function/index.uts';
+/**
+ * Textarea 文本域
+ * @author jry ijry@qq.com
+ * @description 文本域此组件满足了可能出现的表单信息补充，编辑等实际逻辑的功能，内置了字数校验等
+ * @tutorial https://ijry.github.io/uview-plus/components/textarea.html
+ *
+ * @property {String | Number} 		value					输入框的内容
+ * @property {String | Number}		placeholder				输入框为空时占位符
+ * @property {String}			    placeholderClass		指定placeholder的样式类，注意页面或组件的style中写了scoped时，需要在类名前写/deep/ （ 默认 'input-placeholder' ）
+ * @property {String | Object}	    placeholderStyle		指定placeholder的样式，字符串/对象形式，如"color: red;"
+ * @property {String | Number}		height					输入框高度（默认 70 ）
+ * @property {String}				confirmType				设置键盘右下角按钮的文字。为 'return' 时回车换行，取 'done'、'go'、'next'、'search'、'send' 时回车触发 confirm 且不换行（默认 'return' ）
+ * @property {Boolean}				confirmHold				点击键盘右下角按钮时是否保持键盘不收起，confirmType 非 'return' 时有效（默认 false ）
+ * @property {Boolean}				disabled				是否禁用（默认 false ）
+ * @property {Boolean}				count					是否显示统计字数（默认 false ）
+ * @property {Boolean}				focus					是否自动获取焦点，nvue不支持，H5取决于浏览器的实现（默认 false ）
+ * @property {Boolean | Function}	autoHeight				是否自动增加高度（默认 false ）
+ * @property {Boolean}				fixed					如果textarea是在一个position:fixed的区域，需要显示指定属性fixed为true（默认 false ）
+ * @property {Number}				cursorSpacing			指定光标与键盘的距离（默认 0 ）
+ * @property {String | Number}		cursor					指定focus时的光标位置
+ * @property {Function}			    formatter			    内容式化函数
+ * @property {Boolean}				showConfirmBar			是否显示键盘上方带有”完成“按钮那一栏，（默认 true ）
+ * @property {Number}				selectionStart			光标起始位置，自动聚焦时有效，需与selection-end搭配使用，（默认 -1 ）
+ * @property {Number | Number}		selectionEnd			光标结束位置，自动聚焦时有效，需与selection-start搭配使用（默认 -1 ）
+ * @property {Boolean}				adjustPosition			键盘弹起时，是否自动上推页面（默认 true ）
+ * @property {Boolean | Number}		disableDefaultPadding	是否去掉 iOS 下的默认内边距，只微信小程序有效（默认 false ）
+ * @property {Boolean}				holdKeyboard			focus时，点击页面的时候不收起键盘，只微信小程序有效（默认 false ）
+ * @property {String | Number}		maxlength				最大输入长度，设置为 -1 的时候不限制最大长度（默认 140 ）
+ * @property {String}				border					边框类型，surround-四周边框，none-无边框，bottom-底部边框（默认 'surround' ）
+ * @property {Boolean}				ignoreCompositionEvent	是否忽略组件内对文本合成系统事件的处理
+ *
+ * @event {Function(e)} focus					输入框聚焦时触发，event.detail = { value, height }，height 为键盘高度
+ * @event {Function(e)} blur					输入框失去焦点时触发，event.detail = {value, cursor}
+ * @event {Function(e)} linechange				输入框行数变化时调用，event.detail = {height: 0, heightRpx: 0, lineCount: 0}
+ * @event {Function(e)} input					当键盘输入时，触发 input 事件
+ * @event {Function(e)} confirm					点击完成时， 触发 confirm 事件
+ * @event {Function(e)} keyboardheightchange	键盘高度发生变化的时候触发此事件
+ * @example <up-textarea v-model="value1" placeholder="请输入内容" ></up-textarea>
+ */
+const defaultFormat = function(value: string): string {
+    return value
+}
+
+defineOptions({
+    styleIsolation: 'app-and-page',
+    name: 'up-textarea'
+})
+
+const props = defineProps({
+	// 输入框的内容
+	modelValue: {
+		type: [String, Number],
+		default: defProps.getAny('textarea.value')
+	},
+	// 输入框为空时占位符
+	placeholder: {
+		type: [String],
+		default: defProps.getString('textarea.placeholder')
+	},
+	// 指定placeholder的样式类，注意页面或组件的style中写了scoped时，需要在类名前写::v-deep
+	placeholderClass: {
+		type: String,
+		default: defPropsInput.getString('input.placeholderClass')
+	},
+	// 指定placeholder的样式
+	placeholderStyle: {
+		type: [String, Object],
+		default: defPropsInput.getString('input.placeholderStyle')
+	},
+	// 输入框高度
+	height: {
+		type: [String, Number],
+		default: defProps.getAny('textarea.height')
+	},
+	// 设置键盘右下角按钮的文字，仅微信小程序，App和H5有效
+	confirmType: {
+		type: String,
+		default: defProps.getString('textarea.confirmType')
+	},
+	confirmHold: {
+		type: Boolean,
+		default: defProps.getBoolean('textarea.confirmHold')
+	},
+	// 是否禁用
+	disabled: {
+		type: Boolean,
+		default: defProps.getBoolean('textarea.disabled')
+	},
+	// 是否显示统计字数
+	count: {
+		type: Boolean,
+		default: defProps.getBoolean('textarea.count')
+	},
+	// 是否自动获取焦点，nvue不支持，H5取决于浏览器的实现
+	focus: {
+		type: Boolean,
+		default: defProps.getBoolean('textarea.focus')
+	},
+	// 是否自动增加高度
+	autoHeight: {
+		type: Boolean,
+		default: defProps.getBoolean('textarea.autoHeight')
+	},
+	// 如果textarea是在一个position:fixed的区域，需要显示指定属性fixed为true
+	fixed: {
+		type: Boolean,
+		default: defProps.getBoolean('textarea.fixed')
+	},
+	// 指定光标与键盘的距离
+	cursorSpacing: {
+		type: Number,
+		default: defProps.getNumber('textarea.cursorSpacing')
+	},
+	// 指定focus时的光标位置
+	cursor: {
+		type: [String, Number],
+		default: defProps.getAny('textarea.cursor')
+	},
+	// 是否显示键盘上方带有”完成“按钮那一栏，
+	showConfirmBar: {
+		type: Boolean,
+		default: defProps.getBoolean('textarea.showConfirmBar')
+	},
+	// 光标起始位置，自动聚焦时有效，需与selection-end搭配使用
+	selectionStart: {
+		type: Number,
+		default: defProps.getNumber('textarea.selectionStart')
+	},
+	// 光标结束位置，自动聚焦时有效，需与selection-start搭配使用
+	selectionEnd: {
+		type: Number,
+		default: defProps.getNumber('textarea.selectionEnd')
+	},
+	// 键盘弹起时，是否自动上推页面
+	adjustPosition: {
+		type: Boolean,
+		default: defProps.getBoolean('textarea.adjustPosition')
+	},
+	// 是否去掉 iOS 下的默认内边距，只微信小程序有效
+	disableDefaultPadding: {
+		type: Boolean,
+		default: defProps.getBoolean('textarea.disableDefaultPadding')
+	},
+	// focus时，点击页面的时候不收起键盘，只微信小程序有效
+	holdKeyboard: {
+		type: Boolean,
+		default: defProps.getBoolean('textarea.holdKeyboard')
+	},
+	// 最大输入长度，设置为 -1 的时候不限制最大长度
+	maxlength: {
+		type: [String, Number],
+		default: defProps.getAny('textarea.maxlength')
+	},
+	// 边框类型，surround-四周边框，bottom-底部边框
+	border: {
+		type: String,
+		default: defProps.getString('textarea.border')
+	},
+	// 用于处理或者过滤输入框内容的方法
+	formatter: {
+		type: [Function],
+		default: defProps.getAny('textarea.formatter')
+	},
+	// 是否忽略组件内对文本合成系统事件的处理
+	ignoreCompositionEvent: {
+		type: Boolean,
+		default: true
+	},
+    customStyle: {
+        type: [Object, String],
+        default: () => ({})
+    }
+})
+
+const emit = defineEmits(['update:modelValue', 'linechange', 'focus', 'blur', 'change', 'confirm', 'keyboardheightchange'])
+const instance = getCurrentInstance()!.proxy!
+// 输入框的值
+const innerValue = ref('')
+// 是否处于获得焦点状态
+const focused = ref(false)
+// value是否第一次变化，在watch中，由于加入immediate属性，会在第一次触发，此时不应该认为value发生了变化
+const firstChange = ref(true)
+// value绑定值的变化是由内部还是外部引起的
+const changeFromInner = ref(false)
+// 过滤处理方法
+const innerFormatter = ref<Function>(defaultFormat as Function)
+
+const normalizeValue = (value: any): string => {
+	if (value === null || typeof value === 'undefined') return ''
+	return value.toString()
+}
+
+// 内容发生变化，进行处理
+const valueChange = (): void => {
+    const value = innerValue.value;
+    nextTick(() => {
+        emit('update:modelValue', value);
+        // 标识value值的变化是由内部引起的
+        changeFromInner.value = true;
+        emit('change', value);
+        // 尝试调用up-form的验证方法
+        formValidate(instance, 'change');
+    });
+}
+
+watch((): any => props.modelValue, (newVal: any) => {
+    innerValue.value = normalizeValue(newVal);
+    /* #ifdef H5 */
+    // 在H5中，外部value变化后，修改input中的值，不会触发@input事件，此时手动调用值变化方法
+    if (
+        firstChange.value === false &&
+        changeFromInner.value === false
+    ) {
+        valueChange();
+    }
+    /* #endif */
+    firstChange.value = false;
+    // 重置changeFromInner的值为false，标识下一次引起默认为外部引起的
+    changeFromInner.value = false;
+}, { immediate: true })
+
+// 字数统计安全取值，避免 v-model 为 null/undefined/number 时访问 length 报错
+const valueLength = computed((): number => {
+    return normalizeValue(innerValue.value).length
+})
+
+// 组件的类名
+const textareaClass = computed((): string => {
+    let classes: string[] = []
+    if (props.border === 'surround') {
+        (classes = classes.concat(['up-border', 'up-textarea--radius']));
+    }
+    if (props.border === 'bottom') {
+        (classes = classes.concat([
+            'up-border-bottom',
+            'up-textarea--no-radius',
+        ]));
+    }
+    if (props.disabled) {
+        classes.push('up-textarea--disabled');
+    }
+    return classes.join(' ');
+})
+
+// 组件的样式
+const textareaStyle = computed((): UTSJSONObject => {
+    const style = {} as UTSJSONObject
+    return deepMerge(style, addStyle(props.customStyle)) as UTSJSONObject
+})
+
+const fieldStyle = computed((): UTSJSONObject => {
+    return {
+        height: addUnit(props.height)
+    } as UTSJSONObject
+})
+
+const placeholderStyleValue = computed((): string => {
+// 原生 textarea 的 placeholder-style 只接受字符串，这里统一转成 CSS 字符串
+return addStyle(props.placeholderStyle, 'string') as string
+})
+
+const cursorValue = computed((): number => {
+
+	// 原生 textarea 的 cursor 只接受数字，-1 表示不指定位置
+
+	const c = props.cursor
+
+	if (typeof c === 'number') return c
+
+	const parsed = parseInt(c.toString())
+
+	return isNaN(parsed) ? -1 : parsed
+
+})
+
+
+const countStyle = computed((): UTSJSONObject => {
+    return {
+        backgroundColor: props.disabled ? 'transparent' : '#fff'
+    } as UTSJSONObject
+})
+
+// 在微信小程序中，不支持将函数当做props参数，故只能通过ref形式调用
+const setFormatter = (e: Function): void => {
+	innerFormatter.value = e
+}
+
+const onFocus = (e: UniTextareaFocusEvent): void => {
+    emit('focus', e)
+}
+
+const onBlur = (e: UniTextareaBlurEvent): void => {
+    emit('blur', e)
+    // 尝试调用up-form的验证方法
+    formValidate(instance, 'blur')
+}
+
+const onLinechange = (e: UniTextareaLineChangeEvent): void => {
+    emit('linechange', e)
+}
+
+const onInput = (e: UniInputEvent): void => {
+	let value = normalizeValue(e.detail.value)
+	// 格式化过滤方法
+    // todox
+    // const formatter = props.formatter || innerFormatter.value
+	// const formatter = innerFormatter.value
+	// todo
+	// const formatValue = formatter(value)
+	const formatValue = normalizeValue(value)
+	// 为了避免props的单向数据流特性，需要先将innerValue值设置为当前值，再在$nextTick中重新赋予设置后的值才有效
+	innerValue.value = value
+	nextTick(() => {
+		innerValue.value = formatValue;
+		valueChange();
+	})
+}
+
+const onConfirm = (e: UniInputConfirmEvent): void => {
+    emit('confirm', e);
+}
+
+const onKeyboardheightchange = (e: UniInputKeyboardHeightChangeEvent): void => {
+    emit('keyboardheightchange', e);
+}
+
+defineExpose({
+    innerValue,
+    focused,
+    firstChange,
+    changeFromInner,
+    innerFormatter,
+    valueLength,
+    textareaClass,
+    textareaStyle,
+    fieldStyle,
+    placeholderStyleValue,
+    cursorValue,
+    countStyle,
+    normalizeValue,
+    setFormatter,
+    onFocus,
+    onBlur,
+    onLinechange,
+    onInput,
+    valueChange,
+    onConfirm,
+    onKeyboardheightchange
+})
+</script>
+
+<style lang="scss" scoped>
+@import "../../libs/css/components.scss";
+
+.up-textarea {
+    border-radius: 4px;
+    background-color: #fff;
+    position: relative;
+    @include flex;
+    flex: 1;
+	padding: 9px;
+
+    &--radius {
+        border-radius: 4px;
+    }
+
+    &--no-radius {
+        border-radius: 0;
+    }
+
+    &--disabled {
+        background-color: #f5f7fa;
+    }
+
+    &__field {
+        flex: 1;
+        font-size: 15px;
+        color: $up-content-color;
+		width: 100%;
+    }
+
+    &__count {
+        position: absolute;
+        right: 5px;
+        bottom: 2px;
+        font-size: 12px;
+        color: $up-tips-color;
+        background-color: #ffffff;
+        padding: 1px 4px;
+    }
+}
+</style>