自定义 elementUI 描述列表组件

原文地址:http://isee.xyz/a/60370591cfe9924ea139030d

前言

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

组件设计思路

  1. 使用父子组件嵌套实现,父组件为 el-description , 子组件为 el-description-item
  2. el-description-item 要保证默认显示 labelvalue ,而且还可以使用 slot 来定制内容
  3. 利用 vue$slot.content是否存在来实现子组件的内容定制,不存在则显示默认 value,存在则表示是定制内容
  4. 利用 el-rowel-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>
    
  • 显示效果

    description.jpg
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,716评论 4 364
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,558评论 1 294
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 109,431评论 0 244
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,127评论 0 209
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,511评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,692评论 1 222
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,915评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,664评论 0 202
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,412评论 1 246
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,616评论 2 245
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,105评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,424评论 2 254
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,098评论 3 238
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,096评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,869评论 0 197
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,748评论 2 276
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,641评论 2 271

推荐阅读更多精彩内容