使用变量 - 构建 - 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` 的值。需要在表单上同时启用导出变量和返回端点响应。具有多级键的响应会自动展平。

变量	描述
`{{email}}`	此表单的电子邮件字段的值。
`{{fname}}`	此表单的名字字段的值（或使用单一姓名字段时的姓名字段）。
`{{lname}}`	此表单的姓氏字段的值。
`{{company}}`	此表单的公司名称字段的值。
`{{phone}}`	此表单的电话号码字段的值。
`{{consent}}`	此表单的需要同意字段的值。

变量	描述
`{{fieldId}}`	此表单的`fieldId`字段的值。

以下元素目前支持变量：

元素类型	位置
按钮	标签、链接URL
嵌入	代码
表单	按钮标签、“完成后”消息、URL和代码、“成功后”消息、URL和代码、“失败后”消息、URL和代码、“提交时”事件代码、“成功时”事件代码、“失败时”事件代码、（自定义）输入值、（自定义）输入标签
画廊	替代文本、标题、链接URL
图标	链接URL
图片	替代文本、链接URL
链接	标签、链接URL
列表	项目
表格	标题、行
文本	内容

Last updated on 7/17/2025@mrbirddev