使用变量 - 构建 - Carrd 文档

Last updated on 7/17/2025@mrbirddev
使用变量 - 构建 - Carrd 文档

使用变量

需要 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_sourceutm_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
Loading...