7.0 KiB
| title | description | js | mui | video |
|---|---|---|---|---|
| Toggler | Toggler makes it easy to toggle CSS or animate any element with a click. | js/foundation.toggler.js | true | wHpZCrpKlBc |
Toggle a CSS class
To setup a class toggle, start by adding the attribute data-toggler to an element. The value of data-toggler is the class you want to toggle (like .classname and classname). Also give the element a unique ID so it can be targeted.
Watch this part in video
<ul class="menu" id="menuBar" data-toggler=".expanded">
<li><a href="#">One</a></li>
<li><a href="#">Two</a></li>
<li><a href="#">Three</a></li>
<li><a href="#">Four</a></li>
</ul>
Then, add data-toggle to any element, with the ID of the target as the value of the attribute. Now, any time you click on this element, the class will toggle on and off on the target.
<p><a data-toggle="menuBar">Expand!</a></p>
Expand!
Toggle with Animation
Instead of toggling a class, you can also toggle visibility. When toggled, the element comes into or out of view using a Motion UI class.
Instead of data-toggler, add the attribute data-animate. The value of the attribute is the in animation you want, followed by the out animation.
Watch this part in video
<p><a data-toggle="panel">Toggle Panel</a></p>
<div class="callout" id="panel" data-toggler data-animate="hinge-in-from-top spin-out">
<h4>Hello!</h4>
<p>Lorem ipsum dolor sit amet, consectetur adipisicing elit. Dicta quas optio alias voluptas nobis iusto mollitia asperiores incidunt reprehenderit doloribus voluptatibus officiis minus, inventore, quasi nisi. Consequuntur, quidem. Sint, dicta?</p>
</div>
Mark as Closable
To create an element that can be closed once, add the attribute data-closable. Then add a click trigger inside the element using data-close.
Watch this part in video
<div class="callout" data-closable>
<button class="close-button" data-close>×</button>
<p>Lorem ipsum dolor sit amet, consectetur adipisicing elit. Labore praesentium sint alias dolorum qui vel quaerat, libero consequatur non esse asperiores veritatis commodi, odit eum ipsam nemo dicta iste aliquam.</p>
</div>
With Alternate Animation
data-closable can be configured with a custom exit animation.
Watch this part in video
<div class="callout" data-closable="slide-out-right">
<button class="close-button" data-close>×</button>
<p>Lorem ipsum dolor sit amet, consectetur adipisicing elit. Labore praesentium sint alias dolorum qui vel quaerat, libero consequatur non esse asperiores veritatis commodi, odit eum ipsam nemo dicta iste aliquam.</p>
</div>
Toggle on focus
The data-toggle attribute only toggles classes/visibility on click. You can also have the toggle fire when an element is focused or unfocused using data-toggle-focus.
Watch this part in video
<input type="text" data-toggle-focus="form-callout" placeholder="Click in here to reveal extra content">
<div class="secondary callout is-hidden" id="form-callout" data-toggler="is-hidden">
<p>This is only visible when the above field has focus.</p>
</div>
Multiple Targets
The data-toggle, data-close, and data-open attributes can now target multiple elements! The syntax is simple; just pass a space separated list to the data-x attribute like so:
Watch this part in video
<button class="button" data-toggle="foo bar baz">Toggle things</button>
Then the elements with ids of foo, bar, and baz will be toggled any time your button, (or any other element you choose), is clicked.
Toggle All These
