README

Searchable DropDownList form control for Nette Framework with AJAX-powered Nette\Database\Table\Selection datasource.

📖 Full documentation →

Installation

composer require phloxcz/forms-dropdownlist

Include the assets in your base layout:

<link  rel="stylesheet" href="{$basePath}/vendor/phloxcz/forms-dropdownlist/assets/dropdownlist.css">
<script src="{$basePath}/vendor/phloxcz/forms-dropdownlist/assets/dropdownlist.js" defer></script>

Quick start

1. Register the DI extension

# config/common.neon
extensions:
    dropdownlist: Phlox\Forms\DropDownList\DropDownListExtension

2. Add the control to your form

$form->addDropDownList('cityId', 'City', $this->link('searchCity!'))
     ->setSelection($this->database->table('cities'), 'id', 'name')
     ->setPlaceholder('Select city…')
     ->setTheme(DropDownListInput::THEME_BOOTSTRAP);

3. Handle the AJAX signal

public function handleSearchCity(string $q = ''): void
{
    $this->sendJson($this['cityForm']['cityId']->fetchData($q));
}

4. Pre-fill on edit pages

$form->setValues(['cityId' => $entity->cityId]);
// Label is resolved server-side – no extra AJAX on page load.

Themes

License

MIT © Phlox