Skip to content

Component usage

Use providers, component props, slots, models, and shared configuration.

Selaras components are auto-imported with the S prefix. Start with an existing component, then customize its props and slots before building a replacement.

State and events

vue
<script setup lang="ts">
const selected = ref<'Small' | 'Medium' | 'Large'>()
</script>

<template>
  <SSelect v-model="selected" :items="['Small', 'Medium', 'Large']" placeholder="Choose a size" />
</template>

Component reference pages document models, events, item shapes, and slots. Item labels are your content; internal labels are controlled through messages.

Customization

Use props for supported behavior and appearance. Use slots for custom content, class for the root, and :ui for specific styled parts. See Component styling for merging and precedence.

Wrap your app in SApp for providers. Add Toast and CommandPalette where their references describe; providers alone do not render these controls.

Responsive interfaces

Use adaptive controls to opt into modal presentation on small screens. Responsive layout utilities and adaptive presentation solve different needs.

Edit this page