Bootstrap 5 Toggle: Turn Checkboxes into Toggles

Bootstrap 5 Toggle

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

Installation

CDN

jQuery Interface

<link
  href="https://cdn.jsdelivr.net/npm/bootstrap5-toggle@4.3.6/css/bootstrap5-toggle.min.css"
  rel="stylesheet" />
<script src="https://cdn.jsdelivr.net/npm/bootstrap5-toggle@4.3.6/js/bootstrap5-toggle.min.js"></script>

ECMAS Interface

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

Download

NPM

npm install bootstrap5-toggle@4.3.6

Yarn

yarn add bootstrap5-toggle@4.3.6

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>
  $(function () {
    $("#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-on="Enabled"
  data-off="Disabled" />
<input type="checkbox" id="toggle-two" />
<script>
  $(function () {
    $("#toggle-two").bootstrapToggle({
      on: "Enabled",
      off: "Disabled",
    });
  });
</script>

Methods

Methods can be used to control toggles directly.

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

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>
  $(function () {
    $("#toggle-event").change(function () {
      $("#console-event").html("Toggle: " + $(this).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() {
    $("#toggle-silent").bootstrapToggle("on", true);
  }
  function toggleApiOffSilent() {
    $("#toggle-silent").bootstrapToggle("off", true);
  }
  function toggleApiOnNotSilent() {
    $("#toggle-silent").bootstrapToggle("on");
  }
  function toggleApiOffNotSilent() {
    $("#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() {
    $("#toggle-trigger").bootstrapToggle("on");
  }
  function toggleApiOff() {
    $("#toggle-trigger").bootstrapToggle("off");
  }
  function toggleInpOn() {
    $("#toggle-trigger").prop("checked", true).change();
  }
  function toggleInpOff() {
    $("#toggle-trigger").prop("checked", false).change();
  }
</script>

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

Download Details:

Author: palcarazm
Source Code: https://github.com/palcarazm/bootstrap5-toggle 
License: MIT license

#bootstrap #switch