Fields

Slug

Basics

Inherits from Text.

* has the same capabilities

The field depends on the Eloquent model

This field allows you to generate a slug based on the selected field and to save only unique values.

use MoonShine\Laravel\Fields\Slug;
 
Slug::make('Slug')
use MoonShine\Laravel\Fields\Slug;
 
Slug::make('Slug')

slug slug_dark

Slug Generation

Through the from() method, you can specify which field of the model to generate the slug from, in case of an absence of a value.

from(string $from)
from(string $from)
Slug::make('Slug')
    ->from('title')
Slug::make('Slug')
    ->from('title')

Separator

By default, the word separator when generating the slug is -, and the separator() method allows you to change this value.

separator(string $separator)
separator(string $separator)
Slug::make('Slug')
    ->separator('_')
Slug::make('Slug')
    ->separator('_')

Locale

By default, slug generation takes into account the application's set locale. The locale() method allows you to change this behavior for the field.

locale(string $local)
locale(string $local)
Slug::make('Slug')
    ->locale('ru')
Slug::make('Slug')
    ->locale('ru')

Unique Values

If you need to save only unique slugs, you should make use of the unique() method.

unique()
unique()
Slug::make('Slug')
    ->unique()
Slug::make('Slug')
    ->unique()

Dynamic slug

The live() method allows you to create a dynamic field that will track changes in the source field.

Text::make('Title')
    ->reactive(),
Slug::make('Slug')
    ->from('title')
    ->live()
Text::make('Title')
    ->reactive(),
Slug::make('Slug')
    ->from('title')
    ->live()

The lazy mode is also supported.

Text::make('Title')
    ->reactive(lazy: true),
Slug::make('Slug')
    ->from('title')
    ->live(lazy: true)
Text::make('Title')
    ->reactive(lazy: true),
Slug::make('Slug')
    ->from('title')
    ->live(lazy: true)

Dynamism is based on reactivity of fields.