Function leptos::Suspense

source ·
pub fn Suspense<F, E>(cx: Scope, props: SuspenseProps<F, E>) -> impl IntoViewwhere
    F: Fn() -> E + 'static,
    E: IntoView,
Expand description

If any Resources are read in the children of this component, it will show the fallback while they are loading. Once all are resolved, it will render the children.

Note that the children will be rendered initially (in order to capture the fact that those resources are read under the suspense), so you cannot assume that resources have Some value in children.

async fn fetch_cats(how_many: u32) -> Option<Vec<String>> { Some(vec![]) }

let (cat_count, set_cat_count) = create_signal::<u32>(cx, 1);

let cats = create_resource(cx, cat_count, |count| fetch_cats(count));

view! { cx,
  <div>
    <Suspense fallback=move || view! { cx, <p>"Loading (Suspense Fallback)..."</p> }>
      {move || {
          cats.read(cx).map(|data| match data {
            None => view! { cx,  <pre>"Error"</pre> }.into_any(),
            Some(cats) => view! { cx,
              <div>{
                cats.iter()
                  .map(|src| {
                    view! { cx,
                      <img src={src}/>
                    }
                  })
                  .collect::<Vec<_>>()
              }</div>
            }.into_any(),
          })
        }
      }
    </Suspense>
  </div>
};

Required Props

  • cx: Scope
  • fallback: [F]
    • Returns a fallback UI that will be shown while async Resources are still loading.
  • children: [Box<dyn Fn(Scope) -> Fragment>]
    • Children will be displayed once all async Resources have resolved.