Skip to main content
Version: 0.18.0

#[function_component]

The #[function_component(_)] turns a normal Rust function into a function component. Functions with the attribute have to return Html and may take a single parameter for the type of props the component should accept. The parameter type needs to be a reference to a type which implements Properties and PartialEq (ex. props: &MyProps). If the function doesn't have any parameters the resulting component doesn't accept any props.

The attribute doesn't replace your original function with a component. You need to provide a name as an input to the attribute which will be the identifier of the component. Assuming you have a function called chat_container and you add the attribute #[function_component(ChatContainer)] you can use the component like this:

html! { <ChatContainer /> }

Example#

#[derive(Properties, Clone, PartialEq)]pub struct RenderedAtProps {    pub time: String,}
#[function_component(RenderedAt)]pub fn rendered_at(props: &RenderedAtProps) -> Html {    html! {        <p>            <b>{ "Rendered at: " }</b>            { props.time.clone() }        </p>    }}
#[function_component(App)]fn app() -> Html {    let (counter, set_counter) = use_state(|| 0);
    let onclick = {        let counter = Rc::clone(&counter);        Callback::from(move |_| set_counter(*counter + 1))    };
    html! {        <div>            <button onclick=onclick>{ "Increment value" }</button>            <p>                <b>{ "Current value: " }</b>                { counter }            </p>        </div>    }}