--- title: "Formatação condicional" slug: "product-docs-template-7" updated: 2026-10-22T09:39:55Z published: 2026-10-22T09:39:55Z canonical: "support.tulip.co/product-docs-template-7" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Formatação condicional *Aprenda a usar a formatação condicional no widget de tabela interativa.* :::(Info)To use conditional formatting, you need to have an interactive table widget with a datasource in your app. If you don’t have one yet, read [Building Your First Table: Walkthrough](https://support.tulip.co/docs/building-your-first-table-walkthrough). ::: Neste guia, você aprenderá a:* Configurar novas regras para formatação condicional* Entender os diferentes tipos de regras para formatação condicional* Usar a comparação de campos em suas regras de formatação* Solucionar problemas de erros com formatação condicional ## Configurar uma regra 1. Clique no widget de tabela interativa e acesse o . 2. Role para baixo até a seção **Formatação Condicional**. 3. Clique em **+** para adicionar uma nova regra. 4. Por padrão, o primeiro Field no widget é selecionado, e uma regra básica é configurada automaticamente. ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28824%29.png) ### Exemplo - O primeiro campo, **Descrição**, está selecionado. - Se os dados nesse campo **não** estiverem **em branco**, o plano de fundo será formatado em verde com texto branco. - Essa formatação se aplica apenas à coluna **“Descrição** ”. ### Resumo da regra **O Resumo da regra** lista os seguintes detalhes:* **Formatação**: a cor do texto e a cor de fundo * **Campo de origem**: o campo ao qual a regra de formatação condicional se aplica* **Condição**: o requisito que deve ser atendido para que a formatação seja aplicada* **Argumento**: a lógica que deve ser atendida para que a formatação seja aplicada* **Formatação aplicada a**: o número de campos aos quais a formatação se aplica Este é o Resumo da regra para o [exemplo acima](/r230/docs/how-to-use-conditional-formatting#example):![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28825%29.png) Observe que a **Condição** aparece no Resumo da regra, e não o **Argumento**. Isso ocorre porque nossa formatação condicional se aplica desde que o campo **não esteja em branco**. No [terceiro exemplo](/r230/docs/how-to-use-conditional-formatting#example2), que veremos mais adiante neste artigo, a formatação condicional usa um argumento **“Contém** ”. Para este exemplo, o Resumo da regra fica assim:![conditional formatting rule summary with argument.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/conditional%20formatting%20rule%20summary%20with%20argument.png) ## Editar uma regra 1. Na seção **“Formatação condicional”**, passe o mouse sobre a **regra** que você deseja editar na lista. 2. Clique no ícone **de lápis** para modificá-la. 3. Escolha o campo de origem e o tipo de condição adequados para o seu caso de uso. 4. Selecione um valor estático ou uma variável para o argumento. As alterações são aplicadas imediatamente ao widget. ### Exemplo Podemos selecionar **“Status”**, definir o tipo de condição como **“Igual a”** e o valor estático como **“Aberto**”. Em seguida, aplicamos um fundo vermelho com formatação de texto em branco e optamos por aplicar a regra a todos os campos. ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28830%29.png) Agora, vamos destacar as linhas que contêm a palavra “Defeito” na **Descrição**, aplicando um fundo vermelho mais escuro. ## Execução da regra As regras são avaliadas na ordem em que estão listadas. - A **primeira regra** cuja condição for verdadeira determina a formatação da célula ou do intervalo. - Para **reordenar as regras**, clique nelas e arraste-as para uma nova posição. ### Exemplo Vamos aplicar a condição **“Contém”** ao **campo “Descrição”**, definir o valor estático como **“Defeito”** e aplicar formatação em vermelho. Movemos essa regra para uma posição mais alta na hierarquia para garantir que ela tenha precedência. ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28838%29.png) ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28831%29.png) ### Usando uma variável em uma regra Se um argumento usar uma variável que não tenha valor padrão, a regra não será executada no editor do aplicativo, mas será executada quando tiver um valor (seja no Modo Desenvolvedor ou no Player). ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28837%29.png) ## **Estados de erro** Para que a formatação condicional seja executada, certifique-se de que as seguintes seções estejam preenchidas:* **Campo de origem*** **Argumento(s)*** **Aplicar formatação a** Além disso, os seguintes cenários resultarão em erros de formatação condicional: 1. **Campo de origem ausente ou campos arquivados: se**um campo de origem tiver sido arquivado ou excluído do widget, a regra não funcionará mais como esperado. Certifique-se de que todos os campos de origem estejam ativos no seu widget e na fonte de dados. ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28840%29.png) ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28841%29.png) ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28842%29.png) 1. **Campos arquivados na seção “Aplicar formatação a” Se**alguns campos na seção **“Aplicar formatação a”** estiverem arquivados ou excluídos, mas outros ainda estiverem disponíveis, a regra continuará funcionando. No entanto, os campos arquivados ainda serão exibidos, e a formatação pode não ser aplicada a eles. ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28839%29.png) 1. **Campo de argumento ausente**: uma regra não pode funcionar se o campo de argumento estiver ausente. Certifique-se de que todos os campos obrigatórios estejam preenchidos para que a regra seja executada com sucesso. ## Excluir uma regra Para excluir uma regra:1. Na seção **Formatação condicional**, passe o mouse sobre a regra que você deseja excluir.2. Clique no ícone **de lixeira** no canto superior direito do cartão da regra. ## Limites Configure regras de formatação condicional com os seguintes limites para garantir que seu widget tenha um desempenho ideal. | | Limite | | --- | --- | | **Regras por widget (a partir da versão r333)** | 20 | | **Regras por widget (antes da versão r333)** | 10 | ## Destacar uma linha Para aplicar formatação condicional a uma linha inteira (ou seja, todas as colunas dessa linha): 1. Na seção **“Aplicar formatação a”** de uma regra, selecione **todos os campos** da linha. Isso aplicará a formatação selecionada em toda a linha, permitindo que você destaque linhas com condições ou critérios específicos. ## Solução de problemas e práticas recomendadas Se você estiver enfrentando problemas com a formatação condicional, aqui estão algumas práticas recomendadas a serem consideradas: - **Verifique se os campos estão ativos**: certifique-se de que nenhum dos campos com os quais você está trabalhando esteja arquivado ou excluído. - **Verifique se há conflitos entre regras**: como as regras são avaliadas em ordem, certifique-se de que as regras de maior prioridade estejam no topo da lista, caso você precise que elas substituam outras regras. - **Teste suas regras**: após configurar ou editar uma regra, verifique se a formatação está sendo aplicada corretamente tanto no editor do aplicativo quanto no Tulip Player. --- Você encontrou o que estava procurando? Você também pode acessar [community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all) para postar sua pergunta ou ver se outras pessoas já tiveram uma dúvida semelhante! **Table Record Field** **Table Record Fields** are single columns within a **Tulip Table.** ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/Table%20Record%20Field(1).gif)