【Vue.js】Vue.js组件库Element中的树形控件、分页、标记、头像和警告

谁借莪１个温暖的怀抱￠ 2022-12-03 08:47 678阅读 0赞

## 1、Tree 树形控件 ##

用清晰的层级结构展示信息，可展开或折叠。

#### 基础用法 ####

基础的树形结构展示。  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center][]

<el-tree :data="data" :props="defaultProps" @node-click="handleNodeClick"></el-tree>
    
    <script> export default { data() { return { data: [{ label: '一级 1', children: [{ label: '二级 1-1', children: [{ label: '三级 1-1-1' }] }] }, { label: '一级 2', children: [{ label: '二级 2-1', children: [{ label: '三级 2-1-1' }] }, { label: '二级 2-2', children: [{ label: '三级 2-2-1' }] }] }, { label: '一级 3', children: [{ label: '二级 3-1', children: [{ label: '三级 3-1-1' }] }, { label: '二级 3-2', children: [{ label: '三级 3-2-1' }] }] }], defaultProps: { children: 'children', label: 'label' } }; }, methods: { handleNodeClick(data) { console.log(data); } } }; </script>

#### 可选择 ####

适用于需要选择层级时使用。  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 1][]

> 本例还展示了动态加载节点数据的方法。

<el-tree :props="props" :load="loadNode" lazy show-checkbox @check-change="handleCheckChange">
    </el-tree>
    
    <script> export default { data() { return { props: { label: 'name', children: 'zones' }, count: 1 }; }, methods: { handleCheckChange(data, checked, indeterminate) { console.log(data, checked, indeterminate); }, handleNodeClick(data) { console.log(data); }, loadNode(node, resolve) { if (node.level === 0) { return resolve([{ name: 'region1' }, { name: 'region2' }]); } if (node.level > 3) return resolve([]); var hasChild; if (node.data.name === 'region1') { hasChild = true; } else if (node.data.name === 'region2') { hasChild = false; } else { hasChild = Math.random() > 0.5; } setTimeout(() => { var data; if (hasChild) { data = [{ name: 'zone' + this.count++ }, { name: 'zone' + this.count++ }]; } else { data = []; } resolve(data); }, 500); } } }; </script>

#### 懒加载自定义叶子节点 ####

![20200902143704810.png_pic_center][]

> 由于在点击节点时才进行该层数据的获取，默认情况下 Tree 无法预知某个节点是否为叶子节点，所以会为每个节点添加一个下拉按钮，如果节点没有下层数据，则点击后下拉按钮会消失。同时，你也可以提前告知 Tree 某个节点是否为叶子节点，从而避免在叶子节点前渲染下拉按钮。

<el-tree :props="props" :load="loadNode" lazy show-checkbox>
    </el-tree>
    
    <script> export default { data() { return { props: { label: 'name', children: 'zones', isLeaf: 'leaf' }, }; }, methods: { loadNode(node, resolve) { if (node.level === 0) { return resolve([{ name: 'region' }]); } if (node.level > 1) return resolve([]); setTimeout(() => { const data = [{ name: 'leaf', leaf: true }, { name: 'zone' }]; resolve(data); }, 500); } } }; </script>

#### 默认展开和默认选中 ####

可将 Tree 的某些节点设置为默认展开或默认选中。  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 2][]

> 分别通过default-expanded-keys和default-checked-keys设置默认展开和默认选中的节点。需要注意的是，此时必须设置node-key，其值为节点数据中的一个字段名，该字段在整棵树中是唯一的。

<el-tree :data="data" show-checkbox node-key="id" :default-expanded-keys="[2, 3]" :default-checked-keys="[5]" :props="defaultProps">
    </el-tree>
    
    <script> export default { data() { return { data: [{ id: 1, label: '一级 1', children: [{ id: 4, label: '二级 1-1', children: [{ id: 9, label: '三级 1-1-1' }, { id: 10, label: '三级 1-1-2' }] }] }, { id: 2, label: '一级 2', children: [{ id: 5, label: '二级 2-1' }, { id: 6, label: '二级 2-2' }] }, { id: 3, label: '一级 3', children: [{ id: 7, label: '二级 3-1' }, { id: 8, label: '二级 3-2' }] }], defaultProps: { children: 'children', label: 'label' } }; } }; </script>

#### 禁用状态 ####

可将 Tree 的某些节点设置为禁用状态。  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 3][]

> 通过disabled设置禁用状态。

<el-tree :data="data" show-checkbox node-key="id" :default-expanded-keys="[2, 3]" :default-checked-keys="[5]">
    </el-tree>
    
    <script> export default { data() { return { data: [{ id: 1, label: '一级 2', children: [{ id: 3, label: '二级 2-1', children: [{ id: 4, label: '三级 3-1-1' }, { id: 5, label: '三级 3-1-2', disabled: true }] }, { id: 2, label: '二级 2-2', disabled: true, children: [{ id: 6, label: '三级 3-2-1' }, { id: 7, label: '三级 3-2-2', disabled: true }] }] }], defaultProps: { children: 'children', label: 'label' } }; } }; </script>

#### 树节点的选择 ####

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 4][]

> 本例展示如何获取和设置选中节点。获取和设置各有两种方式：通过 node 或通过 key。如果需要通过 key 来获取或设置，则必须设置node-key。

<el-tree :data="data" show-checkbox default-expand-all node-key="id" ref="tree" highlight-current :props="defaultProps">
    </el-tree>
    
    <div class="buttons">
      <el-button @click="getCheckedNodes">通过 node 获取</el-button>
      <el-button @click="getCheckedKeys">通过 key 获取</el-button>
      <el-button @click="setCheckedNodes">通过 node 设置</el-button>
      <el-button @click="setCheckedKeys">通过 key 设置</el-button>
      <el-button @click="resetChecked">清空</el-button>
    </div>
    
    <script> export default { methods: { getCheckedNodes() { console.log(this.$refs.tree.getCheckedNodes()); }, getCheckedKeys() { console.log(this.$refs.tree.getCheckedKeys()); }, setCheckedNodes() { this.$refs.tree.setCheckedNodes([{ id: 5, label: '二级 2-1' }, { id: 9, label: '三级 1-1-1' }]); }, setCheckedKeys() { this.$refs.tree.setCheckedKeys([3]); }, resetChecked() { this.$refs.tree.setCheckedKeys([]); } }, data() { return { data: [{ id: 1, label: '一级 1', children: [{ id: 4, label: '二级 1-1', children: [{ id: 9, label: '三级 1-1-1' }, { id: 10, label: '三级 1-1-2' }] }] }, { id: 2, label: '一级 2', children: [{ id: 5, label: '二级 2-1' }, { id: 6, label: '二级 2-2' }] }, { id: 3, label: '一级 3', children: [{ id: 7, label: '二级 3-1' }, { id: 8, label: '二级 3-2' }] }], defaultProps: { children: 'children', label: 'label' } }; } }; </script>

