> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/chtoriaru/general/expressions-for-lwr-sites.md).

# LWR サイト向けの式

## 概要

式を使うと、計算を行ったり、プロパティ値やその他のデータにアクセスしてコンポーネントの属性に渡したりできます。動的な出力には式を使用し、属性に値を割り当てることでコンポーネントへ値を渡します。

式とは、リテラル値、変数、部分式、または演算子の任意の組み合わせで、1つの値に解決できるものです。メソッド呼び出しは式では使用できません。

式の構文は次のとおりです： **`{!expression}`** ここで expression はプレースホルダーです。

## データバインディング式

| 式                                 | 説明                                                 | 対応ページとコンポーネント                                                                                                                                                                                                                       |
| --------------------------------- | -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`{!Item.field}`**               | 現在バインドされているデータのフィールドのデータを取得します。                    | データにバインドされているものすべて。Salesforce CMS またはレコードデータを含めることができます。                                                                                                                                                                            |
| **`{!Item.field._rawValue}`**     | データフィールドの生の値を取得します。                                | CRM データにバインドされているものすべて。                                                                                                                                                                                                             |
| **`{!Item.field._displayValue}`** | データフィールドの書式設定済みローカライズ値を取得します。                      | CRM データにバインドされているものすべて。                                                                                                                                                                                                             |
| **`{!Item._detailURL}`**          | Salesforce CMS データ項目の URL を取得します。                  | CMS 詳細ページを含む、CMS 項目にバインドされているものすべて。                                                                                                                                                                                                 |
| **`{!Label.namespace.name}`**     | Experience Builder でラベルを指定するときに、ラベルのローカライズ値を定義します。 | まず、Salesforce Setup で翻訳済みのカスタムラベルを作成します。詳細は、 [カスタムラベルの翻訳](https://help.salesforce.com/s/articleView?id=cl_translate_edit.htm\&language=en_US\&type=5)。次に、テキストフィールドを持つ任意の Experience Builder コンポーネントでラベル式を使用すると、ローカライズされたラベルを表示できます。 |

## その他の式

他の式を使用して、パラメータを照会したり、サイトの正しい basePath を解決したり、式でユーザーフィールドを利用したりします。

| 式                                         | 説明                                                                                | 対応ページとコンポーネント                                                                                                        |
| ----------------------------------------- | --------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **`{!Route.param}`**                      | URL からクエリパラメータを取得します。                                                             | <ul><li>すべてのページ</li><li>文字列プロパティを持つ標準およびカスタムコンポーネント</li><li>HTML エディタ</li><li>リッチコンテンツエディター</li></ul>                |
| **`{!param}`**                            | : がパラメータの前に付く URL からパラメータ値を取得します。たとえば、/global-search/:term URL から {!term} を取得します。 | <ul><li>URL に動的パラメータを含むすべてのページ</li><li>文字列プロパティを持つ標準およびカスタムコンポーネント</li><li>HTML エディタ</li><li>リッチコンテンツエディター</li></ul> |
| **`{!Site.basePath}`**                    | LWR サイトの basePath に解決されます。                                                        | <ul><li>すべてのページ</li><li>文字列プロパティを持つ標準およびカスタムコンポーネント</li><li>HTML エディタ</li><li>リッチコンテンツエディター</li></ul>                |
| **`{!User.userId}`**                      | ユーザーの Salesforce ID に解決されます。                                                      | <ul><li>すべてのページ</li><li>文字列プロパティを持つ標準およびカスタムコンポーネント</li><li>HTML エディタ</li><li>リッチコンテンツエディター</li></ul>                |
| **`{!User.isGuest}`**                     | ユーザーがゲストユーザーかどうかに基づいて TRUE または FALSE を返します。                                       | <ul><li>すべてのページ</li><li>文字列プロパティを持つ標準およびカスタムコンポーネント</li><li>HTML エディタ</li><li>リッチコンテンツエディター</li></ul>                |
| **`{!User.Record.<User sObject Field>}`** | Salesforce User オブジェクトのフィールド値に解決されます。                                             | <ul><li>すべてのページ</li><li>文字列プロパティを持つ標準およびカスタムコンポーネント</li><li>HTML エディタ</li><li>リッチコンテンツエディター</li></ul>                |
| **`{!User.Commerce.BuyerGroups}`**        | Commerce テンプレートを使用して構築されたサイトで使用すると、ユーザーに関連付けられた購入者グループのリストを返します。                  | <ul><li>すべてのページ</li><li>文字列プロパティを持つ標準およびカスタムコンポーネント</li><li>HTML エディタ</li><li>リッチコンテンツエディター</li></ul>                |

* HTML エディタまたはリッチコンテンツエディタコンポーネントで {!param} または {!Route.param} 式を使用すると、セキュリティ上の理由から、一部の HTML 特殊文字はエスケープされる、つまり別の値に置き換えられます。これらの文字には <、>、および & が含まれます。
* LWR サイトは、{!CurrentUser. で始まる認証済みユーザー情報を表示する式をサポートしていません。
* ユーザーデータを含む式は、リッチコンテンツエディタではプレビューおよび公開済みサイトでのみ解決されます。
* User データをバインドする場合、{!User.Record.\<User sObject Field>} 式を使用してすべての User sObject フィールドにアクセスできます。また、Commerce テンプレートを使用して構築されたサイトでは、{!User.Commerce.\<Commerce Field>} 式を使用して Commerce に関連するユーザーデータにアクセスすることもできます。Summer '23 リリースでは、Commerce フィールドとしてサポートされているのは BuyerGroups のみです。

### ソース

<https://developer.salesforce.com/docs/atlas.en-us.exp_cloud_lwr.meta/exp_cloud_lwr/advanced_expressions.htm><br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/chtoriaru/general/expressions-for-lwr-sites.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.