ファイルを開く

Lightning Experience および Salesforce アプリケーションで 1 つ以上のファイルレコードを開くには、ナビゲーションサービス lightning/navigation を使用します。ナビゲーションサービスは、Lightning Experience のモーダルダイアログで 1 つ以上のファイルのプレビューを開くか、モバイルデバイスの Salesforce アプリケーションでファイルのダウンロードをトリガします。

ナビゲーションサービスは、ページ (この場合はファイル) を記述する PageReference を使用します。

'type': 'standard__namedPage'、および filePreview の pageName 属性を持つページ参照を使用します。

filePreview 名前付きページ値は、ContentDocument および ContentHubItem (外部ファイル) オブジェクトをサポートします。filePreview 名前付きページ値は、Lightning Experience およびモバイルアプリケーションのすべてのバージョンでサポートされています。Visualforce の Lightning コンポーネント、Lightning Out、エクスペリエンスビルダーサイトなど、他のコンテナではサポートされていません。Lightning Experience や Salesforce モバイルアプリケーション内でこれらのコンテナにアクセスしても、ページ値はサポートされません。

ファイルを開く例

次の例は、Lightning Experience および Salesforce アプリケーションで ID 069xx0000000001AAA を持つレコードを開きます。

1<!-- openFileSample.html -->
2<template>
3  <div>
4    <a onclick={navigateToFiles}>Navigate To Files</a>
5  </div>
6</template>

1// openFileSample.js
2import { LightningElement } from "lwc";
3import { NavigationMixin } from "lightning/navigation";
4
5export default class OpenFileSample extends NavigationMixin(LightningElement) {
6  navigateToFiles() {
7    this[NavigationMixin.Navigate]({
8      type: "standard__namedPage",
9      attributes: {
10        pageName: "filePreview",
11      },
12      state: {
13        recordIds: "069xx0000000001AAA,069xx000000000BAAQ",
14        selectedRecordId: "069xx0000000001AAA",
15      },
16    });
17  }
18}

recordIds は、ダウンロードできるすべてのレコード ID のカンマ区切りのリストです。

Lightning Experience では、selectedRecordId で指定されたレコードが最初にダウンロードされます。ユーザはアプリケーションの矢印をクリックして、他のレコードに切り替えることができます。デスクトップファイルプレビューアは、画像および SVG ベースの複数ページ Office 文書のプレビュー、プレゼンテーションモードと、共有、ダウンロード、アップロード、削除などのファイルアクションへのクリックアクセスを提供します。

Salesforce アプリケーションでは、イベントが起動されるとファイルが 1 つダウンロードされます。selectedRecordId が指定されている場合は、そのファイルがダウンロードされます。selectedRecordId が指定されていない場合は、recordIds リストにある最初のファイルがダウンロードされます。デバイスに応じて、ファイルのネイティブプレビューが表示されます。

関連トピック

The Japanese Summer '24 guide is now live

日本語の Summer '24 ガイドが公開されました! 「Component Reference (コンポーネントリファレンス)」は、以前と同様にコンポーネントライブラリにあります。