#### 自定义节点内容 ####

节点的内容支持自定义，可以在节点区添加按钮或图标等内容。  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 5][]

> 可以通过两种方法进行树节点内容的自定义：render-content和 scoped slot。使用render-content指定渲染函数，该函数返回需要的节点区内容即可。渲染函数的用法请参考 Vue 文档。使用 scoped slot 会传入两个参数node和data，分别表示当前节点的 Node 对象和当前节点的数据。注意：由于 jsfiddle 不支持 JSX 语法，所以render-content示例在 jsfiddle 中无法运行。但是在实际的项目中，只要正确地配置了相关依赖，就可以正常运行。

<div class="custom-tree-container">
      <div class="block">
        <p>使用 render-content</p>
        <el-tree :data="data" show-checkbox node-key="id" default-expand-all :expand-on-click-node="false" :render-content="renderContent">
        </el-tree>
      </div>
      <div class="block">
        <p>使用 scoped slot</p>
        <el-tree :data="data" show-checkbox node-key="id" default-expand-all :expand-on-click-node="false">
          <span class="custom-tree-node" slot-scope="{ node, data }">
            <span>{
       { node.label }}</span>
            <span>
              <el-button type="text" size="mini" @click="() => append(data)">
                Append
              </el-button>
              <el-button type="text" size="mini" @click="() => remove(node, data)">
                Delete
              </el-button>
            </span>
          </span>
        </el-tree>
      </div>
    </div>
    
    <script> let id = 1000; export default { data() { const data = [{ id: 1, label: '一级 1', children: [{ id: 4, label: '二级 1-1', children: [{ id: 9, label: '三级 1-1-1' }, { id: 10, label: '三级 1-1-2' }] }] }, { id: 2, label: '一级 2', children: [{ id: 5, label: '二级 2-1' }, { id: 6, label: '二级 2-2' }] }, { id: 3, label: '一级 3', children: [{ id: 7, label: '二级 3-1' }, { id: 8, label: '二级 3-2' }] }]; return { data: JSON.parse(JSON.stringify(data)), data: JSON.parse(JSON.stringify(data)) } }, methods: { append(data) { const newChild = { id: id++, label: 'testtest', children: [] }; if (!data.children) { this.$set(data, 'children', []); } data.children.push(newChild); }, remove(node, data) { const parent = node.parent; const children = parent.data.children || parent.data; const index = children.findIndex(d => d.id === data.id); children.splice(index, 1); }, renderContent(h, { node, data, store }) { return ( <span class="custom-tree-node"> <span>{ node.label}</span> <span> <el-button size="mini" type="text" on-click={ () => this.append(data) }>Append</el-button> <el-button size="mini" type="text" on-click={ () => this.remove(node, data) }>Delete</el-button> </span> </span>); } } }; </script>
    
    <style> .custom-tree-node { flex: 1; display: flex; align-items: center; justify-content: space-between; font-size: 14px; padding-right: 8px; } </style>

#### 节点过滤 ####

通过关键字过滤树节点。  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 6][]

> 在需要对节点进行过滤时，调用 Tree 实例的filter方法，参数为关键字。需要注意的是，此时需要设置filter-node-method，值为过滤函数。

<el-input placeholder="输入关键字进行过滤" v-model="filterText">
    </el-input>
    
    <el-tree class="filter-tree" :data="data" :props="defaultProps" default-expand-all :filter-node-method="filterNode" ref="tree">
    </el-tree>
    
    <script> export default { watch: { filterText(val) { this.$refs.tree.filter(val); } }, methods: { filterNode(value, data) { if (!value) return true; return data.label.indexOf(value) !== -1; } }, data() { return { filterText: '', data: [{ id: 1, label: '一级 1', children: [{ id: 4, label: '二级 1-1', children: [{ id: 9, label: '三级 1-1-1' }, { id: 10, label: '三级 1-1-2' }] }] }, { id: 2, label: '一级 2', children: [{ id: 5, label: '二级 2-1' }, { id: 6, label: '二级 2-2' }] }, { id: 3, label: '一级 3', children: [{ id: 7, label: '二级 3-1' }, { id: 8, label: '二级 3-2' }] }], defaultProps: { children: 'children', label: 'label' } }; } }; </script>

#### 手风琴模式 ####

对于同一级的节点，每次只能展开一个。  
![2020090215160867.png_pic_center][]

<el-tree :data="data" :props="defaultProps" accordion @node-click="handleNodeClick">
    </el-tree>
    
    <script> export default { data() { return { data: [{ label: '一级 1', children: [{ label: '二级 1-1', children: [{ label: '三级 1-1-1' }] }] }, { label: '一级 2', children: [{ label: '二级 2-1', children: [{ label: '三级 2-1-1' }] }, { label: '二级 2-2', children: [{ label: '三级 2-2-1' }] }] }, { label: '一级 3', children: [{ label: '二级 3-1', children: [{ label: '三级 3-1-1' }] }, { label: '二级 3-2', children: [{ label: '三级 3-2-1' }] }] }], defaultProps: { children: 'children', label: 'label' } }; }, methods: { handleNodeClick(data) { console.log(data); } } }; </script>

#### 可拖拽节点 ####

通过 draggable 属性可让节点变为可拖拽。  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 7][]

