ToggleButton
A specialized call button that triggers toggle behavior on a referenced target element.
import { ToggleButton } from "@schukai/monster/source/components/host/toggle-button.mjs";'%3E%3Cpath style='stroke:none;fill-rule:nonzero;fill:%23f03c2e;fill-opacity:1' d='M90.156 41.965 50.036 1.848a5.918 5.918 0 0 0-8.372 0l-8.328 8.332 10.566 10.566a7.03 7.03 0 0 1 7.23 1.684 7.034 7.034 0 0 1 1.669 7.277l10.187 10.184a7.028 7.028 0 0 1 7.278 1.672 7.04 7.04 0 0 1 0 9.957 7.05 7.05 0 0 1-9.965 0 7.044 7.044 0 0 1-1.528-7.66l-9.5-9.497V59.36a7.04 7.04 0 0 1 1.86 11.29 7.04 7.04 0 0 1-9.957 0 7.04 7.04 0 0 1 0-9.958 7.06 7.06 0 0 1 2.304-1.539V33.926a7.049 7.049 0 0 1-3.82-9.234L29.242 14.272 1.73 41.777a5.925 5.925 0 0 0 0 8.371L41.852 90.27a5.925 5.925 0 0 0 8.37 0l39.934-39.934a5.925 5.925 0 0 0 0-8.371'/%3E%3C/g%3E%3C/svg%3E "View source code")
Introduction
The Monster ToggleButton is a focused variant of CallButton that invokes toggle() on a referenced element. Use it when an overlay, collapse or similar component should be opened and closed from one trigger.
When to use ToggleButton
- Use it for binary open-close interactions: Especially useful for overlays, drawers and collapsible sections.
- Use it when the target already exposes
toggle(): The button stays declarative and concise. - Do not use it when behavior is not truly toggle-based: Explicit open or close actions may be clearer.
Toggle Button
A toggle button that calls toggle() on a collapse element.
Javascript
import '@schukai/monster/source/components/host/toggle-button.mjs';
import '@schukai/monster/source/components/layout/collapse.mjs';<script type="module">import '@schukai/monster/source/components/host/toggle-button.mjs';
import '@schukai/monster/source/components/layout/collapse.mjs';</script>HTML
<monster-collapse class="toggle-target" data-monster-option-labels-title="Section">
<div slot="content">Collapsible content</div>
</monster-collapse>
<monster-toggle-button data-monster-reference=".toggle-target">
Toggle section
</monster-toggle-button>Stylesheet
/** no additional stylesheet is defined **/Component Design
The toggle button inherits the call button structure and exposes the same part for styling.
control: Wrapper around the toggle button.
monster-toggle-button::part(control) {
display: inline-flex;
}
HTML Structure
<monster-toggle-button></monster-toggle-button>JavaScript Initialization
const element = document.createElement('monster-toggle-button');
document.body.appendChild(element);Exported
ToggleButtonDerived from
CallButtonOptions
The Options listed in this section are defined directly within the class. This class is derived from several parent classes, including the CustomElement class. Therefore, it inherits Options from these parent classes. If you cannot find a specific Options in this list, we recommend consulting the documentation of the CallButton.
- since
- deprecated
Properties and Attributes
The Properties and Attributes listed in this section are defined directly within the class. This class is derived from several parent classes, including the CustomElement class and ultimately from HTMLElement. Therefore, it inherits Properties and Attributes from these parent classes. If you cannot find a specific Properties and Attributes in this list, we recommend consulting the documentation of the CallButton.
data-monster-options: Sets the configuration options for the collapse component when used as an HTML attribute.data-monster-option-[name]: Sets the value of the configuration option[name]for the collapse component when used as an HTML attribute.
Methods
The methods listed in this section are defined directly within the class. This class is derived from several parent classes, including the CustomElement class and ultimately from HTMLElement. Therefore, it inherits methods from these parent classes. If you cannot find a specific method in this list, we recommend consulting the documentation of the CallButton.
Static methods
[instanceSymbol]()- {symbol}
instanceof operator.getTag()- {string}
Events
This component does not fire any public events. It may fire events that are inherited from its parent classes.