Struct yew::html::Scope

pub struct Scope<COMP: Component> { /* fields omitted */ }

A context which allows sending messages to a component.

Implementations

impl<COMP: Component> Scope<COMP>

pub fn get_parent(&self) -> Option<&AnyScope>

Returns the parent scope

pub fn get_component(&self) -> Option<impl Deref<Target = COMP> + '_>

Returns the linked component if available

pub fn send_message<T>(&self, msg: T) where
    T: Into<COMP::Message>, 

Send a message to the component.

Please be aware that currently this method synchronously schedules a call to the Component interface.

pub fn send_message_batch(&self, messages: Vec<COMP::Message>)

Send a batch of messages to the component.

This is useful for reducing re-renders of the components because the messages are handled together and the view function is called only once if needed.

Please be aware that currently this method synchronously schedules calls to the Component interface.

pub fn callback<F, IN, M>(&self, function: F) -> Callback<IN> where
    M: Into<COMP::Message>,
    F: Fn(IN) -> M + 'static, 

Creates a Callback which will send a message to the linked component’s update method when invoked.

Please be aware that currently the result of this callback synchronously schedules a call to the Component interface.

pub fn callback_with_passive<F, IN, M>(
    &self,
    passive: impl Into<Option<bool>>,
    function: F
) -> Callback<IN> where
    M: Into<COMP::Message>,
    F: Fn(IN) -> M + 'static, 

Creates a Callback which will send a message to the linked component’s update method when invoked.

Setting passive to Some explicitly makes the event listener passive or not. Yew sets sane defaults depending on the type of the listener. See addEventListener.

Please be aware that currently the result of this callback synchronously schedules a call to the Component interface.

pub fn callback_once<F, IN, M>(&self, function: F) -> Callback<IN> where
    M: Into<COMP::Message>,
    F: FnOnce(IN) -> M + 'static, 

Creates a Callback from an FnOnce which will send a message to the linked component’s update method when invoked.

Please be aware that currently the result of this callback will synchronously schedule calls to the Component interface.

pub fn batch_callback<F, IN, OUT>(&self, function: F) -> Callback<IN> where
    F: Fn(IN) -> OUT + 'static,
    OUT: SendAsMessage<COMP>, 

Creates a Callback which will send a batch of messages back to the linked component’s update method when invoked.

The callback function’s return type is generic to allow for dealing with both Option and Vec nicely. Option can be used when dealing with a callback that might not need to send an update.

link.batch_callback(|_| vec![Msg::A, Msg::B]);
link.batch_callback(|_| Some(Msg::A));

Please be aware that currently the results of these callbacks will synchronously schedule calls to the Component interface.

pub fn batch_callback_once<F, IN, OUT>(&self, function: F) -> Callback<IN> where
    F: FnOnce(IN) -> OUT + 'static,
    OUT: SendAsMessage<COMP>, 

Creates a Callback from an FnOnce which will send a batch of messages back to the linked component’s update method when invoked.

The callback function’s return type is generic to allow for dealing with both Option and Vec nicely. Option can be used when dealing with a callback that might not need to send an update.

link.batch_callback_once(|_| vec![Msg::A, Msg::B]);
link.batch_callback_once(|_| Some(Msg::A));

Please be aware that currently the results of these callbacks will synchronously schedule calls to the Component interface.

pub fn callback_future<FN, FU, IN, M>(&self, function: FN) -> Callback<IN> where
    M: Into<COMP::Message>,
    FU: Future<Output = M> + 'static,
    FN: Fn(IN) -> FU + 'static, 

This method creates a Callback which returns a Future which returns a message to be sent back to the component’s event loop.

Panics

If the future panics, then the promise will not resolve, and will leak.

pub fn callback_future_once<FN, FU, IN, M>(&self, function: FN) -> Callback<IN> where
    M: Into<COMP::Message>,
    FU: Future<Output = M> + 'static,
    FN: FnOnce(IN) -> FU + 'static, 

This method creates a Callback from FnOnce which returns a Future which returns a message to be sent back to the component’s event loop.

Panics

If the future panics, then the promise will not resolve, and will leak.

pub fn send_future<F, M>(&self, future: F) where
    M: Into<COMP::Message>,
    F: Future<Output = M> + 'static, 

This method processes a Future that returns a message and sends it back to the component’s loop.

Panics

If the future panics, then the promise will not resolve, and will leak.

pub fn send_future_batch<F>(&self, future: F) where
    F: Future<Output = Vec<COMP::Message>> + 'static, 

Registers a Future that resolves to multiple messages.

Panics

If the future panics, then the promise will not resolve, and will leak.

pub fn context<T: Clone + PartialEq + 'static>(
    &self,
    callback: Callback<T>
) -> Option<(T, ContextHandle<T>)>

Accesses a value provided by a parent ContextProvider component of the same type.

Trait Implementations

impl<COMP: Component> Clone for Scope<COMP>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<COMP: Component> Debug for Scope<COMP>

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

Formats the value using the given formatter.

impl<COMP: Component> From<Scope<COMP>> for AnyScope

fn from(scope: Scope<COMP>) -> Self

Performs the conversion.

impl<Comp: Component> ImplicitClone for Scope<Comp>