<el-tree :data="data" node-key="id" default-expand-all @node-drag-start="handleDragStart" @node-drag-enter="handleDragEnter" @node-drag-leave="handleDragLeave" @node-drag-over="handleDragOver" @node-drag-end="handleDragEnd" @node-drop="handleDrop" draggable :allow-drop="allowDrop" :allow-drag="allowDrag">
    </el-tree>
    
    <script> export default { data() { return { data: [{ id: 1, label: '一级 1', children: [{ id: 4, label: '二级 1-1', children: [{ id: 9, label: '三级 1-1-1' }, { id: 10, label: '三级 1-1-2' }] }] }, { id: 2, label: '一级 2', children: [{ id: 5, label: '二级 2-1' }, { id: 6, label: '二级 2-2' }] }, { id: 3, label: '一级 3', children: [{ id: 7, label: '二级 3-1' }, { id: 8, label: '二级 3-2', children: [{ id: 11, label: '三级 3-2-1' }, { id: 12, label: '三级 3-2-2' }, { id: 13, label: '三级 3-2-3' }] }] }], defaultProps: { children: 'children', label: 'label' } }; }, methods: { handleDragStart(node, ev) { console.log('drag start', node); }, handleDragEnter(draggingNode, dropNode, ev) { console.log('tree drag enter: ', dropNode.label); }, handleDragLeave(draggingNode, dropNode, ev) { console.log('tree drag leave: ', dropNode.label); }, handleDragOver(draggingNode, dropNode, ev) { console.log('tree drag over: ', dropNode.label); }, handleDragEnd(draggingNode, dropNode, dropType, ev) { console.log('tree drag end: ', dropNode && dropNode.label, dropType); }, handleDrop(draggingNode, dropNode, dropType, ev) { console.log('tree drop: ', dropNode.label, dropType); }, allowDrop(draggingNode, dropNode, type) { if (dropNode.data.label === '二级 3-1') { return type !== 'inner'; } else { return true; } }, allowDrag(draggingNode) { return draggingNode.data.label.indexOf('三级 3-2-2') === -1; } } }; </script>

