vue3.0 ElementPlus 中文版入门教程 ElementPlus Descriptions 描述列表

2024-02-25 开发教程 vue3.0 ElementPlus 中文版入门教程 匿名 19

Descriptions 描述列表

列表形式展示多个字段。

基础用法

<template>
<el-descriptions title="用户信息">
<el-descriptions-item label="用户名">kooriookami</el-descriptions-item>
<el-descriptions-item label="手机号">18100000000</el-descriptions-item>
<el-descriptions-item label="居住地">苏州市</el-descriptions-item>
<el-descriptions-item label="备注">
<el-tag size="small">学校</el-tag>
</el-descriptions-item>
<el-descriptions-item label="联系地址"
>江苏省苏州市吴中区吴中大道 1188 号</el-descriptions-item
>
</el-descriptions>
</template>

不同尺寸

<template>
<el-radio-group v-model="size">
<el-radio label="">默认</el-radio>
<el-radio label="medium">中等</el-radio>
<el-radio label="small">小型</el-radio>
<el-radio label="mini">超小</el-radio>
</el-radio-group>
<el-descriptions
class="margin-top"
title="带边框列表"
:column="3"
:size="size"
border
>
<template #extra>
<el-button type="primary" size="small">操作</el-button>
</template>
<el-descriptions-item>
<template #label>
<i class="el-icon-user"></i>
用户名
</template>
kooriookami
</el-descriptions-item>
<el-descriptions-item>
<template #label>
<i class="el-icon-mobile-phone"></i>
手机号
</template>
18100000000
</el-descriptions-item>
<el-descriptions-item>
<template #label>
<i class="el-icon-location-outline"></i>
居住地
</template>
苏州市
</el-descriptions-item>
<el-descriptions-item>
<template #label>
<i class="el-icon-tickets"></i>
备注
</template>
<el-tag size="small">学校</el-tag>
</el-descriptions-item>
<el-descriptions-item>
<template #label>
<i class="el-icon-office-building"></i>
联系地址
</template>
江苏省苏州市吴中区吴中大道 1188 号
</el-descriptions-item>
</el-descriptions>
<el-descriptions
class="margin-top"
title="无边框列表"
:column="3"
:size="size"
>
<template #extra>
<el-button type="primary" size="small">操作</el-button>
</template>
<el-descriptions-item label="用户名">kooriookami</el-descriptions-item>
<el-descriptions-item label="手机号">18100000000</el-descriptions-item>
<el-descriptions-item label="居住地">苏州市</el-descriptions-item>
<el-descriptions-item label="备注">
<el-tag size="small">学校</el-tag>
</el-descriptions-item>
<el-descriptions-item label="联系地址"
>江苏省苏州市吴中区吴中大道 1188 号</el-descriptions-item
>
</el-descriptions>
</template>
<script>
export default {
data() {
return {
size: '',
}
},
}
</script>

垂直列表

<template>
<el-descriptions title="垂直带边框列表" direction="vertical" :column="4" border>
<el-descriptions-item label="用户名">kooriookami</el-descriptions-item>
<el-descriptions-item label="手机号">18100000000</el-descriptions-item>
<el-descriptions-item label="居住地" :span="2">苏州市</el-descriptions-item>
<el-descriptions-item label="备注">
<el-tag size="small">学校</el-tag>
</el-descriptions-item>
<el-descriptions-item label="联系地址"
>江苏省苏州市吴中区吴中大道 1188 号</el-descriptions-item
>
</el-descriptions>
<el-descriptions
class="margin-top"
title="垂直无边框列表"
:column="4"
direction="vertical"
>
<el-descriptions-item label="用户名">kooriookami</el-descriptions-item>
<el-descriptions-item label="手机号">18100000000</el-descriptions-item>
<el-descriptions-item label="居住地" :span="2">苏州市</el-descriptions-item>
<el-descriptions-item label="备注">
<el-tag size="small">学校</el-tag>
</el-descriptions-item>
<el-descriptions-item label="联系地址"
>江苏省苏州市吴中区吴中大道 1188 号</el-descriptions-item
>
</el-descriptions>
</template>

自定义样式

<template>
<el-descriptions title="自定义样式列表" :column="3" border>
<el-descriptions-item
label="用户名"
label-align="right"
align="center"
label-class-name="my-label"
class-name="my-content"
width="150px"
>kooriookami</el-descriptions-item
>
<el-descriptions-item label="手机号" label-align="right" align="center"
>18100000000</el-descriptions-item
>
<el-descriptions-item label="居住地" label-align="right" align="center"
>苏州市</el-descriptions-item
>
<el-descriptions-item label="备注" label-align="right" align="center">
<el-tag size="small">学校</el-tag>
</el-descriptions-item>
<el-descriptions-item label="联系地址" label-align="right" align="center"
>江苏省苏州市吴中区吴中大道 1188 号</el-descriptions-item
>
</el-descriptions>
</template>

Descriptions Attributes

参数说明类型可选值默认值
border是否带有边框booleanfalse
column一行 Descriptions Item的数量number3
direction排列的方向stringvertical / horizontalhorizontal
size列表的尺寸stringmedium / small / mini
title标题文本,显示在左上方string
extra操作区文本,显示在右上方string

Descriptions Slots

Name说明
title自定义标题,显示在左上方
extra自定义操作区,显示在右上方

Descriptions Item Attributes

参数说明类型可选值默认值
label标签文本string
span列的数量number1
width列的宽度,不同行相同列的宽度按最大值设定(如无 border,宽度包含标签与内容)string / number
min-width列的最小宽度,与 width的区别是 width是固定的,min-width会把剩余宽度按比例分配给设置了 min-width的列(如无 border,宽度包含标签与内容)string / number
align列的内容对齐方式(如无 border,对标签和内容均生效)stringleft / center / rightleft
label-align列的标签对齐方式,若不设置该项,则使用内容的对齐方式(如无 border,请使用 align参数)stringleft / center / right
class-name列的内容自定义类名string
label-class-name列的标签自定义类名string

Descriptions Item Slots

Name说明
label自定义标签文本