SOptionGroup <s-option-group>

Agrupa opções relacionadas dentro de um select sob um rótulo comum. SOptionGroup é o wrapper de Vue 3 tipado do web component <s-option-group> do Shopify Polaris.

import { SOptionGroup } from 'polaris-vue-elements'

Exemplo

<SOptionGroup> doesn't render on its own — it groups related <SOption> children under a label inside an <SSelect>.

United StatesCanadaFranceGermany

Value: (none)

<script setup>
import { ref } from 'vue'
import { SSelect, SOption, SOptionGroup } from 'polaris-vue-elements'

const value = ref('')
</script>

<template>
  <SSelect label="Shipping region" placeholder="Select a region" v-model="value">
    <!-- SOptionGroup labels a cluster of SOption children -->
    <SOptionGroup label="North America">
      <SOption value="us">United States</SOption>
      <SOption value="ca">Canada</SOption>
    </SOptionGroup>
    <SOptionGroup label="Europe">
      <SOption value="fr">France</SOption>
      <SOption value="de">Germany</SOption>
    </SOptionGroup>
  </SSelect>
  <p>Value: {{ value }}</p>
</template>

Props

Prop	Tipo	Descrição
disabled	boolean	Se as opções deste grupo podem ser selecionadas ou não.
label	string	O rótulo visível para o usuário deste grupo de opções.

Slots

Slot	Descrição
default	As opções selecionáveis exibidas na lista suspensa. Aceita componentes de opção para itens selecionáveis individuais dentro deste grupo.