# Brands()

A função **`Brands()`** retorna as marcas cadastradas no Painel Administrativo da loja.

{% hint style="info" %}
**Disponível para uso em todas as páginas.**

**Saiba mais sobre como gerenciar marcas acessando:** [Marcas e Fabricantes](https://basedeconhecimento.tray.com.br/hc/pt-br/articles/6734137851931-Marcas-e-Fabricantes)
{% endhint %}

### Argumentos disponíveis

Essa função sempre retornará um array de dados com todas as marcas e através dele é possível acessar alguns atributos utilizando os argumentos abaixo. Devido ao retorno ser um array é possível utilizar um índice determinado ou iterar em um laço de repetição.

| Atributos              | Característica               |
| ---------------------- | ---------------------------- |
| `{{ brands[0].id }}`   | Identificador único da marca |
| `{{ brands[0].name }}` | Nome da marca                |
| `{{ brands[0].slug }}` | Final da url da marca        |

## Como Usar

Abaixo alguns exemplos de como utilizar a função `Brands()`.

### Para Exibir Todas as Marcas

No código HTML deve ser atribuída a função `Brands()` a uma variável e em seguida iniciar um loop que exibe o nome de cada marca, como o exemplo abaixo.

{% code title="Input" %}

```html
<ul>
  {% set brands = Brands() %}
  {% for brand in brands %}
    <li>{{ brand.name }}</li>
  {% endfor %}
</ul>
```

{% endcode %}

{% code title="Output" %}

```html
<ul>
    <li>Marca A</li>
    <li>Marca C</li>
    <li>Marca D</li>
    <li>Marca E</li>
    <li>Marca F</li>
    <li>Marca G</li>
    <li>Marca H</li>
</ul>
```

{% endcode %}

### Para exibir acima de 30 marcas

No código HTML deve ser atribuída a função `Brands()` a uma variável e em seguida iniciar um loop que exibe o nome de cada marca, como o exemplo abaixo.

```twig
De:{% set brands = Brands() %} 
Para:{% set brands = Brands({ "no_paging":1 }) %}    
```

### Para buscar por determinada Marca ou ID

{% code title="Input" %}

```html
{# busca a marca Tray #}
<ul>
  {% set brandTray = Brands( { "brand": "Tray" } ) %}
  {% for brand in brandTray %}
    <li>{{ brand.name }}</li>
  {% endfor %}
</ul>

{# busca o id 10 #}
<ul>
  {% set brands = Brands( { "id": "10" } ) %}
  {% for brand in brands %}
    <li>{{ brand.id }}</li>
  {% endfor %}
</ul>    
```

{% endcode %}

{% code title="Output" %}

```html
<ul>
    <li>Tray</li>
</ul>

<ul>
    <li>10</li>
</ul>
```

{% endcode %}

### Para exibir todas as marcas em ordem decrescente

Todas as marcas ordenadas por ID decrescente.

{% code title="Input" %}

```html
<ul>
 {% set brands = Brands({ "order": { "id": "desc" }}) %}
 {% for brand in brands %}
   <li><span>{{ brand.id }}</span><span>{{ brand.name }}</span></li>
 {% endfor %}
</ul>    
```

{% endcode %}

{% code title="Output" %}

```html
<ul>
   <li><span>5</span><span>Marca E</span></li>
   <li><span>4</span><span>Marca D</span></li>
   <li><span>3</span><span>Marca C</span></li>
   <li><span>2</span><span>Marca B</span></li>
   <li><span>1</span><span>Marca A</span></li>
</ul>
```

{% endcode %}

Você também pode utilizar nosso snippet de menu de marcas. Para saber mais acesse [menu-de-marcas](https://partners.tray.com.br/themes/construindo-seu-template/referencias/componentes/menu-de-marcas "mention")