使用變數 - 建立 - 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