Skip to content

SUnorderedList <s-unordered-list> ​

Uma lista com marcadores. SUnorderedList é o wrapper de Vue 3 tipado do web component <s-unordered-list> do Shopify Polaris.

ts
import { SUnorderedList } from 'polaris-vue-elements'

Boas práticas ​

  • Use quando a ordem não importar. Uma lista não ordenada apresenta itens relacionados, como recursos, opções ou benefícios, sem sequência nem classificação. Quando a sequência importar, use SOrderedList no lugar.
  • Mantenha os itens paralelos. Dê a todos os itens a mesma estrutura gramatical para que a lista seja fácil de percorrer. Misturar estilos de escrita em uma lista dificulta a leitura.
  • Escreva itens curtos. Listas funcionam melhor quando cada item é breve. Se os itens ficarem longos ou complexos, considere dividir o conteúdo em seções separadas.
  • Limite o aninhamento. Listas aninhadas podem organizar conteúdo hierárquico, mas logo ficam difíceis de acompanhar. Se você precisar de mais de dois níveis, talvez o conteúdo não seja adequado para uma lista.

Veja as boas práticas da Shopify para <s-unordered-list> (em inglês) para todas as recomendações.

Exemplo ​

Free shipping over $5030-day returns24/7 customer supportAdd items to your cartReview your orderConfirm and check out
vue
<script setup>
import { SUnorderedList, SOrderedList, SListItem, SStack } from 'polaris-vue-elements'
</script>

<template>
  <SStack direction="inline" gap="large-500" alignItems="start">
    <!-- SUnorderedList renders its SListItem children as a bulleted list. -->
    <SUnorderedList>
      <SListItem>Free shipping over $50</SListItem>
      <SListItem>30-day returns</SListItem>
      <SListItem>24/7 customer support</SListItem>
    </SUnorderedList>
    <SOrderedList>
      <SListItem>Add items to your cart</SListItem>
      <SListItem>Review your order</SListItem>
      <SListItem>Confirm and check out</SListItem>
    </SOrderedList>
  </SStack>
</template>

Props ​

PropTipoDescrição
childrenanyO conteúdo da UnorderededList. Aceita apenas componentes ListItem.
idstring | undefinedUm identificador exclusivo para o elemento.

Slots ​

SlotDescrição
defaultAs entradas exibidas dentro da lista não ordenada, em que cada item é marcado com um marcador. Aceita apenas componentes de item de lista como filhos. Cada item de lista representa uma única entrada com marcador na lista.

Lançado sob a licença MIT. Logo do Vue por Evan You, CC BY-NC-SA 4.0.