使用变量 - 构建 - Carrd 文档
Last updated on 7/17/2025@mrbirddev
使用变量
需要 Pro Plus 或更高版本
变量使得可以将动态内容融入到网站的文本、链接URL、表单值等中。变量通常由一个名称和一个可选的备用值组成:
{{name|fallback}}
变量的 name
部分是与您尝试包含的内容(或值)相关联的唯一名称,而 fallback
部分是一个可选的备用值,以防该值为空或变量不存在。例如,以下文本行中的变量 {{url.name}}
:
Welcome, {{url.first_name}}!
... 将扩展为 url.first_name
的值,在这种情况下是 first_name
URL 参数:
Welcome, Cayce!
类似地,变量 {{url.first_name|friend}}
也将扩展为 first_name
URL 参数的内容,但如果为空或不存在,它将扩展为备用值 friend
:
Welcome, friend!
支持的变量
以下是 Carrd 当前支持的所有变量的列表。具有全局范围的变量可以在支持变量的任何地方使用。所有其他变量只能在其定义的范围内使用。
某些变量需要用户交互后才能扩展。例如,表单变量如
{{email}}
、{{form01.email}}
或{{form01_response.confirmation_id}}
只有在用户提交该特定表单后才会扩展。
范围 | 变量 | 描述 |
---|---|---|
全局 | {{url.parameter_name}} | parameter_name URL 参数的内容。常见用途包括将 UTM 参数(如 utm_source 和 utm_medium )附加到外部链接,并使用默认值动态填充表单字段。 |
全局 | {{client.date}} | 客户端的本地日期,数字格式(例如,1/3/22 )。 |
全局 | {{client.time}} | 客户端的本地时间,HH:MM 格式(例如,12:34 PM )。 |
全局 | {{client.fulldate}} | 客户端的本地日期,字符串格式(例如,January 3, 2022 )。 |
全局 | {{client.fulltime}} | 客户端的本地时间,HH:MM:SS 格式(例如,12:34:56 PM )。 |
全局 | {{client.timestamp}} | client.utc_timestamp 的别名。 |
全局 | {{client.utc_date}} | UTC 日期,数字格式(例如,1/3/22 )。 |
全局 | {{client.utc_time}} | UTC 时间,HH:MM 格式(例如,12:34 PM )。 |
全局 | {{client.utc_fulldate}} | UTC 日期,字符串格式(例如,January 3, 2022 )。 |
全局 | {{client.utc_fulltime}} | UTC 时间,HH:MM:SS 格式(例如,12:34:56 PM )。 |
全局 | {{client.utc_timestamp}} | UTC 时间,Unix 时间戳格式(例如,1641213240 )。 |
全局 | {{form.fieldId}} | 扩展为最后提交的表单的 fieldId 字段的值。需要在表单上启用导出变量。 |
全局 | {{form_response.key}} | 扩展为最后提交的表单的最新端点响应中的 key 的值。需要在表单上同时启用导出变量和返回端点响应。具有多级键的响应会自动展平。 |
联系表单
变量 | 描述 |
---|---|
{{name}} | 此表单的姓名字段的值。 |
{{email}} | 此表单的电子邮件字段的值。 |
{{message}} | 此表单的信息字段的值。 |
{{company}} | 此表单的公司名称字段的值。 |
{{phone}} | 此表单的电话号码字段的值。 |
{{subject}} | 此表单的主题字段的值。 |
{{consent}} | 此表单的需要同意字段的值。 |
注册表单
变量 | 描述 |
---|---|
{{email}} | 此表单的电子邮件字段的值。 |
{{fname}} | 此表单的名字字段的值(或使用单一姓名字段时的姓名字段)。 |
{{lname}} | 此表单的姓氏字段的值。 |
{{company}} | 此表单的公司名称字段的值。 |
{{phone}} | 此表单的电话号码字段的值。 |
{{consent}} | 此表单的需要同意字段的值。 |
自定义表单
变量 | 描述 |
---|---|
{{fieldId}} | 此表单的fieldId 字段的值。 |
支持的元素
以下元素目前支持变量:
元素类型 | 位置 |
---|---|
按钮 | 标签、链接URL |
嵌入 | 代码 |
表单 | 按钮标签、“完成后”消息、URL和代码、“成功后”消息、URL和代码、“失败后”消息、URL和代码、“提交时”事件代码、“成功时”事件代码、“失败时”事件代码、(自定义)输入值、(自定义)输入标签 |
画廊 | 替代文本、标题、链接URL |
图标 | 链接URL |
图片 | 替代文本、链接URL |
链接 | 标签、链接URL |
列表 | 项目 |
表格 | 标题、行 |
文本 | 内容 |
Last updated on 7/17/2025@mrbirddev