[−][src]Struct cursive_async_view::AsyncView
An AsyncView
is a wrapper view that displays a loading screen, until the
child view is ready to be created. The view can be used in two different
ways.
Poll-based AsyncView
The poll-based AsyncView
is constructed via the AsyncView::new
function
and regularly calls the provided poll_ready
function. It indicates
whether the child view is available or not by returning an AsyncState
enum. The poll_ready
callback should only check for data to be
available and create the child view when the data got available. It must
never block until the data is available or do heavy calculations!
Use a different thread for long taking calculations. Check the bg_task
example for an example on how to use a dedicated calculation thread with
the AsyncView
.
Example usage of the poll-based variant
use std::time::{Instant, Duration}; use cursive::{views::TextView, Cursive}; use cursive_async_view::{AsyncView, AsyncState}; let mut siv = Cursive::default(); let instant = Instant::now(); let async_view = AsyncView::new(&mut siv, move || { // check if the view can be created if instant.elapsed() > Duration::from_secs(10) { AsyncState::Available( TextView::new("Yay!\n\nThe content has loaded!") ) } else { AsyncState::Pending } }); siv.add_layer(async_view); // siv.run();
The content will be displayed after 10 seconds.
Producing view data in a background thread
The second variant produces custom data in a background thread via the
provided bg_task
function. The produced data is then sent to the cursive
thread and given to the provided view_creator
function. This function
should construct the child view and return it to the async view.
All heavy work must be done in the bg_task
function. Otherwise,
the cursive event loop will be blocked, preventing any rendering or event
handling taking place.
Example usage for the background thread variant
use std::thread; use std::time::Duration; use cursive::views::TextView; use cursive::Cursive; use cursive_async_view::AsyncView; let mut siv = Cursive::default(); let async_view = AsyncView::new_with_bg_creator(&mut siv, move || { // this function is executed in a background thread, so we can block // here as long as we like thread::sleep(Duration::from_secs(10)); // enough blocking, let's show the content Ok("Yeet! It worked 🖖") }, TextView::new); // create a text view from the string siv.add_layer(async_view); // siv.run();
The content will be displayed after 10 seconds.
Methods
impl<T: View> AsyncView<T>
[src]
pub fn new<F>(siv: &mut Cursive, ready_poll: F) -> Self where
F: FnMut() -> AsyncState<T> + 'static,
[src]
F: FnMut() -> AsyncState<T> + 'static,
Create a new AsyncView
instance. The cursive reference is used
to control the refresh rate of the terminal when the loading animation
is running. In order to show the view, it has to be directly or indirectly
added to a cursive layer like any other view.
The ready_poll
function will be called regularly until the view has
either been loaded or errored. Use this function only to check whether
your data is available. Do not run heavy calculations in this function.
Instead use a dedicated thread for it as shown in the bg_task
example.
pub fn new_with_bg_creator<F, C, D>(
siv: &mut Cursive,
bg_task: F,
view_creator: C
) -> Self where
D: Send + 'static,
F: FnOnce() -> Result<D, String> + Send + 'static,
C: FnMut(D) -> T + 'static,
[src]
siv: &mut Cursive,
bg_task: F,
view_creator: C
) -> Self where
D: Send + 'static,
F: FnOnce() -> Result<D, String> + Send + 'static,
C: FnMut(D) -> T + 'static,
Create a new AsyncView
instance. The cursive reference is used
to control the refresh rate of the terminal when the loading animation
is running. In order to show the view, it has to be directly or indirectly
added to a cursive layer like any other view.
The bg_task
function is executed on a background thread called
cursive-async-view::bg_task
. It should be used to produce data of
type D
which is converted to a view by the view_creator
function.
pub fn with_width(self, width: usize) -> Self
[src]
Mark the maximum allowed width in characters, the loading animation may consume. By default, the width will be inherited by the parent view.
pub fn with_height(self, height: usize) -> Self
[src]
Mark the maximum allowed height in characters, the loading animation may consume. By default, the height will be inherited by the parent view.
pub fn with_animation_fn<F>(self, animation_fn: F) -> Self where
F: Fn(usize, usize, usize) -> AnimationFrame + 'static,
[src]
F: Fn(usize, usize, usize) -> AnimationFrame + 'static,
Set a custom animation function for this view, indicating that the wrapped view is
not available yet. See the default_animation
function reference for an example on
how to create a custom animation function.
pub fn with_error_fn<F>(self, error_fn: F) -> Self where
F: Fn(&str, usize, usize, usize, usize) -> AnimationFrame + 'static,
[src]
F: Fn(&str, usize, usize, usize, usize) -> AnimationFrame + 'static,
Set a custom error animation function for this view, indicating that the
wrapped view has failed to load. See the default_error
function
reference for an example on how to create a custom error animation
function.
pub fn set_width(&mut self, width: usize)
[src]
Set the maximum allowed width in characters, the loading animation may consume.
pub fn set_height(&mut self, height: usize)
[src]
Set the maximum allowed height in characters, the loading animation may consume.
pub fn set_animation_fn<F>(&mut self, animation_fn: F) where
F: Fn(usize, usize, usize) -> AnimationFrame + 'static,
[src]
F: Fn(usize, usize, usize) -> AnimationFrame + 'static,
Set a custom animation function for this view, indicating that the wrapped view is
not available yet. See the default_animation
function reference for an example on
how to create a custom animation function.
This function may be set at any time. The loading animation can be changed even if the previous loading animation has already started.
pub fn set_error_fn<F>(&mut self, error_fn: F) where
F: Fn(&str, usize, usize, usize, usize) -> AnimationFrame + 'static,
[src]
F: Fn(&str, usize, usize, usize, usize) -> AnimationFrame + 'static,
Set a custom error animation function for this view, indicating that the wrapped view
has failed to load. See the default_error
function reference for an example on
how to create a custom error animation function.
This function may be set at any time. The error animation can be changed even if the previous error animation has already started.
pub fn inherit_width(&mut self)
[src]
Make the loading animation inherit its width from the parent view. This is the default.
pub fn inherit_height(&mut self)
[src]
Make the loading animation inherit its height from the parent view. This is the default.
Trait Implementations
impl<T: View + Sized> View for AsyncView<T>
[src]
fn draw(&self, printer: &Printer)
[src]
fn layout(&mut self, vec: Vec2)
[src]
fn needs_relayout(&self) -> bool
[src]
fn required_size(&mut self, constraint: Vec2) -> Vec2
[src]
fn on_event(&mut self, ev: Event) -> EventResult
[src]
fn call_on_any<'a>(&mut self, sel: &Selector, cb: AnyCb<'a>)
[src]
fn focus_view(&mut self, sel: &Selector) -> Result<(), ()>
[src]
fn take_focus(&mut self, source: Direction) -> bool
[src]
fn important_area(&self, view_size: Vec2) -> Rect
[src]
Auto Trait Implementations
impl<T> !Sync for AsyncView<T>
impl<T> !Send for AsyncView<T>
impl<T> Unpin for AsyncView<T> where
T: Unpin,
T: Unpin,
impl<T> !UnwindSafe for AsyncView<T>
impl<T> !RefUnwindSafe for AsyncView<T>
Blanket Implementations
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> From<T> for T
[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Finder for T where
T: View,
[src]
T: View,
fn call_on<V, F, R>(&mut self, sel: &Selector, callback: F) -> Option<R> where
F: FnOnce(&mut V) -> R,
V: View + Any,
[src]
F: FnOnce(&mut V) -> R,
V: View + Any,
fn call_on_id<V, F, R>(&mut self, id: &str, callback: F) -> Option<R> where
F: FnOnce(&mut V) -> R,
V: View + Any,
[src]
F: FnOnce(&mut V) -> R,
V: View + Any,
fn find_id<V>(
&mut self,
id: &str
) -> Option<OwningHandle<OwningRef<Rc<RefCell<V>>, RefCell<V>>, RefMut<'static, V>>> where
V: View + Any,
[src]
&mut self,
id: &str
) -> Option<OwningHandle<OwningRef<Rc<RefCell<V>>, RefCell<V>>, RefMut<'static, V>>> where
V: View + Any,
impl<T> Scrollable for T where
T: View,
[src]
T: View,
fn scrollable(self) -> ScrollView<Self>
[src]
impl<T> View for T where
T: ViewWrapper,
[src]
T: ViewWrapper,
fn draw(&self, printer: &Printer)
[src]
fn required_size(&mut self, req: XY<usize>) -> XY<usize>
[src]
fn on_event(&mut self, ch: Event) -> EventResult
[src]
fn layout(&mut self, size: XY<usize>)
[src]
fn take_focus(&mut self, source: Direction) -> bool
[src]
fn call_on_any(
&mut self,
selector: &Selector,
callback: Box<dyn FnMut(&mut (dyn Any + 'static)) + 'a>
)
[src]
&mut self,
selector: &Selector,
callback: Box<dyn FnMut(&mut (dyn Any + 'static)) + 'a>
)
fn needs_relayout(&self) -> bool
[src]
fn focus_view(&mut self, selector: &Selector) -> Result<(), ()>
[src]
fn important_area(&self, size: XY<usize>) -> Rect
[src]
impl<T> With for T
[src]
fn with<F>(self, f: F) -> Self where
F: FnOnce(&mut Self),
[src]
F: FnOnce(&mut Self),
fn try_with<E, F>(self, f: F) -> Result<Self, E> where
F: FnOnce(&mut Self) -> Result<(), E>,
[src]
F: FnOnce(&mut Self) -> Result<(), E>,
fn with_if<F>(self, condition: bool, f: F) -> Self where
F: FnOnce(&mut Self),
[src]
F: FnOnce(&mut Self),
impl<T> Boxable for T where
T: View,
[src]
T: View,
fn boxed(self, width: SizeConstraint, height: SizeConstraint) -> BoxView<Self>
[src]
fn fixed_size<S>(self, size: S) -> BoxView<Self> where
S: Into<XY<usize>>,
[src]
S: Into<XY<usize>>,
fn fixed_width(self, width: usize) -> BoxView<Self>
[src]
fn fixed_height(self, height: usize) -> BoxView<Self>
[src]
fn full_screen(self) -> BoxView<Self>
[src]
fn full_width(self) -> BoxView<Self>
[src]
fn full_height(self) -> BoxView<Self>
[src]
fn max_size<S>(self, size: S) -> BoxView<Self> where
S: Into<XY<usize>>,
[src]
S: Into<XY<usize>>,
fn max_width(self, max_width: usize) -> BoxView<Self>
[src]
fn max_height(self, max_height: usize) -> BoxView<Self>
[src]
fn min_size<S>(self, size: S) -> BoxView<Self> where
S: Into<XY<usize>>,
[src]
S: Into<XY<usize>>,
fn min_width(self, min_width: usize) -> BoxView<Self>
[src]
fn min_height(self, min_height: usize) -> BoxView<Self>
[src]
impl<T> Identifiable for T where
T: View,
[src]
T: View,
impl<T> AnyView for T where
T: View,
[src]
T: View,
fn as_any(&self) -> &(dyn Any + 'static)
[src]
Downcast self to a Any
.
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
[src]
Downcast self to a mutable Any
.
fn as_boxed_any(self: Box<T>) -> Box<dyn Any + 'static>
[src]
impl<T> IntoBoxedView for T where
T: View,
[src]
T: View,