bootstrap5-toggle

v5.1.0

Published

20 days ago

Bootstrap Toggle is a bootstrap 5 plugin that converts checkboxes into toggles.

Downloads

4,252

0High
0Medium
0Low

palcarazm

bootstrap bootstrap5 bootstrap-5 bootstrap 5 bootstrap checkbox bootstrap switch bootstrap toggle bootstrap-checkbox bootstrap-switch bootstrap-switch-button bootstrap-toggle

Bootstrap 5 Toggle

Bootstrap 5 Toggle is a bootstrap plugin/widget that converts checkboxes into toggles.

Library Distributions

| Version | Bootstrap Support | Last Release | End of Life | | :----------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | | v5 | | | | | v4 | | | | | v3 | | | |

See EOL for each version in Security Policy Page.

Demos

Demos and API Docs: https://palcarazm.github.io/bootstrap5-toggle/

Related Bootstrap Plugins

Installation

CDN

ECMAS Interface

<link
  href="https://cdn.jsdelivr.net/npm/[email protected]/css/bootstrap5-toggle.min.css"
  rel="stylesheet" />
<script src="https://cdn.jsdelivr.net/npm/[email protected]/js/bootstrap5-toggle.ecmas.min.js"></script>

jQuery Interface

<link
  href="https://cdn.jsdelivr.net/npm/[email protected]/css/bootstrap5-toggle.min.css"
  rel="stylesheet" />
<script src="https://cdn.jsdelivr.net/npm/[email protected]/js/bootstrap5-toggle.jquery.min.js"></script>

Download

NPM

npm install [email protected]

Yarn

yarn add [email protected]

Usage

Initialize With HTML

Simply add data-toggle="toggle" to automatically convert a plain checkbox into a bootstrap 5 toggle.

<input id="chkToggle" type="checkbox" data-toggle="toggle" />

Initialize With Code

Toggles can also be initialized via JavaScript code.

EX: Initialize id chkToggle with a single line of JavaScript.

<input id="chkToggle" type="checkbox" checked />
<script>
  document.querySelector("#chkToggle").bootstrapToggle();
</script>

API

Options

Options can be passed via data attributes or JavaScript
For data attributes, append the option name to data- (ex: data-on="Enabled")

<input
  type="checkbox"
  data-toggle="toggle"
  data-onlabel="Enabled"
  data-offlabel="Disabled" />
<input type="checkbox" id="toggle-two" />
<script>
  document.querySelector("#toggle-two").bootstrapToggle({
    on: "Enabled",
    off: "Disabled",
  });
</script>

| Name | Type | Default | Description | | ---------- | ----------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | onlabel | string/html | "On" | Text of the on toggle | | offlabel | string/html | "Off" | Text of the off toggle | | size | string | "normal" | Size of the toggle. Possible values are: large, normal, small, mini. | | onstyle | string | "primary" | Style of the on toggle. Possible values are: primary, secondary, success, danger, warning, info, light, dark and with outline- prefix | | offstyle | string | "secondary" | Style of the off toggle. Possible values are: primary, secondary, success, danger, warning, info, light, dark and with outline- prefix | | onvalue | string | null | Sets on state value | | offvalue | string | null | Sets off state value | | ontitle | string | null | Title of the on toggle | | offtitle | string | null | Title of the off toggle | | style | string | | Appends the value to the class attribute of the toggle. This can be used to apply custom styles. Refer to Custom Styles for reference. | | width | integer | null | Sets the width of the toggle. if set to null, width will be auto-calculated. | | height | integer | null | Sets the height of the toggle. if set to null, height will be auto-calculated. | | tabindex | integer | 0 | Sets the tabindex of the toggle. | | tristate | boolean | false | Sets tristate support |

Methods

Methods can be used to control toggles directly.

<input id="toggle-demo" type="checkbox" data-toggle="toggle" />
<script>
  const toggleDemo = document.querySelector("#toggle-demo");
</script>

