IllustratorのJSXでレイヤーを取得・作成し、選択したオブジェクトを移動する処理例です。参照する階層を明示し、同じ階層の名前が重複している場合は処理を止めます。
2026年10月3日にコードと説明を改修しました。掲載例はコピーしたデータで試し、レイヤー構造、重なり順、外観、書き出し結果を確認してから使ってください。現在の改修版について、Illustratorでの動作確認はまだ完了していません。
アクティブなレイヤーとオブジェクト選択の違い
doc.activeLayerは新しいオブジェクトを置く現在のレイヤーです。この値を変更しても、レイヤー内のオブジェクトをすべて選択する処理にはなりません。doc.selectionはオブジェクトなどの選択状態で、何も選んでいないときはnull、文字編集中は文字範囲を返す場合があります。
名前の取得は階層ごとに行う
最上位はdoc.layers、子はparent.layersを調べます。下のuniqueLayerは、渡されたコレクションだけを検索します。同名が0件または2件以上ならエラーにするため、名前でどれか1件を暗黙に選ぶ動作を避けられます。
| 取得する階層 | コード内の参照 |
|---|---|
| 最上位 | uniqueLayer(doc.layers, “親”) |
| 親の直下 | uniqueLayer(parent.layers, “子”) |
| 子の直下 | uniqueLayer(child.layers, “孫”) |
最上位のレイヤーをアクティブにする
(function () {
try {
if (app.documents.length === 0) throw new Error("ドキュメントを開いてください。");
var doc = app.activeDocument;
var target = uniqueLayer(doc.layers, "親");
requireEditable(target);
doc.activeLayer = target;
} catch (e) { alert(String(e)); }
function uniqueLayer(layers, name) {
var found = null;
for (var i = 0; i < layers.length; i++) {
if (layers[i].name === name) {
if (found !== null) throw new Error("同名レイヤーが複数あります: " + name);
found = layers[i];
}
}
if (found === null) throw new Error("レイヤーがありません: " + name);
return found;
}
function requireEditable(node) {
while (node && node.typename !== "Document") {
if (node.locked || node.hidden || (node.typename === "Layer" && !node.visible))
throw new Error("ロック・非表示の対象があります。");
node = node.parent;
}
}
}());子・孫レイヤーをアクティブにする
(function () {
try {
if (app.documents.length === 0) throw new Error("ドキュメントを開いてください。");
var doc = app.activeDocument;
var parent = uniqueLayer(doc.layers, "親");
var child = uniqueLayer(parent.layers, "子");
var target = uniqueLayer(child.layers, "孫");
requireEditable(target);
doc.activeLayer = target;
} catch (e) { alert(String(e)); }
function uniqueLayer(layers, name) {
var found = null;
for (var i = 0; i < layers.length; i++) {
if (layers[i].name === name) {
if (found !== null) throw new Error("同名レイヤーが複数あります: " + name);
found = layers[i];
}
}
if (found === null) throw new Error("レイヤーがありません: " + name);
return found;
}
function requireEditable(node) {
while (node && node.typename !== "Document") {
if (node.locked || node.hidden || (node.typename === "Layer" && !node.visible))
throw new Error("ロック・非表示の対象があります。");
node = node.parent;
}
}
}());親レイヤーと子レイヤーを作成する
(function () {
try {
if (app.documents.length === 0) throw new Error("ドキュメントを開いてください。");
var doc = app.activeDocument;
for (var i = 0; i < doc.layers.length; i++) {
if (doc.layers[i].name === "新しい親") throw new Error("同名の親が存在します。");
}
var parent = doc.layers.add();
parent.name = "新しい親";
var child = parent.layers.add();
child.name = "新しい子";
} catch (e) { alert(String(e)); }
function uniqueLayer(layers, name) {
var found = null;
for (var i = 0; i < layers.length; i++) {
if (layers[i].name === name) {
if (found !== null) throw new Error("同名レイヤーが複数あります: " + name);
found = layers[i];
}
}
if (found === null) throw new Error("レイヤーがありません: " + name);
return found;
}
function requireEditable(node) {
while (node && node.typename !== "Document") {
if (node.locked || node.hidden || (node.typename === "Layer" && !node.visible))
throw new Error("ロック・非表示の対象があります。");
node = node.parent;
}
}
}());選択したオブジェクトを「まとめ」へ移動する
移動前に全件を検査し、選択を配列へ控えてから移します。グループ内の一部を直接取り出すと、クリッピングや親の外観から外れるため、この例では部分選択を拒否します。移動対象のロック・非表示を勝手に解除しません。
(function () {
try {
if (app.documents.length === 0) throw new Error("ドキュメントを開いてください。");
var doc = app.activeDocument;
var selection = doc.selection;
if (!selection || !(selection instanceof Array) || selection.length === 0)
throw new Error("選択ツールでオブジェクト全体を選んでください。");
var target = uniqueLayer(doc.layers, "まとめ");
requireEditable(target);
var items = [];
for (var i = 0; i < selection.length; i++) {
var item = selection[i];
if (!item || typeof item.move !== "function" || item.typename === "TextRange" || item.typename === "InsertionPoint")
throw new Error("文字編集中など、対象外の選択です。");
if (item.parent.typename !== "Layer")
throw new Error("グループ内の部分選択は対象外です。グループ全体を選んでください。");
requireEditable(item);
items.push(item);
}
for (var j = items.length - 1; j >= 0; j--)
items[j].move(target, ElementPlacement.PLACEATBEGINNING);
} catch (e) { alert(String(e)); }
function uniqueLayer(layers, name) {
var found = null;
for (var i = 0; i < layers.length; i++) {
if (layers[i].name === name) {
if (found !== null) throw new Error("同名レイヤーが複数あります: " + name);
found = layers[i];
}
}
if (found === null) throw new Error("レイヤーがありません: " + name);
return found;
}
function requireEditable(node) {
while (node && node.typename !== "Document") {
if (node.locked || node.hidden || (node.typename === "Layer" && !node.visible))
throw new Error("ロック・非表示の対象があります。");
node = node.parent;
}
}
}());配列の末尾から移動先の先頭へ入れるため、配列内の順序を反転させずに配置します。ただし、selectionの順序が元のレイヤーパネル全体の重なり順と一致する保証はありません。異なるレイヤー間の前後関係や、親レイヤーの効果・透明度は移動後に比較してください。途中でmoveが失敗すると一部だけ移動した状態が残ります。保存せず結果を確認します。
JSXの保存と実行
コードをUTF-8のテキストで保存し、拡張子を.jsxにします。「ファイル」→「スクリプト」→「その他のスクリプト」から選びます。保存・実行の詳しい手順はJSX入門を参照してください。各コードは別々のファイルとして実行します。
確認用の小さな例
- 「親」の中に「子」、その中に「孫」を作り、各コードが指定した階層だけを参照するか確認する。
- 同じ階層に「親」を2つ置き、変更前にエラーで停止するか確認する。
- 「まとめ」をロック、非表示にし、解除せず停止するか確認する。
- 別レイヤーの重なる図形とクリッピンググループで、移動前後の外観を比較する。
親だけを外す用途は子レイヤーを残して親を削除する処理、参照の基礎はDOMの階層へ進んでください。旧GitHub版・既存画像は今回の改修版と一致するとは限りません。
参照資料
Adobe公式のレイヤーパネル概要と、Adobe資料をもとに維持されているLayerのAPI参照を参照しました。
よくある質問：JSXでレイヤーを操作する
この記事のJSXは、何をするものですか？
IllustratorのJSXでレイヤーを取得・作成し、選択したオブジェクトを移動する処理例です。参照する階層を明示し、同じ階層の名前が重複している場合は処理を止めます。
アクティブなレイヤーと、オブジェクトの選択は、何が違いますか？
doc.activeLayerは、新しいオブジェクトを置く現在のレイヤーです。この値を変更しても、レイヤー内のオブジェクトをすべて選択する処理にはなりません。doc.selectionはオブジェクトなどの選択状態で、何も選んでいないときはnull、文字編集中は文字範囲を返す場合があります。
レイヤーの名前は、どうやって取得しますか？
最上位はdoc.layers、子はparent.layersを調べるなど、階層ごとに行います。記事のuniqueLayerは、渡されたコレクションだけを検索し、同名が0件または2件以上ならエラーにします。そのため、名前でどれか1件を暗黙に選ぶ動作を避けられます。参照先は、最上位がuniqueLayer(doc.layers, “親”)、親の直下がuniqueLayer(parent.layers, “子”)、子の直下がuniqueLayer(child.layers, “孫”)です。
選択したオブジェクトを「まとめ」へ移動すると、何が起こりますか？
記事の例では、移動前に全件を検査し、選択を配列へ控えてから移します。グループ内の一部を直接取り出すと、クリッピングや親の外観から外れるため、この例では部分選択を拒否します。移動対象のロック・非表示は、勝手に解除しません。異なるレイヤー間の前後関係や、親レイヤーの効果・透明度は、移動後に比較してください。途中でmoveが失敗すると、一部だけ移動した状態が残るため、保存せず結果を確認します。
スクリプトは、どうやって実行しますか？
コードをUTF-8のテキストで保存し、拡張子を.jsxにします。「ファイル」→「スクリプト」→「その他のスクリプト」から選びます。各コードは別々のファイルとして実行します。保存・実行の詳しい手順は、関連記事のJSX入門を参照してください。
動作を確かめるには、どんな試し方がありますか？
記事では、確認用の小さな例として、「親」の中に「子」、その中に「孫」を作り、各コードが指定した階層だけを参照するか確認する、同じ階層に「親」を2つ置き、変更前にエラーで停止するか確認する、「まとめ」をロック・非表示にし、解除せず停止するか確認する、別レイヤーの重なる図形とクリッピンググループで、移動前後の外観を比較する、を挙げています。
親レイヤーだけを外したいときは、どうすればよいですか？
親だけを外す用途は、関連記事の「子レイヤーを残して親を削除する処理」を案内しています。参照の基礎は、DOMの階層の記事で確認できます。
掲載コードは、実際のIllustratorで動作確認されていますか？
2026年10月3日にコードと説明を改修したもので、現在の改修版について、Illustratorでの動作確認はまだ完了していません。旧GitHub版・既存画像は、今回の改修版と一致するとは限りません。掲載例はコピーしたデータで試し、レイヤー構造、重なり順、外観、書き出し結果を確認してから使ってください。最新はAdobe公式のレイヤーパネルの説明などで確認してください。
コメント
コメント一覧 （8件）
I am usually to running a blog and i actually respect your content. The article has actually peaks my interest. I am going to bookmark your website and preserve checking for brand new information.
That is the fitting weblog for anyone who wants to search out out about this topic. You notice so much its virtually exhausting to argue with you (not that I really would want…HaHa). You positively put a brand new spin on a subject thats been written about for years. Great stuff, just great!
The heart of your writing whilst appearing reasonable at first, did not really work very well with me personally after some time. Somewhere throughout the sentences you actually managed to make me a believer unfortunately just for a very short while. I still have a problem with your leaps in logic and you might do well to help fill in all those gaps. In the event you actually can accomplish that, I will certainly end up being impressed.
I love your blog.. very nice colors & theme. Did you make this website yourself or did you hire someone to do it for you? Plz answer back as I’m looking to create my own blog and would like to find out where u got this from. thanks a lot
Some genuinely grand work on behalf of the owner of this site, dead great content.
Way cool, some valid points! I appreciate you making this article available, the rest of the site is also high quality. Have a fun.
Can I just say what a aid to search out somebody who actually is aware of what theyre speaking about on the internet. You undoubtedly know how one can carry an issue to gentle and make it important. More people must read this and perceive this facet of the story. I cant imagine youre no more common because you positively have the gift.
You are my inspiration, I have few web logs and occasionally run out from brand :). “Actions lie louder than words.” by Carolyn Wells.