Usando Variáveis - Construção - Documentação Carrd
Usando Variáveis
Requer Pro Plus ou superior
Variáveis permitem incorporar conteúdo dinâmico no texto de um site, URLs de links, valores de formulários e mais. Uma variável geralmente é composta por um nome e um valor alternativo opcional:
{{name|fallback}}
A parte name da variável é o nome único associado ao conteúdo (ou valor) que você está tentando incluir, enquanto a parte fallback é uma alternativa opcional caso o valor esteja em branco ou a variável não exista. Por exemplo, a variável {{url.name}} na seguinte linha de texto:
Bem-vindo, {{url.first_name}}!
... será expandida para o valor de url.first_name, que neste caso é o parâmetro URL first_name:
Bem-vindo, Cayce!
Da mesma forma, a variável {{url.first_name|friend}} também será expandida para o conteúdo do parâmetro URL first_name, mas se estiver em branco ou não existir, será expandida para o valor alternativo friend:
Bem-vindo, amigo!
Variáveis Suportadas
Abaixo está uma lista de todas as variáveis atualmente suportadas pelo Carrd. Variáveis com escopo Global podem ser usadas em qualquer lugar onde variáveis são suportadas. Todas as outras variáveis só podem ser usadas dentro de seus escopos definidos.
Algumas variáveis requerem uma interação do usuário antes de poderem ser expandidas. Por exemplo, variáveis de formulário como
{{email}},{{form01.email}}ou{{form01_response.confirmation_id}}só serão expandidas após o usuário enviar aquele formulário específico.
| Escopo | Variável | Descrição |
|---|---|---|
| Global | {{url.parameter_name}} | Conteúdo do parâmetro URL parameter_name. Usos comuns incluem anexar parâmetros UTM (como utm_source e utm_medium) a links de saída e preencher dinamicamente campos de formulário com valores padrão. |
| Global | {{client.date}} | Data local do cliente em formato numérico (ex.: 1/3/22). |
| Global | {{client.time}} | Hora local do cliente em formato HH:MM (ex.: 12:34 PM). |
| Global | {{client.fulldate}} | Data local do cliente em formato de string (ex.: 3 de janeiro de 2022). |
| Global | {{client.fulltime}} | Hora local do cliente em formato HH:MM:SS (ex.: 12:34:56 PM). |
| Global | {{client.timestamp}} | Alias de client.utc_timestamp. |
| Global | {{client.utc_date}} | Data UTC em formato numérico (ex.: 1/3/22). |
| Global | {{client.utc_time}} | Hora UTC em formato HH:MM (ex.: 12:34 PM). |
| Global | {{client.utc_fulldate}} | Data UTC em formato de string (ex.: 3 de janeiro de 2022). |
| Global | {{client.utc_fulltime}} | Hora UTC em formato HH:MM:SS (ex.: 12:34:56 PM). |
| Global | {{client.utc_timestamp}} | Hora UTC como um timestamp Unix (ex.: 1641213240). |
| Global | {{form.fieldId}} | Expande para o valor do campo fieldId do último formulário enviado. Requer que Exportar variáveis esteja habilitado no formulário. |
| Global | {{form_response.key}} | Expande para o valor de key da resposta mais recente do endpoint do último formulário enviado. Requer que Exportar variáveis e Retornar respostas de endpoint estejam habilitados no formulário. Respostas com chaves multiníveis são automaticamente achatadas. |
Formulário de Contato
| Variável | Descrição |
|---|---|
{{name}} | Valor do campo Nome deste formulário. |
{{email}} | Valor do campo Email deste formulário. |
{{message}} | Valor do campo Mensagem deste formulário. |
{{company}} | Valor do campo Nome da Empresa deste formulário. |
{{phone}} | Valor do campo Número de Telefone deste formulário. |
{{subject}} | Valor do campo Assunto deste formulário. |
{{consent}} | Valor do campo Consentimento Necessário deste formulário. |
Formulário de Inscrição
| Variável | Descrição |
|---|---|
{{email}} | Valor do campo Email deste formulário. |
{{fname}} | Valor do campo Primeiro Nome (ou Nome se usar um único campo de nome). |
{{lname}} | Valor do campo Sobrenome deste formulário. |
{{company}} | Valor do campo Nome da Empresa deste formulário. |
{{phone}} | Valor do campo Número de Telefone deste formulário. |
{{consent}} | Valor do campo Consentimento Necessário deste formulário. |
Formulário Personalizado
| Variável | Descrição |
|---|---|
{{fieldId}} | Valor do campo fieldId deste formulário. |
Elementos Suportados
As variáveis são atualmente suportadas pelos seguintes elementos:
| Tipo de Elemento | Onde |
|---|---|
| Botões | Rótulos, URLs de Links |
| Incorporar | Código |
| Formulário | Rótulos de botões, mensagens "Ao Completar", URLs e código, mensagens "Com Sucesso", URLs e código, mensagens "Com Falha", URLs e código, código de evento "Ao Enviar", código de evento "Com Sucesso", código de evento "Com Falha", valores de entrada (Personalizado), rótulos de entrada (Personalizado) |
| Galeria | Texto Alternativo, Legendas, URLs de Links |
| Ícones | URLs de Links |
| Imagem | Texto Alternativo, URLs de Links |
| Links | Rótulos, URLs de Links |
| Lista | Itens |
| Tabela | Cabeçalhos, Linhas |
| Texto | Conteúdo |