mirror of
https://gitee.com/element-plus/element-plus.git
synced 2024-12-15 01:41:20 +08:00
880b1910bf
Co-authored-by: 无星 <32910694@qq.com>
171 lines
7.3 KiB
Markdown
171 lines
7.3 KiB
Markdown
## Collapse
|
|
|
|
Use Collapse para almacenar contenidos.
|
|
|
|
### Uso básico
|
|
|
|
Puede expandir varios paneles
|
|
|
|
:::demo
|
|
```html
|
|
<el-collapse v-model="activeNames" @change="handleChange">
|
|
<el-collapse-item title="Consistency" name="1">
|
|
<div>Consistent with real life: in line with the process and logic of real life, and comply with languages and habits that the users are used to;</div>
|
|
<div>Consistent within interface: all elements should be consistent, such as: design style, icons and texts, position of elements, etc.</div>
|
|
</el-collapse-item>
|
|
<el-collapse-item title="Feedback" name="2">
|
|
<div>Operation feedback: enable the users to clearly perceive their operations by style updates and interactive effects;</div>
|
|
<div>Visual feedback: reflect current state by updating or rearranging elements of the page.</div>
|
|
</el-collapse-item>
|
|
<el-collapse-item title="Efficiency" name="3">
|
|
<div>Simplify the process: keep operating process simple and intuitive;</div>
|
|
<div>Definite and clear: enunciate your intentions clearly so that the users can quickly understand and make decisions;</div>
|
|
<div>Easy to identify: the interface should be straightforward, which helps the users to identify and frees them from memorizing and recalling.</div>
|
|
</el-collapse-item>
|
|
<el-collapse-item title="Controllability" name="4">
|
|
<div>Decision making: giving advices about operations is acceptable, but do not make decisions for the users;</div>
|
|
<div>Controlled consequences: users should be granted the freedom to operate, including canceling, aborting or terminating current operation.</div>
|
|
</el-collapse-item>
|
|
</el-collapse>
|
|
<script>
|
|
export default {
|
|
data() {
|
|
return {
|
|
activeNames: ['1']
|
|
};
|
|
},
|
|
methods: {
|
|
handleChange(val) {
|
|
console.log(val);
|
|
}
|
|
}
|
|
}
|
|
</script>
|
|
<!--
|
|
<setup>
|
|
|
|
import { defineComponent, ref } from 'vue';
|
|
|
|
export default defineComponent({
|
|
setup() {
|
|
const activeNames = ref(['1']);
|
|
const handleChange = (val) => {
|
|
console.log(val);
|
|
};
|
|
return {
|
|
activeNames,
|
|
handleChange,
|
|
};
|
|
},
|
|
});
|
|
|
|
</setup>
|
|
-->
|
|
```
|
|
:::
|
|
|
|
### Acordeón
|
|
|
|
En modo acordeón sólo un panel puede ser expandido a la vez
|
|
|
|
:::demo Activa el modo acordeón usado el atributo `accordion`.
|
|
```html
|
|
<el-collapse v-model="activeName" accordion>
|
|
<el-collapse-item title="Consistency" name="1">
|
|
<div>Consistent with real life: in line with the process and logic of real life, and comply with languages and habits that the users are used to;</div>
|
|
<div>Consistent within interface: all elements should be consistent, such as: design style, icons and texts, position of elements, etc.</div>
|
|
</el-collapse-item>
|
|
<el-collapse-item title="Feedback" name="2">
|
|
<div>Operation feedback: enable the users to clearly perceive their operations by style updates and interactive effects;</div>
|
|
<div>Visual feedback: reflect current state by updating or rearranging elements of the page.</div>
|
|
</el-collapse-item>
|
|
<el-collapse-item title="Efficiency" name="3">
|
|
<div>Simplify the process: keep operating process simple and intuitive;</div>
|
|
<div>Definite and clear: enunciate your intentions clearly so that the users can quickly understand and make decisions;</div>
|
|
<div>Easy to identify: the interface should be straightforward, which helps the users to identify and frees them from memorizing and recalling.</div>
|
|
</el-collapse-item>
|
|
<el-collapse-item title="Controllability" name="4">
|
|
<div>Decision making: giving advices about operations is acceptable, but do not make decisions for the users;</div>
|
|
<div>Controlled consequences: users should be granted the freedom to operate, including canceling, aborting or terminating current operation.</div>
|
|
</el-collapse-item>
|
|
</el-collapse>
|
|
<script>
|
|
export default {
|
|
data() {
|
|
return {
|
|
activeName: '1'
|
|
};
|
|
}
|
|
}
|
|
</script>
|
|
<!--
|
|
<setup>
|
|
|
|
import { defineComponent, ref } from 'vue';
|
|
|
|
export default defineComponent({
|
|
setup() {
|
|
const activeName = ref('1');
|
|
|
|
return {
|
|
activeName,
|
|
};
|
|
},
|
|
});
|
|
|
|
</setup>
|
|
-->
|
|
```
|
|
:::
|
|
|
|
### Título personalizado
|
|
|
|
Además de usar el atributo `title`, se puede personalizar el título del panel con slots con nombre, esto hace posible agregar contenido personalizado, por ejemplo: iconos.
|
|
|
|
:::demo
|
|
```html
|
|
<el-collapse accordion>
|
|
<el-collapse-item name="1">
|
|
<template #title>
|
|
Consistency<i class="header-icon el-icon-information"></i>
|
|
</template>
|
|
<div>Consistent with real life: in line with the process and logic of real life, and comply with languages and habits that the users are used to;</div>
|
|
<div>Consistent within interface: all elements should be consistent, such as: design style, icons and texts, position of elements, etc.</div>
|
|
</el-collapse-item>
|
|
<el-collapse-item title="Feedback" name="2">
|
|
<div>Operation feedback: enable the users to clearly perceive their operations by style updates and interactive effects;</div>
|
|
<div>Visual feedback: reflect current state by updating or rearranging elements of the page.</div>
|
|
</el-collapse-item>
|
|
<el-collapse-item title="Efficiency" name="3">
|
|
<div>Simplify the process: keep operating process simple and intuitive;</div>
|
|
<div>Definite and clear: enunciate your intentions clearly so that the users can quickly understand and make decisions;</div>
|
|
<div>Easy to identify: the interface should be straightforward, which helps the users to identify and frees them from memorizing and recalling.</div>
|
|
</el-collapse-item>
|
|
<el-collapse-item title="Controllability" name="4">
|
|
<div>Decision making: giving advices about operations is acceptable, but do not make decisions for the users;</div>
|
|
<div>Controlled consequences: users should be granted the freedom to operate, including canceling, aborting or terminating current operation.</div>
|
|
</el-collapse-item>
|
|
</el-collapse>
|
|
```
|
|
:::
|
|
|
|
### Atributos de Collapse
|
|
| Atributo | Descripción | Tipo | Valores aceptados | Por defecto |
|
|
| --------- | ------------------------------------- | ---------------------------------------- | ----------------- | ----------- |
|
|
| model-value / v-model | panel activo | string (modo acordeón) / array (No modo acordeón) | — | — |
|
|
| accordion | especifica si activa el modo acordeón | boolean | — | false |
|
|
|
|
### Eventos de Collapse
|
|
| Nombre de Evento | Descripción | Parametros |
|
|
| ---------------- | ---------------------------------------- | ---------------------------------------- |
|
|
| change | se dispara cuando los paneles activos cambian | (activeNames: array (No modo acordeón) / string (modo acordeón)) |
|
|
|
|
|
|
### Atributos de Collapse Item
|
|
| Atributo | Descripción | Tipo | Valores aceptados | Por defecto |
|
|
| -------- | ----------------------------- | ------------- | ----------------- | ----------- |
|
|
| name | identificador único del panel | string/number | — | — |
|
|
| title | título del panel | string | — | — |
|
|
| disabled | deshabilita el collapse ítem | boolean | — | — |
|
|
|