Tagger ​
The tagger input type renders VInputTagger, a free-form tag creator and selector built on Vuetify's v-combobox. Users can select existing tags (displayed as coloured chips) or type a new value to create one on the fly. Existing tags are editable inline. Unlike Tag, Tagger manages its own tag entity CRUD (create / rename) rather than just selecting from a pre-existing namespace.
Hydrate ​
Class: TaggerHydrateConfig type: taggerOutput type: input-tagger → VInputTagger
The hydrate:
- Requires
_moduleNameand_routeName; throws if the repository does not useTagsTrait - Sets
fetchEndpointandupdateEndpointfrom the module route action URLs - Loads
itemsviarepository->getTags(), prepending a "Select an option or create one" header - Each item is enriched with a
colorcycled from thecolorsarray - For translated tags, items are grouped by locale with a header in each group
Usage ​
Standard (auto-resolved) ​
php
[
'type' => 'tagger',
]Translated tags ​
php
[
'type' => 'tagger',
'translated' => true,
]Custom colors ​
php
[
'type' => 'tagger',
'colors' => ['red', 'blue', 'green', 'yellow'],
]Schema Defaults ​
| Key | Default | Description |
|---|---|---|
itemValue | 'id' | Field used as the tag value |
itemTitle | 'name' | Field displayed for each tag |
default | [] | No tags selected by default |
returnObject | false | Return tag IDs not full objects |
label | 'Tags' | Field label |
name | 'tags' | Form field name |
multiple | true | Allow multiple tag selections |
colors | ['green','purple','indigo','cyan','teal','orange'] | Chip colour cycle |
Tagger vs Tag: Use
taggerwhen users should be able to create new tags from within the form. Usetagwhen tags are managed centrally and users only select from an existing set.
See Also ​
- Tag — Read-only tag selector from a pre-existing namespace
- Hydrates reference — Resolution table and schema contract