From 83e5fc514ea4bdbeab984a0fc90d4cdd6b9ecb20 Mon Sep 17 00:00:00 2001 From: Taylore Date: Thu, 24 Apr 2025 13:39:51 -0700 Subject: [PATCH 1/3] Add "Questions of Interest" section HighlightsFromPointsExplainer.md Practicing editing explainer, added "questions of interest" section. These are questions we're investigating and asking interested partners. --- highlight/HighlightsFromPointsExplainer.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/highlight/HighlightsFromPointsExplainer.md b/highlight/HighlightsFromPointsExplainer.md index 74ee82079..f0c412bb9 100644 --- a/highlight/HighlightsFromPointsExplainer.md +++ b/highlight/HighlightsFromPointsExplainer.md @@ -21,7 +21,7 @@ Here are some inspirational examples of how users may interact with highlighted - When a user hovers over a misspelled word, the web app may display UI with suggested replacement text. - When a user clicks an annotation in a document, the web app may emphasize and scroll into view the corresponding annotation in a pane which lists all the annotations in the document. -Currently, web developers who want to implement some sort of interaction with custom highlights need to use workarounds that are cumbersome to code and maintain and that potentially incur performance penalties. +Currently, web developers who want to implement some sort of interaction with custom highlights need to use workarounds that are cumbersome to code, maintain, often involve directly editing the DOM with static ranges, and incurring performance penalties. ## Customer Problem Example @@ -205,6 +205,10 @@ The API introduces no new security risks. --- [Related issues](https://github.com/MicrosoftEdge/MSEdgeExplainers/labels/highlightsFromPoint) | [Open a new issue](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?template=highlightsfrompoint.md) +## Questions of Interest +Is there a demand for the API to return the Range object in addition to the Highlight pseudo object? +Are there performance issues regarding the "FromPoint" APIs synchronous implementations? + ## Appendix ### highlightsFromPoint IDL Proposed From 7119ec6bc6ab8a7660108f76c92b56b37cb5c790 Mon Sep 17 00:00:00 2001 From: Taylore Date: Thu, 24 Apr 2025 13:49:04 -0700 Subject: [PATCH 2/3] Update HighlightsFromPointsExplainer.md --- highlight/HighlightsFromPointsExplainer.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/highlight/HighlightsFromPointsExplainer.md b/highlight/HighlightsFromPointsExplainer.md index f0c412bb9..280bae21e 100644 --- a/highlight/HighlightsFromPointsExplainer.md +++ b/highlight/HighlightsFromPointsExplainer.md @@ -206,8 +206,8 @@ The API introduces no new security risks. [Related issues](https://github.com/MicrosoftEdge/MSEdgeExplainers/labels/highlightsFromPoint) | [Open a new issue](https://github.com/MicrosoftEdge/MSEdgeExplainers/issues/new?template=highlightsfrompoint.md) ## Questions of Interest -Is there a demand for the API to return the Range object in addition to the Highlight pseudo object? -Are there performance issues regarding the "FromPoint" APIs synchronous implementations? +Is there a demand for the API to return the Range object in addition to the Highlight object? +Are there performance issues regarding the "FromPoint" APIs (e.g. [caretPositionFromPoint](https://developer.mozilla.org/en-US/docs/Web/API/Document/caretPositionFromPoint))synchronous implementations? ## Appendix From bdec60f4a99d245626d044db8ee95c7ccd713d47 Mon Sep 17 00:00:00 2001 From: Taylore Date: Mon, 19 May 2025 23:05:08 -0700 Subject: [PATCH 3/3] Update HighlightsFromPointsExplainer.md adding explanation of existing workarounds that are needed without highlightsFromPoint API --- highlight/HighlightsFromPointsExplainer.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/highlight/HighlightsFromPointsExplainer.md b/highlight/HighlightsFromPointsExplainer.md index 280bae21e..91dbcb465 100644 --- a/highlight/HighlightsFromPointsExplainer.md +++ b/highlight/HighlightsFromPointsExplainer.md @@ -21,7 +21,7 @@ Here are some inspirational examples of how users may interact with highlighted - When a user hovers over a misspelled word, the web app may display UI with suggested replacement text. - When a user clicks an annotation in a document, the web app may emphasize and scroll into view the corresponding annotation in a pane which lists all the annotations in the document. -Currently, web developers who want to implement some sort of interaction with custom highlights need to use workarounds that are cumbersome to code, maintain, often involve directly editing the DOM with static ranges, and incurring performance penalties. +Currently, web developers who want to implement interactions with custom highlights often need to use workarounds that involve directly editing the DOM with static ranges. This approach is cumbersome to code, difficult to maintain, and incurs performance penalties. ## Customer Problem Example