Write about embedding API

Author: delan

_posts/2025-12-12-november-in-servo.md

@@ -7,7 +7,7 @@ summary:    ao!! wrrrrao!!
 categories:
 ---
 
-Landing in [**Servo 0.0.3**](https://github.com/servo/servo/releases/tag/v0.0.3) and our November nightly builds:
+Landing in [**Servo 0.0.3**](https://github.com/servo/servo/releases/tag/v0.0.3) and our November nightly builds, we now have **context menus** for links, images, and other web content (@mrobinson, @atbrakhi, #40402, #40501, #40607), plus several web platform features:
 
 - **<video controls>** (@rayguo17, #40578)
 - **<use>** in SVG (@WaterWhisperer, #40684)
@@ -37,6 +37,22 @@ We now have full support for **SHA3-256**, **SHA3-384**, **SHA3-512** (@kkoyung,
 **<details>** now fires **‘toggle’** events (@lukewarlow, #40271), and **<details name>** is now exclusive, like radio buttons (@simonwuelker, #40314).
 **InputEvent**, which represents **‘input’** and **‘beforeinput’** events, now has **composed**, **data**, **isComposing**, and **inputType** properties (@excitablesnowball, #39989).
 
+## Embedding API
+
+**Each webview** can now now have its **own rendering context** (@mrobinson, @mukilan, #40794, #40738, #40721, #40594, #40923).
+This effectively enables full support for **multiple windows**, and you’ll see servoshell make use of that this month.
+
+[**WebView**](https://doc.servo.org/servo/struct.WebView.html) now has [**can_go_back()**](https://doc.servo.org/servo/struct.WebView.html#method.can_go_back) and [**can_go_forward()**](https://doc.servo.org/servo/struct.WebView.html#method.can_go_forward) methods, and servoshell now uses those to disable the back and forward buttons (@mrobinson, #40598).
+
+Having introduced our new [**RefreshDriver**](https://doc.servo.org/servo/trait.RefreshDriver.html) API in October, we’ve now **removed [Servo](https://doc.servo.org/servo/struct.Servo.html)::<wbr>animating()** (@mrobinson, #40799) and **[ServoDelegate](https://doc.servo.org/servo/trait.ServoDelegate.html)::<wbr>notify_<wbr>animating_<wbr>changed()** (@mrobinson, #40886), and similarly cleaned up the obsolete and inefficient “animating” state in servoshell (@mrobinson, #40715).
+
+We’ve moved virtually all of the useful items in the Servo API to the root of the `servo` library crate (@mrobinson, #40951).
+This is a **breaking change**, but we expect that it will greatly simplify embedding Servo, and it means you can even write `use servo::*;` in a pinch.
+
+When running Servo without a custom [**ClipboardDelegate**](https://doc.servo.org/servo/clipboard_delegate/trait.ClipboardDelegate.html), we normally use the system clipboard by default.
+But if there’s no system clipboard, we now have a built-in **fallback clipboard** (@mrobinson, #40408), rather than having no clipboard at all.
+Note that the fallback clipboard is very limited, as it can only store text and does not work across processes.
+
 <style>
     ._correction {
         max-width: 33em;

commits.txt

@@ -762,7 +762,7 @@ https://github.com/servo/servo/pull/40316	(@tharkum, #40316)	html: Support relea
     # [//]: # (dependabot-automerge-start)
     # [//]: # (dependabot-automerge-end)
 +https://github.com/servo/servo/pull/40408	(@mrobinson, #40408)	libservo: Add a fallback clipboard (#40408)
-    api
+    ;api
     # Add a fallback implementation of the default clipboard delegate that
     # works within a single Servo process. This introduces one failure, which
     # was hidden before.
@@ -839,7 +839,7 @@ https://github.com/servo/servo/pull/40411	(@simonwuelker, #40411)	xpath: Handle
     # cause unnecessary merge conflicts.
     # Testing: New web platform tests start to pass
 +https://github.com/servo/servo/pull/40402	(@mrobinson, @atbrakhi, #40402)	libservo: Integrate context menu into the show_embedder_control API (#40402)
-    api servoshell; rework context menu api, embedders can now know the position and know what each item does (`show_context_menu(webview, result_sender, title, items)` → `ContextMenu.{id,position,items,select,dismiss}()`)
+    ;api servoshell; rework context menu api, embedders can now know the position and know what each item does (`show_context_menu(webview, result_sender, title, items)` → `ContextMenu.{id,position,items,select,dismiss}()`)
     # This PR integrates showing context menus into the
     # `WebViewDelegate::show_embedder_control` API. In addition,
     # `ContextMenuItem` and `ContextMenuAction` data types are exposed which
@@ -1790,7 +1790,7 @@ https://github.com/servo/servo/pull/40542	(@simonwuelker, #40542)	xpath: Don't e
     # roughly 600 lines. There was also a blocking section which was split out.
     # Testing: Should not change functionality and tests still work.
 +https://github.com/servo/servo/pull/40501	(@mrobinson, @atbrakhi, #40501)	script: Add context-based context menu options (#40501)
-    api servoshell; copy link, open link in new, copy image link, open image in new, cut, copy, paste, select all
+    ;api servoshell; copy link, open link in new, copy image link, open image in new, cut, copy, paste, select all
     # Add context menu options for images, links, and editable text areas. In
     # addition add the ability to show menu options that are disabled. This
     # also improves the visual style of the context menu in egui as part of
@@ -1844,7 +1844,7 @@ https://github.com/servo/servo/pull/40541	(@simonwuelker, #40541)	tests: Import
     # `played`. See https://html.spec.whatwg.org/multipage/#earliest-possible-position
     # Testing: No expected changes in tests
 +https://github.com/servo/servo/pull/40598	(@mrobinson, #40598)	libservo: Add `WebView::can_go_forward` and `WebView::can_go_back` (#40598)
-    api servoshell
+    ;api servoshell
     # These two new API method make it easier to enable and disable the back
     # and forward buttons in the browser UI. In addition, they are used to
     # enable and disable the context menu items for "Back" and "Forward". This
@@ -3027,7 +3027,7 @@ https://github.com/servo/servo/pull/40737	(@mrobinson, @mukilan, #40737)	composi
     # for a single `Constellation`.
     # Testing: This should not change behavior so is covered by existing tests.
 +https://github.com/servo/servo/pull/40738	(@mrobinson, @mukilan, #40738)	compositing: Make `RefreshDriver` per-`RenderingContext` (#40738)
-    api; part of per-webview RenderingContext
+    ;api; part of per-webview RenderingContext
     # Instead of having a global `RefreshDriver` for all of Servo, let each
     # `RenderingContext` have its own `RefreshDriver`. This allows for things
     # like per-monitor `RefreshDriver`s and helps to ensure that multiple
@@ -3148,7 +3148,7 @@ https://github.com/servo/servo/pull/40690	(@mrobinson, @mukilan, #40690)	composi
     # thread.
     # Testing: This doesn't really change behavior yet, so is covered by existing tests.
 +https://github.com/servo/servo/pull/40721	(@mrobinson, @mukilan, #40721)	compositing: Allow WebGL contexts to have different Surfman devices (#40721)
-    api; part of per-webview RenderingContext
+    ;api; part of per-webview RenderingContext
     # Currently, a single `surfman::Device` is used for all WebGL contexts.
     # This cannot work when we have multiple rendering contexts. So, extract
     # the surfman `Connection` and `Adapter` into a per-painter data structure
@@ -3172,7 +3172,7 @@ https://github.com/servo/servo/pull/40690	(@mrobinson, @mukilan, #40690)	composi
     # dependency in `requirements.txt` was not removed. This PR fixest that.
     # Testing: This change just removes an unsued build dependency, so no testing is necessary.
 +https://github.com/servo/servo/pull/40715	(@mrobinson, #40715)	servoshell: Always use `ControlFlow::Wait` on winit (#40715)
-    api; removed in favour of RefreshDriver
+    ;api; removed in favour of RefreshDriver
     # Nowadays the renderer will always wake up the event loop when it needs to paint
     # a new frame, so we can always use `ControlFlow::Wait`. This should be a
     # more efficient way to run animations.
@@ -3398,7 +3398,7 @@ https://github.com/servo/servo/pull/40637	(@kongbai1996, #40637)	Compositor: Add
     # into account what attributes changed, but at least it works.
     # Testing: This doesn't have any test changes, but should fix the test situation described in #40419.
 +https://github.com/servo/servo/pull/40607	(@mrobinson, #40607)	libservo: Add `ContextMenuElementInformation` to for the context menu API (#40607)
-    api; element_info() on ContextMenu
+    ;api; element_info() on ContextMenu
     # This new data structure allows passing more information when popping up
     # context menus. It's possible in the future that it will be adapted into
     # a more generic "hit test result" type API ala WebKit, but for now, this is probably
@@ -3454,7 +3454,7 @@ https://github.com/servo/servo/pull/40685	(@tharkum, #40685)	html: Fire the <med
     # correct enum variants.
     # Testing: Pass some WPT tests that were expected to fail.
 +https://github.com/servo/servo/pull/40594	(@mukilan, @mrobinson, #40594)	compositing: Allow WebGL contexts to have different Surfman devices (#40594)
-    api; part of per-webview RenderingContext
+    ;api; part of per-webview RenderingContext
     # Currently, a single `surfman::Device` is used for all WebGL contexts. This cannot work when we have multiple
     # rendering contexts. So, extract the surfman `Connection` and `Adapter` into a per-painter data structure
     # (`PainterSurfmanDetailsMap`) and store the `Device` directly in the WebGL context.
@@ -3533,7 +3533,7 @@ https://github.com/servo/servo/pull/40666	(@arihant2math, @yezhizhen, #40666)	in
     # if the relayout damage is in the element or a descendant.
     # Testing: Not needed, no change in behavior
 +https://github.com/servo/servo/pull/40794	(@mrobinson, #40794)	libservo: Have `WebView` take a `RenderingContext` rather than `Servo` (#40794)
-    api; per-webview rendering contexts (big part of support for multiple windows)
+    ;api; per-webview rendering contexts (big part of support for multiple windows)
     # This is the last major change before we can try to implement support for
     # multiple windows in Servo. This change makes it so that each `WebView`
     # (via `WebViewBuilder`) takes the `RenderingContext` as an argument,
@@ -3561,7 +3561,7 @@ https://github.com/servo/servo/pull/40653	(@TimvdLippe, #40653)	libservo: Notify
     # ```
     # Part of #40615
 +https://github.com/servo/servo/pull/40799	(@mrobinson, #40799)	libservo: Remove `Servo::animating()` (#40799)
-    api; removed in favour of RefreshDriver
+    ;api; removed in favour of RefreshDriver
     # Instead of relying on `Sevo::animating()` in servoshell to drive the
     # event loop, it is sufficient to just let the `RefreshDriver` wake it up
     # when it is time to re-render.
@@ -4227,7 +4227,7 @@ https://github.com/servo/servo/pull/40843	(@dyegoaurelio, #40843)	script: Move C
     # try](https://github.com/servo/servo/actions/runs/19614805970/job/56165963814)
 >>> 2025-11-26T06:18:52Z
 +https://github.com/servo/servo/pull/40886	(@mrobinson, #40886)	libservo: Remove `ServoDelegate::notify_animating_changed` (#40886)
-    api; removed in favour of RefreshDriver
+    ;api; removed in favour of RefreshDriver
     # This is dead code #40799, as it is never called. Remove the delegate
     # call and the entire `ServoShellServoDelegate` as the only thing that it
     # was doing was printing top-level errors which only happen when something
@@ -4708,7 +4708,7 @@ https://github.com/servo/servo/pull/40661	(@janvarga, #40661)	storage: Introduce
     # next-generation IndexedDB implementation under the indexeddb_next feature flag living on a separate branch.
     # Testing: Unit and WPT tests continue to pass
 +https://github.com/servo/servo/pull/40923	(@mrobinson, #40923)	libservo: Starting removing the multi-document interface API (#40923)
-    api; remove old multiple webview features in favour of per-webview RenderingContext
+    ;api; remove old multiple webview features in favour of per-webview RenderingContext
     # For a while Servo has while had a somewhat unfinished multi-document
     # interface API that was meant to implement a kind of window manager
     # inside a single `RenderingContext`. This came with some focus handling
@@ -4796,7 +4796,7 @@ https://github.com/servo/servo/pull/40944	(@mrobinson, #40944)	constellation: Br
     # Testing: This should not change behavior in a way that is observable, so should
     # be covered by existing tests.
 +https://github.com/servo/servo/pull/40951	(@mrobinson, #40951)	libservo: Clean up Servo exports and export more at the root (#40951)
-    api; `use servo::*`
+    ;api; `use servo::*`
     # This change makes it easier for embedders to embed the types that they
     # need by exporting almost everything necessary to use Servo at the root
     # of libservo, apart from a few exceptions. In addition, the `Servo` is moved