#### Attributes ####

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>说明</th> 
   <th>类型</th> 
   <th>可选值</th> 
   <th>默认值</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>data</td> 
   <td>展示数据</td> 
   <td>array</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>empty-text</td> 
   <td>内容为空的时候展示的文本</td> 
   <td>String</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>node-key\每个树节点用来作为唯一标识的属性，整棵树应该是唯一的</td> 
   <td>String</td> 
   <td>—</td> 
   <td>—</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>props</td> 
   <td>配置选项，具体看下表</td> 
   <td>object</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>render-after-expand</td> 
   <td>是否在第一次展开某个树节点后才渲染其子节点</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>true</td> 
  </tr> 
  <tr> 
   <td>load</td> 
   <td>加载子树数据的方法，仅当 lazy 属性为true 时生效</td> 
   <td>function(node, resolve)</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>render-content</td> 
   <td>树节点的内容区的渲染 Function</td> 
   <td>Function(h, { node, data, store }</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>highlight-current</td> 
   <td>是否高亮当前选中节点，默认值是 false</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td>default-expand-all</td> 
   <td>是否默认展开所有节点</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td>expand-on-click-node</td> 
   <td>是否在点击节点的时候展开或者收缩节点， 默认值为 true，如果为 false，则只有点箭头图标的时候才会展开或者收缩节点</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>true</td> 
  </tr> 
  <tr> 
   <td>check-on-click-node</td> 
   <td>是否在点击节点的时候选中节点，默认值为 false，即只有在点击复选框时才会选中节点</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td>auto-expand-parent</td> 
   <td>展开子节点的时候是否自动展开父节点</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>true</td> 
  </tr> 
  <tr> 
   <td>default-expanded-keys</td> 
   <td>默认展开的节点的 key 的数组</td> 
   <td>array</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>show-checkbox</td> 
   <td>节点是否可被选择</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td>check-strictly</td> 
   <td>在显示复选框的情况下，是否严格的遵循父子不互相关联的做法，默认为 false</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td>default-checked-keys</td> 
   <td>默认勾选的节点的 key 的数组</td> 
   <td>array</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>current-node-key</td> 
   <td>当前选中的节点</td> 
   <td>string, number</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>filter-node-method</td> 
   <td>对树节点进行筛选时执行的方法，返回 true 表示这个节点可以显示，返回 false 则表示这个节点会被隐藏</td> 
   <td>Function(value, data, node)</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>accordion</td> 
   <td>是否每次只打开一个同级树节点展开</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td>indent</td> 
   <td>相邻级节点间的水平缩进，单位为像素</td> 
   <td>number</td> 
   <td>—</td> 
   <td>16</td> 
  </tr> 
  <tr> 
   <td>icon-class</td> 
   <td>自定义树节点的图标</td> 
   <td>string</td> 
   <td>-</td> 
   <td>-</td> 
  </tr> 
  <tr> 
   <td>lazy</td> 
   <td>是否懒加载子节点，需与 load 方法结合使用</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td>draggable</td> 
   <td>是否开启拖拽节点功能</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td>allow-drag</td> 
   <td>判断节点能否被拖拽</td> 
   <td>Function(node)</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>allow-drop</td> 
   <td>拖拽时判定目标节点能否被放置。type 参数有三种情况：‘prev’、‘inner’ 和 ‘next’，分别表示放置在目标节点前、插入至目标节点和放置在目标节点后</td> 
   <td>Function(draggingNode, dropNode, type)</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
 </tbody> 
</table>

#### props ####

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>说明</th> 
   <th>类型</th> 
   <th>可选值</th> 
   <th>默认值</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>label</td> 
   <td>指定节点标签为节点对象的某个属性值</td> 
   <td>string, function(data, node)</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>children</td> 
   <td>指定子树为节点对象的某个属性值</td> 
   <td>string</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>disabled</td> 
   <td>指定节点选择框是否禁用为节点对象的某个属性值</td> 
   <td>boolean, function(data, node)</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>isLeaf</td> 
   <td>指定节点是否为叶子节点，仅在指定了 lazy 属性的情况下生效</td> 
   <td>boolean, function(data, node)</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
 </tbody> 
</table>

#### Methods ####

Tree 内部使用了 Node 类型的对象来包装用户传入的数据，用来保存目前节点的状态。 Tree 拥有如下方法：

<table> 
 <thead> 
  <tr> 
   <th>方法名</th> 
   <th>说明</th> 
   <th>参数</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>filter</td> 
   <td>对树节点进行筛选操作</td> 
   <td>接收一个任意类型的参数，该参数会在 filter-node-method 中作为第一个参数</td> 
  </tr> 
  <tr> 
   <td>updateKeyChildren</td> 
   <td>通过 keys 设置节点子元素，使用此方法必须设置 node-key 属性</td> 
   <td>(key, data) 接收两个参数，1. 节点 key 2. 节点数据的数组</td> 
  </tr> 
  <tr> 
   <td>getCheckedNodes</td> 
   <td>若节点可被选择（即 show-checkbox 为 true），则返回目前被选中的节点所组成的数组</td> 
   <td>(leafOnly, includeHalfChecked) 接收两个 boolean 类型的参数，1. 是否只是叶子节点，默认值为 false 2. 是否包含半选节点，默认值为 false</td> 
  </tr> 
  <tr> 
   <td>setCheckedNodes</td> 
   <td>设置目前勾选的节点，使用此方法必须设置 node-key 属性</td> 
   <td>(nodes) 接收勾选节点数据的数组</td> 
  </tr> 
  <tr> 
   <td>getCheckedKeys</td> 
   <td>若节点可被选择（即 show-checkbox 为 true），则返回目前被选中的节点的 key 所组成的数组</td> 
   <td>(leafOnly) 接收一个 boolean 类型的参数，若为 true 则仅返回被选中的叶子节点的 keys，默认值为 false</td> 
  </tr> 
  <tr> 
   <td>setCheckedKeys</td> 
   <td>通过 keys 设置目前勾选的节点，使用此方法必须设置 node-key 属性</td> 
   <td>(keys, leafOnly) 接收两个参数，1. 勾选节点的 key 的数组 2. boolean 类型的参数，若为 true 则仅设置叶子节点的选中状态，默认值为 false</td> 
  </tr> 
  <tr> 
   <td>setChecked</td> 
   <td>通过 key / data 设置某个节点的勾选状态，使用此方法必须设置 node-key</td> 
   <td>属性 (key/data, checked, deep) 接收三个参数，1. 勾选节点的 key 或者 data 2. boolean 类型，节点是否选中 3. boolean 类型，是否设置子节点 ，默认为 false</td> 
  </tr> 
  <tr> 
   <td>getHalfCheckedNodes</td> 
   <td>若节点可被选择（即 show-checkbox 为 true），则返回目前半选中的节点所组成的数组</td> 
   <td>-</td> 
  </tr> 
  <tr> 
   <td>getHalfCheckedKeys</td> 
   <td>若节点可被选择（即 show-checkbox 为 true），则返回目前半选中的节点的 key 所组成的数组</td> 
   <td>-</td> 
  </tr> 
  <tr> 
   <td>getCurrentKey</td> 
   <td>获取当前被选中节点的 key，使用此方法必须设置 node-key 属性，若没有节点被选中则返回 null</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>getCurrentNode</td> 
   <td>获取当前被选中节点的 data，若没有节点被选中则返回 null</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>setCurrentKey</td> 
   <td>通过 key 设置某个节点的当前选中状态，使用此方法必须设置 node-key</td> 
   <td>属性 (key) 待被选节点的 key，若为 null 则取消当前高亮的节点</td> 
  </tr> 
  <tr> 
   <td>setCurrentNode</td> 
   <td>通过 node 设置某个节点的当前选中状态，使用此方法必须设置 node-key 属性</td> 
   <td>(node) 待被选节点的 node</td> 
  </tr> 
  <tr> 
   <td>getNode</td> 
   <td>根据 data 或者 key 拿到 Tree 组件中的 node</td> 
   <td>(data) 要获得 node 的 key 或者 data</td> 
  </tr> 
  <tr> 
   <td>remove</td> 
   <td>删除 Tree 中的一个节点，使用此方法必须设置 node-key 属性</td> 
   <td>(data) 要删除的节点的 data 或者 node</td> 
  </tr> 
  <tr> 
   <td>append</td> 
   <td>为 Tree 中的一个节点追加一个子节点</td> 
   <td>(data, parentNode) 接收两个参数，1. 要追加的子节点的 data 2. 子节点的 parent 的 data、key 或者 node</td> 
  </tr> 
  <tr> 
   <td>insertBefore</td> 
   <td>为 Tree 的一个节点的前面增加一个节点</td> 
   <td>(data, refNode) 接收两个参数，1. 要增加的节点的 data 2. 要增加的节点的后一个节点的 data、key 或者 node</td> 
  </tr> 
  <tr> 
   <td>insertAfter</td> 
   <td>为 Tree 的一个节点的后面增加一个节点</td> 
   <td>(data, refNode) 接收两个参数，1. 要增加的节点的 data 2. 要增加的节点的前一个节点的 data、key 或者 node</td> 
  </tr> 
 </tbody> 
</table>

#### Events ####

<table> 
 <thead> 
  <tr> 
   <th>事件名称</th> 
   <th>说明</th> 
   <th>回调参数</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>node-click</td> 
   <td>节点被点击时的回调</td> 
   <td>共三个参数，依次为：传递给 data 属性的数组中该节点所对应的对象、节点对应的 Node、节点组件本身</td> 
  </tr> 
  <tr> 
   <td>node-contextmenu</td> 
   <td>当某一节点被鼠标右键点击时会触发该事件</td> 
   <td>共四个参数，依次为：event、传递给 data 属性的数组中该节点所对应的对象、节点对应的 Node、节点组件本身</td> 
  </tr> 
  <tr> 
   <td>check-change</td> 
   <td>节点选中状态发生变化时的回调</td> 
   <td>共三个参数，依次为：传递给 data 属性的数组中该节点所对应的对象、节点本身是否被选中、节点的子树中是否有被选中的节点</td> 
  </tr> 
  <tr> 
   <td>check</td> 
   <td>当复选框被点击的时候触发</td> 
   <td>共两个参数，依次为：传递给 data 属性的数组中该节点所对应的对象、树目前的选中状态对象，包含 checkedNodes、checkedKeys、halfCheckedNodes、halfCheckedKeys 四个属性</td> 
  </tr> 
  <tr> 
   <td>current-change</td> 
   <td>当前选中节点变化时触发的事件</td> 
   <td>共两个参数，依次为：当前节点的数据，当前节点的 Node 对象</td> 
  </tr> 
  <tr> 
   <td>node-expand</td> 
   <td>节点被展开时触发的事件</td> 
   <td>共三个参数，依次为：传递给 data 属性的数组中该节点所对应的对象、节点对应的 Node、节点组件本身</td> 
  </tr> 
  <tr> 
   <td>node-collapse</td> 
   <td>节点被关闭时触发的事件</td> 
   <td>共三个参数，依次为：传递给 data 属性的数组中该节点所对应的对象、节点对应的 Node、节点组件本身</td> 
  </tr> 
  <tr> 
   <td>node-drag-start</td> 
   <td>节点开始拖拽时触发的事件</td> 
   <td>共两个参数，依次为：被拖拽节点对应的 Node、event</td> 
  </tr> 
  <tr> 
   <td>node-drag-enter</td> 
   <td>拖拽进入其他节点时触发的事件</td> 
   <td>共三个参数，依次为：被拖拽节点对应的 Node、所进入节点对应的 Node、event</td> 
  </tr> 
  <tr> 
   <td>node-drag-leave</td> 
   <td>拖拽离开某个节点时触发的事件</td> 
   <td>共三个参数，依次为：被拖拽节点对应的 Node、所离开节点对应的 Node、event</td> 
  </tr> 
  <tr> 
   <td>node-drag-over</td> 
   <td>在拖拽节点时触发的事件（类似浏览器的 mouseover 事件）</td> 
   <td>共三个参数，依次为：被拖拽节点对应的 Node、当前进入节点对应的 Node、event</td> 
  </tr> 
  <tr> 
   <td>node-drag-end</td> 
   <td>拖拽结束时（可能未成功）触发的事件</td> 
   <td>共四个参数，依次为：被拖拽节点对应的 Node、结束拖拽时最后进入的节点（可能为空）、被拖拽节点的放置位置（before、after、inner）、event</td> 
  </tr> 
  <tr> 
   <td>node-drop</td> 
   <td>拖拽成功完成时触发的事件</td> 
   <td>共四个参数，依次为：被拖拽节点对应的 Node、结束拖拽时最后进入的节点、被拖拽节点的放置位置（before、after、inner）、event</td> 
  </tr> 
 </tbody> 
</table>

#### Scoped Slot ####

<table> 
 <thead> 
  <tr> 
   <th>name</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>—</td> 
   <td>自定义树节点的内容，参数为 { node, data }</td> 
  </tr> 
 </tbody> 
</table>

## 2、Pagination 分页 ##

当数据量过多时，使用分页分解数据。

#### 基础用法 ####

![20200903084438666.png_pic_center][]

> 设置layout，表示需要显示的内容，用逗号分隔，布局元素会依次显示。prev表示上一页，next为下一页，pager表示页码列表，除此以外还提供了jumper和total，size和特殊的布局符号->，->后的元素会靠右显示，jumper表示跳页元素，total表示总条目数，size用于设置每页显示的页码数量。

<div class="block">
      <span class="demonstration">页数较少时的效果</span>
      <el-pagination layout="prev, pager, next" :total="50">
      </el-pagination>
    </div>
    <div class="block">
      <span class="demonstration">大于 7 页时的效果</span>
      <el-pagination layout="prev, pager, next" :total="1000">
      </el-pagination>
    </div>

#### 设置最大页码按钮数 ####

![20200903084652153.png_pic_center][]

> 默认情况下，当总页数超过 7 页时，Pagination 会折叠多余的页码按钮。通过pager-count属性可以设置最大页码按钮数。

<el-pagination :page-size="20" :pager-count="11" layout="prev, pager, next" :total="1000">
    </el-pagination>

#### 带有背景色的分页 ####

![2020090308483291.png_pic_center][]

> 设置background属性可以为分页按钮添加背景色。

<el-pagination background layout="prev, pager, next" :total="1000">
    </el-pagination>

#### 小型分页 ####

在空间有限的情况下，可以使用简单的小型分页。  
![20200903085029328.png_pic_center][]

> 只需要一个small属性，它接受一个Boolean，默认为false，设为true即可启用。

<el-pagination small layout="prev, pager, next" :total="50">
    </el-pagination>

#### 附加功能 ####

根据场景需要，可以添加其他功能模块。  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 8][]

