Photoshop JSXで最上位レイヤーを選択する｜layers[0]とグループの範囲

2025年3月17日2026年10月4日

Photoshopの文書直下で最上位にあるレイヤーまたはグループを選ぶJSXです。指定はdoc.layers[0]です。グループ内の子まで自動で掘り下げず、表示・非表示にかかわらず、このコレクションの端を対象にします。反対側の端は最下位の選択を参照してください。

今回確認したのは標準JavaScriptの構文と模擬条件です。Photoshopでの選択・表示・実画面の撮影は未検証です。コードはレイヤーの移動・名前変更・保存を呼びませんが、選択状態は変わります。非表示、ロック、複数選択、アートボードの実際の挙動は自作の文書で確認してください。

配列の並び順とグループの扱い

AdobeのScripting Guideは、レイヤーパネルの先頭をスクリプトの先頭として扱うと説明しています。JavaScriptの先頭は0で、末尾はlength−1です。レイヤー名の「レイヤー1」と配列の添字1は別です。Action ManagerのitemIndexや背景による番号差とも混同しません。

文書直下のコレクション	先頭	末尾
doc.layers（グループを含む）	doc.layers[0]	doc.layers[doc.layers.length – 1]
doc.artLayers（グループを含めない）	doc.artLayers[0]	doc.artLayers[doc.artLayers.length – 1]
選択するもの	文書直下で先頭の要素	文書直下で末尾の要素

最上位がグループなら、そのグループ自体を選びます。子のうち最上位を選ぶ処理、文書全体で最初のArtLayerを再帰的に探す処理、表示されているArtLayerだけを選ぶ処理は対象範囲が異なります。グループを自動展開したり、子を複数選択したりするコードは含めていません。

文書直下の最上位を選択する全体コード

新しい全体コードをUTF-8の.jsxとして保存し、ファイル→スクリプト→参照から実行します。旧コードへ追記せず、別ファイルとして1回実行してください。メニューへの登録は動作を確認した後に行います。

#target photoshop
(function () {
    if (app.documents.length === 0) { alert("文書を開いてください。"); return; }
    try {
        var doc = app.activeDocument;
        if (doc.layers.length === 0) { alert("文書直下にレイヤーがありません。"); return; }
        var target = doc.layers[0];
        doc.activeLayer = target;
    } catch (error) {
        alert("読取または選択で中断: " + error.message + "\n行: " + error.line);
    }
}());

対象範囲を変える場合

文書直下のArtLayerだけに限定する場合は、コード内の空件数検査・length・添字の参照をすべてdoc.artLayersへ揃えます。文書直下がグループだけならartLayersは0件となるため、0件検査を残します。layersとartLayersのlengthを混ぜると、存在しない添字や別の対象を参照します。

グループ直下の端を選びたい場合は、名前配列でグループを指定する方法で対象を取得し、LayerSetであることを確認してから、そのgroup.layersを使います。activeLayer.parentを無条件で使うと、文書直下のレイヤーではDocumentになり、グループ選択時には選んだグループの親になります。対象グループを明示してから参照してください。

確認用の配置と期待値

自作文書の条件	この例の最上位選択
上から「CGM_Top」「CGM_Group」「CGM_Bottom」	CGM_Top
文書直下の最上位がグループ	グループ自体。内部の子を自動で選ばない。
1要素の文書	その1要素。先頭と末尾は同じ。
端が非表示またはロック	候補からは除外しない。実際の選択・表示の可否はPhotoshopで確認。
文書なし・読取/選択の例外	先に停止し、エラーを不在と決めつけない。

確認時は実行前後のレイヤーパネルを撮影し、端の行が選択されたことと、レイヤー数・順序・名前・表示状態を比較します。選択は重ね順の移動や画素の選択範囲作成とは別です。元の複数選択全体の自動復元を含めていないため、実行前の選択も記録してください。

旧説明から修正した点

旧コードは「一番上」と説明しながらdoc.layers[doc.layers.length – 1]を指定していました。これは文書直下の末尾を参照するため、今回の最上位の例はdoc.layers[0]へ修正しています。

旧コードと過去の画面（参照用）

以下は誤った方向の説明を含む旧コードです。参照用に保持し、新しい全体コードと混ぜて実行しないでください。旧画像は編集画面だけで、対象の選択結果や文書の構成を確認できません。

// 現在のドキュメントを取得
var doc = app.activeDocument;

// レイヤーが存在するか確認
if (doc.layers.length > 0) {
    // 一番上のレイヤーを取得してアクティブにする
    doc.activeLayer = doc.layers[doc.layers.length - 1];
} else {
    alert("レイヤーが存在しません。");
}

旧記事のコード編集画面。下部にArtLayer 背景が表示されていますが、文書の最上位が選ばれたことを示すレイヤーパネルは写っていません。過去の掲載画像で、撮影日・Photoshopの詳細版は未確認です。

参照資料と確認範囲

Adobe Photoshop Scripting Guide 2020の38〜39ページ（並び順・レイヤーセット）、JavaScript Scripting Reference 2020のDocument、ArtLayers、Layers、LayerSetを参照しています。2020年版のExtendScript資料で、現在のPhotoshopで実機確認した記録ではありません。

Adobeのレイヤー選択手順ではパネルでの選択と、サムネールからのピクセル選択を区別しています。UXPのLayers資料は別の実行環境です。このJSXを.psjsに改名するだけでは移行できません。UXPスクリプトの実行方法で分担を確認してください。