Observable 映射
observable.map(values)
observable.map(values?)
- 创建一个动态键的 observable 映射。
如果你不但想对一个特定项的更改做出反应,而且对添加或删除该项也做出反应的话,那么 observable 映射会非常有用。observable.map(values)
中的 values 可以是对象、 数组或者字符串键的 ES6 map。
与 ES6 map 不同的是,键只能是字符串。
通过 ES6 Map 构造函数,你可以使用 observable(new Map())
或使用装饰器 @observable map = new Map()
的类属性来初始化 observable 映射 。
下列 observable 映射所暴露的方法是依据 ES6 Map 规范:
has(key)
- 返回映射是否有提供键对应的项。注意键的存在本身就是可观察的。set(key, value)
- 把给定键的值设置为value
。提供的键如果在映射中不存在的话,那么它会被添加到映射之中。delete(key)
- 把给定键和它的值从映射中删除。get(key)
- 返回给定键的值(或undefined
)。keys()
- 返回映射中存在的所有键。插入顺序会被保留。values()
- 返回映射中存在的所有值。插入顺序会被保留。entries()
- 返回一个(保留插入顺序)的数组,映射中的每个键值对都会对应数组中的一项[key, value]
。forEach(callback:(value, key, map) => void, thisArg?)
- 为映射中每个键值对调用给定的回调函数。clear()
- 移除映射中的所有项。size
- 返回映射中项的数量。
以下函数不属于 ES6 规范,而是由 MobX 提供:
toJS()
- 返回映射的浅的普通对象表示。(深复制使用mobx.toJS(map)
)。intercept(interceptor)
- 可以用来在任何变化作用于映射前将其拦截。参见 observe & intercept。observe(listener, fireImmediately?)
- 注册侦听器,在映射中的每个更改时触发,类似于为 Object.observe 发出的事件。想了解更多详情,请参见 observe & intercept。merge(values)
- 把提供对象的所有项拷贝到映射中。values
可以是普通对象、entries 数组或者 ES6 字符串键的映射。replace(values)
- 用提供值替换映射全部内容。是.clear().merge(values)
的简写形式。
observable.shallowMap(values)
任何分配给 observable 映射的值都会默认通过 observable
来传递使其转变成可观察的。
创建浅映射以禁用此行为,并按原样存储值。关于此机制的更多详情,请参见 调节器。
名称参数
observable.map
和 observable.shallowMap
都接收第二个参数作为 spy
或者 MobX 开发者工具中的调试名称。