Descriptions

EasyDescriptions is an enhanced version based on Element Plus Descriptions component, supporting grouping, dynamic components, conditional rendering, etc.

Online Demo

基础用法

用户名		性别	女 男
年龄	25	手机号	18100000000
邮箱		地址	上海市普陀区金沙江路 1518 弄

分组模式

基本信息

用户名	张三	性别	男
年龄	25	手机号	18100000000

联系方式

邮箱	zhangsan@example.com
地址	上海市普陀区金沙江路 1518 弄

VIP 信息

VIP 等级

Gold

备注

<template>
  <div class="descriptions-demo">
    <h3>基础用法</h3>
    <easy-descriptions :items="basicItems" v-model="formData" :column="2" border> </easy-descriptions>

    <h3 style="margin-top: 30px">分组模式</h3>
    <easy-descriptions :items="groupedItems" v-model="formData" border>
      <template #gender>
        <el-tag type="success" size="large">
          {{ formData.gender == 1 ? "男" : "女" }}
        </el-tag>
      </template>
    </easy-descriptions>

    <div class="actions">
      <el-button type="primary" @click="handleSubmit">提交数据</el-button>
    </div>

    <div v-if="submitResult" class="result">
      <strong>提交的数据：</strong>
      <pre>{{ submitResult }}</pre>
    </div>
  </div>
</template>

<script setup>
import { ref } from "vue"
import { EasyDescriptions } from "easy-elplus"
import { ElMessage, ElButton } from "element-plus"

const formData = ref({
  username: "张三",
  gender: 1,
  age: 25,
  tel: "18100000000",
  email: "zhangsan@example.com",
  address: "上海市普陀区金沙江路 1518 弄",
  isVip: true,
  vipLevel: "Gold",
  remark: "这是一个备注信息"
})

const submitResult = ref("")

// 基础配置
const basicItems = [
  {
    label: "用户名",
    value: {
      id: "username",
      components: "el-input",
      props: {
        placeholder: "请输入用户名"
      }
    }
  },
  {
    label: "性别",
    value: {
      id: "gender",
      components: "el-switch",
      props: {
        activeText: "男",
        inactiveText: "女",
        activeValue: 1,
        inactiveValue: 0
      }
    }
  },

  { label: "年龄", value: "age", hidden: data => data.gender == 0 },
  { label: "手机号", value: "tel" },
  {
    label: "邮箱",
    value: {
      id: "email",
      components: "el-input",
      props: {
        placeholder: "请输入邮箱"
      }
    }
  },
  { label: "地址", value: "address", span: 2 }
]

// 分组配置
const groupedItems = [
  {
    title: "基本信息",
    column: 2,
    items: [
      { label: "用户名", value: "username" },
      {
        label: "性别",
        value: "gender"
      },
      { label: "年龄", value: "age" },
      { label: "手机号", value: "tel" }
    ]
  },
  {
    title: "联系方式",
    column: 1,
    items: [
      { label: "邮箱", value: "email" },
      { label: "地址", value: "address" }
    ]
  },
  {
    title: "VIP 信息",
    hidden: data => !data.isVip,
    column: 2,
    items: [
      { label: "VIP 等级", value: "vipLevel" },
      {
        label: "备注",
        value: {
          id: "remark",
          components: "el-input",
          props: {
            type: "textarea",
            rows: 3
          }
        },
        span: 2
      }
    ]
  }
]

const handleSubmit = () => {
  submitResult.value = JSON.stringify(formData.value, null, 2)
  ElMessage.success("提交成功")
}
</script>

<style scoped>
h3 {
  margin: 20px 0 10px;
  font-size: 16px;
  color: #303133;
}

.result {
  margin-top: 20px;
  padding: 12px;
  background: #f0f9ff;
  border: 1px solid #409eff;
  border-radius: 4px;
  color: #409eff;
  font-size: 14px;
}

.result pre {
  margin-top: 8px;
  font-size: 12px;
  line-height: 1.5;
}
</style>

API

Attributes

Attribute	Description	Type	Default
items	Configuration list	Array	[]
modelValue / v-model	Data object	Object	{}

Inherits all attributes of Element Plus Descriptions, such as:

Attribute	Description	Type	Default
column	Number of columns	Number	3
border	With border	Boolean	false
direction	Direction	String	horizontal
size	Size	String	default

Items Configuration

Single Group Mode

interface Item {
  label: string | object // Label text or configuration object
  value: string | object // Field name or configuration object
  hidden?: boolean | ((data) => boolean) // Whether to hide
  span?: number // Number of columns occupied
  // ... other Descriptions attributes
}

Group Configuration

interface GroupItem {
  title?: string // Group title
  extra?: string // extra text
  items: Item[] // Field list of the group
  hidden?: boolean | ((data) => boolean) // Whether to hide the entire group
  column?: number // Number of columns for the group
  border?: boolean // Whether the group has a border
  // ... other DescriptionsItem attributes
}

Value Object Configuration

interface ValueConfig {
  id: string // Field name
  components: string | Component // Component name or component
  props: Object // Component attributes
}

Events

Inherits all events of Element Plus Descriptions.

Slots

Slot Name	Description	Parameters
title	Custom title
extra	Custom extra area
[id]	Custom field content	label｜value

Features

1. Simple Display: Use string configuration directly
2. Form Editing: Use component configuration to implement editable description lists
3. Group Display: Use group mode to organize complex data
4. Conditional Display: Use hidden function to implement dynamic display logic
5. Custom Rendering: Use slots to implement complex custom requirements