Inconsistent Reactivity Terminology

[ealmloff]

Reactive Terminology

When referencing reactivity in the guide and inline docs, we haven't been very consistent with terminology. Recently I have been trying to switch to using two different terms for values in reactive code:

1. Tracked values are values that track when they have been read. They will add themselves as dependencies to reactive hooks and automatically rerun any reactive hooks that subscribe to them when they are changed. Eg. Signal, ReadOnlySignal, Memo, and Resource are all tracked values, but Effect is not

• Solid JS calls these reactive values. https://docs.solidjs.com/concepts/signals#reactivity
• Vue calls these reactive objects. https://vuejs.org/guide/scaling-up/state-management.html#simple-state-management-with-reactivity-api
• Svelte calls this reactive state
• Leptos calls these reactive values
• React calls these reactive values

2. Reactive hooks are hooks that keep track of dependencies and rerun when the tracked values that are read inside of them change. Eg. use_memo, use_resource, and use_effect are all reactive hooks, but use_signal is not

• Solid JS calls these tracking scopes. https://docs.solidjs.com/concepts/signals#reactivity
• Vue calls these reactive effects. https://vuejs.org/guide/extras/reactivity-in-depth.html#how-reactivity-works-in-vue
• Svelte mentions effects and derived state, but I don't see a central term for all of these kinds of functions
• Leptos calls these reactive closures

It might make sense to switch the two since that seems to align more closely with other frameworks people could be familiar with

Places where we refer to tracked values as reactive today:

• https://dioxuslabs.com/learn/0.6/cookbook/antipatterns#avoid-interior-mutability-in-props
• https://dioxuslabs.com/learn/0.6/essentials/state/#making-props-reactive

• dioxus/packages/core-macro/docs/props.md

  Line 238 in 19ca707

  ### Reactive Props

• dioxus/packages/hooks/docs/use_resource.md

  Line 112 in 19ca707

  ## With non-reactive dependencies

• dioxus/packages/hooks/docs/derived_state.md

  Line 63 in 19ca707

  ## With non-reactive dependencies

• dioxus/packages/core-macro/docs/component.md

  Line 225 in 19ca707

  ### Reactive Props

• dioxus/packages/core/docs/reactivity.md

  Line 67 in 19ca707

  ## Non Reactive State

• dioxus/packages/hooks/src/use_reactive.rs

  Line 103 in 19ca707

  pub fn use_reactive<O, D: Dependency>(