quanyawei
2024-03-01 bd99a5211f3a5fcaa051e5da868d87bb870148f5
uni_modules/uview-ui/components/u-cell/u-cell.vue
New file
@@ -0,0 +1,229 @@
<template>
   <view class="u-cell" :class="[customClass]" :style="[$u.addStyle(customStyle)]"
      :hover-class="(!disabled && (clickable || isLink)) ? 'u-cell--clickable' : ''" :hover-stay-time="250"
      @tap="clickHandler">
      <view class="u-cell__body" :class="[ center && 'u-cell--center', size === 'large' && 'u-cell__body--large']">
         <view class="u-cell__body__content">
            <view class="u-cell__left-icon-wrap" v-if="$slots.icon || icon">
               <slot name="icon" v-if="$slots.icon">
               </slot>
               <u-icon v-else :name="icon" :custom-style="iconStyle" :size="size === 'large' ? 22 : 18"></u-icon>
            </view>
            <view class="u-cell__title">
               <slot name="title">
                  <text v-if="title" class="u-cell__title-text" :style="[titleTextStyle]"
                     :class="[disabled && 'u-cell--disabled', size === 'large' && 'u-cell__title-text--large']">{{ title }}</text>
               </slot>
               <slot name="label">
                  <text class="u-cell__label" v-if="label"
                     :class="[disabled && 'u-cell--disabled', size === 'large' && 'u-cell__label--large']">{{ label }}</text>
               </slot>
            </view>
         </view>
         <slot name="value">
            <text class="u-cell__value"
               :class="[disabled && 'u-cell--disabled', size === 'large' && 'u-cell__value--large']"
               v-if="!$u.test.empty(value)">{{ value }}</text>
         </slot>
         <view class="u-cell__right-icon-wrap" v-if="$slots['right-icon'] || isLink"
            :class="[`u-cell__right-icon-wrap--${arrowDirection}`]">
            <slot name="right-icon" v-if="$slots['right-icon']">
            </slot>
            <u-icon v-else :name="rightIcon" :custom-style="rightIconStyle" :color="disabled ? '#c8c9cc' : 'info'"
               :size="size === 'large' ? 18 : 16"></u-icon>
         </view>
      </view>
      <u-line v-if="border"></u-line>
   </view>
</template>
<script>
   import props from './props.js';
   /**
    * cell  单元格
    * @description cell单元格一般用于一组列表的情况,比如个人中心页,设置页等。
    * @tutorial https://uviewui.com/components/cell.html
    * @property {String | Number}   title         标题
    * @property {String | Number}   label         标题下方的描述信息
    * @property {String | Number}   value         右侧的内容
    * @property {String}         icon         左侧图标名称,或者图片链接(本地文件建议使用绝对地址)
    * @property {Boolean}         disabled      是否禁用cell
    * @property {Boolean}         border         是否显示下边框 (默认 true )
    * @property {Boolean}         center         内容是否垂直居中(主要是针对右侧的value部分) (默认 false )
    * @property {String}         url            点击后跳转的URL地址
    * @property {String}         linkType      链接跳转的方式,内部使用的是uView封装的route方法,可能会进行拦截操作 (默认 'navigateTo' )
    * @property {Boolean}         clickable      是否开启点击反馈(表现为点击时加上灰色背景) (默认 false )
    * @property {Boolean}         isLink         是否展示右侧箭头并开启点击反馈 (默认 false )
    * @property {Boolean}         required      是否显示表单状态下的必填星号(此组件可能会内嵌入input组件) (默认 false )
    * @property {String}         rightIcon      右侧的图标箭头 (默认 'arrow-right')
    * @property {String}         arrowDirection   右侧箭头的方向,可选值为:left,up,down
    * @property {Object | String}         rightIconStyle   右侧箭头图标的样式
    * @property {Object | String}         titleStyle      标题的样式
    * @property {Object | String}         iconStyle      左侧图标样式
    * @property {String}         size         单位元的大小,可选值为 large,normal,mini
    * @property {Boolean}         stop         点击cell是否阻止事件传播 (默认 true )
    * @property {Object}         customStyle      定义需要用到的外部样式
    *
    * @event {Function}         click         点击cell列表时触发
    * @example 该组件需要搭配cell-group组件使用,见官方文档示例
    */
   export default {
      name: 'u-cell',
      data() {
         return {
         }
      },
      mixins: [uni.$u.mpMixin, uni.$u.mixin, props],
      computed: {
         titleTextStyle() {
            return uni.$u.addStyle(this.titleStyle)
         }
      },
      methods: {
         // 点击cell
         clickHandler(e) {
            if (this.disabled) return
            this.$emit('click', {
               name: this.name
            })
            // 如果配置了url(此props参数通过mixin引入)参数,跳转页面
            this.openPage()
            // 是否阻止事件传播
            this.stop && this.preventEvent(e)
         },
      }
   }
