DevTools: Show HTML tree (#32655)

* feat: watch root node Signed-off-by: eri <eri@inventati.org> * reafactor: divide inspector in components Signed-off-by: eri <eri@inventati.org> * feat: add css properties actor Signed-off-by: eri <eri@inventati.org> * feat: accesibility actor Signed-off-by: eri <eri@inventati.org> * feat: layout actor Signed-off-by: eri <eri@inventati.org> * feat: network parent and refactor Signed-off-by: eri <eri@inventati.org> * feat: progress on the inspector messages Signed-off-by: eri <eri@inventati.org> * feat: more progress on inspector Signed-off-by: eri <eri@inventati.org> * feat: try to fix nodes showing Signed-off-by: eri <eri@inventati.org> * feat: initial dom tree Signed-off-by: eri <eri@inventati.org> * feat: some more messages Signed-off-by: eri <eri@inventati.org> * feat: clean and add documentation Signed-off-by: eri <eri@inventati.org> * refactor: add more docs and clean Signed-off-by: eri <eri@inventati.org> * fix: restore deleted node attributes field Signed-off-by: eri <eri@inventati.org> * Apply suggestions from code review Fix a few nits in comments Signed-off-by: Martin Robinson <mrobinson@igalia.com> --------- Signed-off-by: eri <eri@inventati.org> Signed-off-by: Martin Robinson <mrobinson@igalia.com> Co-authored-by: Martin Robinson <mrobinson@igalia.com>
2025-06-06 16:45:39 +00:00 · 2024-07-26 17:17:54 +02:00 · 2024-07-26 17:17:54 +02:00 · 902bf57331
commit 902bf57331
parent f7448b5d61
23 changed files with 1487 additions and 833 deletions
--- a/components/devtools/actors/inspector/accessibility.rs
+++ b/components/devtools/actors/inspector/accessibility.rs
@ -0,0 +1,132 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+
+//! The Accessibility actor is responsible for the Accessibility tab in the DevTools page. Right
+//! now it is a placeholder for future functionality.
+
+use std::net::TcpStream;
+
+use serde::Serialize;
+use serde_json::{Map, Value};
+
+use crate::actor::{Actor, ActorMessageStatus, ActorRegistry};
+use crate::protocol::JsonPacketStream;
+use crate::StreamId;
+
+#[derive(Serialize)]
+struct BootstrapState {
+    enabled: bool,
+}
+
+#[derive(Serialize)]
+struct BootstrapReply {
+    from: String,
+    state: BootstrapState,
+}
+
+#[derive(Serialize)]
+struct GetSimulatorReply {
+    from: String,
+    simulator: ActorMsg,
+}
+
+#[derive(Serialize)]
+#[serde(rename_all = "camelCase")]
+struct AccessibilityTraits {
+    tabbing_order: bool,
+}
+
+#[derive(Serialize)]
+struct GetTraitsReply {
+    from: String,
+    traits: AccessibilityTraits,
+}
+
+#[derive(Serialize)]
+struct ActorMsg {
+    actor: String,
+}
+
+#[derive(Serialize)]
+struct GetWalkerReply {
+    from: String,
+    walker: ActorMsg,
+}
+
+pub struct AccessibilityActor {
+    name: String,
+}
+
+impl Actor for AccessibilityActor {
+    fn name(&self) -> String {
+        self.name.clone()
+    }
+
+    /// The accesibility actor can handle the following messages:
+    ///
+    /// - `bootstrap`: It is required but it doesn't do anything yet
+    ///
+    /// - `getSimulator`: Returns a new Simulator actor
+    ///
+    /// - `getTraits`: Informs the DevTools client about the configuration of the accessibility actor
+    ///
+    /// - `getWalker`: Returns a new AccessibleWalker actor (not to be confused with the general
+    /// inspector Walker actor)
+    fn handle_message(
+        &self,
+        registry: &ActorRegistry,
+        msg_type: &str,
+        _msg: &Map<String, Value>,
+        stream: &mut TcpStream,
+        _id: StreamId,
+    ) -> Result<ActorMessageStatus, ()> {
+        Ok(match msg_type {
+            "bootstrap" => {
+                let msg = BootstrapReply {
+                    from: self.name(),
+                    state: BootstrapState { enabled: false },
+                };
+                let _ = stream.write_json_packet(&msg);
+                ActorMessageStatus::Processed
+            },
+            "getSimulator" => {
+                // TODO: Create actual simulator
+                let simulator = registry.new_name("simulator");
+                let msg = GetSimulatorReply {
+                    from: self.name(),
+                    simulator: ActorMsg { actor: simulator },
+                };
+                let _ = stream.write_json_packet(&msg);
+                ActorMessageStatus::Processed
+            },
+            "getTraits" => {
+                let msg = GetTraitsReply {
+                    from: self.name(),
+                    traits: AccessibilityTraits {
+                        tabbing_order: true,
+                    },
+                };
+                let _ = stream.write_json_packet(&msg);
+                ActorMessageStatus::Processed
+            },
+            "getWalker" => {
+                // TODO: Create actual accessible walker
+                let walker = registry.new_name("accesiblewalker");
+                let msg = GetWalkerReply {
+                    from: self.name(),
+                    walker: ActorMsg { actor: walker },
+                };
+                let _ = stream.write_json_packet(&msg);
+                ActorMessageStatus::Processed
+            },
+            _ => ActorMessageStatus::Ignored,
+        })
+    }
+}
+
+impl AccessibilityActor {
+    pub fn new(name: String) -> Self {
+        Self { name }
+    }
+}