@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.43 kB | 0.21 kB |
| vue-collapse.js | 2.11 kB | 0.91 kB |
| vue-collapse.umd.cjs | 1.71 kB | 0.86 kB |
CSS required
:warning: ️You need to add the CSS file.
import '@kunukn/vue-collapse/style' // this imports the vue-collapse.css file.
or CDN
<link
rel="stylesheet"
href="https://unpkg.com/@kunukn/vue-collapse/dist/vue-collapse.css"
/>
or manually copy the content from the vue-collapse.css file to your app.
To alter the timing, you can use the transition prop. Or add custom CSS.
<style>
[data-vue-collapse-transition] {
transition-duration: 200ms;
transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
}
</style>
Supported versions
Vue 3
Install
npm install @kunukn/vue-collapse
Import
import '@kunukn/vue-collapse/style'
import { VueCollapse } from '@kunukn/vue-collapse'
Attribute options
There are four possible states: collapsed, collapsing, expanded, expanding.
Click: to see the attributes
| Attribute | Type | Default | About |
|---|---|---|---|
| :when | boolean | falsy | should component collapse? |
| :as | string | div | element type to render |
| transition | string | falsy | apply custom CSS transition, see demo example below |
| @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 examples
Click: Simple version using ARIA
<template>
<div class="app">
<button
@click="isCollapsed = !isCollapsed"
:aria-expanded="!isCollapsed"
aria-controls="my-description"
>
{{ display }}
</button>
<VueCollapse
id="my-description"
: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>
</VueCollapse>
</div>
</template>
<script setup>
import { VueCollapse } 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-duration: 200ms;
transition-timing-function: 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
Click: to see 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
Related Packages
vue-collapsible-component
Vue component to wrap content in Collapsible element with trigger to open and cl...
22,082
vue-bulma-accordion
A simple, easily configurable accordion or collapsible for Vue, styled with Bulm...
33,590
36
Version History
| Version | Released | Vue | License |
|---|---|---|---|
| 0.2.0 | 3.x.x | MIT | |
| 0.1.1 | 3.x.x | MIT | |
| 0.1.0 | 3.x.x | MIT | |
| 0.0.8 | 3.x.x | MIT | |
| 0.0.7 | 3.x.x | MIT | |
| 0.0.6 | 3.x.x | MIT | |
| 0.0.5 | 3.x.x | MIT | |
| 0.0.4 | 3.x.x | MIT | |
| 0.0.3 | 3.x.x | MIT | |
| 0.0.2 | 3.x.x | MIT | |
| 0.0.1 | 3.x.x | MIT |