• Collapse 折叠面板
    • 基础用法
    • 手风琴效果
    • 自定义面板标题
    • Collapse Attributes
    • Collapse Events
    • Collapse Item Attributes

    Collapse 折叠面板

    通过折叠面板收纳内容区域

    基础用法

    可同时展开多个面板,面板之间不影响

    Collapse 折叠面板 - 图1

    1. <el-collapse v-model="activeNames" @change="handleChange">
    2. <el-collapse-item title="一致性 Consistency" name="1">
    3. <div>与现实生活一致:与现实生活的流程、逻辑保持一致,遵循用户习惯的语言和概念;</div>
    4. <div>在界面中一致:所有的元素和结构需保持一致,比如:设计样式、图标和文本、元素的位置等。</div>
    5. </el-collapse-item>
    6. <el-collapse-item title="反馈 Feedback" name="2">
    7. <div>控制反馈:通过界面样式和交互动效让用户可以清晰的感知自己的操作;</div>
    8. <div>页面反馈:操作后,通过页面元素的变化清晰地展现当前状态。</div>
    9. </el-collapse-item>
    10. <el-collapse-item title="效率 Efficiency" name="3">
    11. <div>简化流程:设计简洁直观的操作流程;</div>
    12. <div>清晰明确:语言表达清晰且表意明确,让用户快速理解进而作出决策;</div>
    13. <div>帮助用户识别:界面简单直白,让用户快速识别而非回忆,减少用户记忆负担。</div>
    14. </el-collapse-item>
    15. <el-collapse-item title="可控 Controllability" name="4">
    16. <div>用户决策:根据场景可给予用户操作建议或安全提示,但不能代替用户进行决策;</div>
    17. <div>结果可控:用户可以自由的进行操作,包括撤销、回退和终止当前操作等。</div>
    18. </el-collapse-item>
    19. </el-collapse>
    20. <script>
    21. export default {
    22. data() {
    23. return {
    24. activeNames: ['1']
    25. };
    26. },
    27. methods: {
    28. handleChange(val) {
    29. console.log(val);
    30. }
    31. }
    32. }
    33. </script>

    手风琴效果

    每次只能展开一个面板

    Collapse 折叠面板 - 图2

    通过 accordion 属性来设置是否以手风琴模式显示。

    1. <el-collapse v-model="activeName" accordion>
    2. <el-collapse-item title="一致性 Consistency" name="1">
    3. <div>与现实生活一致:与现实生活的流程、逻辑保持一致,遵循用户习惯的语言和概念;</div>
    4. <div>在界面中一致:所有的元素和结构需保持一致,比如:设计样式、图标和文本、元素的位置等。</div>
    5. </el-collapse-item>
    6. <el-collapse-item title="反馈 Feedback" name="2">
    7. <div>控制反馈:通过界面样式和交互动效让用户可以清晰的感知自己的操作;</div>
    8. <div>页面反馈:操作后,通过页面元素的变化清晰地展现当前状态。</div>
    9. </el-collapse-item>
    10. <el-collapse-item title="效率 Efficiency" name="3">
    11. <div>简化流程:设计简洁直观的操作流程;</div>
    12. <div>清晰明确:语言表达清晰且表意明确,让用户快速理解进而作出决策;</div>
    13. <div>帮助用户识别:界面简单直白,让用户快速识别而非回忆,减少用户记忆负担。</div>
    14. </el-collapse-item>
    15. <el-collapse-item title="可控 Controllability" name="4">
    16. <div>用户决策:根据场景可给予用户操作建议或安全提示,但不能代替用户进行决策;</div>
    17. <div>结果可控:用户可以自由的进行操作,包括撤销、回退和终止当前操作等。</div>
    18. </el-collapse-item>
    19. </el-collapse>
    20. <script>
    21. export default {
    22. data() {
    23. return {
    24. activeName: '1'
    25. };
    26. }
    27. }
    28. </script>

    自定义面板标题

    除了可以通过 title 属性以外,还可以通过具名 slot 来实现自定义面板的标题内容,以实现增加图标等效果。

    Collapse 折叠面板 - 图3

    1. <el-collapse accordion>
    2. <el-collapse-item>
    3. <template slot="title">
    4. 一致性 Consistency<i class="header-icon el-icon-info"></i>
    5. </template>
    6. <div>与现实生活一致:与现实生活的流程、逻辑保持一致,遵循用户习惯的语言和概念;</div>
    7. <div>在界面中一致:所有的元素和结构需保持一致,比如:设计样式、图标和文本、元素的位置等。</div>
    8. </el-collapse-item>
    9. <el-collapse-item title="反馈 Feedback">
    10. <div>控制反馈:通过界面样式和交互动效让用户可以清晰的感知自己的操作;</div>
    11. <div>页面反馈:操作后,通过页面元素的变化清晰地展现当前状态。</div>
    12. </el-collapse-item>
    13. <el-collapse-item title="效率 Efficiency">
    14. <div>简化流程:设计简洁直观的操作流程;</div>
    15. <div>清晰明确:语言表达清晰且表意明确,让用户快速理解进而作出决策;</div>
    16. <div>帮助用户识别:界面简单直白,让用户快速识别而非回忆,减少用户记忆负担。</div>
    17. </el-collapse-item>
    18. <el-collapse-item title="可控 Controllability">
    19. <div>用户决策:根据场景可给予用户操作建议或安全提示,但不能代替用户进行决策;</div>
    20. <div>结果可控:用户可以自由的进行操作,包括撤销、回退和终止当前操作等。</div>
    21. </el-collapse-item>
    22. </el-collapse>

    Collapse Attributes

    参数说明类型可选值默认值
    value / v-model当前激活的面板(如果是手风琴模式,绑定值类型需要为string,否则为array)string / array
    accordion是否手风琴模式booleanfalse

    Collapse Events

    事件名称说明回调参数
    change当前激活面板改变时触发(如果是手风琴模式,参数 activeNames 类型为string,否则为array)(activeNames: array / string)

    Collapse Item Attributes

    参数说明类型可选值默认值
    name唯一标志符string/number
    title面板标题string
    disabled是否禁用boolean