> 此例是一个完整的用例，使用了size-change和current-change事件来处理页码大小和当前页变动时候触发的事件。page-sizes接受一个整型数组，数组元素为展示的选择每页显示个数的选项，\[100, 200, 300, 400\]表示四个选项，每页显示 100 个，200 个，300 个或者 400 个。

<template>
      <div class="block">
        <span class="demonstration">显示总数</span>
        <el-pagination @size-change="handleSizeChange" @current-change="handleCurrentChange" :current-page.sync="currentPage1" :page-size="100" layout="total, prev, pager, next" :total="1000">
        </el-pagination>
      </div>
      <div class="block">
        <span class="demonstration">调整每页显示条数</span>
        <el-pagination @size-change="handleSizeChange" @current-change="handleCurrentChange" :current-page.sync="currentPage2" :page-sizes="[100, 200, 300, 400]" :page-size="100" layout="sizes, prev, pager, next" :total="1000">
        </el-pagination>
      </div>
      <div class="block">
        <span class="demonstration">直接前往</span>
        <el-pagination @size-change="handleSizeChange" @current-change="handleCurrentChange" :current-page.sync="currentPage3" :page-size="100" layout="prev, pager, next, jumper" :total="1000">
        </el-pagination>
      </div>
      <div class="block">
        <span class="demonstration">完整功能</span>
        <el-pagination @size-change="handleSizeChange" @current-change="handleCurrentChange" :current-page="currentPage4" :page-sizes="[100, 200, 300, 400]" :page-size="100" layout="total, sizes, prev, pager, next, jumper" :total="400">
        </el-pagination>
      </div>
    </template>
    <script> export default { methods: { handleSizeChange(val) { console.log(`每页 ${ val} 条`); }, handleCurrentChange(val) { console.log(`当前页: ${ val}`); } }, data() { return { currentPage1: 5, currentPage2: 5, currentPage3: 5, currentPage4: 4 }; } } </script>

