Skip to main content


👻 Primitive and flexible state management for React
Go to Latest
---title: Large objectsnav: 8.01keywords: large,object---
> The examples and descriptions below are based on this [codesandbox](, so it will give you a better understanding if you check it out along with these examples.Sometimes we have nested data we need to store in atoms, and we may need to change that data at different levels, or we need to use part of that data without listening to all changes.
Consider this example:
```jsconst initialData = { people: [ { name: 'Luke Skywalker', information: { height: 172 }, siblings: ['John Skywalker', 'Doe Skywalker'], }, { name: 'C-3PO', information: { height: 167 }, siblings: ['John Doe', 'Doe John'], }, ], films: [ { title: 'A New Hope', planets: ['Tatooine', 'Alderaan'], }, { title: 'The Empire Strikes Back', planets: ['Hoth'], }, ], info: { tags: ['People', 'Films', 'Planets', 'Titles'], },}```
## focusAtom
> `focusAtom` creates a new atom, based on the focus that you pass to it. [jotai-optics](../integrations/optics.mdx#focus-atom)We use this utility to focus an atom and create an atom from a specific part of the data. For example we may need to consume the people property of the above data, Here's how we do it:
```jsimport { atom } from 'jotai'import { focusAtom } from 'jotai-optics'
const dataAtom = atom(initialData)
const peopleAtom = focusAtom(dataAtom, (optic) => optic.prop('people'))```
`focusAtom` returns `WritableAtom` which means it's possible to change the `peopleAtom` data.
If we change the `films` property of the above data example, the `peopleAtom` won't cause a re-render, so that's one of the benefits of using `focusAtom`.
## splitAtom
> The `splitAtom` utility is useful when you want to get an atom for each element in a list. [jotai/utils](../utilities/split.mdx)We use this utility for atoms that return arrays as their values. For example, the `peopleAtom` we made above returns the people property array, so we can return an atom for each item of that array. If the array atom is writable, `splitAtom` returned atoms are going to be writable, if the array atom is read-only, the returned atoms will be read-only too.
```jsimport { splitAtom } from 'jotai/utils'
const peopleAtomsAtom = splitAtom(peopleAtom)```
And this is how we use it in components.
```jsxconst People = () => { const [peopleAtoms] = useAtom(peopleAtomsAtom) return ( <div> { => ( <Person personAtom={personAtom} key={`${personAtom}`} /> ))} </div> )}```
## selectAtom
> This function creates a derived atom whose value is a function of the original atom's value. [jotai/utils](../utilities/select.mdx)This utility is like `focusAtom`, but we use it when we have a read-only atom to select part of it, and it always returns a read-only atom.
Assume we want to consume the info data, and its data is always unchangeable. We can make a read-only atom from it and select that created atom.
```js// first we create a read-only atom based on initialData.infoconst readOnlyInfoAtom = atom((get) => get(dataAtom).info)```
Then we use it in our component:
```jsximport { atom, useAtom } from 'jotai'import { selectAtom, splitAtom } from 'jotai/utils'
const tagsSelector = (s) => s.tagsconst Tags = () => { const tagsAtom = selectAtom(readOnlyInfoAtom, tagsSelector) const tagsAtomsAtom = splitAtom(tagsAtom) const [tagAtoms] = useAtom(tagsAtomsAtom) return ( <div> { => ( <Tag key={`${tagAtom}`} tagAtom={tagAtom} /> ))} </div> )}```