Skip to content

Commit 1aaa5e8

Browse files
committed
[css-paint-api] For "long running scripts" optionally produce an invalid image.
Fixes w3c#236.
1 parent 2a8e4f8 commit 1aaa5e8

File tree

1 file changed

+8
-5
lines changed

1 file changed

+8
-5
lines changed

css-paint-api/Overview.bs

+8-5
Original file line numberDiff line numberDiff line change
@@ -619,15 +619,18 @@ When the user agent wants to <dfn>invoke a paint callback</dfn> given |name|, |i
619619
11. <a>Invoke</a> |paintFunctionCallback| with arguments «|renderingContext|, |paintSize|,
620620
|styleMap|, |inputArguments|», and with |paintInstance| as the <a>callback this value</a>.
621621

622+
If |paintFunctionCallback| does not complete within an acceptable time (as determined by the
623+
user agent, i.e. it is a "long running script") the user agent <em>may</em> terminate the
624+
script, let the image output be an <a>invalid image</a>, and abort all these steps.
625+
626+
Note: User agents could provide tooling within their debugging tools to show authors how
627+
expensive their paint classes are. User agents could also how an "unresponsive script"
628+
dialog in this case if appropriate.
629+
622630
12. The image output is to be produced from the |renderingContext| given to the method.
623631

624632
If an exception is <a>thrown</a> the let the image output be an <a>invalid image</a>.
625633

626-
Note: The user agent can consider long running paint functions similar to long running script in the
627-
main execution context. For example, they could show a "unresponsive script" dialog or similar.
628-
In addition user agents could provide tooling within their debugging tools to show authors how
629-
expensive their paint classes are.
630-
631634
Note: The contents of the resulting image are not designed to be accessible. Authors can communicate
632635
any useful information through the standard accessibility APIs.
633636
</div>

0 commit comments

Comments
 (0)