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

<template>
  <view class="u-input" :class="inputClass" :style="[wrapperStyle]">
    <view class="u-input__content">
      <view
          class="u-input__content__prefix-icon"
          v-if="prefixIcon || $slots.prefix"
      >
        <slot name="prefix">
          <u-icon
              :name="prefixIcon"
              size="18"
              :customStyle="prefixIconStyle"
          ></u-icon>
        </slot>
      </view>
      <view class="u-input__content__field-wrapper" @tap="clickHandler">
        <!-- 根据uni-app的input组件文档，H5和APP中只要声明了password参数(无论true还是false)，type均失效，此时
          为了防止type=number时，又存在password属性，type无效，此时需要设置password为undefined
         -->
        <input
            class="u-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' || undefined"
            @input="onInput"
            @blur="onBlur"
            @focus="onFocus"
            @confirm="onConfirm"
            @keyboardheightchange="onkeyboardheightchange"
        />
      </view>
      <view
          class="u-input__content__clear"
          v-if="isShowClear"
          @tap="onClear"
      >
        <u-icon
            name="close"
            size="11"
            color="#ffffff"
            customStyle="line-height: 12px"
        ></u-icon>
      </view>
      <view
          class="u-input__content__subfix-icon"
          v-if="suffixIcon || $slots.suffix"
      >
        <slot name="suffix">
          <u-icon
              :name="suffixIcon"
              size="18"
              :customStyle="suffixIconStyle"
          ></u-icon>
        </slot>
      </view>
    </view>
  </view>
</template>

<script>
import props from "./props.js";

/**
 * Input 输入框
 * @description  此组件为一个输入框，默认没有边框和样式，是专门为配合表单组件u-form而设计的，利用它可以快速实现表单验证，输入内容，下拉选择等功能。
 * @tutorial https://uviewui.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 {String | 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时光标的位置（ 默认 -1 ）
 * @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        定义需要用到的外部样式
 *
 * @example <u-input v-model="value" :password="true" suffix-icon="lock-fill" />
 */
export default {
  name: "u-input",
  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: {
    // 是否显示清除控件
    isShowClear() {
      const {clearable, readonly, focused, innerValue} = this;
      return !!clearable && !readonly && !!focused && innerValue !== "";
    },
    // 组件的类名
    inputClass() {
      let classes = [],
          {border, disabled, shape} = this;
      border === "surround" &&
      (classes = classes.concat(["u-border", "u-input--radius"]));
      classes.push(`u-input--${shape}`);
      border === "bottom" &&
      (classes = classes.concat([
        "u-border-bottom",
        "u-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 uni.$u.deepMerge(style, uni.$u.addStyle(this.customStyle));
    },
    // 输入框的样式
    inputStyle() {
      const style = {
        color: this.color,
        fontSize: uni.$u.addUnit(this.fontSize),
        textAlign: this.inputAlign
      };
      return style;
    },
  },
  methods: {
    // 在微信小程序中，不支持将函数当做props参数，故只能通过ref形式调用
    setFormatter(e) {
      this.innerFormatter = e
    },
    // 当键盘输入时，触发input事件
    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();
      })
    },
    // 输入框失去焦点时触发
    onBlur(event) {
      this.$emit("blur", event.detail.value);
      // H5端的blur会先于点击清除控件的点击click事件触发，导致focused
      // 瞬间为false，从而隐藏了清除控件而无法被点击到
      uni.$u.sleep(50).then(() => {
        this.focused = false;
      });
      // 尝试调用u-form的验证方法
      uni.$u.formValidate(this, "blur");
    },
    // 输入框聚焦时触发
    onFocus(event) {
      this.focused = true;
      this.$emit("focus");
    },
    // 点击完成按钮时触发
    onConfirm(event) {
      this.$emit("confirm", this.innerValue);
    },
    // 键盘高度发生变化的时候触发此事件
    // 兼容性：微信小程序2.7.0+、App 3.1.0+
    onkeyboardheightchange() {
      this.$emit("keyboardheightchange");
    },
    // 内容发生变化，进行处理
    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");
      });
    },
    // 点击清除控件
    onClear() {
      this.innerValue = "";
      this.$nextTick(() => {
        this.valueChange();
        this.$emit("clear");
      });
    },
    /**
     * 在安卓nvue上，事件无法冒泡
     * 在某些时间，我们希望监听u-from-item的点击事件，此时会导致点击u-form-item内的u-input后
     * 无法触发u-form-item的点击事件，这里通过手动调用u-form-item的方法进行触发
     */
    clickHandler() {
      // #ifdef APP-NVUE
      if (uni.$u.os() === "android") {
        const formItem = uni.$u.$parent.call(this, "u-form-item");
        if (formItem) {
          formItem.clickHandler();
        }
      }
      // #endif
    },
  },
};
</script>

<style lang="scss" scoped>
@import "../../libs/css/components.scss";

.u-border {
  border: none;
}

.u-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: $u-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>