lightning:fileUpload (ベータ)

lightning:fileUpload コンポーネントは、複数のファイルをアップロードするための統合された簡単な方法をユーザに提供します。ファイルアップローダには、ドラッグアンドドロップ機能とファイル種別による絞り込みが含まれています。

このコンポーネントは、Lightning Design System のファイルセレクタからスタイル設定を継承します。

ファイルのアップロードは常にレコードに関連付けられるため、recordId 属性は必須です。アップロードされたファイルは、[自分が所有者] 検索条件の [ファイル] ホーム、およびレコード詳細ページのレコードの [添付ファイル] 関連リストで使用できます。Salesforce でサポートされているすべてのファイル形式が許可されていますが、accept 属性を使用してファイル形式を制限できます。

次の例では、複数の PDF および PNG ファイルのアップロードを許可するファイルアップローダを作成します。recordId 値を適切な値に変更します。

1<aura:component>
2    <aura:attribute name="myRecordId" type="String" description="Record to which the files should be attached" />
3    <lightning:fileUpload label="Attach receipt" 
4        multiple="true" 
5        accept=".pdf, .png"
6        recordId="{!v.myRecordId}" 
7        onuploadfinished="{!c.handleUploadFinished}" />
8</aura:component

onuploadfinished イベントを処理する必要があります。イベントは、アップロードが完了すると起動します。

1({
2    handleUploadFinished: function (cmp, event) {
3        // Get the list of uploaded files
4        var uploadedFiles = event.getParam("files");
5        alert("Files uploaded : " + uploadedFiles.length);
6    }
7})

event.getParam("files") は、プロパティ name と documentId を使用して、アップロードされたファイルのリストを返します。

• name: filename.extension 形式のファイル名 (たとえば、account.jpg)。
• documentId: 069XXXXXXXXXXXX 形式の ContentDocument ID。

ファイルアップロードの制限

Salesforce システム管理者が制限を変更していない限り、デフォルトでは、最大 10 個のファイルを同時にアップロードできます。同時にアップロードするファイル数の組織の制限は、最大 25 個および最小 3 個です。アップロードできるファイルの最大サイズは 2 GB です。コミュニティの場合、ファイルのサイズ制限と許可される種別は、コミュニティファイルモデレーションが定める設定のとおりです。

使用上の考慮事項

このコンポーネントは、Lightning Out またはスタンドアロンアプリケーションによってサポートされておらず、無効の入力として表示されます。また、組織で [HTML で添付ファイルまたはドキュメントレコードとしてアップロードすることを許可しない] セキュリティ設定が有効になっている場合、ファイルアップローダを使用して、.htm、.html、.htt、.htx、.mhtm、.mhtml、.shtm、.shtml、.acgi、.svg の拡張子を持つファイルをアップロードすることはできません。詳細は、Salesforce ヘルプの「ファイルのアップロードおよび共有」を参照してください。

属性