atom(options)——迹忆客-ag捕鱼王app官网

一个 atom 表示 recoil 的 state。atom() 函数返回一个可写的 recoilstate 对象。

unction atom({
  key: string,
  default: t | promise | recoilvalue,
  effects_unstable?: $readonlyarray>,
  dangerouslyallowmutability?: boolean,
}): recoilstate

• key - 在内部用于标识 atom 的唯一字符串。在整个应用中，该字符串必须相对于其他 atom 和 selector 保持唯一。
• default - atom 的初始值，或一个 promise，或另一个 atom，或一个用来表示相同类型的值的 selector。
• dangerouslyallowmutability - 在某些情况下，我们可能希望允许存储在 atom 中的对象发生改变，而这些变化并不代表 status 的变更。使用这个选项可以覆盖开发模式下的 freezing 对象。

recoil 管理 atom 的 state 变化，以便通知订阅该 atom 的组件何时重新渲染，所以你需使用下面列出的钩子函数来改变 atom 的 state。如果一个存储在 atom 中的对象被直接 mutated，它可能会绕过钩子，在没有正确触发订阅的情况下导致 state 的变化，为了帮助大家检测 bug，recoil 会在开发模式下 freeze 存储在 atom 中的对象。

通常，你需要使用以下 hook 来与 atom 搭配使用。

• **userecoilstate()**：当你同时需要对 atom 进行读写时，使用此 hook。使用此 hook 会使组件订阅 atom。
• **userecoilvalue()**：当你仅需要读取 atom 时，使用此 hook。使用此 hook 会使组件订阅 atom。
• **usesetrecoilstate()**：当你仅需要写入 atom 时，使用此 hook。
• **useresetrecoilstate()**：需将 atom 重置为默认值时，使用此 hook。

在一些罕见的场景下，你需要在不订阅组件的情况下读取 atom 的值，请参考 userecoilcallback()。

可以使用 promise 或者表示相同类型值的 recoilvalue。因为 promise 会是 pending 状态，而默认的 selector 也可能是异步的，因此 atom 的值也可以是 pending 状态，或者在读取值的时候抛出异常。注意设置 atom 时，你不能对 promise 实时赋值。对于异步函数，请使用 selectors 。

atom 不能用来直接存储 promise 或 recoilvalue，但是可以用对象包装它们。注意 promise 是可变的。atoms 可以设置为纯函数，如果你这么做，你需要使用更新器组成 setter。（例如： set(myatom, () => myfunc);）。

示例

import {atom, userecoilstate} from 'recoil';
const counter = atom({
  key: 'mycounter',
  default: 0,
});
function counter() {
  const [count, setcount] = userecoilstate(counter);
  const incrementbyone = () => setcount(count   1);
  return (
    

      count: {count}
      

      increment
    
  );
}

atom families

atomfamily() 对于存储一系列的相关状态以及 划分你 atom 状态的作用域 来说，非常有用。