変数の使用 - ビルディング - 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_nameURLパラメータです:

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
リストアイテム
テーブル見出し、行
テキストコンテンツ

目次 - carrd ドキュメント

Last updated on 7/17/2025@mrbirddev
Loading...