Container 布局容器

用于布局的容器组件，方便快速搭建页面的基本结构：

<el-container>：外层容器。当子元素中包含 <el-header> 或 <el-footer> 时，全部子元素会垂直上下排列，否则会水平左右排列。
<el-header>：顶栏容器。
<el-aside>：侧边栏容器。
<el-main>：主要区域容器。
<el-footer>：底栏容器。

TIP

以上组件采用了 flex 布局，请确保浏览器版本支持。此外 <el-container> 的直接子元素必须是后四者之一，后四者的父元素也必须是一个 <el-container>。

import { createApp } from 'vue'
import { Container as ElContainer, Header as ElHeader, Aside as ElAside, Main as ElMain, Footer as ElFooter } from '@szhn/dh-design-pc'

const app = createApp()
app.use(ElContainer)
app.use(ElHeader)
app.use(ElAside)
app.use(ElMain)
app.use(ElFooter)

常见页面布局

<template>
  <div class="demo-container-wrap">
    <el-container>
      <el-header>Header</el-header>
      <el-main>Main</el-main>
    </el-container>
  </div>
</template>

<script lang="ts" setup>
</script>

<style scoped>
.demo-container-wrap :deep(.el-header) {
  background-color: var(--el-color-primary-light-7);
  color: var(--el-text-color-primary);
  text-align: center;
  line-height: 60px;
}
.demo-container-wrap :deep(.el-main) {
  background-color: var(--el-color-primary-light-9);
  color: var(--el-text-color-primary);
  text-align: center;
  line-height: 160px;
}
.demo-container-wrap :deep(.el-container) {
  min-height: 220px;
  border: 1px solid var(--el-border-color-lighter);
  border-radius: var(--el-border-radius-base);
  overflow: hidden;
}
</style>

<template>
  <div class="demo-container-wrap">
    <el-container>
      <el-header>Header</el-header>
      <el-main>Main</el-main>
      <el-footer>Footer</el-footer>
    </el-container>
  </div>
</template>

<script lang="ts" setup>
</script>

<style scoped>
.demo-container-wrap :deep(.el-header),
.demo-container-wrap :deep(.el-footer) {
  background-color: var(--el-color-primary-light-7);
  color: var(--el-text-color-primary);
  text-align: center;
  line-height: 60px;
}
.demo-container-wrap :deep(.el-main) {
  background-color: var(--el-color-primary-light-9);
  color: var(--el-text-color-primary);
  text-align: center;
  line-height: 160px;
}
.demo-container-wrap :deep(.el-container) {
  min-height: 280px;
  border: 1px solid var(--el-border-color-lighter);
  border-radius: var(--el-border-radius-base);
  overflow: hidden;
}
</style>

<template>
  <div class="demo-container-wrap">
    <el-container>
      <el-aside width="200px">Aside</el-aside>
      <el-main>Main</el-main>
    </el-container>
  </div>
</template>

<script lang="ts" setup>
</script>

<style scoped>
.demo-container-wrap :deep(.el-aside) {
  background-color: var(--el-color-primary-light-8);
  color: var(--el-text-color-primary);
  text-align: center;
  line-height: 220px;
}
.demo-container-wrap :deep(.el-main) {
  background-color: var(--el-color-primary-light-9);
  color: var(--el-text-color-primary);
  text-align: center;
  line-height: 220px;
}
.demo-container-wrap :deep(.el-container) {
  min-height: 240px;
  border: 1px solid var(--el-border-color-lighter);
  border-radius: var(--el-border-radius-base);
  overflow: hidden;
}
</style>

<template>
  <div class="demo-container-wrap">
    <el-container>
      <el-aside width="200px">Aside</el-aside>
      <el-container>
        <el-header>Header</el-header>
        <el-main>Main</el-main>
      </el-container>
    </el-container>
  </div>
</template>

<script lang="ts" setup>
</script>

