2
0
mirror of https://github.com/tenrok/vue-select.git synced 2026-05-17 02:29:37 +03:00
Files
Jeff Sagal efc5093207 Add API for overwriting default components (#850)
* implement API for overwriting child components

* add test coverage

* update documentation for Components & Styling

* update docs

* refactor API, update docs

* remove the service worker

* fix tests
2019-04-25 15:03:43 -07:00

1.7 KiB

::: tip Vue Select leverages scoped slots to allow for total customization of the presentation layer. Slots can be used to change the look and feel of the UI, or to simply swap out text. :::

Selected Option(s)

selected-option

Scope:

  • option {Object} - A selected option
<slot name="selected-option" v-bind="(typeof option === 'object')?option:{[label]: option}">
	{{ getOptionLabel(option) }}
</slot>

selected-option-container

Scope:

  • option {Object} - A selected option
  • deselect {Function} - Method used to deselect a given option when multiple is true
  • disabled {Boolean} - Determine if the component is disabled
  • multiple {Boolean} - If the component supports the selection of multiple values
<slot v-for="option in valueAsArray" name="selected-option-container"
			:option="(typeof option === 'object')?option:{[label]: option}" :deselect="deselect" :multiple="multiple" :disabled="disabled">
	<span class="selected-tag" v-bind:key="option.index">
		<slot name="selected-option" v-bind="(typeof option === 'object')?option:{[label]: option}">
			{{ getOptionLabel(option) }}
		</slot>
		<button v-if="multiple" :disabled="disabled" @click="deselect(option)" type="button" class="close" aria-label="Remove option">
			<span aria-hidden="true">&times;</span>
		</button>
	</span>
</slot>

Component Actions

spinner

<slot name="spinner">
	<div class="spinner" v-show="mutableLoading">Loading...</div>
</slot>

Dropdown

option

Scope:

  • option {Object} - The currently iterated option from filteredOptions
<slot name="option" v-bind="(typeof option === 'object')?option:{[label]: option}">
	{{ getOptionLabel(option) }}
</slot>