2025-03-23 09:29:40 +08:00
|
|
|
|
<template>
|
|
|
|
|
|
<view class="u-textarea" :class="textareaClass" :style="[textareaStyle]">
|
|
|
|
|
|
<textarea
|
|
|
|
|
|
class="u-textarea__field"
|
|
|
|
|
|
:value="innerValue"
|
|
|
|
|
|
:style="{ height: $u.addUnit(height) }"
|
|
|
|
|
|
:placeholder="placeholder"
|
|
|
|
|
|
:placeholder-style="$u.addStyle(placeholderStyle, 'string')"
|
|
|
|
|
|
:placeholder-class="placeholderClass"
|
|
|
|
|
|
:disabled="disabled"
|
|
|
|
|
|
:focus="focus"
|
|
|
|
|
|
:autoHeight="autoHeight"
|
|
|
|
|
|
:fixed="fixed"
|
|
|
|
|
|
:cursorSpacing="cursorSpacing"
|
|
|
|
|
|
:cursor="cursor"
|
|
|
|
|
|
:showConfirmBar="showConfirmBar"
|
|
|
|
|
|
:selectionStart="selectionStart"
|
|
|
|
|
|
:selectionEnd="selectionEnd"
|
|
|
|
|
|
:adjustPosition="adjustPosition"
|
|
|
|
|
|
:disableDefaultPadding="disableDefaultPadding"
|
|
|
|
|
|
:holdKeyboard="holdKeyboard"
|
|
|
|
|
|
:maxlength="maxlength"
|
|
|
|
|
|
:confirmType="confirmType"
|
|
|
|
|
|
:ignoreCompositionEvent="ignoreCompositionEvent"
|
|
|
|
|
|
@focus="onFocus"
|
|
|
|
|
|
@blur="onBlur"
|
|
|
|
|
|
@linechange="onLinechange"
|
|
|
|
|
|
@input="onInput"
|
|
|
|
|
|
@confirm="onConfirm"
|
|
|
|
|
|
@keyboardheightchange="onKeyboardheightchange"
|
|
|
|
|
|
></textarea>
|
|
|
|
|
|
<text
|
|
|
|
|
|
class="u-textarea__count"
|
|
|
|
|
|
:style="{
|
|
|
|
|
|
'background-color': disabled ? 'transparent' : '#fff',
|
|
|
|
|
|
}"
|
|
|
|
|
|
v-if="count"
|
|
|
|
|
|
>{{ innerValue.length }}/{{ maxlength }}</text
|
|
|
|
|
|
>
|
|
|
|
|
|
</view>
|
|
|
|
|
|
</template>
|
|
|
|
|
|
|
|
|
|
|
|
<script>
|
|
|
|
|
|
import props from "./props.js";
|
|
|
|
|
|
/**
|
|
|
|
|
|
* Textarea 文本域
|
|
|
|
|
|
* @description 文本域此组件满足了可能出现的表单信息补充，编辑等实际逻辑的功能，内置了字数校验等
|
|
|
|
|
|
* @tutorial https://www.uviewui.com/components/textarea.html
|
|
|
|
|
|
*
|
|
|
|
|
|
* @property {String | Number} value 输入框的内容
|
|
|
|
|
|
* @property {String | Number} placeholder 输入框为空时占位符
|
2025-04-01 17:06:24 +08:00
|
|
|
|
* @property {String} placeholderClass 指定placeholder的样式类，注意页面或组件的style中写了scoped时，需要在类名前写:v-deep （ 默认 'input-placeholder' ）
|
2025-03-23 09:29:40 +08:00
|
|
|
|
* @property {String | Object} placeholderStyle 指定placeholder的样式，字符串/对象形式，如"color: red;"
|
|
|
|
|
|
* @property {String | Number} height 输入框高度（默认 70 ）
|
|
|
|
|
|
* @property {String} confirmType 设置键盘右下角按钮的文字，仅微信小程序，App-vue和H5有效（默认 'done' ）
|
|
|
|
|
|
* @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 <u--textarea v-model="value1" placeholder="请输入内容" ></u--textarea>
|
|
|
|
|
|
*/
|
|
|
|
|
|
export default {
|
|
|
|
|
|
name: "u-textarea",
|
|
|
|
|
|
mixins: [uni.$u.mpMixin, uni.$u.mixin, props],
|
|
|
|
|
|
data() {
|
|
|
|
|
|
return {
|
|
|
|
|
|
// 输入框的值
|
|
|
|
|
|
innerValue: "",
|
|
|
|
|
|
// 是否处于获得焦点状态
|
|
|
|
|
|
focused: false,
|
|
|
|
|
|
// value是否第一次变化，在watch中，由于加入immediate属性，会在第一次触发，此时不应该认为value发生了变化
|
|
|
|
|
|
firstChange: true,
|
|
|
|
|
|
// value绑定值的变化是由内部还是外部引起的
|
|
|
|
|
|
changeFromInner: false,
|
|
|
|
|
|
// 过滤处理方法
|
|
|
|
|
|
innerFormatter: value => value
|
|
|
|
|
|
}
|
|
|
|
|
|
},
|
|
|
|
|
|
watch: {
|
|
|
|
|
|
value: {
|
|
|
|
|
|
immediate: true,
|
|
|
|
|
|
handler(newVal, oldVal) {
|
|
|
|
|
|
this.innerValue = newVal;
|
|
|
|
|
|
/* #ifdef H5 */
|
|
|
|
|
|
// 在H5中，外部value变化后，修改input中的值，不会触发@input事件，此时手动调用值变化方法
|
|
|
|
|
|
if (
|
|
|
|
|
|
this.firstChange === false &&
|
|
|
|
|
|
this.changeFromInner === false
|
|
|
|
|
|
) {
|
|
|
|
|
|
this.valueChange();
|
|
|
|
|
|
}
|
|
|
|
|
|
/* #endif */
|
|
|
|
|
|
this.firstChange = false;
|
|
|
|
|
|
// 重置changeFromInner的值为false，标识下一次引起默认为外部引起的
|
|
|
|
|
|
this.changeFromInner = false;
|
|
|
|
|
|
},
|
|
|
|
|
|
},
|
|
|
|
|
|
},
|
|
|
|
|
|
computed: {
|
|
|
|
|
|
// 组件的类名
|
|
|
|
|
|
textareaClass() {
|
|
|
|
|
|
let classes = [],
|
|
|
|
|
|
{ border, disabled, shape } = this;
|
|
|
|
|
|
border === "surround" &&
|
|
|
|
|
|
(classes = classes.concat(["u-border", "u-textarea--radius"]));
|
|
|
|
|
|
border === "bottom" &&
|
|
|
|
|
|
(classes = classes.concat([
|
|
|
|
|
|
"u-border-bottom",
|
|
|
|
|
|
"u-textarea--no-radius",
|
|
|
|
|
|
]));
|
|
|
|
|
|
disabled && classes.push("u-textarea--disabled");
|
|
|
|
|
|
return classes.join(" ");
|
|
|
|
|
|
},
|
|
|
|
|
|
// 组件的样式
|
|
|
|
|
|
textareaStyle() {
|
|
|
|
|
|
const style = {};
|
|
|
|
|
|
// #ifdef APP-NVUE
|
|
|
|
|
|
// 由于textarea在安卓nvue上的差异性，需要额外再调整其内边距
|
|
|
|
|
|
if (uni.$u.os() === "android") {
|
|
|
|
|
|
style.paddingTop = "6px";
|
|
|
|
|
|
style.paddingLeft = "9px";
|
|
|
|
|
|
style.paddingBottom = "3px";
|
|
|
|
|
|
style.paddingRight = "6px";
|
|
|
|
|
|
}
|
|
|
|
|
|
// #endif
|
|
|
|
|
|
return uni.$u.deepMerge(style, uni.$u.addStyle(this.customStyle));
|
|
|
|
|
|
},
|
|
|
|
|
|
},
|
|
|
|
|
|
methods: {
|
|
|
|
|
|
// 在微信小程序中，不支持将函数当做props参数，故只能通过ref形式调用
|
|
|
|
|
|
setFormatter(e) {
|
|
|
|
|
|
this.innerFormatter = e
|
|
|
|
|
|
},
|
|
|
|
|
|
onFocus(e) {
|
|
|
|
|
|
this.$emit("focus", e);
|
|
|
|
|
|
},
|
|
|
|
|
|
onBlur(e) {
|
|
|
|
|
|
this.$emit("blur", e);
|
|
|
|
|
|
// 尝试调用u-form的验证方法
|
|
|
|
|
|
uni.$u.formValidate(this, "blur");
|
|
|
|
|
|
},
|
|
|
|
|
|
onLinechange(e) {
|
|
|
|
|
|
this.$emit("linechange", e);
|
|
|
|
|
|
},
|
|
|
|
|
|
onInput(e) {
|
|
|
|
|
|
let { value = "" } = e.detail || {};
|
|
|
|
|
|
// 格式化过滤方法
|
|
|
|
|
|
const formatter = this.formatter || this.innerFormatter
|
|
|
|
|
|
const formatValue = formatter(value)
|
|
|
|
|
|
// 为了避免props的单向数据流特性，需要先将innerValue值设置为当前值，再在$nextTick中重新赋予设置后的值才有效
|
|
|
|
|
|
this.innerValue = value
|
|
|
|
|
|
this.$nextTick(() => {
|
|
|
|
|
|
this.innerValue = formatValue;
|
|
|
|
|
|
this.valueChange();
|
|
|
|
|
|
})
|
|
|
|
|
|
},
|
|
|
|
|
|
// 内容发生变化，进行处理
|
|
|
|
|
|
valueChange() {
|
|
|
|
|
|
const value = this.innerValue;
|
|
|
|
|
|
this.$nextTick(() => {
|
|
|
|
|
|
this.$emit("input", value);
|
|
|
|
|
|
// 标识value值的变化是由内部引起的
|
|
|
|
|
|
this.changeFromInner = true;
|
|
|
|
|
|
this.$emit("change", value);
|
|
|
|
|
|
// 尝试调用u-form的验证方法
|
|
|
|
|
|
uni.$u.formValidate(this, "change");
|
|
|
|
|
|
});
|
|
|
|
|
|
},
|
|
|
|
|
|
onConfirm(e) {
|
|
|
|
|
|
this.$emit("confirm", e);
|
|
|
|
|
|
},
|
|
|
|
|
|
onKeyboardheightchange(e) {
|
|
|
|
|
|
this.$emit("keyboardheightchange", e);
|
|
|
|
|
|
},
|
|
|
|
|
|
},
|
|
|
|
|
|
};
|
|
|
|
|
|
</script>
|
|
|
|
|
|
|
|
|
|
|
|
<style lang="scss" scoped>
|
|
|
|
|
|
@import "../../libs/css/components.scss";
|
|
|
|
|
|
|
|
|
|
|
|
.u-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: $u-content-color;
|
|
|
|
|
|
width: 100%;
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
&__count {
|
|
|
|
|
|
position: absolute;
|
|
|
|
|
|
right: 5px;
|
|
|
|
|
|
bottom: 2px;
|
|
|
|
|
|
font-size: 12px;
|
|
|
|
|
|
color: $u-tips-color;
|
|
|
|
|
|
background-color: #ffffff;
|
|
|
|
|
|
padding: 1px 4px;
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
</style>
|
