Skip to content
A jQuery plugin that collapses boxes of content using CSS3 transition (it can also works as an accordion)
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist
fonts
js
sass
.gitignore
.travis.yml
LICENSE
README.md
_config.yml
circle.yml
example.html
gulpfile.js
package.json
yarn.lock

README.md

cssCollapse is a jQuery plugin that collapses elements using CSS3 transitions

Build Status github tag

This plugin was developed to slide the content of a hidden box using the CSS3 transitions rules.

Examples

See the cssCollapse jQuery plugin in actions!

Options and parameters

It works with the following parameters that can be overwritten if needed.

  • accordion: this variable set if the collapse has to behave like an accordion or not (the default is 'false', this means that if you want the accordion behavior, you have to call the plugin with the variable inside it set to 'true')
  • accordionContainer: this variable is the class that tells the plugin the container class for the accordion (the default is 'accordionContainer')
  • prefix: this is the prefix that you can use for all the classes of this plugin to distinguish the instances or the libraries or other plugins that you are using that in some cases can use the same class names (the default is 'cssCollapse-')
  • targetClass: this is the target class where the click perform the action. The target can be a link or a button or a box (the default is 'target')
  • targetSelected: this is the class that is put to the open accordion target (the default is 'selected')
  • hiddenContentClass: this is the class that contain the hidden content that has to be shown when the target class has been clicked (the default is 'hiddenContent')
  • collapseClass: this is the class that is put to show the hidden stuff. NOTE: if you change this class you have to modify also the CSS (the default is 'is-open')
  • iconClass: this is the general class that you have to add if you are using icon-fonts to indicate the opening and closing of the box (the default is 'collapseIcons')
  • iconOpen: this is the class for the icon-font when the hidden content is shown (the default is 'diff-added')
  • iconClose: this is the class for the icon-font when the hidden content is hidden (the default is 'diff-removed')
  • behavior: this is the CSS3 transitions name that you want to use examples are ease, linear, etc (the default is false to let the css rules works itself)
  • duration: this is the transitions speed that you want to use (the default is false to let the css rules works itself)
  • delay: this is the CSS3 transitions delay that you want to use (the default is false to let the css rules works itself)
  • accordionCloseLinkClass: this is the the class for the closing link inside the accordion, if needed (the default is 'closeAccordion')
  • noScrollClass: this is the the class that you have to use in your HTML near the target class, if you don't want to scroll the page when the target is clicked (the default class name is 'noScroll')

Usage

Apply the plugin to a single selector that have to contain the target and the hidden content to make it work independently one to the other in the same page.

It can be applied also to the entire document if the same behavior is required for all the components inside the page.

Use the plugin as shown in the examples below and in the example.html file.

$(document).cssCollapse({
    accordion: true,
    targetClass: 'accordion-target',
    hiddenContentClass: 'accordion-hiddenContent',
    iconClose: 'chevron-down',
    iconOpen: 'chevron-up'
});

Remember to structure the CSS as shown below. It is a plugin that is using the CSS3 transitions, so some rules are needed.

In particular the classes that have to be present in the CSS are .hiddenContent and .hiddenContent.is-open

.hiddenContent {
    overflow-y: hidden;
    padding: 0 20px;
    max-height: 0px;
    -webkit-transition: ease-in-out 600ms max-height;
    -moz-transition: ease-in-out 600ms max-height;
    -o-transition: ease-in-out 600ms max-height;
    transition: ease-in-out 600ms max-height;
}

.hiddenContent.is-open {
    -webkit-transition: ease-in-out 600ms max-height;
    -moz-transition: ease-in-out 600ms max-height;
    -o-transition: ease-in-out 600ms max-height;
    transition: ease-in-out 600ms max-height;
}

The transition attributes can be omitted in the CSS and put in the plugin call as shown before. Remember that if they are present in both places the JS ones are the one that will be played.


Known issues

This plugin, obviously, does not show the transition animations for the hidden boxes on older browsers like Internet Explorer 7/8/9 because they do not support the CSS 3 transitions rules.

The behavior on these browsers will be a simple hide/show of the hidden content.

To fix this issue, you may try some Polyfill.

You can’t perform that action at this time.