mirror of
https://gitee.com/element-plus/element-plus.git
synced 2024-12-15 01:41:20 +08:00
6c78478e0e
* docs(container): update container docs * docs(container): update container's dropdown docs * docs(container): update container's text docs * docs(container): update container's style docs
242 lines
6.6 KiB
Markdown
242 lines
6.6 KiB
Markdown
## Container 布局容器
|
||
用于布局的容器组件，方便快速搭建页面的基本结构：
|
||
|
||
`<el-container>`：外层容器。当子元素中包含 `<el-header>` 或 `<el-footer>` 时，全部子元素会垂直上下排列，否则会水平左右排列。
|
||
|
||
`<el-header>`：顶栏容器。
|
||
|
||
`<el-aside>`：侧边栏容器。
|
||
|
||
`<el-main>`：主要区域容器。
|
||
|
||
`<el-footer>`：底栏容器。
|
||
|
||
:::tip
|
||
以上组件采用了 flex 布局，使用前请确定目标浏览器是否兼容。此外，`<el-container>` 的子元素只能是后四者，后四者的父元素也只能是 `<el-container>`。
|
||
:::
|
||
|
||
### 常见页面布局
|
||
|
||
:::demo
|
||
```html
|
||
<el-container>
|
||
<el-header>Header</el-header>
|
||
<el-main>Main</el-main>
|
||
</el-container>
|
||
|
||
<el-container>
|
||
<el-header>Header</el-header>
|
||
<el-main>Main</el-main>
|
||
<el-footer>Footer</el-footer>
|
||
</el-container>
|
||
|
||
<el-container>
|
||
<el-aside width="200px">Aside</el-aside>
|
||
<el-main>Main</el-main>
|
||
</el-container>
|
||
|
||
<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>
|
||
|
||
<el-container>
|
||
<el-header>Header</el-header>
|
||
<el-container>
|
||
<el-aside width="200px">Aside</el-aside>
|
||
<el-container>
|
||
<el-main>Main</el-main>
|
||
<el-footer>Footer</el-footer>
|
||
</el-container>
|
||
</el-container>
|
||
</el-container>
|
||
|
||
<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>
|
||
|
||
<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>
|
||
|
||
<style>
|
||
.el-header, .el-footer {
|
||
background-color: #B3C0D1;
|
||
color: #333;
|
||
text-align: center;
|
||
line-height: 60px;
|
||
}
|
||
|
||
.el-aside {
|
||
background-color: #D3DCE6;
|
||
color: #333;
|
||
text-align: center;
|
||
line-height: 200px;
|
||
}
|
||
|
||
.el-main {
|
||
background-color: #E9EEF3;
|
||
color: #333;
|
||
text-align: center;
|
||
line-height: 160px;
|
||
}
|
||
|
||
body > .el-container {
|
||
margin-bottom: 40px;
|
||
}
|
||
|
||
.el-container:nth-child(5) .el-aside,
|
||
.el-container:nth-child(6) .el-aside {
|
||
line-height: 260px;
|
||
}
|
||
|
||
.el-container:nth-child(7) .el-aside {
|
||
line-height: 320px;
|
||
}
|
||
</style>
|
||
```
|
||
:::
|
||
|
||
### 实例
|
||
|
||
:::demo
|
||
```html
|
||
<el-container style="height: 500px; border: 1px solid #eee">
|
||
<el-aside width="200px" style="background-color: rgb(238, 241, 246)">
|
||
<el-menu :default-openeds="['1', '3']">
|
||
<el-submenu index="1">
|
||
<template #title><i class="el-icon-message"></i>导航一</template>
|
||
<el-menu-item-group>
|
||
<template #title>分组一</template>
|
||
<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="分组2">
|
||
<el-menu-item index="1-3">选项3</el-menu-item>
|
||
</el-menu-item-group>
|
||
<el-submenu index="1-4">
|
||
<template #title>选项4</template>
|
||
<el-menu-item index="1-4-1">选项4-1</el-menu-item>
|
||
</el-submenu>
|
||
</el-submenu>
|
||
<el-submenu index="2">
|
||
<template #title><i class="el-icon-menu"></i>导航二</template>
|
||
<el-menu-item-group>
|
||
<template #title>分组一</template>
|
||
<el-menu-item index="2-1">选项1</el-menu-item>
|
||
<el-menu-item index="2-2">选项2</el-menu-item>
|
||
</el-menu-item-group>
|
||
<el-menu-item-group title="分组2">
|
||
<el-menu-item index="2-3">选项3</el-menu-item>
|
||
</el-menu-item-group>
|
||
<el-submenu index="2-4">
|
||
<template #title>选项4</template>
|
||
<el-menu-item index="2-4-1">选项4-1</el-menu-item>
|
||
</el-submenu>
|
||
</el-submenu>
|
||
<el-submenu index="3">
|
||
<template #title><i class="el-icon-setting"></i>导航三</template>
|
||
<el-menu-item-group>
|
||
<template #title>分组一</template>
|
||
<el-menu-item index="3-1">选项1</el-menu-item>
|
||
<el-menu-item index="3-2">选项2</el-menu-item>
|
||
</el-menu-item-group>
|
||
<el-menu-item-group title="分组2">
|
||
<el-menu-item index="3-3">选项3</el-menu-item>
|
||
</el-menu-item-group>
|
||
<el-submenu index="3-4">
|
||
<template #title>选项4</template>
|
||
<el-menu-item index="3-4-1">选项4-1</el-menu-item>
|
||
</el-submenu>
|
||
</el-submenu>
|
||
</el-menu>
|
||
</el-aside>
|
||
|
||
<el-container>
|
||
<el-header style="text-align: right; font-size: 12px">
|
||
<el-dropdown>
|
||
<i class="el-icon-setting" style="margin-right: 15px"></i>
|
||
<template #dropdown>
|
||
<el-dropdown-menu>
|
||
<el-dropdown-item>查看</el-dropdown-item>
|
||
<el-dropdown-item>新增</el-dropdown-item>
|
||
<el-dropdown-item>删除</el-dropdown-item>
|
||
</el-dropdown-menu>
|
||
</template>
|
||
</el-dropdown>
|
||
<span>王小虎</span>
|
||
</el-header>
|
||
|
||
<el-main>
|
||
<el-table :data="tableData">
|
||
<el-table-column prop="date" label="日期" width="140">
|
||
</el-table-column>
|
||
<el-table-column prop="name" label="姓名" width="120">
|
||
</el-table-column>
|
||
<el-table-column prop="address" label="地址">
|
||
</el-table-column>
|
||
</el-table>
|
||
</el-main>
|
||
</el-container>
|
||
</el-container>
|
||
|
||
<style>
|
||
.el-header {
|
||
background-color: #B3C0D1;
|
||
color: #333;
|
||
line-height: 60px;
|
||
}
|
||
|
||
.el-aside {
|
||
color: #333;
|
||
}
|
||
</style>
|
||
|
||
<script>
|
||
export default {
|
||
data() {
|
||
const item = {
|
||
date: '2016-05-02',
|
||
name: '王小虎',
|
||
address: '上海市普陀区金沙江路 1518 弄'
|
||
};
|
||
return {
|
||
tableData: Array(20).fill(item)
|
||
}
|
||
}
|
||
};
|
||
</script>
|
||
```
|
||
:::
|
||
|
||
### Container Attributes
|
||
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|
||
|---------|----------|---------|-------------|--------|
|
||
| direction | 子元素的排列方向 | string | horizontal / vertical | 子元素中有 `el-header` 或 `el-footer` 时为 vertical，否则为 horizontal |
|
||
|
||
### Header Attributes
|
||
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|
||
|---------|----------|---------|-------------|--------|
|
||
| height | 顶栏高度 | string | — | 60px |
|
||
|
||
### Aside Attributes
|
||
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|
||
|---------|----------|---------|-------------|--------|
|
||
| width | 侧边栏宽度 | string | — | 300px |
|
||
|
||
### Footer Attributes
|
||
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|
||
|---------|----------|---------|-------------|--------|
|
||
| height | 底栏高度 | string | — | 60px | |