顶层 API.pdfVIP

顶层 API React React 是 React 库的入口。如果使用的是预编译包，则 React 是全局的；如果使 用 CommonJS 模块系统，则可以用 require() 函数引入 React。 React.createClass ReactClass createClass(object specification) 创建一 组件类，并作出定义。组件实现了 render() 方法，该方法返回一个子 级。该子级可能包含很深的子级结构。组件与标准原型类的不同之处在于，你不需要 使用 new 来实例化。 组件是一种很方便的封装，可以 （通过 new ）为你创建后台 实例。 更多关于定义组件对象的信息，参考组件定义和生命周期。 React.createElement ReactElement createElement( string/ReactClass type, [object props], [children ] ) 创建并返回一 新的指定类型的 ReactElement 。type 参数可以是一 html 标签 名字字符串 （例如，“div”，“span”，等等），或者是 ReactClass （通 过 React createClass 创建的）。 React.createFactory factoryFunction createFactory( string/ReactClass type ) 返回一 生成指定类型 ReactElements 的函数。比如 React createElement ， type 参数可以是一 html 标签名字字符串 （例如，“div”，“span”，等等），或者 是 ReactClass 。 React.render ReactComponent render( ReactElement element, DOMElement container, [function callback] ) 渲染一 ReactElement 到 DOM 中，放在 container 指定的 DOM 元素下，返 回一 到该组件的引用。 如果 ReactElement 之前就被渲染到了 container 中，该函数将会更新此 ReactElement，仅改变需要改变的 DOM 节点以展示最新的 React 组件。 如果提供了可选的回调函数，则该函数将会在组件渲染或者更新之后调用。 注意： React render() 替换传入的容器节点内容。在将来，或许可能插入组件到 已存在的 DOM 节点中，但不覆盖已有的子节点。 React.unmountComponent tNode boolean unmountComponentAtNode(DOMElement container) 从 DOM 中移除已经挂载的 React 组件，清除相应的事件处理器和 state。如果在 container 内没有组件挂载，这 函数将什么都不做。如果组件成功移除，则返 回 true ；如果没有组件被移除，则返回 false 。 React.renderToString string renderToString(ReactElement element) 把组件渲染成原始的 HTML 字符串。该方法应该仅在服务器端使用。React 将会返 回一 HTML 字符串。你可以在服务器端用此方法生成 HTML，然后将这些标记发 送给客户端，这样可以获得更快的页面加载速度，并且有利于搜索引擎抓取页面，方 便做 SEO。 如果在一 节点上面调用 React render() ，并且该节点已经有了服务器渲染的标 记，React 将会维护该节点，并且仅绑定事件处理器，保证有一 高效的首屏加载体 验。 React.renderToStaticMarkup string renderToStaticMarkup(ReactElement element) 和 renderToString 类似，除了不创建额外的 DOM 属性，例如 data-react- id ，因为这些属性仅在 React 内部使用。如果你想用 React 做一 简单的静态页 面生成器，这是很有用的，因为丢掉额外的属性能够节省很多字节。 React.isValidElement boolean