# 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](/themes/construindo-seu-template/referencias/componentes/menu-de-marcas.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://partners.tray.com.br/themes/construindo-seu-template/referencias/funcoes/brands.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.