#### 当只有一页时隐藏分页 ####

当只有一页时，通过设置 hide-on-single-page 属性来隐藏分页。  
![20200903090158544.png_pic_center][]  
![2020090309020791.png_pic_center][]

<div>
     <el-switch v-model="value">
     </el-switch>
     <el-pagination :hide-on-single-page="value" :total="5" layout="prev, pager, next">
    </el-pagination>
    </div>
    
    <script> export default { data() { return { value: false } } } </script>

#### Attributes ####

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>说明</th> 
   <th>类型</th> 
   <th>可选值</th> 
   <th>默认值</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>small</td> 
   <td>是否使用小型分页样式</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td>background</td> 
   <td>是否为分页按钮添加背景色</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td>page-size</td> 
   <td>每页显示条目个数，支持 .sync 修饰符</td> 
   <td>number</td> 
   <td>—</td> 
   <td>10</td> 
  </tr> 
  <tr> 
   <td>total</td> 
   <td>总条目数</td> 
   <td>number</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>page-count</td> 
   <td>总页数，total 和 page-count 设置任意一个就可以达到显示页码的功能；如果要支持 page-sizes 的更改，则需要使用 total 属性</td> 
   <td>Number</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>pager-count</td> 
   <td>页码按钮的数量，当总页数超过该值时会折叠</td> 
   <td>number</td> 
   <td>大于等于 5 且小于等于 21 的奇数</td> 
   <td>7</td> 
  </tr> 
  <tr> 
   <td>current-page</td> 
   <td>当前页数，支持 .sync 修饰符</td> 
   <td>number</td> 
   <td>—</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>layout</td> 
   <td>组件布局，子组件名用逗号分隔</td> 
   <td>String</td> 
   <td>sizes, prev, pager, next, jumper, -&gt;, total, slot</td> 
   <td>‘prev, pager, next, jumper, -&gt;, total’</td> 
  </tr> 
  <tr> 
   <td>page-sizes</td> 
   <td>每页显示个数选择器的选项设置</td> 
   <td>number[]</td> 
   <td>—</td> 
   <td>[10, 20, 30, 40, 50, 100]</td> 
  </tr> 
  <tr> 
   <td>popper-class</td> 
   <td>每页显示个数选择器的下拉框类名</td> 
   <td>string</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>prev-text</td> 
   <td>替代图标显示的上一页文字</td> 
   <td>string</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>next-text</td> 
   <td>替代图标显示的下一页文字</td> 
   <td>string</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>disabled</td> 
   <td>是否禁用</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td>hide-on-single-page</td> 
   <td>只有一页时是否隐藏</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>-</td> 
  </tr> 
 </tbody> 
</table>

#### Events ####

<table> 
 <thead> 
  <tr> 
   <th>事件名称</th> 
   <th>说明</th> 
   <th>回调参数</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>size-change</td> 
   <td>pageSize 改变时会触发</td> 
   <td>每页条数</td> 
  </tr> 
  <tr> 
   <td>current-change</td> 
   <td>currentPage 改变时会触发</td> 
   <td>当前页</td> 
  </tr> 
  <tr> 
   <td>prev-click</td> 
   <td>用户点击上一页按钮改变当前页后触发</td> 
   <td>当前页</td> 
  </tr> 
  <tr> 
   <td>next-click</td> 
   <td>用户点击下一页按钮改变当前页后触发</td> 
   <td>当前页</td> 
  </tr> 
 </tbody> 
</table>

#### Slot ####

<table> 
 <thead> 
  <tr> 
   <th>name</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>—</td> 
   <td>自定义内容，需要在 layout 中列出 slot</td> 
  </tr> 
 </tbody> 
</table>

## 3、Badge 标记 ##

出现在按钮、图标旁的数字或状态标记。

#### 基础用法 ####

展示新消息数量。  
![2020090309173168.png_pic_center][]

> 定义value属性，它接受Number或者String。

<el-badge :value="12" class="item">
      <el-button size="small">评论</el-button>
    </el-badge>
    <el-badge :value="3" class="item">
      <el-button size="small">回复</el-button>
    </el-badge>
    <el-badge :value="1" class="item" type="primary">
      <el-button size="small">评论</el-button>
    </el-badge>
    <el-badge :value="2" class="item" type="warning">
      <el-button size="small">回复</el-button>
    </el-badge>
    
    <el-dropdown trigger="click">
      <span class="el-dropdown-link">
        点我查看<i class="el-icon-caret-bottom el-icon--right"></i>
      </span>
      <el-dropdown-menu slot="dropdown">
        <el-dropdown-item class="clearfix">
          评论
          <el-badge class="mark" :value="12" />
        </el-dropdown-item>
        <el-dropdown-item class="clearfix">
          回复
          <el-badge class="mark" :value="3" />
        </el-dropdown-item>
      </el-dropdown-menu>
    </el-dropdown>
    
    <style> .item { margin-top: 10px; margin-right: 40px; } </style>

#### 最大值 ####

可自定义最大值。  
![20200903091953668.png_pic_center][]

> 由max属性定义，它接受一个Number，需要注意的是，只有当value为Number时，它才会生效。

<el-badge :value="200" :max="99" class="item">
      <el-button size="small">评论</el-button>
    </el-badge>
    <el-badge :value="100" :max="10" class="item">
      <el-button size="small">回复</el-button>
    </el-badge>
    
    <style> .item { margin-top: 10px; margin-right: 40px; } </style>

#### 自定义内容 ####

可以显示数字以外的文本内容。  
![20200903092154364.png_pic_center][]

> 定义value为String类型是时可以用于显示自定义文本。

<el-badge value="new" class="item">
      <el-button size="small">评论</el-button>
    </el-badge>
    <el-badge value="hot" class="item">
      <el-button size="small">回复</el-button>
    </el-badge>
    
    <style> .item { margin-top: 10px; margin-right: 40px; } </style>

#### 小红点 ####

以红点的形式标注需要关注的内容。  
![20200903092352494.png_pic_center][]

> 除了数字外，设置is-dot属性，它接受一个Boolean。

