use std::{any::TypeId, fmt::Arguments}; use crate::innerlude::*; /// Every "Props" used for a component must implement the `Properties` trait. This trait gives some hints to Dioxus /// on how to memoize the props and some additional optimizations that can be made. We strongly encourage using the /// derive macro to implement the `Properties` trait automatically as guarantee that your memoization strategy is safe. /// /// If your props are 'static, then Dioxus will require that they also be PartialEq for the derived memoize strategy. /// /// By default, the memoization strategy is very conservative, but can be tuned to be more aggressive manually. However, /// this is only safe if the props are 'static - otherwise you might borrow references after-free. /// /// We strongly suggest that any changes to memoization be done at the "PartialEq" level for 'static props. Additionally, /// we advise the use of smart pointers in cases where memoization is important. /// /// ## Example /// /// For props that are 'static: /// ```rust, ignore /// #[derive(Props, PartialEq, Clone)] /// struct MyProps { /// data: String /// } /// ``` pub trait Properties: Clone + Sized + 'static { /// The type of the builder for this component. /// Used to create "in-progress" versions of the props. type Builder; /// Create a builder for this component. fn builder() -> Self::Builder; /// Compare two props to see if they are memoizable. fn memoize(&mut self, other: &Self) -> bool; /// Create a component from the props. fn into_vcomponent( self, render_fn: impl ComponentFunction, component_name: &'static str, ) -> VComponent { VComponent::new(render_fn, self, component_name) } } impl Properties for () { type Builder = EmptyBuilder; fn builder() -> Self::Builder { EmptyBuilder {} } fn memoize(&mut self, _other: &Self) -> bool { true } } /// Root properties never need to be memoized, so we can use a dummy implementation. pub(crate) struct RootProps

(pub P); impl

Clone for RootProps

where P: Clone, { fn clone(&self) -> Self { Self(self.0.clone()) } } impl

Properties for RootProps

where P: Clone + 'static, { type Builder = P; fn builder() -> Self::Builder { unreachable!("Root props technically are never built") } fn memoize(&mut self, _other: &Self) -> bool { true } } // We allow components to use the () generic parameter if they have no props. This impl enables the "build" method // that the macros use to anonymously complete prop construction. pub struct EmptyBuilder; impl EmptyBuilder { pub fn build(self) {} } /// This utility function launches the builder method so rsx! and html! macros can use the typed-builder pattern /// to initialize a component's props. pub fn fc_to_builder(_: impl ComponentFunction) ->

::Builder where P: Properties, { P::builder() } /// Any component that implements the `ComponentFn` trait can be used as a component. pub trait ComponentFunction: Clone + 'static { /// Get the type id of the component. fn id(&self) -> TypeId { TypeId::of::() } /// Convert the component to a function that takes props and returns an element. fn rebuild(&self, props: Props) -> Element; } /// Accept any callbacks that take props impl Element + Clone + 'static, P> ComponentFunction

for F { fn rebuild(&self, props: P) -> Element { self(props) } } /// Accept any callbacks that take no props pub struct EmptyMarker; impl Element + Clone + 'static> ComponentFunction<(), EmptyMarker> for F { fn rebuild(&self, _: ()) -> Element { self() } } /// A enhanced version of the `Into` trait that allows with more flexibility. pub trait SuperInto { /// Convert from a type to another type. fn super_into(self) -> O; } impl SuperInto for T where O: SuperFrom, { fn super_into(self) -> O { O::super_from(self) } } /// A enhanced version of the `From` trait that allows with more flexibility. pub trait SuperFrom { /// Convert from a type to another type. fn super_from(_: T) -> Self; } // first implement for all types that are that implement the From trait impl SuperFrom for O where O: From, { fn super_from(input: T) -> Self { Self::from(input) } } #[doc(hidden)] pub struct OptionStringFromMarker; impl<'a> SuperFrom<&'a str, OptionStringFromMarker> for Option { fn super_from(input: &'a str) -> Self { Some(String::from(input)) } } #[doc(hidden)] pub struct OptionArgumentsFromMarker; impl<'a> SuperFrom, OptionArgumentsFromMarker> for Option { fn super_from(input: Arguments<'a>) -> Self { Some(input.to_string()) } } #[test] #[allow(unused)] fn from_props_compiles() { // T -> T works let option: i32 = 0i32.super_into(); let option: i32 = 0.super_into(); // Note we don't need type hints on all inputs let option: i128 = 0.super_into(); let option: &'static str = "hello world".super_into(); // // T -> From works let option: i64 = 0i32.super_into(); let option: String = "hello world".super_into(); // T -> Option works let option: Option = 0i32.super_into(); let option: Option = 0.super_into(); let option: Option = 0.super_into(); fn takes_option_string(_: impl SuperInto, M>) {} takes_option_string("hello world"); takes_option_string("hello world".to_string()); }