nepttune/ajaxselect

Ajax-filled selectbox for nette forms.

v2.4.3 2022-12-02 20:28 UTC

This package is auto-updated.

Last update: 2024-10-30 01:59:31 UTC


README

🔧 Ajax-filled selectbox for nette forms.

Packagist Packagist CommitsSinceTag

Code Climate Scrutinizer Code Quality

Introduction

This extension provides easy to use ajax-driven selectbox.

Dependencies

How to use

  • Register \Nepttune\DI\AjaxSelectExtension as nette extension.
  • Use addAjaxSelect or addAjaxMultiSelect in your forms.

Example configuration

extensions:
    ajaxSelect: Nepttune\DI\AjaxSelectExtension

Example form

$form->addAjaxSelect('client_id', 'Klient', function (string $query, ?int $default = 0) {
      if ($default) {
          $row = $this->repository->getRow($default);
          return [$row->id => $row->name];
      }

      return $this->repository->search($query);
  })
  ->setPrompt('--- Vyberte ---')
  ->setRequired();

Parameter $query contains text being searched, parametered $default contains value which is set as default (for example when editing existing entry, you need to provide saved key => value in your callback).

Javascript snippet using select2

if ($(this).data('ajaxselect')) {
    $(this).select2({
        tokenSeparators: [',', ' '],
        ajax: {
            url: $(this).data('ajaxselect'),
            delay: 250,
            dataType: 'json',
            data: function (params) {
                return {
                    q: params.term
                };
            },
            processResults: function (data, params) {
                var result = [];
                $.each(data, function (key, value) {
                    result.push({
                        id: key,
                        text: value
                    });
                });
                return {
                    results: result
                };
            }
        }
    });
}