<el-badge is-dot class="item">数据查询</el-badge>
    <el-badge is-dot class="item">
      <el-button class="share-button" icon="el-icon-share" type="primary"></el-button>
    </el-badge>
    
    <style> .item { margin-top: 10px; margin-right: 40px; } </style>

#### Attributes ####

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>说明</th> 
   <th>类型</th> 
   <th>可选值</th> 
   <th>默认值</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>value</td> 
   <td>显示值</td> 
   <td>string, number</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>max</td> 
   <td>最大值，超过最大值会显示 ‘{max}+’，要求 value 是 Number 类型</td> 
   <td>number</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>is-dot</td> 
   <td>小圆点</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td>hidden</td> 
   <td>隐藏 badge</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td>type</td> 
   <td>类型</td> 
   <td>string</td> 
   <td>primary / success / warning / danger / info</td> 
   <td>—</td> 
  </tr> 
 </tbody> 
</table>

## 4、Avatar 头像 ##

用图标、图片或者字符的形式展示用户或事物信息。

#### 基本用法 ####

通过 shape 和 size 设置头像的形状和大小。  
![20200903093117893.png_pic_center][]

<template>
      <el-row class="demo-avatar demo-basic">
        <el-col :span="12">
          <div class="sub-title">circle</div>
          <div class="demo-basic--circle">
            <div class="block"><el-avatar :size="50" :src="circleUrl"></el-avatar></div>
            <div class="block" v-for="size in sizeList" :key="size">
              <el-avatar :size="size" :src="circleUrl"></el-avatar>
            </div>
          </div>
        </el-col>  
        <el-col :span="12">
          <div class="sub-title">square</div>
          <div class="demo-basic--circle">
            <div class="block"><el-avatar shape="square" :size="50" :src="squareUrl"></el-avatar></div>
            <div class="block" v-for="size in sizeList" :key="size">
              <el-avatar shape="square" :size="size" :src="squareUrl"></el-avatar>
            </div>
          </div>
        </el-col> 
      </el-row>
    </template>
    <script> export default { data () { return { circleUrl: "https://cube.elemecdn.com/3/7c/3ea6beec64369c2642b92c6726f1epng.png", squareUrl: "https://cube.elemecdn.com/9/c2/f0ee8a3c7c9638a54940382568c9dpng.png", sizeList: ["large", "medium", "small"] } } } </script>

#### 展示类型 ####

支持三种类型：图标、图片和字符。  
![20200903093304699.png_pic_center][]

#### 图片加载失败的 fallback 行为 ####

当展示类型为图片的时候，图片加载失败的 fallback 行为。  
![20200903093533577.png_pic_center][]

<template>
      <div class="demo-type">
        <el-avatar :size="60" src="https://empty" @error="errorHandler">
          <img src="https://cube.elemecdn.com/e/fd/0fc7d20532fdaf769a25683617711png.png"/>
        </el-avatar>
      </div>
    </template>
    <script> export default { methods: { errorHandler() { return true } } } </script>

#### 图片如何适应容器框 ####

当展示类型为图片的时候，使用 fit 属性定义图片如何适应容器框，同原生 object-fit。  
![20200903093904940.png_pic_center][]

<template>
      <div class="demo-fit">
        <div class="block" v-for="fit in fits" :key="fit">
            <span class="title">{
       { fit }}</span>
            <el-avatar shape="square" :size="100" :fit="fit" :src="url"></el-avatar>
        </div>
      </div>
    </template>
    <script> export default { data() { return { fits: ['fill', 'contain', 'cover', 'none', 'scale-down'], url: 'https://fuss10.elemecdn.com/e/5d/4a731a90594a4af544c0c25941171jpeg.jpeg' } } } </script>

#### Attributes ####

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>说明</th> 
   <th>类型</th> 
   <th>可选值</th> 
   <th>默认值</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>icon</td> 
   <td>设置头像的图标类型，参考 Icon 组件</td> 
   <td>string</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>size</td> 
   <td>设置头像的大小</td> 
   <td>number/string</td> 
   <td>number / large / medium / small</td> 
   <td>large</td> 
  </tr> 
  <tr> 
   <td>shape</td> 
   <td>设置头像的形状</td> 
   <td>string</td> 
   <td>circle / square</td> 
   <td>circle</td> 
  </tr> 
  <tr> 
   <td>src</td> 
   <td>图片头像的资源地址</td> 
   <td>string</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>srcSet</td> 
   <td>以逗号分隔的一个或多个字符串列表表明一系列用户代理使用的可能的图像</td> 
   <td>string</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>alt</td> 
   <td>描述图像的替换文本</td> 
   <td>string</td> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>fit</td> 
   <td>当展示类型为图片的时候，设置图片如何适应容器框</td> 
   <td>string</td> 
   <td>fill / contain / cover / none / scale-down</td> 
   <td>cover</td> 
  </tr> 
 </tbody> 
</table>

#### Events ####

<table> 
 <thead> 
  <tr> 
   <th>事件名</th> 
   <th>说明</th> 
   <th>回调参数</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>error</td> 
   <td>图片类头像加载失败的回调， 返回 false 会关闭组件默认的 fallback 行为</td> 
   <td>(e: Event)</td> 
  </tr> 
 </tbody> 
</table>

#### Slot ####

<table> 
 <thead> 
  <tr> 
   <th>名称</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>default</td> 
   <td>自定义头像展示内容</td> 
  </tr> 
 </tbody> 
</table>

## 5、Alert 警告 ##

用于页面中展示重要的提示信息。

#### 基本用法 ####

页面中的非浮层元素，不会自动消失。  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 9][]

> Alert 组件提供四种主题，由type属性指定，默认值为info。

#### 主题 ####

Alert 组件提供了两个不同的主题：light和dark。  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 10][]

> 通过设置effect属性来改变主题，默认为light。

#### 自定义关闭按钮 ####

自定义关闭按钮为文字或其他符号。  
![2020090309535961.png_pic_center][]

> 在 Alert 组件中，你可以设置是否可关闭，关闭按钮的文本以及关闭时的回调函数。closable属性决定是否可关闭，接受boolean，默认为true。你可以设置close-text属性来代替右侧的关闭图标，注意：close-text必须为文本。设置close事件来设置关闭时的回调。

