自定义 elementUI 描述列表组件

SegmentFault

共 8913字,需浏览 18分钟

 ·

2021-02-26 13:20

作者:大橙子
来源:SegmentFault 思否社区




前言


以前用 ant design vue,组件特别多。里面有一个描述组件很好用(


后来切换到 element 发现没有这种组件,每次都需要自己编写。但是一个项目界面风格要统一,每次都复制代码很是麻烦,而且如果要改样式,那么就是一个炸弹呀,还不得累死。一咬牙,一跺脚,自己写一个吧。




组件设计思路


  1. 使用父子组件嵌套实现,父组件为 el-description , 子组件为 el-description-item 。

  2. el-description-item 要保证默认显示 label 和 value ,而且还可以使用 slot 来定制内容

  3. 利用 vue 的 $slot.content是否存在来实现子组件的内容定制,不存在则显示默认 value,存在则表示是定制内容

  4. 利用 el-row 和 el-col 来实现栅格布局




组件开发


  • 父组件 el-description


  • <template>
      <div class="descriptions">
        <div v-if="Boolean(title)" class="descriptions-title">{{ title }}</div>
        <div class="descriptions-view">
          <el-row class="descriptions-row">
            <slot v-if="$slots.default" />
            <div v-else style="text-align: center; color: grey;">暂无数据</div>
          </el-row>
        </div>
      </div>
    </template>

    <script>
    export default {
      name: 'ElDescription',
      props: {
        title: {
          type: String,
          required: false,
          default: ''
        }
      }
    }
    </script>

    <style scoped lang="scss">
      .descriptions{
        .descriptions-title{
          margin-bottom: 20px;
          color: rgba(0,0,0,.85);
          font-weight: 700;
          font-size: 16px;
          line-height: 1.5;
        }
        .descriptions-view{
          width: 100%;
          overflow: hidden;
          table{
            width: 100%;
            table-layout: fixed;
            border-collapse: collapse;
          }
          .descriptions-row{

          }
        }

      }

    </style>


  • 子组件 el-description-item


  • <template>
      <el-col
        :span="span"
        :xs="spanMap.xs"
        :sm="spanMap.sm"
        :md="spanMap.md"
        :lg="spanMap.lg"
        :xl="spanMap.xl"
        class="descriptions-item"
      >
        <div class="descriptions-item-content">
          <div class="descriptions-item-label">{{ label }}:</div>
          <div class="descriptions-item-value">
            <slot v-if="$slots.content" name="content" />
            <div v-else class="default-value" :title="value">{{ value }}</div>
          </div>
        </div>
      </el-col>
    </template>

    <script>
    export default {
      name: 'ElDescriptionItem',
      props: {
        spanMap: {
          type: Object,
          required: false,
          default: () => { return { } }
        },
        span: {
          type: Number,
          required: false,
          default: 6
        },
        label: {
          required: true
        },
        value: {
          required: false,
          default() {
            return ''
          }
        }
      }

    }
    </script>

    <style scoped lang="scss">
      .descriptions-item {
        padding-bottom: 16px;
        padding-right: 20px;
        span {
          display: inline-block;
        }
        .descriptions-item-content {
          display: flex;
          justify-content: flex-start;
          align-items: center;
          color: rgba(0,0,0,.65);
          font-size: 14px;
          line-height: 1.5;
          width: 100%;
          .descriptions-item-label{
            flex-grow: 0;
            flex-shrink: 0;
            color: rgba(0,0,0,.85);
            font-weight: 400;
            font-size: 14px;
            line-height: 1.5;
          }
          .descriptions-item-value{
            flex-grow: 1;
            overflow: hidden;
            .default-value{
              overflow: hidden;
              text-overflow: ellipsis;
              white-space: nowrap;
            }
          }
        }
      }
    </style>




组件使用


  • 组件引用


  • // 引入组件
    import ElDescription from '@/components/ElDescription'
    import ElDescriptionItem from '@/components/ElDescriptionItem'

    export default {
    // 声明组件
      components: { ElDescription, ElDescriptionItem }
    }
  • 组件使用

        
  •     <!-- 可以使用span 和 span-map对象来控制栅格的大小 -->
        <el-description title="测试数据">
          <el-description-item label="标题1" value="我是内容1" :span-map="{xl:8}" />
          <el-description-item label="标题2" value="我是内容2" :span="6" />
          <el-description-item label="标题3" value="超长文本省略号显示,超长文本省略号显示,超长文本省略号显示,超长文本省略号显示,超长文本省略号显示," />
          <el-description-item label="标题4" value="我是内容4" :span="8" :span-map="{md:12}" />
          <el-description-item label="标题5" value="我是内容5" />
          <el-description-item label="标题6" value="我是内容6" />
          <el-description-item label="标题7" value="我是内容7" />
          <el-description-item label="标题8" value="我是内容8" />
          <el-description-item label="定制">
            <!--  使用名称为conent的slot来定制-->
            <template slot="content">
              <div style="color: red;">
                我是定制内容
              </div>
            </template>
          </el-description-item>
        </el-description>


  • 显示效果




点击左下角阅读原文,到 SegmentFault 思否社区 和文章作者展开更多互动和交流,扫描下方”二维码“或在“公众号后台回复“ 入群 ”即可加入我们的技术交流群,收获更多的技术文章~

- END -


浏览 30
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报