<style scoped>
.demo-container-wrap :deep(.el-header) {
  background-color: var(--el-color-primary-light-7);
  color: var(--el-text-color-primary);
  text-align: center;
  line-height: 60px;
}
.demo-container-wrap :deep(.el-aside) {
  background-color: var(--el-color-primary-light-8);
  color: var(--el-text-color-primary);
  text-align: center;
  line-height: 260px;
}
.demo-container-wrap :deep(.el-main) {
  background-color: var(--el-color-primary-light-9);
  color: var(--el-text-color-primary);
  text-align: center;
  line-height: 200px;
}
.demo-container-wrap :deep(.el-container) {
  min-height: 280px;
  border: 1px solid var(--el-border-color-lighter);
  border-radius: var(--el-border-radius-base);
  overflow: hidden;
}
.demo-container-wrap :deep(.el-container .el-container) {
  border: none;
  border-radius: 0;
}
</style>

<template>
  <div class="demo-container-wrap">
    <el-container>
      <el-aside width="200px">Aside</el-aside>
      <el-container>
        <el-header>Header</el-header>
        <el-main>Main</el-main>
        <el-footer>Footer</el-footer>
      </el-container>
    </el-container>
  </div>
</template>

<script lang="ts" setup>
</script>

<style scoped>
.demo-container-wrap :deep(.el-header),
.demo-container-wrap :deep(.el-footer) {
  background-color: var(--el-color-primary-light-7);
  color: var(--el-text-color-primary);
  text-align: center;
  line-height: 60px;
}
.demo-container-wrap :deep(.el-aside) {
  background-color: var(--el-color-primary-light-8);
  color: var(--el-text-color-primary);
  text-align: center;
  line-height: 320px;
}
.demo-container-wrap :deep(.el-main) {
  background-color: var(--el-color-primary-light-9);
  color: var(--el-text-color-primary);
  text-align: center;
  line-height: 200px;
}
.demo-container-wrap :deep(.el-container) {
  min-height: 320px;
  border: 1px solid var(--el-border-color-lighter);
  border-radius: var(--el-border-radius-base);
  overflow: hidden;
}
.demo-container-wrap :deep(.el-container .el-container) {
  border: none;
  border-radius: 0;
}
</style>

<template>
  <div class="demo-container-wrap">
    <el-container>
      <el-header>Header</el-header>
      <el-container>
        <el-aside width="200px">Aside</el-aside>
        <el-main>Main</el-main>
      </el-container>
    </el-container>
  </div>
</template>

<script lang="ts" setup>
</script>

<style scoped>
.demo-container-wrap :deep(.el-header) {
  background-color: var(--el-color-primary-light-7);
  color: var(--el-text-color-primary);
  text-align: center;
  line-height: 60px;
}
.demo-container-wrap :deep(.el-aside) {
  background-color: var(--el-color-primary-light-8);
  color: var(--el-text-color-primary);
  text-align: center;
  line-height: 200px;
}
.demo-container-wrap :deep(.el-main) {
  background-color: var(--el-color-primary-light-9);
  color: var(--el-text-color-primary);
  text-align: center;
  line-height: 200px;
}
.demo-container-wrap :deep(.el-container) {
  min-height: 280px;
  border: 1px solid var(--el-border-color-lighter);
  border-radius: var(--el-border-radius-base);
  overflow: hidden;
}
.demo-container-wrap :deep(.el-container .el-container) {
  border: none;
  border-radius: 0;
}
</style>

<template>
  <div class="demo-container-wrap">
    <el-container>
      <el-header>Header</el-header>
      <el-container>
        <el-aside width="200px">Aside</el-aside>
        <el-main>Main</el-main>
      </el-container>
      <el-footer>Footer</el-footer>
    </el-container>
  </div>
</template>

<script lang="ts" setup>
</script>

<style scoped>
.demo-container-wrap :deep(.el-header),
.demo-container-wrap :deep(.el-footer) {
  background-color: var(--el-color-primary-light-7);
  color: var(--el-text-color-primary);
  text-align: center;
  line-height: 60px;
}
.demo-container-wrap :deep(.el-aside) {
  background-color: var(--el-color-primary-light-8);
  color: var(--el-text-color-primary);
  text-align: center;
  line-height: 200px;
}
.demo-container-wrap :deep(.el-main) {
  background-color: var(--el-color-primary-light-9);
  color: var(--el-text-color-primary);
  text-align: center;
  line-height: 200px;
}
.demo-container-wrap :deep(.el-container) {
  min-height: 340px;
  border: 1px solid var(--el-border-color-lighter);
  border-radius: var(--el-border-radius-base);
  overflow: hidden;
}
.demo-container-wrap :deep(.el-container .el-container) {
  border: none;
  border-radius: 0;
}
</style>