<template>
      <el-alert title="不可关闭的 alert" type="success" :closable="false">
      </el-alert>
      <el-alert title="自定义 close-text" type="info" close-text="知道了">
      </el-alert>
      <el-alert title="设置了回调的 alert" type="warning" @close="hello">
      </el-alert>
    </template>
    
    <script> export default { methods: { hello() { alert('Hello World!'); } } } </script>

#### 带有 icon ####

表示某种状态时提升可读性。  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 11][]

> 通过设置show-icon属性来显示 Alert 的 icon，这能更有效地向用户展示你的显示意图。

#### 文字居中 ####

使用 center 属性让文字水平居中。  
![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 12][]

#### 带有辅助性文字介绍 ####

包含标题和内容，解释更详细的警告。  
![2020090309595942.png_pic_center][]

> 除了必填的title属性外，你可以设置description属性来帮助你更好地介绍，我们称之为辅助性文字。辅助性文字只能存放单行文本，会自动换行显示。

#### 带有 icon 和辅助性文字介绍 ####

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 13][]

> 最后，这是一个同时具有 icon 和辅助性文字的样例。

#### Attributes ####

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>说明</th> 
   <th>类型</th> 
   <th>可选值</th> 
   <th>默认值</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>title</td> 
   <td>标题</td> 
   <td>string</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>type</td> 
   <td>主题</td> 
   <td>string</td> 
   <td>success/warning/info/error</td> 
   <td>info</td> 
  </tr> 
  <tr> 
   <td>description</td> 
   <td>辅助性文字。也可通过默认 slot 传入</td> 
   <td>string</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>closable</td> 
   <td>是否可关闭</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>true</td> 
  </tr> 
  <tr> 
   <td>center</td> 
   <td>文字是否居中</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>true</td> 
  </tr> 
  <tr> 
   <td>close-text</td> 
   <td>关闭按钮自定义文本</td> 
   <td>string</td> 
   <td>—</td> 
   <td>—</td> 
  </tr> 
  <tr> 
   <td>show-icon</td> 
   <td>是否显示图标</td> 
   <td>boolean</td> 
   <td>—</td> 
   <td>false</td> 
  </tr> 
  <tr> 
   <td>effect</td> 
   <td>选择提供的主题</td> 
   <td>string</td> 
   <td>light/dark</td> 
   <td>light</td> 
  </tr> 
 </tbody> 
</table>

#### Slot ####

<table> 
 <thead> 
  <tr> 
   <th>Name</th> 
   <th>Description</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>—</td> 
   <td>描述</td> 
  </tr> 
  <tr> 
   <td>title</td> 
   <td>标题的内容</td> 
  </tr> 
 </tbody> 
</table>

#### Events ####

<table> 
 <thead> 
  <tr> 
   <th>事件名称</th> 
   <th>说明</th> 
   <th>回调参数</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>close</td> 
   <td>关闭时触发的事件</td> 
   <td>—</td> 
  </tr> 
 </tbody> 
</table>

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center]: /images/20221123/9a7b70c966b44650b503abdb436b12f4.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221123/8db90885a4c04d4facd03f574ed5aaa4.png
[20200902143704810.png_pic_center]: /images/20221123/60d23b71a14c42dba75c01ead8998a88.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20221123/5399133d066547258cf04282a43bcdf4.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 3]: /images/20221123/e3ad6fa47f99437781d79bee9616cf50.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 4]: /images/20221123/e7b4a373e44247cf9e0b286c0ac508f7.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 5]: /images/20221123/f5dbda32216847caacfc9516853d931a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 6]: /images/20221123/6506c8d5222d4fb6b5fc4bd058c022a9.png
[2020090215160867.png_pic_center]: /images/20221123/3cc7e476252b47209a2907c681972fb4.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 7]: /images/20221123/bf4d6ae8cb244375b1c685721b407eac.png
[20200903084438666.png_pic_center]: /images/20221123/942b693ba814431f87d3adb75924d71b.png
[20200903084652153.png_pic_center]: /images/20221123/4bf54585b7b847ae945f5344882b3ced.png
[2020090308483291.png_pic_center]: /images/20221123/44e0abc006434c18a427b043c27de531.png
[20200903085029328.png_pic_center]: /images/20221123/85761a8b0bc6488ab06a6b82ae26cdee.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 8]: /images/20221123/dd187ca2c6da4081bf162888340de1f2.png
[20200903090158544.png_pic_center]: /images/20221123/9c10b43a3bad4fba8b92e96c74808c42.png
[2020090309020791.png_pic_center]: /images/20221123/32958b650dad4b61a4294aae79b25185.png
[2020090309173168.png_pic_center]: /images/20221123/418891ee31734fd297951718f6566f7c.png
[20200903091953668.png_pic_center]: /images/20221123/ca32d052e6624a4ea788193d06a522f4.png
[20200903092154364.png_pic_center]: /images/20221123/16fe61467b62469a919cb1935d8e9732.png
[20200903092352494.png_pic_center]: /images/20221123/f519c5b2e047467ca5e119f1afc437b7.png
[20200903093117893.png_pic_center]: /images/20221123/610b50511e1b49caa9bad3f66f268a69.png
[20200903093304699.png_pic_center]: /images/20221123/3de2b33f551349e7ae328fb35645321c.png
[20200903093533577.png_pic_center]: /images/20221123/60ed7efbada54076bb4a94c23000396f.png
[20200903093904940.png_pic_center]: /images/20221123/e4b742b911de4b4fbfddda48f58ae133.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 9]: /images/20221123/2a5046fff6d74557a90c61b845e10968.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 10]: /images/20221123/9378c49ace284d8ebbb6032acc79d996.png
[2020090309535961.png_pic_center]: /images/20221123/87d846b41cf646db82ee962eebe2359c.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 11]: /images/20221123/d1ad3deeb1fb4caba617064c986d2fb3.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 12]: /images/20221123/32ad575db86846f5a193fbdfbbe7e89e.png
[2020090309595942.png_pic_center]: /images/20221123/ca072d77379a4ba8b5a50b716e66037a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2dvbmd4aWZhY2FpX2JlbGlldmU_size_16_color_FFFFFF_t_70_pic_center 13]: /images/20221123/07cb9a2406244b2e814e7f2103b109a2.png