# CMS: conectar um botão a um conjunto de dados

Source: https://support.wix.com/pt/article/cms-conectar-um-bot%C3%A3o-a-um-conjunto-de-dados (updated 2026-11-19)
Related: Wix developer documentation, https://dev.wix.com/docs/llms.txt; Help Center index, https://support.wix.com/en/llms.txt

Conecte um elemento de botão a um conjunto de dados para definir o que acontece quando o botão é clicado. Por exemplo, você pode vincular um botão à ação de clique "Enviar", a uma página dinâmica de item ou a um documento armazenado em sua coleção. Você também pode conectar a etiqueta do botão a um campo de coleção para mostrar texto dinâmico no botão.

> A lista de ações de conjunto de dados disponíveis varia dependendo do [modo do conjunto de dados](https://support.wix.com/pt/article/cms-working-with-the-dataset-mode-and-collection-permissions) e se você se conecta a um conjunto de dados normal ou a um conjunto de dados de página dinâmica. Saiba mais sobre todas as [ações de clique disponíveis no conjunto de dados](https://support.wix.com/pt/article/cms-about-dataset-click-actions-for-buttons-and-images).

---

## Conectar um botão a um conjunto de dados

Depois de conectar um botão a um conjunto de dados, você pode ver todos os tipos de conexão disponíveis no dropdown **A ação do clique se conecta a**. O conjunto de dados é o que vincula os elementos da sua página ao conteúdo da coleção do CMS.

**Editor Wix:**

1. [Vá para a página relevante no seu editor](https://manage.wix.com/account/site-selector/?actionUrl=https%3A%2F%2Fwww.wix.com%2Feditor%2F%7BmetaSiteId%7D%3FeditorSessionId%3D%7Besi%7D%26).
2. Clique no botão que você deseja conectar ao CMS. Saiba como [adicionar um botão](https://support.wix.com/pt/article/wix-editor-adding-and-setting-up-an-icon-button).
3. Clique no ícone **Conectar ao CMS** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/06/16/2d484f5d-e1bf-4d48-9e42-82216e8b88de/08e74518-edad-42f8-b007-c974ba767eb6.png).
4. Clique no dropdown **Escolha um novo conjunto de dados** e selecione um conjunto de dados existente que se conecte à sua coleção. Se preferir, clique em **Adicionar conjunto de dados** e escolha a coleção que deseja conectar, dê um nome ao conjunto de dados e clique em **Criar**.
5. Clique no dropdown **A ação do clique se conecta a** e selecione a opção relevante:  
   * **Páginas dinâmicas:** escolha a [página dinâmica](https://support.wix.com/pt/article/cms-about-dynamic-pages) à qual você deseja vincular. Em seguida, escolha como o link abre: **Na janela atual** ou **Em uma nova janela**. Clique no dropdown **Valores rel (SEO)** para [definir os atributos do link](https://support.wix.com/pt/article/adding-link-rel-attributes).  
   * **Ações do conjunto de dados:** escolha a [ação que você deseja que o conjunto de dados execute](https://support.wix.com/pt/article/cms-about-dataset-click-actions-for-buttons-and-images) quando o botão é clicado.  
   * **Campos:** escolha o campo da coleção ao qual você deseja se conectar. Você pode se conectar aos seguintes tipos de campo: **Áudio**, **Documento**, **Email**, **Imagem**, **URL** ou **Vídeo**. Saiba mais [sobre os tipos de campo e suas limitações de conteúdo](https://support.wix.com/pt/article/cms-formerly-content-manager-supported-content-in-collection-field-types).  
   **Dica:** selecione **+ Adicionar** para [adicionar um novo campo à sua coleção](https://support.wix.com/pt/article/cms-formerly-content-manager-adding-a-field-to-a-collection) e vincular a ele.

![Captura de tela de um botão sendo conectado a uma página dinâmica de item.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/08/29/27c70f13-53ae-464a-86df-651d9076bfa4/36275c7f-7d1f-43d8-b08a-cd4b2db1e34c.png)

1. (Opcional) Exiba um texto dinâmico no botão que muda de acordo com o item da coleção ao qual ele está vinculado. Clique no dropdown **Etiqueta se conecta a** e selecione o campo da coleção relevante.  
**Dica:** como alternativa, você pode usar texto estático que não é alterado nas configurações do botão.

![Captura de tela da etiqueta do botão sendo conectada a um campo da coleção.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/08/29/a50970ba-7291-4077-b23a-53fb2e04a234/0290ac87-b4a7-4b19-86f1-2df8ba0d4ac1.png)

1. Clique no dropdown **Nome acessível se conecta a** e selecione o campo que melhor descreve para os leitores de tela o que acontece quando o botão é clicado.
2. (Opcional) Conecte os campos "Cor" ao seu botão:  
   1. Role para baixo até **Cores** no painel **Conectar botão** à direita.  
   2. Clique na aba relevante para escolher qual estado do botão você deseja conectar: **Normal**, **Ao passar o mouse** ou **Desativado**  
   3. Clique nos menus dropdown relevantes para selecionar os campos "Cor" que você deseja conectar:  
         * **A cor do texto se conecta a:** conecte um campo "Cor" à cor dos caracteres do texto.  
         * **A cor do ícone se conecta a:** conecte um campo "Cor" ao ícone do botão (se o seu botão tiver um ícone).  
         * **A cor da borda se conecta a:** conecte um campo "Cor" à cor da borda.  
         * **A cor do background se conecta a:** conecte um campo "Cor" à cor de background do botão.  
   4. Repita esse passo para cada estado do botão que você deseja conectar a um campo da coleção "Cor".

![Captura de tela das várias opções de conexão de cores para um botão no Editor Wix.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2025/01/15/2aae0dbb-66c3-49f5-82f4-db1161477e14/23c270e9-d999-4ff8-b1fb-8ea9f908d1a6.png)

1. Clique em **Visualizar** para testar suas conexões.
2. Clique em **Publicar** se as alterações puderem ser publicadas.

**Editor do Wix Studio:**

1. [Vá para a página relevante no seu editor](https://manage.wix.com/account/site-selector/?actionUrl=https%3A%2F%2Fwww.wix.com%2Feditor%2F%7BmetaSiteId%7D%3FeditorSessionId%3D%7Besi%7D%26).
2. Clique no botão que você deseja conectar ao CMS. Saiba como [adicionar um botão](https://support.wix.com/pt/article/wix-editor-adding-and-setting-up-an-icon-button).
3. Clique no ícone **Conectar ao CMS** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/06/16/2d484f5d-e1bf-4d48-9e42-82216e8b88de/08e74518-edad-42f8-b007-c974ba767eb6.png).
4. Clique no dropdown **Escolha um novo conjunto de dados** e selecione um conjunto de dados existente que se conecte à sua coleção. Se preferir, clique em **Adicionar conjunto de dados** e escolha a coleção que deseja conectar, dê um nome ao conjunto de dados e clique em **Criar**.
5. Clique no dropdown **A ação do clique se conecta a** e selecione a opção relevante:  
   * **Páginas dinâmicas:** escolha a [página dinâmica](https://support.wix.com/pt/article/cms-about-dynamic-pages) à qual você deseja vincular. Em seguida, escolha como o link abre: **Na janela atual** ou **Em uma nova janela**. Clique no dropdown **Valores rel (SEO)** para [definir os atributos do link](https://support.wix.com/pt/article/adding-link-rel-attributes).  
   * **Ações do conjunto de dados:** escolha a [ação que você deseja que o conjunto de dados execute](https://support.wix.com/pt/article/cms-about-dataset-click-actions-for-buttons-and-images) quando o botão é clicado.  
   * **Campos:** escolha o campo da coleção ao qual você deseja se conectar. Você pode se conectar aos seguintes tipos de campo: **Áudio**, **Documento**, **Email**, **Imagem**, **URL** ou **Vídeo**. Saiba mais [sobre os tipos de campo e suas limitações de conteúdo](https://support.wix.com/pt/article/cms-formerly-content-manager-supported-content-in-collection-field-types).  
   **Dica:** selecione **+ Adicionar** para [adicionar um novo campo à sua coleção](https://support.wix.com/pt/article/cms-formerly-content-manager-adding-a-field-to-a-collection) e vincular a ele.

![Uma captura de tela de um botão sendo conectado à página dinâmica de item.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2023/09/08/4995d999-8c0a-488e-be1d-664eea969157/c5623613-a1a5-45cc-aab8-c4e3d432a560.png)

1. (Opcional) Exiba um texto dinâmico no botão que muda de acordo com o item da coleção ao qual ele está vinculado. Clique no dropdown **Etiqueta se conecta a** e selecione o campo da coleção relevante.  
**Dica:** como alternativa, você pode usar texto estático que não muda ao clicar em **Alterar texto**.
2. Clique no dropdown **Nome acessível se conecta a** e selecione o campo que melhor descreve para os leitores de tela o que acontece quando o botão é clicado.
3. (Opcional) Conecte os campos "Cor" ao seu botão:  
   1. Role para baixo até **Cores** no painel **Conectar botão** à direita.  
   2. Clique na aba relevante para escolher qual estado do botão você deseja conectar: **Normal** ou **Ao passar o mouse**  
   3. Clique nos menus dropdown relevantes para selecionar os campos "Cor" que você deseja conectar:  
         * **A cor do texto se conecta a:** conecte um campo "Cor" à cor dos caracteres do texto.  
         * **A cor da borda se conecta a:** conecte um campo "Cor" à cor da borda.  
         * **A cor do background se conecta a:** conecte um campo "Cor" à cor de background do botão.  
   * Repita esse passo para cada estado do botão que você deseja conectar a um campo da coleção "Cor".

![Captura de tela das várias opções de conexão de cores para um botão no Editor do Wix Studio.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2025/01/15/726229cb-705b-4e75-8edc-570244eae06f/8d3dccec-152a-4b77-a372-f04f3fd190a5.png)

1. Clique no ícone **Visualizar** ![](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/8696077d-830a-4b1e-bd86-9df98f89994a/2023/07/12/45e03e4e-437b-4067-977e-869c3ff1ddd7/357065e4-6113-4838-9dbd-edc880533773.png) no canto superior direito para testar suas conexões.
2. Clique em **Publicar** se as alterações puderem ser publicadas.

---

## Perguntas frequentes

Clique abaixo para obter respostas a perguntas comuns sobre como vincular botões no CMS.

**Posso criar um link dinâmico que os visitantes clicam para enviar emails?**

Sim. Você pode criar links dinâmicos que abrem o cliente de email do visitante (por exemplo: Outlook, Gmail) para que ele possa enviar um email para o endereço relevante.

  
**Opção 1: use o tipo de campo Email (Recomendado):**

O método mais fácil é usar o tipo de campo **Email**, que valida automaticamente os endereços de email e cria o link para você.

1. [Adicione um campo "Email"](https://support.wix.com/pt/article/cms-formerly-content-manager-adding-a-field-to-a-collection) à sua coleção.
2. Insira os endereços de email (por exemplo: suporte@email.com).
3. [Conecte um botão ou imagem](https://support.wix.com/pt/article/cms-connecting-a-button-to-a-dataset) ao conjunto de dados.
4. Defina o dropdown **A ação do clique se conecta** ao seu campo "Email".

  
**Opção 2: use um campo de URL (Alternativa):**

Você também pode usar um campo de URL padrão se preferir formatar o link manualmente.

1. [Crie um tipo de campo de URL](https://support.wix.com/pt/article/cms-formerly-content-manager-adding-a-field-to-a-collection) na sua coleção.
2. Adicione os endereços de email com **mailto:** no início de cada endereço (por exemplo, **mailto:suporte@email.com**).  
![Uma captura de tela de um campo de URL em uma coleção com mailto: adicionado antes de cada endereço de email.](https://d2x3xhvgiqkx42.cloudfront.net/12345678-1234-1234-1234-1234567890ab/d6b40156-9694-4cfe-9209-54815ef9d6dc/2024/09/25/0b57535b-0a1f-4ebd-956b-48f923cf5f45/67e9f6ba-f489-408c-a7d7-9b7c309ed401.png)
3. [Vincule um botão ou imagem a um conjunto de dados](https://support.wix.com/pt/article/cms-connecting-a-button-to-a-dataset) e conecte a este campo "URL".

**Posso exibir texto dinâmico no meu botão?**

Sim, você pode exibir texto dinâmico no seu botão. Após conectar um botão ao conjunto de dados, clique no dropdown **Etiqueta se conecta a** e selecione o campo da coleção relevante. A etiqueta do botão será alterada com base no item de coleção ao qual está vinculada.

**A quais tipos de limitações de conteúdo devo estar ciente ao conectar um tipo de campo diferente?**

Cada tipo de campo (áudio, documento, email, imagem, URL, vídeo) tem limitações de conteúdo específicas. Certifique-se de que seu conteúdo atenda a essas limitações para evitar problemas com a funcionalidade do botão.

  
Você pode vincular botões aos seguintes campos dinâmicos de coleção no conjunto de dados: 

* **Áudio:** abra arquivos de áudio únicos usando tipos de arquivo como MP3, WAV, FLAC e mais.
* **Documento:** abra arquivos de documento únicos, como PDFs, CSVs e mais.
* **Email:** abre o cliente de email do visitante com o endereço de email no campo "Para:".
* **Imagem:** abra arquivos de imagem, como JPG, PNG e GIF.
* **URL:** abra endereços web para cada item. Você pode adicionar os seguintes caracteres ao início dos URLs para modificar a forma como eles abrem:  
   * **mailto:** abre o cliente de email do visitante definido para enviar um email para o endereço relevante (por exemplo: **mailto:vendas@email.com**)  
   * **sms:** abre o aplicativo do visitante usado para enviar mensagens SMS (texto) (por exemplo: **sms:9254135555**).  
   * **tel:** abre o aplicativo que o visitante usa para ligar para um número de telefone (por exemplo: **tel:9254135555**).
* **Vídeo:** abra arquivos de vídeo únicos usando tipos de arquivo como AVI, MPEG, MOV e mais.

  
Saiba mais sobre [os tipos de campo compatíveis e suas limitações](https://support.wix.com/pt/article/cms-formerly-content-manager-supported-content-in-collection-field-types).

**O que devo usar para o campo de nome acessível do botão?**

Para tornar seu site mais acessível, adicione um nome acessível a cada botão conectado ao seu CMS. Nomes acessíveis funcionam como alt text, mas foram criados para botões. Eles ajudam os leitores de tela a descrever o que o botão faz ou para onde ele direciona.

  
Recomendamos criar um campo de coleção para o nome acessível do seu botão e conectá-lo ao dropdown **O nome acessível se conecta a**. O campo deve ter uma descrição clara e útil da ação ou destino do botão. Por exemplo, use "Leia mais sobre nossos serviços" ou "Envie sua inscrição" em vez de um nome genérico como "Clique aqui".

  
Você também pode usar expressões para criar nomes mais personalizados ao combinar texto estático com dados da sua coleção. Por exemplo, você pode usar **CONCAT("Leia mais sobre ", title)** para ajudar os leitores de tela a fornecer descrições exclusivas para cada botão.

  
Adicionar nomes acessíveis melhora a acessibilidade do seu site e torna mais fácil para todos os visitantes navegarem no seu conteúdo. Saiba mais sobre as [práticas recomendadas de acessibilidade do CMS](https://support.wix.com/pt/article/accessibility-best-practices-for-the-cms#accessible-names-for-buttons).
