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
SOrderedListno 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
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
| Prop | Tipo | Descrição |
|---|---|---|
children | any | O conteúdo da UnorderededList. Aceita apenas componentes ListItem. |
id | string | undefined | Um identificador exclusivo para o elemento. |
Slots
| Slot | Descrição |
|---|---|
default | As 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. |