Struct savory_html::prelude::ElRef

pub struct ElRef<E> {
    pub shared_node_ws: SharedNodeWs,
    // some fields omitted
}

DOM element reference. You want to use it instead of DOM selectors to get raw DOM elements.

Note: Cloning is cheap, it uses only phantom data and Rc under the hood.

Example

#[derive(Default)]
struct Model {
    canvas: ElRef<web_sys::HtmlCanvasElement>,
}

fn view(model: &Model) -> impl IntoNodes<Msg> {
    canvas![
        el_ref(&model.canvas),
        attrs![
            At::Width => px(200),
            At::Height => px(100),
        ],
    ]
}

fn after_mount(_: Url, orders: &mut impl Orders<Msg>) -> AfterMount<Model> {
    orders.after_next_render(|_| Msg::Rendered);
// ...

fn update(msg: Msg, model: &mut Model, orders: &mut impl Orders<Msg>) {
    match msg {
        Msg::Rendered => {
            let canvas = canvas.get().expect("get canvas element");
            // ...
            orders.after_next_render(|_| Msg::Rendered).skip();
        }
// ...

Fields

shared_node_ws: SharedNodeWs

Implementations

impl<E> ElRef<E> where
    E: Clone + JsCast, 

pub fn new() -> ElRef<E>

pub fn get(&self) -> Option<E>

Get referenced DOM element.

It returns Some(element) when:

• An associated DOM element has been already attached during render.
• The DOM element is still a part of the current DOM.
• The DOM element has the same type like ElRef.

pub fn map_type<T>(&self) -> ElRef<T>

Map ElRef type.

• It just changes type saved in the phantom - it's cheap.

• It's useful when you have, for instance, ElRef<HtmlInputElement> and want to focus the referenced input. HtmlInputElement doesn't have method focus, but parent interface HtmlElement has.

Example

let input: ElRef<HtmlInputElement> = model.refs.my_input.clone();
orders.after_next_render(move |_| {
    input
        .map_type::<HtmlElement>()
        .get()
        .expect("get `my_input`")
        .focus()
        .expect("focus 'my_input'");
 });

Trait Implementations

impl<E> Clone for ElRef<E> where
    E: Clone, 

fn clone(&self) -> ElRef<E>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<E> Debug for ElRef<E> where
    E: Debug, 

fn fmt(&self, f: &mut Formatter) -> Result<(), Error>

Formats the value using the given formatter.

impl<E> Default for ElRef<E>

fn default() -> ElRef<E>

Returns the "default value" for a type.

impl<T: Clone + JsCast> ElRefExt<T> for ElRef<T>

fn get_then(&self, conf: impl FnOnce(T)) -> &Self

impl<Ms, E> UpdateEl<Ms> for ElRef<E> where
    E: Clone, 

fn update_el(self, el: &mut El<Ms>)