Skip to main content

AwaitProps

Struct AwaitProps 

Source
pub struct AwaitProps<T, Fut, Chil, V>
where T: Send + Sync + Serialize + DeserializeOwned + 'static, Fut: Future<Output = T> + Send + 'static, Chil: FnOnce(&T) -> V + Send + 'static, V: IntoView + 'static,
{ pub future: Fut, pub blocking: bool, pub children: Chil, }
Expand description

Props for the Await component.

Allows you to inline the data loading for an async block or server function directly into your view. This is the equivalent of combining a [create_resource] that only loads once (i.e., with a source signal || ()) with a Suspense with no fallback.

Adding let:{variable name} to the props makes the data available in the children that variable name, when resolved.

async fn fetch_monkeys(monkey: i32) -> i32 {
    // do some expensive work
    3
}

view! {
    <Await
        future=fetch_monkeys(3)
        let:data
    >
        <p>{*data} " little monkeys, jumping on the bed."</p>
    </Await>
}

§Required Props

  • future: [Fut]
    • A Future that will the component will .await before rendering.
  • children: [Chil]
    • A function that takes a reference to the resolved data from the future renders a view.

      §Syntax

      This can be passed in the view children of the <Await/> by using the let: syntax to specify the name for the data variable.

      view! {
          <Await
              future=fetch_monkeys(3)
              let:data
          >
              <p>{*data} " little monkeys, jumping on the bed."</p>
          </Await>
      }

      is the same as

      view! {
         <Await
             future=fetch_monkeys(3)
             children=|data| view! {
               <p>{*data} " little monkeys, jumping on the bed."</p>
             }
         />
      }

§Optional Props

  • blocking: bool
    • If true, the component will create a blocking resource, preventing the HTML stream from returning anything before future has resolved.

Fields§

§future: Fut

A Future that will the component will .await before rendering.

§blocking: bool

If true, the component will create a blocking resource, preventing the HTML stream from returning anything before future has resolved.

§children: Chil

A function that takes a reference to the resolved data from the future renders a view.

§Syntax

This can be passed in the view children of the <Await/> by using the let: syntax to specify the name for the data variable.

view! {
    <Await
        future=fetch_monkeys(3)
        let:data
    >
        <p>{*data} " little monkeys, jumping on the bed."</p>
    </Await>
}

is the same as

view! {
   <Await
       future=fetch_monkeys(3)
       children=|data| view! {
         <p>{*data} " little monkeys, jumping on the bed."</p>
       }
   />
}

Implementations§

Source§

impl<T, Fut, Chil, V> AwaitProps<T, Fut, Chil, V>
where T: Send + Sync + Serialize + DeserializeOwned + 'static, Fut: Future<Output = T> + Send + 'static, Chil: FnOnce(&T) -> V + Send + 'static, V: IntoView + 'static,

Source

pub fn builder() -> AwaitPropsBuilder<T, Fut, Chil, V>

Create a builder for building AwaitProps. On the builder, call .future(...), .blocking(...)(optional), .children(...) to set the values of the fields. Finally, call .build() to create the instance of AwaitProps.

Trait Implementations§

Source§

impl<T, Fut, Chil, V> Props for AwaitProps<T, Fut, Chil, V>
where T: Send + Sync + Serialize + DeserializeOwned + 'static, Fut: Future<Output = T> + Send + 'static, Chil: FnOnce(&T) -> V + Send + 'static, V: IntoView + 'static,

Source§

type Builder = AwaitPropsBuilder<T, Fut, Chil, V>

Source§

fn builder() -> <AwaitProps<T, Fut, Chil, V> as Props>::Builder

Auto Trait Implementations§

§

impl<T, Fut, Chil, V> Freeze for AwaitProps<T, Fut, Chil, V>
where Fut: Freeze, Chil: Freeze,

§

impl<T, Fut, Chil, V> RefUnwindSafe for AwaitProps<T, Fut, Chil, V>
where Fut: RefUnwindSafe, Chil: RefUnwindSafe,

§

impl<T, Fut, Chil, V> Send for AwaitProps<T, Fut, Chil, V>

§

impl<T, Fut, Chil, V> Sync for AwaitProps<T, Fut, Chil, V>
where Fut: Sync, Chil: Sync,

§

impl<T, Fut, Chil, V> Unpin for AwaitProps<T, Fut, Chil, V>
where Fut: Unpin, Chil: Unpin,