</script>
<style lang="scss" scoped>
   @import "../../libs/css/components.scss";
   $u-cell-padding: 10px 15px !default;
   $u-cell-font-size: 15px !default;
   $u-cell-line-height: 24px !default;
   $u-cell-color: $u-main-color !default;
   $u-cell-icon-size: 16px !default;
   $u-cell-title-font-size: 15px !default;
   $u-cell-title-line-height: 22px !default;
   $u-cell-title-color: $u-main-color !default;
   $u-cell-label-font-size: 12px !default;
   $u-cell-label-color: $u-tips-color !default;
   $u-cell-label-line-height: 18px !default;
   $u-cell-value-font-size: 14px !default;
   $u-cell-value-color: $u-content-color !default;
   $u-cell-clickable-color: $u-bg-color !default;
   $u-cell-disabled-color: #c8c9cc !default;
   $u-cell-padding-top-large: 13px !default;
   $u-cell-padding-bottom-large: 13px !default;
   $u-cell-value-font-size-large: 15px !default;
   $u-cell-label-font-size-large: 14px !default;
   $u-cell-title-font-size-large: 16px !default;
   $u-cell-left-icon-wrap-margin-right: 4px !default;
   $u-cell-right-icon-wrap-margin-left: 4px !default;
   $u-cell-title-flex:1 !default;
   $u-cell-label-margin-top:5px !default;
   .u-cell {
      &__body {
         @include flex();
         /* #ifndef APP-NVUE */
         box-sizing: border-box;
         /* #endif */
         padding: $u-cell-padding;
         font-size: $u-cell-font-size;
         color: $u-cell-color;
         // line-height: $u-cell-line-height;
         align-items: center;
         &__content {
            @include flex(row);
            align-items: center;
            flex: 1;
         }
         &--large {
            padding-top: $u-cell-padding-top-large;
            padding-bottom: $u-cell-padding-bottom-large;
         }
      }
      &__left-icon-wrap,
      &__right-icon-wrap {
         @include flex();
         align-items: center;
         // height: $u-cell-line-height;
         font-size: $u-cell-icon-size;
      }
      &__left-icon-wrap {
         margin-right: $u-cell-left-icon-wrap-margin-right;
      }
      &__right-icon-wrap {
         margin-left: $u-cell-right-icon-wrap-margin-left;
         transition: transform 0.3s;
         &--up {
            transform: rotate(-90deg);
         }
         &--down {
            transform: rotate(90deg);
         }
      }
      &__title {
         flex: $u-cell-title-flex;
         &-text {
            font-size: $u-cell-title-font-size;
            line-height: $u-cell-title-line-height;
            color: $u-cell-title-color;
            &--large {
               font-size: $u-cell-title-font-size-large;
            }
         }
      }
      &__label {
         margin-top: $u-cell-label-margin-top;
         font-size: $u-cell-label-font-size;
         color: $u-cell-label-color;
         line-height: $u-cell-label-line-height;
         &--large {
            font-size: $u-cell-label-font-size-large;
         }
      }
      &__value {
         text-align: right;
         font-size: $u-cell-value-font-size;
         line-height: $u-cell-line-height;
         color: $u-cell-value-color;
         &--large {
            font-size: $u-cell-value-font-size-large;
         }
      }
      &--clickable {
         background-color: $u-cell-clickable-color;
      }
      &--disabled {
         color: $u-cell-disabled-color;
         /* #ifndef APP-NVUE */
         cursor: not-allowed;
         /* #endif */
      }
      &--center {
         align-items: center;
      }
   }
</style>