> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ビジュアルエディター

> デザインとアプリに直接ビジュアル編集を加える — コードを書かずにクリックだけでテキスト、色、レイアウト、画像を調整します。

## ビジュアルエディターとは？

ビジュアルエディターを使うと、要素を直接クリックしてUIを手動で変更できます。[デザインCanvas](/learn/design/canvas)とプレビューの両方で動作するので、モックアップと実行中のアプリケーションを同じ方法で編集できます。

シンプルな編集 — テキストの変更、色の調整、スペースの微調整 — はAIクレジットを消費せずにソースコードを直接更新します。隠れた複雑さを伴う変更の場合、ビジュアルエディターは自動的にAgentに引き渡します。

主要な概念：

* **確定的な編集**：シンプルな変更（テキスト、色、スペース）はAgentのループなしにソースコードに直接適用
* **クレジットコストなし**：直接編集はAIクレジットを消費しません — 複雑な変更のみAgentを通じます
* **デュアルコンテキスト**：デザインCanvasフレームとプレビューで同じように動作
* **ソースコードの同期**：すべての編集がすぐに基盤となるソースコードを更新

<Note>
  ビジュアルエディターは現在**ウェブブラウザ**でのみ利用可能です。モバイルアプリとデスクトップアプリではサポートされていません。
</Note>

## ビジュアルエディターの使い方

### プレビューで編集する

実行中のアプリケーション内の任意の要素をクリックして編集を開始します。テキスト、色、スペース、または画像を変更すると、ライブで変更が適用されます。

<Steps>
  <Step title="要素を選択する">
    プレビュー内の任意の要素をクリックして編集を開始します。
  </Step>

  <Step title="編集する">
    テキストをインラインで編集したり、カラーピッカーで色を調整したり、スタイルコントロールでスペースを変更したり、画像を入れ替えたりできます。チャットのエディターペインでパディング、マージンなど追加のプロパティを調整できます。
  </Step>

  <Step title="保存する">
    保存を押してソースコードを更新します。シンプルな変更はAIクレジットを消費せずに直接適用されます。編集に複雑さが伴う場合、ビジュアルエディターはターゲットメタデータをAgentに送信してサポートを求めます。
  </Step>
</Steps>

### Canvasで編集する

同じ編集体験がデザインCanvasフレームでも機能します。フレーム内の任意の要素をクリックして編集できます — Agentのループなしにモックアップのリサイズ、テキスト変更、色やスペースの調整ができます。

### テキスト編集

テキスト要素をクリックして直接入力すると変更できます。テキストがソースコード内の文字列であれば、編集はすぐに適用されます。

<Frame>
  <video autoPlay muted loop playsInline src="https://storage.googleapis.com/replit-cdn/sanity/v2-text-edits.mp4" />
</Frame>

### 色の調整

カラーピッカーを使ってテキストと背景色を調整します。入力欄に「purple」などの色の名前を入力するか、スポイトツールを使って画面上の任意の場所から色を選択できます。

<Frame>
  <video autoPlay muted loop playsInline src="https://storage.googleapis.com/replit-cdn/sanity/v2-color-picker-and-eyedropper.mp4" />
</Frame>

### スタイルの変更

直感的なコントロールを使って要素全体のパディング、マージン、レイアウトを調整します。

<Frame>
  <video autoPlay muted loop playsInline src="https://storage.googleapis.com/replit-cdn/sanity/v2-related-elements.mp4" />
</Frame>

### レイアウトコントロール

ビジュアルエディターはすべてのコントロールをわかりやすいセクションにグループ化し、必要なものをより素早く見つけられます：**テキスト**、**レイアウト**、**色**、**ボーダー**。（画像要素を選択した場合は**画像**セクションも表示されます。）

**レイアウト**セクションでは、Agentを通じずにコンテナ内の子要素の配置を調整できます。フレックスコンテナを選択し、Layoutを展開すると以下が表示されます：

* **整列**：コンテナ内の両軸に沿ってアイテムが配置される場所を示す3×3のドットピッカー。
* **方向**：子要素を行または列に積み重ねる2つの矢印ボタン。
* **ギャップ**：アイテム間のスペースのピクセル値。ギャップ入力の横にあるアイコンは現在の方向に合わせて変わるので、水平または垂直スペースを調整しているかが常にわかります。その隣にある矢印アイコンは**アイテム間にスペースを分配**をトグルし、子要素をコンテナの両端に押し広げます。
* **外側スペース**：要素の外側のスペースを各辺ごとに設定する入力欄（辺ごとに1つの入力欄、4辺すべてを一度にロックするリンクトグル付き）。
* **内側スペース**：各軸に沿って要素の内側のスペースを設定する入力欄、両軸を一度にロックするリンクトグル付き。

<Frame>
  <img src="https://mintcdn.com/replit/z4RAmWFZHk1tpgLX/images/replitai/visual-editor-layout.png?fit=max&auto=format&n=z4RAmWFZHk1tpgLX&q=85&s=07654fdfbcee895267690ab28bd135da" alt="フレックスコンテナが選択されたビジュアルエディター右ペイン。整列3×3ドットピッカー、方向矢印ボタン、隣接するスペース間トグル付きギャップ入力、各辺の外側スペース入力、内側スペース入力が表示されたLayoutセクション" width="1220" height="977" data-path="images/replitai/visual-editor-layout.png" />
</Frame>

レイアウトセクションは、少なくとも1つのレイアウトコントロールが選択した要素に適用される場合にのみ表示されます。スペースやレイアウトプロパティがないプレーンテキストノードではセクションが完全に非表示になり、エディターはコンパクトに保たれます。

### 画像の更新

画像を選択してURLを入れ替えるか、即時プレビューで独自ファイルをアップロードできます。

<Frame>
  <video autoPlay muted loop playsInline src="https://storage.googleapis.com/replit-cdn/sanity/v2-image-edits.mp4" />
</Frame>

## できること

* **テキストのクイック修正**：ソースファイルを開かずにコピー、ラベル、見出しを更新
* **色の探索**：クリックして調整してさまざまな配色を試す — 適切なCSSを見つける必要なし
* **レイアウトの微調整**：ピクセル値を推測する代わりにビジュアルでパディング、マージン、スペースを細かく調整
* **画像の入れ替え**：クリックしてアップロードすることでプレースホルダー画像をリアルなアセットに置き換え
* **デザインの反復**：AgentのラウンドトリップなしにCanvasフレームをすばやく調整してビジュアルの方向性を比較

## よくある質問

<Accordion title="ビジュアルエディターの変更はAIクレジットを消費しますか？">
  シンプルで確定的な編集 — テキスト変更、色の選択、スペースの調整 — はAIクレジットを消費しません。ソースコードを直接更新します。ビジュアルエディターが隠れた複雑さを検出した場合、変更をAgentを通じてルーティングし、クレジットが使用されます。
</Accordion>

<Accordion title="複数の場所に表示される要素を編集できますか？">
  はい。ループでレンダリングされたりコンポーネント全体で再利用されたりする要素を選択すると、すべてのインスタンスが強調表示され、一度に更新されます。
</Accordion>

<Accordion title="一部の要素のテキストを編集できないのはなぜですか？">
  複数のサブ要素で構成される複合要素は、ビジュアルエディターで直接テキスト編集できません。代わりにチャットでAgentに変更を依頼してください。
</Accordion>

<Accordion title="要素のソースコードを見つけるにはどうすればよいですか？">
  選択した要素の左上のラベルをクリックすると、ソースコード内のその場所にジャンプします。
</Accordion>
