1.顶层API
1.1React
React是React库的入口。如果使用的是预编译包,则React是全局的;如果使用CommonJS模块系统,则可以用require()函数引入React。
1.ateClass
ReactClass createClass(object specification)
创建一个组件类,并作出定义。组件实现了render()方法,该方法返回一个子级。该子级可能包含很深的子级结构。组件与标准原型类的不同之处在于,你不需要使用new来实例化。组件是一种很方便的封装,可以(通过new)为你创建后台实例。
更多关于定义组件对象的信息,参考组件定义和生命周期。
1.ateElement
ReactElement createElement(
string/ReactClass type,
[object props],
[]
)
创建并返回一个新的指定类型的ReactElement。type参数可以是一个html标签名字字符串(例如,“div”,“span”,等等),或者是ReactClass(通过ateClass创建的)。
1.ateFactory
factoryFunction createFactory(
string/ReactClass type
)
返回一个生成指定类型ReactElements的函数。比
如ateElement,type参数可以是一个html标签名字字符串(例如,“div”,“span”,等等),或者是ReactClass。
1.der
ReactComponent render(
ReactElement element,
DOMElement container,
[function callback]
)
渲染一个ReactElement到DOM中,放在container指定的DOM 元素下,返回一个到该组件的引用。
如果ReactElement之前就被渲染到了container中,该函数将会更新此ReactElement,仅改变需要改变的DOM节点以展示最新的React组件。
如果提供了可选的回调函数,则该函数将会在组件渲染或者更新之后调用。
注意:
1.1.5React.unmountComponentAtNode
boolean unmountComponentAtNode(DOMElement container)
从DOM中移除已经挂载的React组件,清除相应的事件处理器和state。如果在container内没有组件挂载,这个函数将什么都不做。如果组件成功移除,则返回true;如果没有组件被移除,则返回false。
1.derToString
string renderToString(ReactElement element)
把组件渲染成原始的HTML字符串。该方法应该仅在服务器端使用。React将会返回一个HTML字符串。你可以在服务器端用此方法生成HTML,然后将这些标记发送给客户端,这样可以获得更快的页面加载速度,并且有利于搜索引擎抓取页面,方便做SEO。
如果在一个节点上面调用der(),并且该节点已经有了服务器渲染的标记,React将会维护该节点,并且仅绑定事件处理器,保证有一个高效的首屏加载体验。
1.derToStaticMarkup
string renderToStaticMarkup(ReactElement element)
和renderToString类似,除了不创建额外的DOM属性,例
如data-react-id,因为这些属性仅在React内部使用。如果你想用React做一个简单的静态页面生成器,这是很有用的,因为丢掉额外的属性能够节省很多字节。
1.1.8React.isValidElement
boolean isValidElement(*object)
判断对象是否是一个ReactElement。
1.1.9React.DOM
React.DOM运用ateElement为DOM组件提供了方便的包装。该方式仅在未使用JSX的时候适
用。例如,React.DOM.div(null, 'Hello World!')。
1.1.10React.PropTypes
react to中文React.PropTypes包含了能与组件propTypes对象共用的类型,用于验证传入组件的props。更多有关propTypes的信息,参考复用组件。
1.1.11React.initializeTouchEvents
initializeTouchEvents(boolean shouldUseTouch)
配置React的事件系统,使React能处理移动设备的触摸(touch)事件。
1.1.12React.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参数是null或者undefined,那么返回null或者undefined而不是一个空对象。React.Children.forEach
React.Children.forEach(object children,function fn[,object context])
类似于React.Children.map(),但是不返回对象。
unt
number unt(object children)
返回children当中的组件总数,和传递给map或者forEach的回调函数的调用次数一致。
ly
object ly(object children)
返回children中仅有的子级。否则抛出异常。
2.组件API
2.1ReactComponent
React组件实例在渲染的时候创建。这些实例在接下来的渲染中被重复使用,可以在组件方法中通过this访问。唯一一种在React之外获取React组件实例句柄的方式就是保存der的返回值。在其它组件内,可以使用refs得到相同的结果。
2.1.1setState
setState(object nextState[,function callback])
合并nextState和当前state。这是在事件处理函数中和请求回调函数中触发UI更新的主要方法。另外,也支持可选的回调函数,该函数在setState执行完毕并且组件重新渲染完成之后调用。
注意:
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论