1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71
//! Unique state shared application-wide
use std::rc::Rc;
pub use yewdux_macros::Store;
use crate::Context;
/// A type that holds application state.
pub trait Store: 'static {
/// Create this store.
fn new(cx: &Context) -> Self;
/// Indicate whether or not subscribers should be notified about this change. Usually this
/// should be set to `self != old`.
fn should_notify(&self, old: &Self) -> bool;
}
/// A type that can change state.
///
/// ```
/// use std::rc::Rc;
///
/// use yew::prelude::*;
/// use yewdux::prelude::*;
///
/// #[derive(Default, Clone, PartialEq, Eq, Store)]
/// struct Counter {
/// count: u32,
/// }
///
/// enum Msg {
/// AddOne,
/// }
///
/// impl Reducer<Counter> for Msg {
/// fn apply(self, mut counter: Rc<Counter>) -> Rc<Counter> {
/// let state = Rc::make_mut(&mut counter);
/// match self {
/// Msg::AddOne => state.count += 1,
/// };
///
/// counter
/// }
/// }
///
/// #[function_component]
/// fn App() -> Html {
/// let (counter, dispatch) = use_store::<Counter>();
/// let onclick = dispatch.apply_callback(|_| Msg::AddOne);
///
/// html! {
/// <>
/// <p>{ counter.count }</p>
/// <button {onclick}>{"+1"}</button>
/// </>
/// }
/// }
/// ```
pub trait Reducer<S> {
/// Mutate state.
fn apply(self, state: Rc<S>) -> Rc<S>;
}
impl<F, S> Reducer<S> for F
where
F: FnOnce(Rc<S>) -> Rc<S>,
{
fn apply(self, state: Rc<S>) -> Rc<S> {
self(state)
}
}