diff --git a/files/en-us/_redirects.txt b/files/en-us/_redirects.txt index 2d4761925f80808..ae29fe73869d763 100644 --- a/files/en-us/_redirects.txt +++ b/files/en-us/_redirects.txt @@ -8799,6 +8799,10 @@ /en-US/docs/Web/API/IndexedDB_API/ObjectStore /en-US/docs/Web/API/IDBObjectStore /en-US/docs/Web/API/IndexedDB_API/Synchronous_API /en-US/docs/Web/API/IndexedDB_API /en-US/docs/Web/API/IndexedDB_API/Transaction /en-US/docs/Web/API/IDBTransaction +/en-US/docs/Web/API/InkPresenter /en-US/docs/Web/API/DelegatedInkTrailPresenter +/en-US/docs/Web/API/InkPresenter/expectedImprovement /en-US/docs/Web/API/DelegatedInkTrailPresenter/expectedImprovement +/en-US/docs/Web/API/InkPresenter/presentationArea /en-US/docs/Web/API/DelegatedInkTrailPresenter/presentationArea +/en-US/docs/Web/API/InkPresenter/updateInkTrailStartPoint /en-US/docs/Web/API/DelegatedInkTrailPresenter/updateInkTrailStartPoint /en-US/docs/Web/API/Input.mozGetFileNameArray /en-US/docs/Web/API/HTMLInputElement /en-US/docs/Web/API/Input.mozSetFileNameArray /en-US/docs/Web/API/HTMLInputElement /en-US/docs/Web/API/Input.multiple /en-US/docs/Web/API/HTMLInputElement/multiple diff --git a/files/en-us/web/api/inkpresenter/expectedimprovement/index.md b/files/en-us/web/api/delegatedinktrailpresenter/expectedimprovement/index.md similarity index 53% rename from files/en-us/web/api/inkpresenter/expectedimprovement/index.md rename to files/en-us/web/api/delegatedinktrailpresenter/expectedimprovement/index.md index a0e484d6b8a6c60..3e0a5ecfbb5c9bb 100644 --- a/files/en-us/web/api/inkpresenter/expectedimprovement/index.md +++ b/files/en-us/web/api/delegatedinktrailpresenter/expectedimprovement/index.md @@ -1,16 +1,17 @@ --- -title: "InkPresenter: expectedImprovement property" +title: "DelegatedInkTrailPresenter: expectedImprovement property" short-title: expectedImprovement -slug: Web/API/InkPresenter/expectedImprovement +slug: Web/API/DelegatedInkTrailPresenter/expectedImprovement page-type: web-api-instance-property status: - - experimental -browser-compat: api.InkPresenter.expectedImprovement + - deprecated + - non-standard +browser-compat: api.DelegatedInkTrailPresenter.expectedImprovement --- -{{APIRef("Ink API")}}{{SeeCompatTable}} +{{APIRef("Ink API")}}{{Deprecated_header}}{{Non-Standard_Header}} -The **`expectedImprovement`** read-only property of the {{domxref("InkPresenter")}} interface returns a value, in milliseconds, indicating the latency improvement that can be expected using this presenter. +The **`expectedImprovement`** read-only property of the {{domxref("DelegatedInkTrailPresenter")}} interface returns a value, in milliseconds, indicating the latency improvement that can be expected using this presenter. ### Value @@ -30,7 +31,7 @@ async function inkInit() { ## Specifications -{{Specifications}} +The feature is no longer a part of the specification. ## Browser compatibility diff --git a/files/en-us/web/api/inkpresenter/index.md b/files/en-us/web/api/delegatedinktrailpresenter/index.md similarity index 74% rename from files/en-us/web/api/inkpresenter/index.md rename to files/en-us/web/api/delegatedinktrailpresenter/index.md index eb13ea5916c57ae..a33f2193a5276b7 100644 --- a/files/en-us/web/api/inkpresenter/index.md +++ b/files/en-us/web/api/delegatedinktrailpresenter/index.md @@ -1,35 +1,35 @@ --- -title: InkPresenter -slug: Web/API/InkPresenter +title: DelegatedInkTrailPresenter +slug: Web/API/DelegatedInkTrailPresenter page-type: web-api-interface status: - experimental -browser-compat: api.InkPresenter +browser-compat: api.DelegatedInkTrailPresenter --- {{APIRef("Ink API")}}{{SeeCompatTable}} -The **`InkPresenter`** interface of the [Ink API](/en-US/docs/Web/API/Ink_API) provides the ability to instruct the OS-level compositor to render ink strokes between pointer event dispatches. +The **`DelegatedInkTrailPresenter`** interface of the [Ink API](/en-US/docs/Web/API/Ink_API) provides the ability to instruct the OS-level compositor to render ink strokes between pointer event dispatches. {{InheritanceDiagram}} ## Instance properties -- {{domxref("InkPresenter.expectedImprovement", "expectedImprovement")}} {{Experimental_Inline}} {{ReadOnlyInline}} +- {{domxref("DelegatedInkTrailPresenter.expectedImprovement", "expectedImprovement")}} {{Deprecated_Inline}} {{Non-standard_Inline}} {{ReadOnlyInline}} - : Returns a value, in milliseconds, indicating the latency improvement that can be expected using this presenter. -- {{domxref("InkPresenter.presentationArea", "presentationArea")}} {{Experimental_Inline}} {{ReadOnlyInline}} +- {{domxref("DelegatedInkTrailPresenter.presentationArea", "presentationArea")}} {{Experimental_Inline}} {{ReadOnlyInline}} - : Returns the {{domxref("Element")}} inside which rendering of ink strokes is confined. ## Instance methods -- {{domxref("InkPresenter.updateInkTrailStartPoint", "updateInkTrailStartPoint()")}} {{Experimental_Inline}} +- {{domxref("DelegatedInkTrailPresenter.updateInkTrailStartPoint", "updateInkTrailStartPoint()")}} {{Experimental_Inline}} - : Passes the {{domxref("PointerEvent")}} that was used as the last rendering point for the current frame, allowing the OS-level compositor to render a delegated ink trail ahead of the next pointer event being dispatched. ## Example In this example, we draw a trail onto a 2D canvas. Near the start of the code, we call {{domxref("Ink.requestPresenter()")}}, passing it the canvas as the presentation area for it to take care of and storing the promise it returns in the `presenter` variable. -Later on, in the `pointermove` event listener, the new position of the trailhead is drawn onto the canvas each time the event fires. In addition, the `InkPresenter` object returned when the `presenter` promise fulfills has its {{domxref("InkPresenter.updateInkTrailStartPoint", "updateInkTrailStartPoint()")}} method invoked; this is passed: +Later on, in the `pointermove` event listener, the new position of the trailhead is drawn onto the canvas each time the event fires. In addition, the `DelegatedInkTrailPresenter` object returned when the `presenter` promise fulfills has its {{domxref("DelegatedInkTrailPresenter.updateInkTrailStartPoint", "updateInkTrailStartPoint()")}} method invoked; this is passed: - The last trusted pointer event representing the rendering point for the current frame. - A `style` object containing color and diameter settings. diff --git a/files/en-us/web/api/inkpresenter/presentationarea/index.md b/files/en-us/web/api/delegatedinktrailpresenter/presentationarea/index.md similarity index 77% rename from files/en-us/web/api/inkpresenter/presentationarea/index.md rename to files/en-us/web/api/delegatedinktrailpresenter/presentationarea/index.md index 12b3124ec2c5258..08bf568408ca624 100644 --- a/files/en-us/web/api/inkpresenter/presentationarea/index.md +++ b/files/en-us/web/api/delegatedinktrailpresenter/presentationarea/index.md @@ -1,16 +1,14 @@ --- -title: "InkPresenter: presentationArea property" +title: "DelegatedInkTrailPresenter: presentationArea property" short-title: presentationArea -slug: Web/API/InkPresenter/presentationArea +slug: Web/API/DelegatedInkTrailPresenter/presentationArea page-type: web-api-instance-property -status: - - experimental -browser-compat: api.InkPresenter.presentationArea +browser-compat: api.DelegatedInkTrailPresenter.presentationArea --- {{APIRef("Ink API")}}{{SeeCompatTable}} -The **`presentationArea`** read-only property of the {{domxref("InkPresenter")}} interface returns the {{domxref("Element")}} inside which rendering of ink strokes is confined. +The **`presentationArea`** read-only property of the {{domxref("DelegatedInkTrailPresenter")}} interface returns the {{domxref("Element")}} inside which rendering of ink strokes is confined. If the preceding {{domxref("Ink.requestPresenter", "Ink.requestPresenter()")}} method call included a specific `presentationArea` element definition, then that will be the element returned. Otherwise, the default is returned, which is the containing viewport. diff --git a/files/en-us/web/api/inkpresenter/updateinktrailstartpoint/index.md b/files/en-us/web/api/delegatedinktrailpresenter/updateinktrailstartpoint/index.md similarity index 79% rename from files/en-us/web/api/inkpresenter/updateinktrailstartpoint/index.md rename to files/en-us/web/api/delegatedinktrailpresenter/updateinktrailstartpoint/index.md index a9dc893f07f33ad..b57c3cf10e6e778 100644 --- a/files/en-us/web/api/inkpresenter/updateinktrailstartpoint/index.md +++ b/files/en-us/web/api/delegatedinktrailpresenter/updateinktrailstartpoint/index.md @@ -1,16 +1,14 @@ --- -title: "InkPresenter: updateInkTrailStartPoint() method" +title: "DelegatedInkTrailPresenter: updateInkTrailStartPoint() method" short-title: updateInkTrailStartPoint() -slug: Web/API/InkPresenter/updateInkTrailStartPoint +slug: Web/API/DelegatedInkTrailPresenter/updateInkTrailStartPoint page-type: web-api-instance-method -status: - - experimental -browser-compat: api.InkPresenter.updateInkTrailStartPoint +browser-compat: api.DelegatedInkTrailPresenter.updateInkTrailStartPoint --- {{APIRef("Ink API")}}{{SeeCompatTable}} -The **`updateInkTrailStartPoint()`** method of the {{domxref("InkPresenter")}} interface indicates which {{domxref("PointerEvent")}} was used as the last rendering point for the current frame, allowing the OS-level compositor to render a delegated ink trail ahead of the next pointer event being dispatched. +The **`updateInkTrailStartPoint()`** method of the {{domxref("DelegatedInkTrailPresenter")}} interface indicates which {{domxref("PointerEvent")}} was used as the last rendering point for the current frame, allowing the OS-level compositor to render a delegated ink trail ahead of the next pointer event being dispatched. ## Syntax @@ -39,7 +37,7 @@ requestPresenter(event, style) - : An error is thrown and the operation is aborted if the: - `color` property does not contain a valid CSS color code. - `diameter` property is not a number or less than 1. - - {{domxref("InkPresenter.presentationArea", "presentationArea")}} element is removed from the document before or during rendering. + - {{domxref("DelegatedInkTrailPresenter.presentationArea", "presentationArea")}} element is removed from the document before or during rendering. ## Examples @@ -47,7 +45,7 @@ requestPresenter(event, style) In this example, we draw a trail onto a 2D canvas. Near the start of the code, we call {{domxref("Ink.requestPresenter()")}}, passing it the canvas as the presentation area for it to take care of and storing the promise it returns in the `presenter` variable. -Later on, in the `pointermove` event listener, the new position of the trailhead is drawn onto the canvas each time the event fires. In addition, the {{domxref("InkPresenter")}} object returned when the `presenter` promise fulfills has its `updateInkTrailStartPoint()` method invoked; this is passed: +Later on, in the `pointermove` event listener, the new position of the trailhead is drawn onto the canvas each time the event fires. In addition, the {{domxref("DelegatedInkTrailPresenter")}} object returned when the `presenter` promise fulfills has its `updateInkTrailStartPoint()` method invoked; this is passed: - The last trusted pointer event representing the rendering point for the current frame. - A `style` object containing color and diameter settings. diff --git a/files/en-us/web/api/ink/index.md b/files/en-us/web/api/ink/index.md index 56beb2a76527f16..b5daccf45943c16 100644 --- a/files/en-us/web/api/ink/index.md +++ b/files/en-us/web/api/ink/index.md @@ -9,14 +9,14 @@ browser-compat: api.Ink {{APIRef("Ink API")}}{{SeeCompatTable}} -The **`Ink`** interface of the [Ink API](/en-US/docs/Web/API/Ink_API) provides access to {{domxref("InkPresenter")}} objects for the application to use to render ink strokes. +The **`Ink`** interface of the [Ink API](/en-US/docs/Web/API/Ink_API) provides access to {{domxref("DelegatedInkTrailPresenter")}} objects for the application to use to render ink strokes. {{InheritanceDiagram}} ## Instance methods - {{domxref("Ink.requestPresenter", "requestPresenter()")}} {{Experimental_Inline}} - - : Returns a {{jsxref("Promise")}} that fulfills with an {{domxref("InkPresenter")}} object to handle rendering strokes. + - : Returns a {{jsxref("Promise")}} that fulfills with a {{domxref("DelegatedInkTrailPresenter")}} object to handle rendering strokes. ## Example diff --git a/files/en-us/web/api/ink/requestpresenter/index.md b/files/en-us/web/api/ink/requestpresenter/index.md index b26ec34781f476c..2f094e00e3e4589 100644 --- a/files/en-us/web/api/ink/requestpresenter/index.md +++ b/files/en-us/web/api/ink/requestpresenter/index.md @@ -10,7 +10,7 @@ browser-compat: api.Ink.requestPresenter {{APIRef("Ink API")}}{{SeeCompatTable}} -The **`requestPresenter()`** method of the {{domxref("Ink")}} interface returns a {{jsxref("Promise")}} that fulfills with an {{domxref("InkPresenter")}} object to handle rendering strokes. +The **`requestPresenter()`** method of the {{domxref("Ink")}} interface returns a {{jsxref("Promise")}} that fulfills with a {{domxref("DelegatedInkTrailPresenter")}} object to handle rendering strokes. ## Syntax @@ -21,13 +21,13 @@ requestPresenter(param) ### Parameters - `param` {{optional_inline}} - - : An `InkPresenterParam` object that contains the following property: + - : An object that contains the following property: - `presentationArea` {{optional_inline}} - : An {{domxref("Element")}} inside which rendering of ink strokes is confined (the element's border box, to be precise). If `param` is not included, or `presentationArea` is set to `null`, ink rendering is confined to the containing viewport by default. ### Return value -A {{jsxref("Promise")}} that resolves to an {{domxref("InkPresenter")}} object instance. +A {{jsxref("Promise")}} that resolves to a {{domxref("DelegatedInkTrailPresenter")}} object instance. ### Exceptions diff --git a/files/en-us/web/api/ink_api/index.md b/files/en-us/web/api/ink_api/index.md index bf7fecedd768d23..79b38945a572503 100644 --- a/files/en-us/web/api/ink_api/index.md +++ b/files/en-us/web/api/ink_api/index.md @@ -22,13 +22,13 @@ The Ink API significantly reduces this latency by allowing browsers to bypass th > [!NOTE] > Compositors are part of the rendering machinery that draws the UI to the screen in a browser or operating system. See [Inside look at modern web browser (part 3)](https://developer.chrome.com/blog/inside-browser-part3/) for some interesting insights into how a compositor functions inside a web browser. -The entry point is the {{domxref("Navigator.ink")}} property, which returns an {{domxref("Ink")}} object for the current document. The {{domxref("Ink.requestPresenter","Ink.requestPresenter()")}} method returns a {{jsxref("Promise")}} that fulfills with an {{domxref("InkPresenter")}} object instance. This instructs the OS-level compositor to render ink strokes between pointer event dispatches in the next available frame in each case. +The entry point is the {{domxref("Navigator.ink")}} property, which returns an {{domxref("Ink")}} object for the current document. The {{domxref("Ink.requestPresenter","Ink.requestPresenter()")}} method returns a {{jsxref("Promise")}} that fulfills with a {{domxref("DelegatedInkTrailPresenter")}} object instance. This instructs the OS-level compositor to render ink strokes between pointer event dispatches in the next available frame in each case. ## Interfaces -- {{domxref("Ink")}} - - : Provides access to {{domxref("InkPresenter")}} objects for the application to use to render the strokes. -- {{domxref("InkPresenter")}} +- {{domxref("Ink")}} {{Experimental_Inline}} + - : Provides access to {{domxref("DelegatedInkTrailPresenter")}} objects for the application to use to render the strokes. +- {{domxref("DelegatedInkTrailPresenter")}} {{Experimental_Inline}} - : Instructs the OS-level compositor to render ink strokes between pointer event dispatches. ### Extensions to other interfaces @@ -42,7 +42,7 @@ The entry point is the {{domxref("Navigator.ink")}} property, which returns an { In this example, we draw a trail onto a 2D canvas. Near the start of the code, we call {{domxref("Ink.requestPresenter()")}}, passing it the canvas as the presentation area for it to take care of and storing the promise it returns in the `presenter` variable. -Later on, in the `pointermove` event listener, the new position of the trailhead is drawn onto the canvas each time the event fires. In addition, the {{domxref("InkPresenter")}} object returned when the `presenter` promise fulfills has its {{domxref("InkPresenter.updateInkTrailStartPoint", "updateInkTrailStartPoint()")}} method invoked; this is passed: +Later on, in the `pointermove` event listener, the new position of the trailhead is drawn onto the canvas each time the event fires. In addition, the {{domxref("DelegatedInkTrailPresenter")}} object returned when the `presenter` promise fulfills has its {{domxref("DelegatedInkTrailPresenter.updateInkTrailStartPoint", "updateInkTrailStartPoint()")}} method invoked; this is passed: - The last trusted pointer event representing the rendering point for the current frame. - A `style` object containing color and diameter settings. diff --git a/files/jsondata/GroupData.json b/files/jsondata/GroupData.json index 07135e0cd2a5aeb..cb769586c3aada9 100644 --- a/files/jsondata/GroupData.json +++ b/files/jsondata/GroupData.json @@ -915,7 +915,7 @@ }, "Ink API": { "overview": ["Ink API"], - "interfaces": ["Ink", "InkPresenter"], + "interfaces": ["DelegatedInkTrailPresenter", "Ink"], "methods": [], "properties": ["Navigator.ink"], "events": []