# Documentation v8.0.38

Preview Downloads Purchase

# Overview

Bootstrap Selectsplitter's transforms a `<select>`containing one or more `<optgroup>`in two chained `<select>`. For full documentation please check the plugin's repository.

# Usage

Bootstrap Selectsplitter's Javascript files are bundled in the global plugin bundles and globally included in all pages:

    <script src="assets/plugins/global/plugins.bundle.js"></script>

# Example 1

Create a `<select>`with at least one `<optgroup>`. Each `<option>`of your `<select>`must have a unique value.

    $("#kt_multiselectsplitter_example_1").multiselectsplitter();

    <select id="kt_multiselectsplitter_example_1" multiple="multiple">
        <optgroup label="Category 1">
            <option value="1">Choice 1</option>
            <option value="2">Choice 2</option>
            <option value="3" selected="selected">Choice 3</option>
            <option value="4">Choice 4</option>
        </optgroup>
        <optgroup label="Category 2">
            <option value="5">Choice 5</option>
            <option value="6" selected="selected">Choice 6</option>
            <option value="7">Choice 7</option>
            <option value="8">Choice 8</option>
        </optgroup>
        <optgroup label="Category 3">
            <option value="9">Choice 9</option>
            <option value="10">Choice 10</option>
            <option value="11">Choice 11</option>
            <option value="12">Choice 12</option>
        </optgroup>
    </select>

# Example 2

Multiple select of size 7 with group counter. Second select is cleared, when first changed:

    $("#kt_multiselectsplitter_example_2").multiselectsplitter({
        selectSize: 7,
        clearOnFirstChange: true,
        groupCounter: true
    });

    <select id="kt_multiselectsplitter_example_2" multiple="multiple">
        <optgroup label="Category 1">
            <option value="1">Choice 1</option>
            <option value="2">Choice 2</option>
            <option value="3" selected="selected">Choice 3</option>
            <option value="4">Choice 4</option>
        </optgroup>
        <optgroup label="Category 2">
            <option value="5">Choice 5</option>
            <option value="6" selected="selected">Choice 6</option>
            <option value="7">Choice 7</option>
            <option value="8">Choice 8</option>
        </optgroup>
        <optgroup label="Category 3">
            <option value="9">Choice 9</option>
            <option value="10">Choice 10</option>
            <option value="11">Choice 11</option>
            <option value="12">Choice 12</option>
        </optgroup>
    </select>

# Example 3

Multiple select with group counter. You can select maximum 2 options of all categories:

    $("#kt_multiselectsplitter_example_3").multiselectsplitter({
        groupCounter: true,
        maximumSelected: 2
    });

    <select id="kt_multiselectsplitter_example_3" multiple="multiple">
        <optgroup label="Category 1">
            <option value="1">Choice 1</option>
            <option value="2">Choice 2</option>
            <option value="3" selected="selected">Choice 3</option>
            <option value="4">Choice 4</option>
        </optgroup>
        <optgroup label="Category 2">
            <option value="5">Choice 5</option>
            <option value="6" selected="selected">Choice 6</option>
            <option value="7">Choice 7</option>
            <option value="8">Choice 8</option>
        </optgroup>
        <optgroup label="Category 3">
            <option value="9">Choice 9</option>
            <option value="10">Choice 10</option>
            <option value="11">Choice 11</option>
            <option value="12">Choice 12</option>
        </optgroup>
    </select>

# Example 4

Multiple select with group counter. You can select maximum 3 options ONLY from one cattegory:

    $("#kt_multiselectsplitter_example_4").multiselectsplitter({
        groupCounter: true,
        maximumSelected: 3,
        onlySameGroup: true
    });

    <select id="kt_multiselectsplitter_example_4" multiple="multiple">
        <optgroup label="Category 1">
            <option value="1">Choice 1</option>
            <option value="2">Choice 2</option>
            <option value="3" selected="selected">Choice 3</option>
            <option value="4">Choice 4</option>
        </optgroup>
        <optgroup label="Category 2">
            <option value="5">Choice 5</option>
            <option value="6">Choice 6</option>
            <option value="7">Choice 7</option>
            <option value="8">Choice 8</option>
        </optgroup>
        <optgroup label="Category 3">
            <option value="9">Choice 9</option>
            <option value="10">Choice 10</option>
            <option value="11">Choice 11</option>
            <option value="12">Choice 12</option>
        </optgroup>
    </select>

# Example 5

Multiple select with custom functions for creating options. Select works even with custom text. On background, original select is correctly updated with original values. Maximum alert message was changed:

    $("#kt_multiselectsplitter_example_5").multiselectsplitter({
        size: 6,
        groupCounter: true,
        maximumSelected: 2,
        maximumAlert: function(maximumSelected) {
            alert("You choose " + ( maximumSelected + 1 ) + " options. Are you crazy ?");
        },
        createFirstSelect: function (label, $originalSelect) {
            return "<option class=\"text-success\">prefix - " + label + "</option>";
        },
        createSecondSelect: function (label, $firstSelect) {
            return "<option class=\"text-danger\"> ??? </option>";
        }
    });

    <select id="kt_multiselectsplitter_example_5" multiple="multiple">
        <optgroup label="Category 1">
            <option value="1">Choice 1</option>
            <option value="2">Choice 2</option>
            <option value="3">Choice 3</option>
            <option value="4">Choice 4</option>
        </optgroup>
        <optgroup label="Category 2">
            <option value="5">Choice 5</option>
            <option value="6">Choice 6</option>
            <option value="7">Choice 7</option>
            <option value="8">Choice 8</option>
        </optgroup>
        <optgroup label="Category 3">
            <option value="9">Choice 9</option>
            <option value="10">Choice 10</option>
            <option value="11">Choice 11</option>
            <option value="12">Choice 12</option>
        </optgroup>
    </select>

### Explore

### Metronic Licenses

License FAQs
Regular License
For single end product used by you or one client
$ 39
Extended License
For single SaaS app with paying users
$ 969
Custom License
Reach us for custom license offers.
Contact Us
Buy Now

### Metronic Demos

Demo 1
Demo 2
Demo 3
Demo 4
Demo 5
Demo 6
Demo 7
Demo 8
Demo 9
Demo 10
Demo 11
Demo 12
Demo 13
Demo 14
Demo 15
Demo 16
Demo 17
Demo 18
Demo 19
Demo 20
Demo 21
Demo 22
Coming soon
Coming soon

##### Learn & Get Inspired

## Support at devs.keenthemes.com

Join our developers community to find answer to your question and help others. FAQs
Get Support
Documentation & Videos
From guides and video tutorials, to live demos and code examples to get started.
Plugins & Components
Check out our 300+ in-house components and customized 3rd-party plugins.
Layout Builder
Build your layout, preview it and export the HTML for server side integration.
Metronic Downloads
Download your prefered framework and demo with one click.
What's New
Latest features and improvements added with our users feedback in mind.
Buy now