# 構造化ノード：描写、登場人物、セリフ

> タイプメニューの展開、数字キーによる選択、Enterキーでの継続入力、安全に試せる種別変更の仕組みを解説します。

Source: https://loomworld.ai/ja/docs/editor-nodes

## タイプメニューを開く

操作しやすい方の方法を自由に選べます。任意の本文行で `Tab` キーを押すか、空行の先頭で `/` を入力します。現在の行の位置から、タイプが横並びになったカプセルメニューが浮き上がります。

メニューが開いている間、その行は意図的に読み取り専用に設定されます。これにより、押した数字が本文に入力されることなく、メニューの選択肢として正しく認識されます。キャンセルする場合は `Esc` を押すか、そのまま文字入力を続けてください。

## タイプの選択：数字キーまたはマウス操作

メニューの並び順は固定されており、数字キーの `1`〜`9` に直接対応しています： 1 描写、2 登場人物、3 セリフ、4 メモ、5 ト書き、6 ナレーション、7 トランジション、8 時空（シーン設定）、9 シーンです。`↑``↓`（または `Tab`）でハイライトを移動し、`Enter` で確定します。マウスでクリックして選択することも可能ですが、数字キーを使うことで執筆のリズムを崩さずに操作できます。

最も誤用されやすいのが「登場人物」です。これは「次のセリフを誰が話すか」を宣言するものであり、「この人物がこのシーンに登場している」こと全般を示すものではありません。登場人物が入室し、窓の外を眺め、一言も発しない場合は「描写」行として記述します。「登場人物」を出場マーカーとして使用すると、登場回数の統計が狂ってしまいます。

## Enterキーと矢印キーによる継続入力

- 登場人物行でEnterを押すと、その人物のセリフ行が自動生成されます。セリフ行でEnterを押すと次もセリフ行のままとなるため、連続するセリフをタイプし直す必要はありません。
- その他のタイプで行末でEnterを押すと、通常の描写行に戻ります。
- ト書きはセリフの合間に挿入される動作です。正しい構造は「登場人物 →（任意の数のト書き）→ 1つ以上のセリフ」であり、ト書き行単独で話し手を立てることはできません。
- メモを入力すると現在の話し手構造は終了します。自分自身への控えであり、対話の一部ではありません。
- 通常のテキスト行では、先頭行または末尾行で ↑ ↓ を押すと前後のノードに移動します。シーンと時空は複数フィールドを持つノードであるため、Enterキーはまず各フィールド間を順に移動し、最後のフィールドでのみ新しい行を開始します。
- シーン内の空行でEnterを押すとそのシーンから抜け出します。空行でBackspaceを押すと空行が削除され、直前の行にフォーカスが戻ります。

## 各ノードの入力可能フィールド

行のタイプを設定すると、入力できるフィールドがタイプごとに異なります。事前に把握しておくことで試行錯誤を減らせます。

- コンテンツブロック（描写、登場人物、セリフ、メモ、ト書き、ナレーション、トランジション）：本文テキスト自体に加え、1行の執筆意図を記述できます。登場人物行は実体カードにもリンクされ、行内の角括弧で囲まれた小道具名はその行に記録されます。
- シーン：ロケーション（ロケーションライブラリから選択するか、新規名称を入力してカード作成）、時間（自由記述）、短いタイトル、シーンのあらすじ、および番号付きのビート（ビートは後の散文拡張の基礎となります）。あらすじには出所情報が付与され、自動生成されたものは再生成可能ですが、手動入力したものは上書きされません。
- 時空（シーン設定）：ロケーションと時間、状況説明、および物語内タイムラインのインデックス、ラベル、メモ（この瞬間をタイムラインに紐付けます）。時空のロケーションは、そのシーン自体のメインロケーションまたはその配下の階層に限定されます。
- 章：タイトル、章の意図、カラー設定。章番号はタイトル文字列ではなく現在の章の順序から自動的に算出されるため、新規作成時にタイトルが空で「第3章」と表示されるのは正常な動作です。

シーンと時空は複数フィールドを持つノードです。Enterキーでフィールド間を順次移動し、最後のフィールドでEnterを押した時のみ改行されるため、マウスを使わずにスムーズに入力できます。

## 原文を損なわない安心の种別変更

タイプの変更はその行のセマンティックマークを切り替えるだけであり、入力した文字列自体が勝手に書き換わることはありません。そのため自由に試すことができます。実際に変化するのは構造の所属です。ある行を「シーン」に変更すると以降の行はそのシーンに属するようになり、シーンノードを削除するとそのシーンが構造から取り除かれ、残りのシーンが自動で再番号付けされます。

操作を元に戻す方法は2つあります。全アプリ共通のプロジェクト取り消しスタック（`Cmd`/`Ctrl` + `Z`、最大30ステップ、1秒以内の連続入力は1ステップに集約）と、ローカル優先保存です。編集内容はまずローカルに書き込まれてから同期キューに入るため、通信が途切れても執筆した文章が失われることはありません。

## 制限事項とトラブルシューティング

- タイプメニューは脚本の本文行でのみ機能します。カード内の入力欄（キャラクター名、ロケーションの説明など）でTabキーを押してもネイティブの入力フォーカス移動となり、メニューは開きません。
- 旧バージョンの「コメント」「括注」「字幕」の3つのタイプは廃止されており、互換読み込みも行われません。現在はメモ、ト書き、ナレーションとして記述してください。
- 複数行を選択してコピーするとプレーンテキストとして取得され、ノードタイプやスタイルは引き継がれません。単一ノード内でのコピーであれば指定範囲を正確に保持します。
- 目的のタイプが見当たらない場合：メニュー行は横スクロール可能です。← → キーを使用するか、数字キーを直接押して選択してください。

各ノードの詳細なセマンティクスと画面レイアウトについては、 [脚本エディターの概要](https://loomworld.ai/ja/docs/editor-overview) を参照してください。
