servo 0.1.0

A component of the servo web-engine.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

/* 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/. */

use std::rc::Rc;

use embedder_traits::user_contents::{UserContentManagerId, UserScript, UserStyleSheet};
use servo_constellation_traits::{EmbedderToConstellationMessage, UserContentManagerAction};

use crate::Servo;

/// The [`UserContentManager`] allows embedders to inject content (scripts, styles) during
/// into the pages loaded within the `WebView`. The same `UserContentManager` can be
/// shared among multiple `WebView`s. Any updates to the `UserContentManager` will
/// take effect only after the page is reloaded.
#[derive(Clone)]
pub struct UserContentManager {
    pub(crate) id: UserContentManagerId,
    pub(crate) servo: Servo,
}

impl UserContentManager {
    pub fn new(servo: &Servo) -> Self {
        Self {
            id: UserContentManagerId::next(),
            servo: servo.clone(),
        }
    }

    pub(crate) fn id(&self) -> UserContentManagerId {
        self.id
    }

    pub fn add_script(&self, user_script: Rc<UserScript>) {
        self.servo.constellation_proxy().send(
            EmbedderToConstellationMessage::UserContentManagerAction(
                self.id,
                UserContentManagerAction::AddUserScript((*user_script).clone()),
            ),
        );
    }

    pub fn remove_script(&self, user_script: Rc<UserScript>) {
        self.servo.constellation_proxy().send(
            EmbedderToConstellationMessage::UserContentManagerAction(
                self.id,
                UserContentManagerAction::RemoveUserScript(user_script.id()),
            ),
        );
    }

    pub fn add_stylesheet(&self, user_stylesheet: Rc<UserStyleSheet>) {
        self.servo.constellation_proxy().send(
            EmbedderToConstellationMessage::UserContentManagerAction(
                self.id,
                UserContentManagerAction::AddUserStyleSheet((*user_stylesheet).clone()),
            ),
        );
    }

    pub fn remove_stylesheet(&self, user_stylesheet: Rc<UserStyleSheet>) {
        self.servo.constellation_proxy().send(
            EmbedderToConstellationMessage::UserContentManagerAction(
                self.id,
                UserContentManagerAction::RemoveUserStyleSheet(user_stylesheet.id()),
            ),
        );
    }
}

impl Drop for UserContentManager {
    fn drop(&mut self) {
        self.servo.constellation_proxy().send(
            EmbedderToConstellationMessage::UserContentManagerAction(
                self.id,
                UserContentManagerAction::DestroyUserContentManager,
            ),
        );
    }
}