mirror of
https://gitee.com/element-plus/element-plus.git
synced 2024-12-15 09:50:58 +08:00
d9b7ef56ea
* style(docs): use css var * style: update * style: demo-icon use grid layout * style: remove demo-block.vue style scoped * docs: remove strange character
269 lines
7.5 KiB
Markdown
269 lines
7.5 KiB
Markdown
## Container
|
|
Container components for scaffolding basic structure of the page:
|
|
|
|
`<el-container>`: wrapper container. When nested with a `<el-header>` or `<el-footer>`, all its child elements will be vertically arranged. Otherwise horizontally.
|
|
|
|
`<el-header>`: container for headers.
|
|
|
|
`<el-aside>`: container for side sections (usually a side nav).
|
|
|
|
`<el-main>`: container for main sections.
|
|
|
|
`<el-footer>`: container for footers.
|
|
|
|
:::tip
|
|
These components use flex for layout, so please make sure your browser supports it. Besides, `<el-container>`'s direct child elements have to be one or more of the latter four components. And father element of the latter four components must be a `<el-container>`.
|
|
:::
|
|
|
|
### Common layouts
|
|
|
|
:::demo
|
|
```html
|
|
<div class="common-layout">
|
|
<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>
|
|
</div>
|
|
|
|
<style>
|
|
.el-header, .el-footer {
|
|
background-color: #B3C0D1;
|
|
color: var(--el-text-color-primary);
|
|
text-align: center;
|
|
line-height: 60px;
|
|
}
|
|
|
|
.el-aside {
|
|
background-color: #D3DCE6;
|
|
color: var(--el-text-color-primary);
|
|
text-align: center;
|
|
line-height: 200px;
|
|
}
|
|
|
|
.el-main {
|
|
background-color: #E9EEF3;
|
|
color: var(--el-text-color-primary);
|
|
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>
|
|
```
|
|
:::
|
|
|
|
### Example
|
|
|
|
:::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-sub-menu index="1">
|
|
<template #title><i class="el-icon-message"></i>Navigator One</template>
|
|
<el-menu-item-group>
|
|
<template #title>Group 1</template>
|
|
<el-menu-item index="1-1">Option 1</el-menu-item>
|
|
<el-menu-item index="1-2">Option 2</el-menu-item>
|
|
</el-menu-item-group>
|
|
<el-menu-item-group title="Group 2">
|
|
<el-menu-item index="1-3">Option 3</el-menu-item>
|
|
</el-menu-item-group>
|
|
<el-sub-menu index="1-4">
|
|
<template #title>Option4</template>
|
|
<el-menu-item index="1-4-1">Option 4-1</el-menu-item>
|
|
</el-sub-menu>
|
|
</el-sub-menu>
|
|
<el-sub-menu index="2">
|
|
<template #title><i class="el-icon-menu"></i>Navigator Two</template>
|
|
<el-menu-item-group>
|
|
<template #title>Group 1</template>
|
|
<el-menu-item index="2-1">Option 1</el-menu-item>
|
|
<el-menu-item index="2-2">Option 2</el-menu-item>
|
|
</el-menu-item-group>
|
|
<el-menu-item-group title="Group 2">
|
|
<el-menu-item index="2-3">Option 3</el-menu-item>
|
|
</el-menu-item-group>
|
|
<el-sub-menu index="2-4">
|
|
<template #title>Option 4</template>
|
|
<el-menu-item index="2-4-1">Option 4-1</el-menu-item>
|
|
</el-sub-menu>
|
|
</el-sub-menu>
|
|
<el-sub-menu index="3">
|
|
<template #title><i class="el-icon-setting"></i>Navigator Three</template>
|
|
<el-menu-item-group>
|
|
<template #title>Group 1</template>
|
|
<el-menu-item index="3-1">Option 1</el-menu-item>
|
|
<el-menu-item index="3-2">Option 2</el-menu-item>
|
|
</el-menu-item-group>
|
|
<el-menu-item-group title="Group 2">
|
|
<el-menu-item index="3-3">Option 3</el-menu-item>
|
|
</el-menu-item-group>
|
|
<el-sub-menu index="3-4">
|
|
<template #title>Option 4</template>
|
|
<el-menu-item index="3-4-1">Option 4-1</el-menu-item>
|
|
</el-sub-menu>
|
|
</el-sub-menu>
|
|
</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>View</el-dropdown-item>
|
|
<el-dropdown-item>Add</el-dropdown-item>
|
|
<el-dropdown-item>Delete</el-dropdown-item>
|
|
</el-dropdown-menu>
|
|
</template>
|
|
</el-dropdown>
|
|
<span>Tom</span>
|
|
</el-header>
|
|
|
|
<el-main>
|
|
<el-table :data="tableData">
|
|
<el-table-column prop="date" label="Date" width="140">
|
|
</el-table-column>
|
|
<el-table-column prop="name" label="Name" width="120">
|
|
</el-table-column>
|
|
<el-table-column prop="address" label="Address">
|
|
</el-table-column>
|
|
</el-table>
|
|
</el-main>
|
|
</el-container>
|
|
</el-container>
|
|
|
|
<style>
|
|
.el-header {
|
|
background-color: #B3C0D1;
|
|
color: var(--el-text-color-primary);
|
|
line-height: 60px;
|
|
}
|
|
|
|
.el-aside {
|
|
color: var(--el-text-color-primary);
|
|
}
|
|
</style>
|
|
|
|
<script>
|
|
export default {
|
|
data() {
|
|
const item = {
|
|
date: '2016-05-02',
|
|
name: 'Tom',
|
|
address: 'No. 189, Grove St, Los Angeles'
|
|
};
|
|
return {
|
|
tableData: Array(20).fill(item)
|
|
}
|
|
}
|
|
};
|
|
</script>
|
|
|
|
<!--
|
|
<setup>
|
|
|
|
import { defineComponent, ref } from 'vue';
|
|
|
|
export default defineComponent({
|
|
setup() {
|
|
const item = {
|
|
date: '2016-05-02',
|
|
name: 'Tom',
|
|
address: 'No. 189, Grove St, Los Angeles',
|
|
};
|
|
|
|
const tableData = ref(Array(20).fill(item));
|
|
|
|
return {
|
|
tableData,
|
|
};
|
|
},
|
|
});
|
|
|
|
</setup>
|
|
-->
|
|
```
|
|
:::
|
|
|
|
### Container Attributes
|
|
| Attribute | Description | Type | Accepted Values | Default |
|
|
|---------- |-------------- |---------- |-------------------------------- |-------- |
|
|
| direction | layout direction for child elements | string | horizontal / vertical | vertical when nested with `el-header` or `el-footer`; horizontal otherwise |
|
|
|
|
### Header Attributes
|
|
| Attribute | Description | Type | Accepted Values | Default |
|
|
|---------- |-------------- |---------- |-------------------------------- |-------- |
|
|
| height | height of the header | string | — | 60px |
|
|
|
|
### Aside Attributes
|
|
| Attribute | Description | Type | Accepted Values | Default |
|
|
|---------- |-------------- |---------- |-------------------------------- |-------- |
|
|
| width | width of the side section | string | — | 300px |
|
|
|
|
### Footer Attributes
|
|
| Attribute | Description | Type | Accepted Values | Default |
|
|
|---------- |-------------- |---------- |-------------------------------- |-------- |
|
|
| height | height of the footer | string | — | 60px |
|