Skip to content

FormMultiSelectList

A compact multi-select component that combines a select dropdown with a tag/badge display of selected items. Styled for use inside form layouts.

Usage

vue
<script setup>
import { ref } from 'vue'
import { FormMultiSelectList } from 'praxis-vue-ui'

const tags = [
  { id: 1, name: 'Urgent' },
  { id: 2, name: 'Follow-up' },
  { id: 3, name: 'Reviewed' },
]
const selected = ref([])
</script>

<template>
  <FormMultiSelectList
    v-model="selected"
    :options="tags"
    label="Tags"
  />
</template>

Props

PropTypeDefaultDescription
modelValueunknown[][]Array of selected values. Use with v-model.
optionsrequiredunknown[]Available options for the dropdown.
labelstringundefinedLabel displayed above the select.
placeholderstring'Select...'Placeholder for the dropdown.
disabledbooleanfalseDisables the component.

Emits

EventPayloadDescription
update:modelValueunknown[]Emitted on selection change.

Built with VitePress