mirror of https://github.com/yewstack/yew
53 lines
1.7 KiB
Plaintext
53 lines
1.7 KiB
Plaintext
---
|
|
title: 'Hooks'
|
|
slug: /concepts/function-components/hooks
|
|
---
|
|
|
|
## Hooks
|
|
|
|
Hooks are functions that let you store state and perform side effects.
|
|
|
|
Yew comes with a few pre-defined hooks. You can also create your own or discover many [community-made hooks](/community/awesome#hooks).
|
|
|
|
## Rules of hooks
|
|
|
|
1. A hook function name always has to start with `use_`
|
|
2. Hooks can only be used in the following locations:
|
|
- Top-level of a function/hook.
|
|
- Blocks inside a function/hook, given it is not already branched.
|
|
- In the condition of a top-level `if` expression inside a function/hook.
|
|
- In the scrutinee of a top-level `match` expression inside a function/hook.
|
|
3. Hooks must be called in the same order for every render. Returning early is only allowed when using [Suspense](../../suspense.mdx)
|
|
|
|
These rules are enforced by either compile-time or run-time errors.
|
|
|
|
### Pre-defined Hooks
|
|
|
|
Yew comes with the following predefined Hooks:
|
|
|
|
- `use_state`
|
|
- `use_state_eq`
|
|
- `use_memo`
|
|
- `use_callback`
|
|
- `use_ref`
|
|
- `use_mut_ref`
|
|
- `use_node_ref`
|
|
- `use_reducer`
|
|
- `use_reducer_eq`
|
|
- `use_effect`
|
|
- `use_effect_with`
|
|
- `use_context`
|
|
- `use_force_update`
|
|
|
|
The documentation for these hooks can be found in the [Yew API docs](https://yew-rs-api.web.app/next/yew/functional/)
|
|
|
|
### Custom Hooks
|
|
|
|
There are cases where you want to define your own Hooks to encapsulate potentially stateful logic from a component into reusable functions.
|
|
See the [Defining custom hooks](concepts/function-components/hooks/custom-hooks.mdx#defining-custom-hooks) section for more information.
|
|
|
|
## Further reading
|
|
|
|
- The React documentation has a section on [React hooks](https://reactjs.org/docs/hooks-intro.html).
|
|
These are not the same as Yew's hooks, but the underlying concept is similar.
|