pco/app/uview-ui/components/u-textarea/u-textarea.vue

<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"
            @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        输入框为空时占位符
 * @property {String}          placeholderClass    指定placeholder的样式类，注意页面或组件的style中写了scoped时，需要在类名前写/deep/ （ 默认 'input-placeholder' ）
 * @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' ）
 *
 * @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>