@kunukn/vue-collapse

Vue Collapse

Collapsible component with CSS transition for elements with variable and dynamic height.

vue-collapse

Demo

Codesandbox simple Vue 3

View

Edit

Tiny library

name	size	gzip
vue-collapse.css	0.37 kB	0.20 kB
vue-collapse.js	2.11 kB	0.91 kB
vue-collapse.umd.cjs	1.72 kB	0.88 kB

CSS required

⚠️ ️You need to add the CSS file.

import "@kunukn/vue-collapse/dist/vue-collapse.css"

or CDN

<link
  rel="stylesheet"
  href="https://unpkg.com/@kunukn/vue-collapse/dist/vue-collapse.css"
/>

Supported versions

Vue 3

Install

npm install @kunukn/vue-collapse

Import

import "@kunukn/vue-collapse/dist/vue-collapse.css";
import { VueCollapse } from "@kunukn/vue-collapse";

Attribute options

There are four possible states: collapsed, collapsing, expanded, expanding.

Attribute	Type	Default	About
:when	boolean	falsy	should component collapse?
:transition	string	falsy	apply custom CSS transition
:as	string	div	element type to render
@collapse()	function		event emitted with component in this state
@collapsing()	function		event emitted with component in this state
@expanded()	function		event emitted with component in this state
@expanding()	function		event emitted with component in this state
@event(state)	function		event emitted with one of the 4 states
@init(state)	function		component mount event emitted with current state

Usage example

Simple

<template>
  <div class="app">
    <button @click="isCollapsed = !isCollapsed">{{ display }}</button>

    <section class="section">
      <Collapse :when="isCollapsed" @event="onEvent" v-slot="{ state }">
        <p class="long-text">
          I know the state: {{ state }}. Lorem Ipsum is simply dummy text of the
          printing and typesetting industry.
        </p>
      </Collapse>
    </section>
  </div>
</template>

<script setup>
import { VueCollapse as Collapse } from "@kunukn/vue-collapse";
import { ref } from "vue";

const isCollapsed = ref(false);
const display = ref("");

const onEvent = (state) => {
  display.value = "event " + state;
};
</script>

<style>
/* Custom easing */
.vue-collapse[data-vue-collapse-transition] {
  transition: grid-template-rows 250ms cubic-bezier(0.4, 0, 0.2, 1);
}
</style>

CDN

https://unpkg.com/@kunukn/vue-collapse/

Supported browsers

Modern browsers that can CSS transition on grid-template-rows.

Design goals

• Minimal in file size
• Let the browser handle the animation using CSS transition
• Minimalistic API
• Flexible - provide your own markup, styling and easing
• Interruptible - can be reversed during movement
• Inert - when collapsed you should tab over the collapsed component
• Availability - from CDN or npm install
• Collapsible on height only