【Swift】　ファイル選択やインポートに便利な .fileImporterとは？引数の意味や使い方をわかりやすく解説！

2025年8月23日 2025年8月23日

SwiftUIでユーザーにファイルを選択・読み込みさせたいときに便利なのが .fileImporter() です。

ドキュメントファイルや外部データの取り込みが必要な場面で、システム標準のファイル選択UIを簡単に導入できます。

この記事では .fileImporter() の基本的な意味や使い方、主要な引数の意味、活用シーン、注意点までをわかりやすく丁寧に解説します。

.fileImporter() とは？

.fileImporter() は SwiftUIにおけるモディファイアの一種で、ユーザーにファイルを選択・読み込みするためのダイアログUIを提供します。

つまり、「ファイルを選ぶUI」と「そのファイルを読み込む処理」をセットで簡単に呼び出せる仕組みです。

UIKitであれば UIDocumentPickerViewController を自分で呼び出して処理をつなげる必要がありましたが、SwiftUIでは .fileImporter() を書くだけで同じことがより直感的に実現できます。

具体例：テキストファイルを読み込む

このサンプルコードは、外部のテキストファイルを選択してアプリ内に読み込む流れを示しています。

ボタンを押すとファイル選択のダイアログが表示され、選択したテキストファイルの内容をアプリ内で表示できるようになります。

import SwiftUI
import UniformTypeIdentifiers

struct ContentView: View {
    @State private var isImporterPresented = false
    @State private var loadedText = "ファイルを読み込んでください"
    @State private var didLoad = false

    var body: some View {
        VStack {
            Text(loadedText)
                .padding()
                .frame(height: 200)
                .frame(maxWidth: .infinity)
                .border(.gray)
                .scrollContentBackground(.hidden)

            Button("テキストファイルを読み込む") {
                isImporterPresented = true
            }

            if didLoad {
                Text("読み込み完了")
                    .foregroundColor(.blue)
            }
        }
        .fileImporter(
            isPresented: $isImporterPresented,
            allowedContentTypes: [.plainText],
            allowsMultipleSelection: false
        ) { result in
            switch result {
            case .success(let urls):
                if let url = urls.first {
                    loadTextFile(from: url)
                }
            case .failure(let error):
                print("ファイル読み込みエラー: \(error.localizedDescription)")
            }
        }
    }
    
    private func loadTextFile(from url: URL) {
        do {
            // セキュリティスコープの開始
            let _ = url.startAccessingSecurityScopedResource()
            
            // ファイル内容を読み込み
            let content = try String(contentsOf: url, encoding: .utf8)
            loadedText = content
            didLoad = true
            
            // セキュリティスコープの終了
            url.stopAccessingSecurityScopedResource()
        } catch {
            print("ファイル読み込み失敗: \(error.localizedDescription)")
            loadedText = "読み込みに失敗しました"
        }
    }
}

import SwiftUI

import UniformTypeIdentifiers

