folder（フォルダー）

eagle.folder API を使って、新しいフォルダを簡単に作成したり、現在のアプリケーション内のフォルダにアクセスすることができます。

// Eagle アプリで現在選択されているフォルダを取得
let folder = (await eagle.folder.getSelected())[0];

// 属性を変更
folder.name = '新しいフォルダ名';
folder.description = '新しい説明...';

// 変更を保存
await folder.save();

🦄 ベストプラクティス： データの安全性を確保するために、API が提供する save() メソッドを使用してデータの読み書きや変更を行い、Eagle リソースライブラリの下の metadata.json や任意のファイルを直接変更しないようにしてください。

メソッド

create(options)

フォルダを作成します。

options Object
- name string - フォルダ名
- description string (任意) - フォルダの説明
- parent string (任意) - 親フォルダの ID。このパラメーター付きだと createSubfolder(parentId, options) と同じです。
戻り値 Promise<folder: Folder> - 成功した folder を返します。

let newFolder = await eagle.folder.create({
    name: '新しいフォルダ',
    description: 'フォルダの説明。',
});

createSubfolder(parentId, options)

サブフォルダを作成します。

parentId string - 親フォルダの ID
options Object
- name string - フォルダ名
- description string (任意) - フォルダの説明
戻り値 Promise<folder: Folder> - 成功した folder を返します。

let parentFolder = await eagle.folder.getById('folder_id');
let subFolder = await eagle.folder.createSubfolder(parentFolder.id, {
    name: 'サブフォルダ',
    description: 'サブフォルダの説明。',
});

get(options)

指定条件のフォルダを取得。

options Object - 検索条件
- id string (任意) - フォルダの id
- ids string[] (任意) - フォルダ id の配列
- isSelected boolean (任意) - 現在選択されているフォルダ
- isRecent boolean (任意) - 最近利用したフォルダ
戻り値 Promise<folders: Folder[]> - 検索結果の folders

// 指定された id のフォルダを取得
let folders = await eagle.folder.get({
    ids: ['folder_id1', 'folder_id2']
});

// 現在のアプリで選択されているフォルダを取得
let folders = await eagle.folder.get({
    isSelected: true
});

getAll()

すべてのフォルダを取得します。

戻り値 Promise<folders: Folder[]> - folders を返します。

let folders = await eagle.folder.getAll();

getById(folderId)

対応する folderId のフォルダーを取得します。

folderId string - フォルダの id
返り値 Promise<folder: Folder> - folder の検索結果

let folder = await eagle.folder.getById('folder_id');

getByIds(folderIds)

対応する folderIds のフォルダーアレイを取得します。

folderIds string[] - フォルダー id のアレイ
返り値 Promise<folders: Folder[]> - folders の検索結果

let folders = await eagle.folder.getByIds(['folder_id1', 'folder_id2']);

getSelected()

現在のアプリケーションで選択されているフォルダーを取得します。

返り値 Promise<folders: Folder[]> - folders

let folders = await eagle.folder.getSelected();

getRecents()

最近使用されたフォルダーを取得します。

返り値 Promise<folders: Folder[]> - folders

let folders = await eagle.folder.getRecents();

open(folderId)

Eagle は対応する folderId のフォルダーを開きます。

返り値 Promise<void>

await eagle.folder.open('folder_id');

// 以下と同等
let folder = await eagle.folder.getById('folder_id');
await folder.open();

ヒント：フォルダーを開くために、フォルダーのインスタンスの open() メソッドを直接呼び出すこともできます。

クラス：Folder

Folder API get から返される Object タイプで、変更および保存機能を提供します。

let folder = await eagle.folder.getById('folder_id');

console.log(folder.id);
console.log(folder.name);

folder.name = 'new name';
console.log(folder.name);

await folder.save();

🦄 ベストプラクティス： データの安全性を確保するために、Folder インスタンスが提供する save() メソッドを使用してデータの取得および変更を行い、Eagle のリソースリポジトリの下の metadata.json または任意のファイルを直接変更しないでください。

インスタンスメソッド

save()

すべての変更を保存します。

返り値 Promise<void>

let folder = await eagle.folder.getById('folder_id');
folder.name = 'New Fodler Name';

// 変更を保存
await folder.save();

open()

Eagle はこのフォルダーを開きます。

返り値 Promise<void>

let folder = await eagle.folder.getById('folder_id');
await folder.open();

// これと等価
await eagle.folder.open('folder_id');

ヒント：フォルダを開くために、eagle.folder.open(folderId) メソッドを直接呼び出すこともできます。

インスタンス属性

Folder インスタンスには以下の属性が含まれます：

`id` string

読み取り専用、フォルダー id。

`name` string

フォルダー名。

`description` string

フォルダーの説明、紹介。

`icon` string

読み取り専用、フォルダーのアイコン。

`iconColor` string

読み取り専用、フォルダーのアイコンの色。

`createdAt` Integer

読み取り専用、フォルダーの作成時間（タイムスタンプ）。

let date = new Date(folder.createdAt);

`children` Folder[]

読み取り専用、子フォルダーの配列。

let children = folder.children;

console.log(children[0]);
await children[0].open();

前へitem（項目）次へtag（タグ）

最終更新 1 年前