sloveniangooner/searchable-select

A Laravel Nova field.

This package's canonical repository appears to be gone and the package has been frozen as a result.

1.3.2 2019-12-04 08:26 UTC

This package is auto-updated.

Last update: 2024-06-04 18:21:23 UTC


README

A Searchable Select Field for Laravel Nova. This field joins the functionalities of the BelongsTofield and Select field.

Basically a regular Select field where you specify the resource you want to search for and no "relationships" are needed. This means, you can use it also in additional JSON fields in your database.

Installation

Composer

composer require sloveniangooner/searchable-select

Usage

Just like the regular select field, but instead of the options method you provide the resource method with your resource name.

use Sloveniangooner\SearchableSelect\SearchableSelect;
...

SearchableSelect::make('Content', 'content_id')->resource("contents")
... or
SearchableSelect::make("Content", "content_id")->resource(\App\Nova\Content::class)

You can pass all the regular options like:

SearchableSelect::make('Content', 'content_id')
    ->resource("contents")
    ->help("Help text")
    ->displayUsingLabels()
    ->nullable()

But also three additional options:

SearchableSelect::make('Content', 'content_id')
    ->resource("contents")
    ->label("custom_label_field") // Defaults to the static $title attribute of the resource class
    ->labelPrefix("custom_prefix_field") // Allows you to prefix the label field with one other field, i.e. "code":"label"
    ->value("custom_value_field") // Defaults to 'id'

You can now also choose the multiple option. Needs a text or json field in the database.

SearchableSelect::make('Content', 'content_id')
    ->resource("contents")
    ->multiple()
    ->displayUsingLabels()
    ->nullable()

Another option is to define the maximum number of items shown in the search. (Default: 20)

SearchableSelect::make("Content", "content_id")
                ->resource("contents")
                ->max(10)

You can use the base model's search method instead of the Nova resource's search method with useBaseSearch().

SearchableSelect::make('Content', 'content_id')
    ->resource("contents")
    ->useBaseSearch()