dropdown Component

Basic Dropdown

Simple Dropdown

Preview Code
Copy

With Pre-selected Value

Preview Code
Copy

With Label and Help Text

Preview Code
Copy

Searchable Dropdown

With Search Functionality

Preview Code
Copy

Multiple Selection

Multi-Select with Checkboxes

Preview Code
Copy

Grouped Items

Categories with Headers

Preview Code
Copy

Clearable Dropdown

With Clear Button

Preview Code
Copy

Click × to clear selection

Color Variants

Themed Dropdowns

Preview Code
Copy

Form Integration

Complete Form Example

Preview Code
Copy

JavaScript API

The dropdown component provides a comprehensive JavaScript API for programmatic control and event handling.

Basic API Usage

Preview Code
Copy
// Get dropdown instance
const dropdown = $('.dropdown').data('hyggeDropdown');

// Methods
dropdown.getValue();                    // Get selected value(s)
dropdown.setValue('value');            // Set single value
dropdown.setValue(['val1', 'val2']);   // Set multiple values
dropdown.clearSelection();              // Clear selection
dropdown.open();                        // Open dropdown
dropdown.close();                       // Close dropdown
dropdown.toggle();                      // Toggle open/close

// Events
$('.dropdown').on('dropdown:change', function(e, value, text) {
    console.log('Selected:', value, text);
});

$('.dropdown').on('dropdown:open', function() {
    console.log('Dropdown opened');
});

$('.dropdown').on('dropdown:close', function() {
    console.log('Dropdown closed');
});

$('.dropdown').on('dropdown:clear', function() {
    console.log('Selection cleared');
});

Code Examples

Basic HTML Structure

<div class="dropdown">
    <div class="trigger">
        <span class="placeholder">Select option</span>
    </div>
    <div class="menu">
        <div class="item" data-value="1">Option 1</div>
        <div class="item" data-value="2">Option 2</div>
        <div class="item" data-value="3">Option 3</div>
    </div>
</div>

With All Options

<div class="dropdown" 
     data-searchable="true" 
     data-multiple="true"
     data-clearable="true"
     data-placeholder="Select items">
    <div class="trigger">
        <span class="placeholder">Select items</span>
    </div>
    <div class="menu">
        <div class="item" data-value="1">
            <input type="checkbox"> Item 1
        </div>
        <div class="item" data-value="2">
            <input type="checkbox"> Item 2
        </div>
    </div>
</div>

With Form Field

<div class="dropdown-field">
    <label class="label">
        Field Label <span class="required">*</span>
    </label>
    <div class="dropdown">
        <!-- Dropdown content -->
    </div>
    <p class="help-text">Helper text</p>
</div>