ReactJS中文API文档

所需积分/C币:45 2017-11-13 11:25:21 446KB PDF
收藏 收藏
举报

ReactJS中文API文档,给需要pdf格式的朋友.最新的16版还没有找到.
如果 Reactelement之前就被渲染到了 container中,该函数将会更新 此 Reactelement,仅改变需要改变的DOM节点以展示最新的 React组件。 如果提供了可选的回调函数,则该函数将会在组件渲染或者更新之后调 用。 注意: React. render0替换传入的容器节点內容。在将来,或许可能插入组件到 已存在的DoM节点中,但不覆盖已有的子节点。 1.1.5 React. unmount componentAtNode boolean unmountComponentAtNode(DOMElement container 从DoM中移除已经挂载的 React组件,清除相应的事件处理器和 state。如果在 container内没有组件挂载,这个函数将什么都不做。 如果组件成功移除,则返回true;如果没有组件被移除,则返回 false。 1.1.6 React. renderTostring string renderTostring(ReactElement element) 把组件渲染成原始的HTML字符串。该方法应该仅在服务器端使用。 React将会返回一个HTML字符串。你可以在服务器端用此方法生成 HTML,然后将这些标记发送给客户端,这样可以获得更快的页面加载 速度,并且有利于搜索引擎抓取页面,方便做SEO 如果在一个节点上面调用 React. render()并且该节点已经有了服务器渲 染的标记, React将会维护该节点,并且仅绑定事件处理器,保证有 个高效的首屏加载体验。 1.1.7 React. renderToStaticMarkup string renderTostaticMarkup(ReactElement element 和 renderToString类似,除了不创建额外的DoM属性,例 如data- react-id,因为这些属性仅在 React内部使用。如果你想用 React做一个简单的静态页面生成器,这是很有用的,因为丢掉额外的 属性能够节省很多字节。 11. 8 React is validElement boolean isValidElement(* object) 判断对象是否是一个 Reactelement。 1.1.9 React. DOM React DOM运用 React. createelement为DOM组件提供了方便的包 装。该方式仅在未使用JsX的时侯适用。例如, React. DOM.div(null Hello World! 1.1.10 React. PropTypes React. Prop Types包含了能与组件 propTypes对象共用的类型,用于验 证传入组件的 props。更多有关 prop Types的信息,参考复用组件。 1.1.11 React initialize TouchEvents initialize Touch Events(boolean should Use Touch) 配置 React的事件系统,使 React能处理移动设备的触摸( touch) 事件。 1.1.12 React. Children React. Children为处理 this props. children这个封闭的数据结构提供了 有用的工具。 React. Children. map object React. Children. map(object children, function fn[ object context]) 在每一个直接子级(包含在 children参数中的)上调用fn函数,此函 数中的this指向上下文。如果 children是一个内嵌的对象或者数组,它 将被遍历:不会传入容器对象到fn中。如果 children参数是nu!或 者 undefined,那么返回nu或者 undefined而不是一个空对象 React. Children forEach React. Children. for Each(object children, function fn[ object context]) 类似于 React. Children. map0,但是不返回对象 React. children count number React. Children count(object children 返回 children当中的组件总数,和传递给map或者 for Each的回调函 数的调用次数一致 React. Children. only object React. Children only(object children) 返回 children中仅有的子级。否则抛出异常。 2组件API 2.1React component React组件实例在渲染的时候创建。这些实例在接下来的渲染中被重复 使用,可以在组件方法中通过this访问。唯——种在 React之外获取 React组件实例句柄的方式就是保存 React render的返回值。在其它组 件内,可以使用refs得到相同的结果。 2.1.1 setstate setState(object nextState, function callback]) 合并 nextstate和当前 state。这是在事件处理函数中和请求回调函 数中触发UI更新的主要方法。另外,也支持可选的回调函数,该函数 在 setstate执行完毕并且组件重新渲染完成之后调用, 注意: 绝不要直接改变this. state,因为在之后调用 setstate0可能会替换掉 你做的更改。把this. state当做不可变的。 setstate0不会立刻改变 thisstate,而是创建一个即将处理的 state转 变。在调用该方法之后获取this. state的值可能会得到现有的值,而不 是最新设置的值。 不保证 setstate调用的同步性,为了提升性能,可能会批量执行 state 转变和DOM渲染 setstate0将总是触发一次重绘,除非在 should ComponentUpdate0中 实现了条件渲染逻辑。如果使用可变的对象,但是又不能 在 should ComponentUpdate(中实现这种逻辑,仅在新 state和之前 的 state存在差异的时候调用 setstate0可以避免不必要的重新渲染。 2.1.2 replace state replace State(object nextStateL function callback) 类似于 setstate0,但是删除之前所有已存在的 state键,这些键都不 在 nextstate中。 2.1.3 forceUpdateO forceUpdate([function callback]) 如果 renderi0方法从 this props或者 this state之外的地方读取数据你 需要通过调用 forceUpdate0告诉 React什么时候需要再次运 render0。如果直接改变了 this state,也需要调用 forceUpdate0。 调用 forceUpdate0将会导致 render方法在相应的组件上被调用,并 且子级组件也会调用自己的 renderi0,但是如果标记改变了,那么 React仅会更新DOM。 通常情况下,应该尽量避免所有使用 forceUpdate0的情况, 在 render0中仅从 this props和 this state中读取数据。这会使应用大大 简化,并且更加高效。 2.1.4 getDOMNode DOMElement getDOMNodeo 如果组件已经挂载到了DOM上,该方法返回相应的本地浏览器 DOM元素。从DOM中读取值的时候,该方法很有用,比如获取表 单字段的值和做一些DOM操作。当 render返回nu或者 false的时 候, this. getDOMNode0返回 2.1.5 isMountedo bool is Mounted 如果组件渲染到了DOM中, amOunted0返回true。可以使用该方 法保证 setstate(和 forceUpdate0在异步场景下的调用不会出错。 2.1.6 setProps setProps(object nextProps[ function callback)) 当和一个外部的 JavaScript应用集成的时候,你可能想给一个 用 React. render0渲染的组件打上改变的标记。 尽管在同一个节点上再次调用 React render0来更新根组件是首选的方 式,也可以调用 setProps0来改变组件的属性,触发一次重新渲染。另 外,可以传递一个可选的回调函数,该函数将会在 setProps完成并且 组件重新渲染完成之后调用 注意: When possible, the declarative approach of calling React. render() again is preferred; it tends to make updates easier to reason about. (There's no significant performance difference between the two approaches. 刚方法仅在根组件上面调用。也就是说,仅在直接传 给 React render0的组件上可用,在它的子级组件上不可用。如果你倾 向于在子组件上使用 setProps0,不要利用响应式更新,而是当子组件 在 render0中创建的时候传入新的prop到子组件中。 2.1.7 replace Props replaceProps(object nextProps[, function callback]) 类似于 setProps0,但是删除所有已存在的 props,而不是合并新旧两 个 props对象。 3组件的详细说明和生命周期 Component Specs and Lifecycle 31组件的详细说明( Component Specifications 当通过调用 React. createClass90来创建组件的时候,你应该提供一个包 含 render方法的对象,并且也可以包含其它的在这里描述的生命周期 方法。 3.1.1 render Reactcomponent render render0方法是必须的。 当调用的时候,会检测 this props和 this state,返回一个单子级组件。 该子级组件可以是虚拟的本地DOM组件(比如<dⅳ/>或 者 React. doM div0),也可以是自定义的复合组件。 你也可以返回nu或者fase来表明不需要渲染任何东西。实际上 React渲染一个< noscript>标签来处理当前的差异检查逻辑。当返 回nul或者 false的时候, this.getDOMNode0将返回null render函数应该是的,也就是说该函数不修改组件 state,每次 调用都返回相同的结果,不读写DOM信息,也不和浏览器交互(例 如通过使用 setTimeout)。如果需要和浏览器交互, 在 componentDidMount0中或者其它生命周期方法中做这件事。保持 render(纯粹,可以使服务器端渲染更加切实可行,也使组件更容易被 理解。 3.1.2 getInitialState

...展开详情
试读 38P ReactJS中文API文档
立即下载 低至0.43元/次 身份认证VIP会员低至7折
    抢沙发
    一个资源只可评论一次,评论内容不能少于5个字
    关注 私信 TA的资源
    上传资源赚积分,得勋章
    最新推荐
    ReactJS中文API文档 45积分/C币 立即下载
    1/38
    ReactJS中文API文档第1页
    ReactJS中文API文档第2页
    ReactJS中文API文档第3页
    ReactJS中文API文档第4页
    ReactJS中文API文档第5页
    ReactJS中文API文档第6页
    ReactJS中文API文档第7页
    ReactJS中文API文档第8页
    ReactJS中文API文档第9页
    ReactJS中文API文档第10页
    ReactJS中文API文档第11页
    ReactJS中文API文档第12页

    试读已结束,剩余26页未读...

    45积分/C币 立即下载 >