| Method | Example | Description | | ------------- | --------------------------------------------- | ------------------------------------------------------------------------------------- | | initialize | toggleDemo.bootstrapToggle() | Initializes the toggle plugin with options | | destroy | toggleDemo.bootstrapToggle('destroy') | Destroys the toggle | | rerender | toggleDemo.bootstrapToggle('rerender') | Rerender toggle with the appropriated size. Useful when parent is collapsed at first. | | on | toggleDemo.bootstrapToggle('on') | Sets the toggle to 'On' state | | off | toggleDemo.bootstrapToggle('off') | Sets the toggle to 'Off' state | | toggle | toggleDemo.bootstrapToggle('toggle') | Toggles the state of the toggle on/off | | enable | toggleDemo.bootstrapToggle('enable') | Enables the toggle | | disable | toggleDemo.bootstrapToggle('disable') | Disables the toggle | | readonly | toggleDemo.bootstrapToggle('readonly') | Disables the toggle but preserve checkbox enabled | | indeterminate | toggleDemo.bootstrapToggle('indeterminate') | Sets the toggle to 'indeterminate' state | | determinate | toggleDemo.bootstrapToggle('determinate') | Sets the toggle to 'determinate' state |

Events

Event Propagation

Note All events are propagated to and from input element to the toggle.

You should listen to events from the <input type="checkbox"> directly rather than look for custom events.

<input id="toggle-event" type="checkbox" data-toggle="toggle" />
<div id="console-event"></div>
<script>
  document.querySelector("#toggle-event").change(function (e) {
    document
      .querySelector("#console-event")
      .html("Toggle: " + e.target.prop("checked"));
  });
</script>

Stopping Event Propagation

Passing true to the on, off, toggle, determinate and indeterminate methods will enable the silent option to prevent the control from propagating the change event in cases where you want to update the controls on/off state, but do not want to fire the onChange event.

<input id="toggle-silent" type="checkbox" data-toggle="toggle" />
<button class="btn btn-success" onclick="toggleApiOnSilent()">
  On by API (silent)
</button>
<button class="btn btn-success" onclick="toggleApiOffSilent()">
  Off by API (silent)
</button>
<button class="btn btn-warning" onclick="toggleApiOnNotSilent()">
  On by API (not silent)
</button>
<button class="btn btn-warning" onclick="toggleApiOffNotSilent()">
  On by API (not silent)
</button>
<script>
  function toggleApiOnSilent() {
    document.querySelector("#toggle-silent").bootstrapToggle("on", true);
  }
  function toggleApiOffSilent() {
    document.querySelector("#toggle-silent").bootstrapToggle("off", true);
  }
  function toggleApiOnNotSilent() {
    document.querySelector("#toggle-silent").bootstrapToggle("on");
  }
  function toggleApiOffNotSilent() {
    document.querySelector("#toggle-silent").bootstrapToggle("off");
  }
</script>

API vs Input

This also means that using the API or Input to trigger events will work both ways.

<input id="toggle-trigger" type="checkbox" data-toggle="toggle" />
<button class="btn btn-success" onclick="toggleApiOn()">On by API</button>
<button class="btn btn-danger" onclick="toggleApiOff()">Off by API</button>
<button class="btn btn-success" onclick="toggleInpOn()">On by Input</button>
<button class="btn btn-danger" onclick="toggleInpOff()">Off by Input</button>
<script>
  function toggleApiOn() {
    document.querySelector("#toggle-trigger").bootstrapToggle("on");
  }
  function toggleApiOff() {
    document.querySelector("#toggle-trigger").bootstrapToggle("off");
  }
  function toggleInpOn() {
    document.querySelector("#toggle-trigger").prop("checked", true).change();
  }
  function toggleInpOff() {
    document.querySelector("#toggle-trigger").prop("checked", false).change();
  }
</script>

Collaborators welcom!

:sos: ¿Do you need some help? Open a issue in GitHub help wanted
:bug: ¿Do you find a bug? Open a issue in GitHub bug report
:bulb: ¿Do you have a great idea? Open a issue in GitHub feature request
:computer: ¿Do you know how to fix a bug? Open a pull request in GitHub pull repuest.

¿Do you like the project? Give us a :star: in GitHub.