struct ContentView: View {

@State private var isImporterPresented = false

@State private var loadedText = "ファイルを読み込んでください"

@State private var didLoad = false

var body: some View {

VStack {

Text(loadedText)

.padding()

.frame(height: 200)

.frame(maxWidth: .infinity)

.border(.gray)

.scrollContentBackground(.hidden)

Button("テキストファイルを読み込む") {

isImporterPresented = true

}

if didLoad {

Text("読み込み完了")

.foregroundColor(.blue)

}

.fileImporter(

isPresented: $isImporterPresented,

allowedContentTypes: [.plainText],

allowsMultipleSelection: false

) { result in

switch result {

case .success(let urls):

if let url = urls.first {

loadTextFile(from: url)

}

case .failure(let error):

print("ファイル読み込みエラー: \(error.localizedDescription)")

}

private func loadTextFile(from url: URL) {

do {

// セキュリティスコープの開始

let _ = url.startAccessingSecurityScopedResource()

// ファイル内容を読み込み

let content = try String(contentsOf: url, encoding: .utf8)

loadedText = content

didLoad = true

// セキュリティスコープの終了

url.stopAccessingSecurityScopedResource()

} catch {

print("ファイル読み込み失敗: \(error.localizedDescription)")

loadedText = "読み込みに失敗しました"

}

この例では、ボタンをタップすると .plainText 形式のファイル（.txt など）を選択するダイアログが表示されます。

ファイルが選択されると loadTextFile メソッドが呼ばれ、ファイル内容が画面に表示されます。

つまり、外部ファイルの内容をアプリ内に取り込んで活用できる仕組みを作っているわけです。

SwiftUIの標準UIを使うことで、複雑なファイル操作処理をほとんど書かずにファイル読み込み機能を実装できるのがポイントです。

主要な引数とその意味

.fileImporter() を正しく使うには、渡す引数の役割を理解しておくことが重要です。

ここで紹介する引数を押さえておくと、ファイル選択処理の仕組みやUIの挙動をコントロールしやすくなります。

それぞれの引数は次のような意味があります。

引数名	型	説明
isPresented	Binding<Bool>	ファイル選択UIを表示するトリガー
allowedContentTypes	[UTType]	選択可能なファイル種類の配列（例：[.plainText, .pdf]など）
allowsMultipleSelection	Bool	複数ファイル選択を許可するかどうか
onCompletion	Result<[URL], Error> クロージャ	ファイル選択成功／失敗を受け取る処理

allowedContentTypes は配列で指定するため、複数のファイル形式を同時に許可することができます。

また allowsMultipleSelection を true に設定すると、ユーザーが複数のファイルを一度に選択できるようになります。

これらの引数を理解することで、ユーザーがファイル選択UIを開いたときにどのような種類のファイルが選択でき、選択後にどの処理が走るのかを正しく設計できるようになります。

具体的な指定の仕方

上記の引数を組み合わせて指定します。

これらを設定することで、どのタイミングでファイル選択UIを出すか、どんな種類のファイルを選択対象にするか、選択後に何を行うかを決められます。

.fileImporter(
    isPresented: $isImporterPresented,           // ファイル選択ダイアログを出すかどうか
    allowedContentTypes: [.plainText, .pdf],     // 選択可能なファイル種類
    allowsMultipleSelection: false               // 複数選択を許可するかどうか
) { result in
    switch result {
    case .success(let urls):
        // 選択されたファイルのURL配列を処理
        for url in urls {
            processFile(url: url)                // 成功時の処理
        }
    case .failure(let error):
        print("ファイル選択エラー: \(error.localizedDescription)") // 失敗時の処理
    }
}

.fileImporter(

isPresented: $isImporterPresented, // ファイル選択ダイアログを出すかどうか

allowedContentTypes: [.plainText, .pdf], // 選択可能なファイル種類

allowsMultipleSelection: false // 複数選択を許可するかどうか

) { result in

switch result {

case .success(let urls):

// 選択されたファイルのURL配列を処理

for url in urls {

processFile(url: url) // 成功時の処理

}

case .failure(let error):

print("ファイル選択エラー: \(error.localizedDescription)") // 失敗時の処理

}

ここで特に大切なのは allowedContentTypes の指定です。

この配列に含まれるファイル種類のみが選択対象として表示されるため、アプリで扱えないファイルを除外できます。

例えば .plainText や .pdf、.json、.image などを組み合わせることで、テキストファイルと画像ファイルの両方を選択可能にするといった柔軟な設定ができます。

これらを正しく組み合わせることで、アプリに自然な形でファイル読み込み機能を組み込めます。

.fileImporter の活用シーン

.fileImporter() はアプリの中で「ユーザーが外部ファイルを取り込みたい」といったニーズに応えるために使われます。

単なるファイル読み込みに限らず、データインポートや設定ファイルの読み込みなど幅広い場面で役立ちます。

.fileImporter() は以下のような場面で活用されます。

ユーザーが作成したドキュメントやテキストファイルをアプリに読み込みたいとき
画像やPDFなどの外部ファイルをアプリ内で表示・編集したい場合
CSVやJSONなどのデータファイルをインポートしてアプリで活用したい機能
設定ファイルや構成ファイルを外部から読み込む仕組みの導入
ドキュメントアプリや編集アプリでの既存ファイル読み込みフローに活用

シンプルな構成で、ファイルの読み込みUIを自然に追加できる点が魅力です。

特に、アプリ外部にあるデータを「アプリ内で活用できる形」に変換してユーザーが扱えるようになる点が大きなメリットです。

.fileImporter を使うときの注意点

便利な .fileImporter() ですが、使う際にはいくつかの前提条件や注意すべきポイントがあります。

これらを理解しておくことで、予期しないエラーや動作不良を防ぐことができます。

import UniformTypeIdentifiers が必要（allowedContentTypesの指定にUTTypeを利用）
iOS 14 / macOS 11 以降が対応対象（旧OSでは動作しない）
ファイル読み込み時は startAccessingSecurityScopedResource() / stopAccessingSecurityScopedResource() でセキュリティスコープを適切に管理すること
選択完了後に実際の読み込み処理を行う場合は、onCompletion 内で Result<[URL], Error> を適切に処理すること
大きなファイルを読み込む際は、メインスレッドをブロックしないよう非同期処理を検討する

つまり、.fileImporter() を使う際は、単にファイル選択UIを出すだけではなく、選択後の読み込み処理やエラーハンドリングも合わせて設計することが重要です。