Skip to content

Commit f6fda3d

Browse files
committed
feat: write docs for edit highlights on hover section
1 parent ab335f2 commit f6fda3d

File tree

2 files changed

+42
-2
lines changed

2 files changed

+42
-2
lines changed

docs/07-Pro Features/01-live-preview-edit.md

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ Alternatively, you can switch to Edit Mode by updating the `livePreviewMode` set
2626

2727
The **Info Box** displays information about an element. It is normally shown at the top-left of the element, but if there is not enough space, Phoenix Code may display it on another side where sufficient space is available. Phoenix Code attempts to position the Info Box as close to the element as possible while keeping it visible.
2828

29-
> By default, the Info Box appears when you hover over an element in the Live Preview, but this behavior can be changed. See the **Edit Highlights on Hover** section for more details.
29+
> By default, the Info Box appears when you hover over an element in the Live Preview, but this behavior can be changed. See the [Edit Highlights on Hover](#edit-highlights-on-hover) section for more details.
3030
3131
<!-- TODO: add image showing Info Box -->
3232

@@ -81,3 +81,23 @@ The Tool Box displays different options depending on the selected element type.
8181
> The Tool Box is never shown for non-editable elements that are dynamically created by JavaScript.
8282
8383
---
84+
85+
## Edit Highlights on Hover
86+
87+
By default, in Edit Mode, hovering over elements in the Live Preview highlights them and displays the Info Box. You can change this behavior to show highlights only when you click elements instead.
88+
89+
To toggle this setting, click the **mode selector dropdown** in the Live Preview toolbar and unselect **Edit Highlights on Hover**. By default, this option remains checked.
90+
91+
<!-- TODO: add image showing the Edit Highlights on Hover option in the mode dropdown -->
92+
93+
When **Edit Highlights on Hover** is checked (default):
94+
- Hovering over elements shows highlights and the Info Box
95+
- Clicking an element selects it and displays the Tool Box along with the Info Box
96+
97+
When **Edit Highlights on Hover** is unchecked:
98+
- Hovering over elements has no effect
99+
- Clicking an element shows highlights, the Info Box, and the Tool Box
100+
101+
Alternatively, you can change this setting by updating the `livePreviewElementHighlights` preference in the preferences file. Set it to `"hover"` (default) or `"click"`. See [Editing Preferences](../editing-text#editing-preferences) to learn how to edit the preferences file.
102+
103+
---

docs/07-Pro Features/01-live-preview-edit.md~

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ The Tool Box displays different options depending on the selected element type.
5959
- **Select Parent** *(up-arrow icon)*: Selects the parent of the currently selected element.
6060
*This button appears only when a valid parent exists (it is not shown when the parent is `body`, `html`, or a JavaScript-rendered element).*
6161

62-
- **Edit Text** *(pencil icon)*: Opens inline text editing for the selected element. You can edit text directly in the Live Preview, and Phoenix Code automatically updates the source code. Press `Enter` to save the edited text or `Esc` to cancel.
62+
- **Edit Text** *(pencil icon)*: Opens inline text editing for the selected element. You can edit text directly in the Live Preview, and Phoenix Code automatically updates the source code. Press `Enter` to save the edited text or `Esc` to cancel.
6363
*This button appears only for elements that can contain text (it is not available for `<img>`, `<video>`, `<br>`, etc.).*
6464
> You can also edit text by double-clicking the element in the Live Preview.
6565

@@ -81,3 +81,23 @@ The Tool Box displays different options depending on the selected element type.
8181
> The Tool Box is never shown for non-editable elements that are dynamically created by JavaScript.
8282

8383
---
84+
85+
## Edit Highlights on Hover
86+
87+
By default, in Edit Mode, hovering over elements in the Live Preview highlights them and displays the Info Box. You can change this behavior to show highlights only when you click elements instead.
88+
89+
To toggle this setting, click the **mode selector dropdown** in the Live Preview toolbar and unselect **Edit Highlights on Hover**. By default, this option remains checked.
90+
91+
<!-- TODO: add image showing the Edit Highlights on Hover option in the mode dropdown -->
92+
93+
When **Edit Highlights on Hover** is checked (default):
94+
- Hovering over elements shows highlights and the Info Box
95+
- Clicking an element selects it and displays the Tool Box along with the Info Box
96+
97+
When **Edit Highlights on Hover** is unchecked:
98+
- Hovering over elements has no effect
99+
- Clicking an element shows highlights, the Info Box, and the Tool Box
100+
101+
Alternatively, you can change this setting by updating the `livePreviewElementHighlights` preference in the preferences file. Set it to `"hover"` (default) or `"click"`. See [Editing Preferences](../editing-text#editing-preferences) to learn how to edit the preferences file.
102+
103+
---

0 commit comments

Comments
 (0)