dioxus_core/
lib.rs

1#![doc = include_str!("../README.md")]
2#![doc(html_logo_url = "https://avatars.githubusercontent.com/u/79236386")]
3#![doc(html_favicon_url = "https://avatars.githubusercontent.com/u/79236386")]
4#![warn(missing_docs)]
5
6mod any_props;
7mod arena;
8mod diff;
9mod effect;
10mod error_boundary;
11mod events;
12mod fragment;
13mod generational_box;
14mod global_context;
15mod launch;
16mod mutations;
17mod nodes;
18mod properties;
19mod reactive_context;
20mod render_error;
21mod root_wrapper;
22mod runtime;
23mod scheduler;
24mod scope_arena;
25mod scope_context;
26mod scopes;
27mod suspense;
28mod tasks;
29mod virtual_dom;
30
31mod hotreload_utils;
32
33/// Items exported from this module are used in macros and should not be used directly.
34#[doc(hidden)]
35pub mod internal {
36    #[doc(hidden)]
37    pub use crate::hotreload_utils::{
38        DynamicLiteralPool, DynamicValuePool, FmtSegment, FmtedSegments, HotReloadAttributeValue,
39        HotReloadDynamicAttribute, HotReloadDynamicNode, HotReloadLiteral,
40        HotReloadTemplateWithLocation, HotReloadedTemplate, HotreloadedLiteral, NamedAttribute,
41        TemplateGlobalKey,
42    };
43
44    #[doc(hidden)]
45    pub use generational_box;
46}
47
48pub(crate) mod innerlude {
49    pub(crate) use crate::any_props::*;
50    pub use crate::arena::*;
51    pub(crate) use crate::effect::*;
52    pub use crate::error_boundary::*;
53    pub use crate::events::*;
54    pub use crate::fragment::*;
55    pub use crate::generational_box::*;
56    pub use crate::global_context::*;
57    pub use crate::launch::*;
58    pub use crate::mutations::*;
59    pub use crate::nodes::*;
60    pub use crate::properties::*;
61    pub use crate::reactive_context::*;
62    pub use crate::render_error::*;
63    pub use crate::runtime::{Runtime, RuntimeGuard};
64    pub use crate::scheduler::*;
65    pub use crate::scopes::*;
66    pub use crate::suspense::*;
67    pub use crate::tasks::*;
68    pub use crate::virtual_dom::*;
69
70    /// An [`Element`] is a possibly-none [`VNode`] created by calling `render` on [`ScopeId`] or [`ScopeState`].
71    ///
72    /// An Errored [`Element`] will propagate the error to the nearest error boundary.
73    pub type Element = std::result::Result<VNode, RenderError>;
74
75    /// A [`Component`] is a function that takes [`Properties`] and returns an [`Element`].
76    pub type Component<P = ()> = fn(P) -> Element;
77}
78
79pub use crate::innerlude::{
80    fc_to_builder, generation, schedule_update, schedule_update_any, use_hook, vdom_is_rendering,
81    AnyValue, Attribute, AttributeValue, CapturedError, Component, ComponentFunction, DynamicNode,
82    Element, ElementId, Event, Fragment, HasAttributes, IntoDynNode, LaunchConfig, MarkerWrapper,
83    Mutation, Mutations, NoOpMutations, Ok, Properties, Result, Runtime, ScopeId, ScopeState,
84    SpawnIfAsync, Task, Template, TemplateAttribute, TemplateNode, VComponent, VNode, VNodeInner,
85    VPlaceholder, VText, VirtualDom, WriteMutations,
86};
87
88/// The purpose of this module is to alleviate imports of many common types
89///
90/// This includes types like [`Element`], and [`Component`].
91pub mod prelude {
92    pub use crate::innerlude::{
93        consume_context, consume_context_from_scope, current_owner, current_scope_id,
94        fc_to_builder, force_all_dirty, generation, has_context, needs_update, needs_update_any,
95        parent_scope, provide_context, provide_error_boundary, provide_root_context, queue_effect,
96        remove_future, schedule_update, schedule_update_any, spawn, spawn_forever,
97        spawn_isomorphic, suspend, suspense_context, throw_error, try_consume_context,
98        use_after_render, use_before_render, use_drop, use_hook, use_hook_with_cleanup, with_owner,
99        AnyValue, Attribute, Callback, Component, ComponentFunction, Context, Element,
100        ErrorBoundary, ErrorContext, Event, EventHandler, Fragment, HasAttributes,
101        IntoAttributeValue, IntoDynNode, OptionStringFromMarker, Properties, ReactiveContext,
102        RenderError, Runtime, RuntimeGuard, ScopeId, ScopeState, SuperFrom, SuperInto,
103        SuspendedFuture, SuspenseBoundary, SuspenseBoundaryProps, SuspenseContext,
104        SuspenseExtension, Task, Template, TemplateAttribute, TemplateNode, VNode, VNodeInner,
105        VirtualDom,
106    };
107}
108
109pub use const_format;
dioxus_core/lib.rs

dioxus_core/
lib.rs