实例

<template>
  <div class="demo-container-example">
    <el-container class="example-root">
      <el-aside width="200px">
        <el-menu default-active="1" class="example-menu">
          <el-sub-menu index="1">
            <template #title>
              <span>导航一</span>
            </template>
            <el-menu-item-group title="分组一">
              <el-menu-item index="1-1">选项1</el-menu-item>
              <el-menu-item index="1-2">选项2</el-menu-item>
            </el-menu-item-group>
            <el-menu-item-group title="分组二">
              <el-menu-item index="1-3">选项3</el-menu-item>
            </el-menu-item-group>
          </el-sub-menu>
          <el-menu-item index="2">导航二</el-menu-item>
          <el-menu-item index="3">导航三</el-menu-item>
          <el-menu-item index="4">导航四</el-menu-item>
        </el-menu>
      </el-aside>

      <el-container>
        <el-header class="example-header">
          <span>Dashboard</span>
          <el-dropdown>
            <span class="example-user">
              Tom <el-icon class="example-caret"><arrow-down /></el-icon>
            </span>
            <template #dropdown>
              <el-dropdown-menu>
                <el-dropdown-item>个人中心</el-dropdown-item>
                <el-dropdown-item>设置</el-dropdown-item>
                <el-dropdown-item divided>退出登录</el-dropdown-item>
              </el-dropdown-menu>
            </template>
          </el-dropdown>
        </el-header>

        <el-main>
          <el-table :data="tableData" stripe>
            <el-table-column prop="date" label="日期" width="140" />
            <el-table-column prop="name" label="姓名" width="120" />
            <el-table-column prop="address" label="地址" />
          </el-table>
        </el-main>
      </el-container>
    </el-container>
  </div>
</template>

<script lang="ts" setup>
import { ArrowDown } from '@szhn/dh-design-pc/icons'

const tableData = Array.from({ length: 6 }).map((_, i) => ({
  date: `2024-0${(i % 9) + 1}-0${i + 1}`,
  name: ['Tom', 'Jerry', 'Kite', 'Leo', 'May', 'Noah'][i],
  address: `海南省海口市 ${i + 101} 号`,
}))
</script>

<style scoped>
.demo-container-example {
  height: 520px;
}
.example-root {
  height: 100%;
  border: 1px solid var(--el-border-color-lighter);
  border-radius: var(--el-border-radius-base);
  overflow: hidden;
}
.example-root :deep(.el-aside) {
  background: var(--el-color-primary-light-9);
  color: var(--el-text-color-primary);
  padding: 0;
}
.example-menu {
  height: 100%;
  border-right: none;
  background: transparent;
}
.example-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  background: var(--el-bg-color);
  border-bottom: 1px solid var(--el-border-color-lighter);
  padding: 0 16px;
}
.example-user {
  cursor: pointer;
  color: var(--el-text-color-regular);
  display: inline-flex;
  align-items: center;
  gap: 4px;
}
.example-caret {
  font-size: 12px;
}
.example-root :deep(.el-main) {
  background: var(--el-bg-color-page);
  padding: 16px;
}
</style>

API

Container Attributes

名称	说明	类型	默认值
`direction`	子元素的排列方向	`horizontal` / `vertical`	子元素中有 `<el-header>` 或 `<el-footer>` 时为 vertical，否则为 horizontal

Container Slots

插槽名	说明	子标签
`default`	自定义默认内容	Header / Aside / Main / Footer

Header Attributes

名称	说明	类型	默认值
`height`	顶栏高度	string	`60px`

Aside Attributes

名称	说明	类型	默认值
`width`	侧边栏宽度	string	`300px`

名称	说明	类型	默认值
`height`	底栏高度	string	`60px`

更多细节参见 Element Plus Container 文档。

Container 布局容器 ​

常见页面布局 ​

实例 ​

API ​

Container Attributes ​

Container Slots ​

Header Attributes ​

Aside Attributes ​

Footer Attributes ​

Container 布局容器

常见页面布局

实例

API

Container Attributes

Container Slots

Header Attributes

Aside Attributes

Footer Attributes