§

impl<T, Fut, Chil, V> UnwindSafe for AwaitProps<T, Fut, Chil, V>
where Fut: UnwindSafe, Chil: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<E, T, Request, Encoding> FromReq<Patch<Encoding>, Request, E> for T
where Request: Req<E> + Send + 'static, Encoding: Decodes<T>, E: FromServerFnError,

Source§

async fn from_req(req: Request) -> Result<T, E>

Attempts to deserialize the arguments from a request.
Source§

impl<E, T, Request, Encoding> FromReq<Post<Encoding>, Request, E> for T
where Request: Req<E> + Send + 'static, Encoding: Decodes<T>, E: FromServerFnError,

Source§

async fn from_req(req: Request) -> Result<T, E>

Attempts to deserialize the arguments from a request.
Source§

impl<E, T, Request, Encoding> FromReq<Put<Encoding>, Request, E> for T
where Request: Req<E> + Send + 'static, Encoding: Decodes<T>, E: FromServerFnError,

Source§

async fn from_req(req: Request) -> Result<T, E>

Attempts to deserialize the arguments from a request.
Source§

impl<E, Encoding, Response, T> FromRes<Patch<Encoding>, Response, E> for T
where Response: ClientRes<E> + Send, Encoding: Decodes<T>, E: FromServerFnError,

Source§

async fn from_res(res: Response) -> Result<T, E>

Attempts to deserialize the outputs from a response.
Source§

impl<E, Encoding, Response, T> FromRes<Post<Encoding>, Response, E> for T
where Response: ClientRes<E> + Send, Encoding: Decodes<T>, E: FromServerFnError,

Source§

async fn from_res(res: Response) -> Result<T, E>

Attempts to deserialize the outputs from a response.
Source§

impl<E, Encoding, Response, T> FromRes<Put<Encoding>, Response, E> for T
where Response: ClientRes<E> + Send, Encoding: Decodes<T>, E: FromServerFnError,

Source§

async fn from_res(res: Response) -> Result<T, E>

Attempts to deserialize the outputs from a response.
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<E, T, Encoding, Request> IntoReq<Patch<Encoding>, Request, E> for T
where Request: ClientReq<E>, Encoding: Encodes<T>, E: FromServerFnError,

Source§

fn into_req(self, path: &str, accepts: &str) -> Result<Request, E>

Attempts to serialize the arguments into an HTTP request.
Source§

impl<E, T, Encoding, Request> IntoReq<Post<Encoding>, Request, E> for T
where Request: ClientReq<E>, Encoding: Encodes<T>, E: FromServerFnError,

Source§

fn into_req(self, path: &str, accepts: &str) -> Result<Request, E>

Attempts to serialize the arguments into an HTTP request.
Source§

impl<E, T, Encoding, Request> IntoReq<Put<Encoding>, Request, E> for T
where Request: ClientReq<E>, Encoding: Encodes<T>, E: FromServerFnError,

Source§

fn into_req(self, path: &str, accepts: &str) -> Result<Request, E>

Attempts to serialize the arguments into an HTTP request.
Source§

impl<E, Response, Encoding, T> IntoRes<Patch<Encoding>, Response, E> for T
where Response: TryRes<E>, Encoding: Encodes<T>, E: FromServerFnError + Send, T: Send,

Source§

async fn into_res(self) -> Result<Response, E>

Attempts to serialize the output into an HTTP response.
Source§

impl<E, Response, Encoding, T> IntoRes<Post<Encoding>, Response, E> for T
where Response: TryRes<E>, Encoding: Encodes<T>, E: FromServerFnError + Send, T: Send,

Source§

async fn into_res(self) -> Result<Response, E>

Attempts to serialize the output into an HTTP response.
Source§

impl<E, Response, Encoding, T> IntoRes<Put<Encoding>, Response, E> for T
where Response: TryRes<E>, Encoding: Encodes<T>, E: FromServerFnError + Send, T: Send,

Source§

async fn into_res(self) -> Result<Response, E>

Attempts to serialize the output into an HTTP response.
Source§

impl<T> SerializableKey for T

Source§

fn ser_key(&self) -> String

Serializes the key to a unique string. Read more
Source§

impl<T> StorageAccess<T> for T

Source§

fn as_borrowed(&self) -> &T

Borrows the value.
Source§

fn into_taken(self) -> T

Takes the value.
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.