从问题出发
我被问过这样一个问题:
想要实现一个 useTitle
方法,具体使用示例如下:
function Header() {
const [Title, changeTitle] = useTitle();
return (
<div onClick={() => changeTitle('new title')}>
<Title />
</div>
)
}
但在编写 useTitle
代码的时候却出了问题:
function TitleComponent({title}) {
return <div>{title}</div>
}
function useTitle() {
const [title, changeTitle] = useState('default title');
const Element = React.createElement(TitleComponent, {title});
return [Element.type, changeTitle];
}
这段代码直接报错,连渲染都渲染不出来,如果是你,该如何修改这段代码呢?
元素与组件
其实这就是一个很典型的元素与组件如何区分和使用的问题。
元素
我们先看 React 官方文档中对 React 元素的介绍:
Babel 会把 JSX 转译成一个名为 React.createElement()
函数调用。以下两种示例代码完全等效:
const element = <h1 className="greeting">Hello, world!</h1>;
const element = React.createElement(
'h1',
{className: 'greeting'},
'Hello, world!'
);
React.createElement()
会预先执行一些检查,以帮助你编写无错代码,但实际上它创建了一个这样的对象:
// 注意:这是简化过的结构
const element = {
type: 'h1',
props: {
className: 'greeting',
children: 'Hello, world!'
}
};
这些对象被称为 “React 元素”。它们描述了你希望在屏幕上看到的内容。
你看,React 元素其实就是指我们日常编写的 JSX 代码,它会被 Babel 转义为一个函数调用,最终得到的结果是一个描述 DOM 结构的对象,它的数据结构本质是一个 JS 对象。
在 JSX 中,我们是可以嵌入表达式的,就比如:
const name = 'Josh Perez';
const element = <h1>Hello, {name}</h1>;
所以如果我们要使用一个 React 元素,那我们应该使用嵌入表达式这种方式:
const name = <span>Josh Perez</span>;
const element = <h1>Hello, {name}</h1>;
组件
那组件呢?组件有两种,函数组件和 class 组件:
// 函数组件
function Welcome(props) {
return <h1>Hello, {props.name}</h1>;
}
// class 组件
class Welcome extends React.Component {
render() {
return <h1>Hello, {this.props.name}</h1>;
}
}
那如何使用组件呢?
const element = <Welcome name="Sara" />;
对于组件,我们要使用类似于 HTML 标签的方式进行调用,Babel 会将其转译为一个函数调用
const element = React.createElement(Welcome, {
name: "Sara"
});
所以你看,组件的数据结构本质是一个函数或者类,当你使用元素标签的方式进行调用时,函数或者类会被执行,最终返回一个 React 元素。
问题如何解决
尽管这些内容都来自于 React 官方文档,但如果你能清晰的了解到 React 元素和组件的差别,你已经可以解决开头的问题了。至少有两种方式可以解决,一种是返回 React 元素,一种是返回 React 组件
第一种我们返回 React 元素:
const root = ReactDOM.createRoot(document.getElementById('root'));
function Header() {
const [Title, changeTitle] = useTitle();
// 这里因为返回的是 React 元素,所以我们使用 {} 的方式嵌入表达式
return (
<div onClick={() => changeTitle('new title')}>
{Title}
</div>
)
}
function TitleComponent({title}) {
return <div>{title}</div>
}
function useTitle() {
const [title, changeTitle] = useState('default title');
// createElement 返回的是 React 元素
const Element = React.createElement(TitleComponent, {title});
return [Element, changeTitle];
}
root.render(<Header />);
第二种我们返回 React 组件:
const root = ReactDOM.createRoot(document.getElementById('root'));
function Header() {
const [Title, changeTitle] = useTitle();
// 因为返回的是 React 组件,所以我们使用元素标签的方式调用
return (
<div onClick={() => changeTitle('new title')}>
<Title />
</div>
)
}
function TitleComponent({title}) {
return <div>{title}</div>
}
function useTitle() {
const [title, changeTitle] = useState('default title');
// 这里我们构建了一个函数组件
const returnComponent = () => {
return <TitleComponent title={title} />
}
// 这里我们直接将组件返回出去
return [returnComponent, changeTitle];
}
root.render(<Header />);
自定义内容
有的时候我们需要给组件传入一个自定义内容。
举个例子,我们实现了一个 Modal 组件,有确定按钮,有取消按钮,但 Modal 展示的内容为了更加灵活,我们提供了一个 props 属性,用户可以自定义一个组件传入其中,用户提供什么,Modal 就展示什么,Modal 相当于一个容器,那么,我们该怎么实现这个功能呢?
第一种实现方式
以下是第一种实现方式:
function Modal({content}) {
return (
<div>
{content}
<button>确定</button>
<button>取消</button>
</div>
)
}
function CustomContent({text}) {
return <div>{text}</div>
}
<Modal content={<CustomContent text="content" />} />
根据前面的知识,我们可以知道,content
属性这里传入的其实是一个 React 元素,所以 Modal 组件的内部是用 {}
进行渲染。
第二种实现方式
但第一种方式,并不总能解决需求。有的时候,我们可能会用到组件内部的值。
就比如一个倒计时组件 Timer
,依然提供了一个属性 content
,用于自定义时间的展示样式,时间由 Timer
组件内部处理,展示样式则完全由用户自定义,在这种时候,我们就可以选择传入一个组件:
function Timer({content: Content}) {
const [time, changeTime] = useState('0');
useEffect(() => {
setTimeout(() => {
changeTime((new Date).toLocaleTimeString())
}, 1000)
}, [time])
return (
<div>
<Content time={time} />
</div>
)
}
function CustomContent({time}) {
return <div style={{border: '1px solid #ccc'}}>{time}</div>
}
<Timer content={CustomContent} />
在这个示例中,我们可以看到 content
属性传入的是一个 React 组件 CustomContent,而 CustomContent 组件会被传入 time 属性,我们正是基于这个约定进行的 CustomContent 组件的开发。
而 Timer 组件内部,因为传入的是组件,所以使用的是 <Content time={time}/>
进行的渲染。
第三种实现方式
在面对第二种实现方式的需求时,除了上面这种实现方式,还有一种称为 render props
的技巧,比第二种方式更常见一些,我们依然以 Timer 组件为例:
function Timer({renderContent}) {
const [time, changeTime] = useState('0');
useEffect(() => {
setTimeout(() => {
changeTime((new Date).toLocaleTimeString())
}, 1000)
}, [time])
// 这里直接调用传入的 renderContent 函数
return (
<div>
{renderContent(time)}
</div>
)
}
function CustomContent({time}) {
return <div style={{border: '1px solid #ccc'}}>{time}</div>
}
root.render(<Timer renderContent={(time) => {
return <CustomContent time={time} />
}} />);
鉴于我们传入的是一个函数,我们把 content
属性名改为了 renderContent
,其实叫什么都可以。
renderContent
传入了一个函数,该函数接收 time
作为参数,返回一个 React 元素,而在 Timer
内部,我们直接执行了 renderContent 函数,并传入内部处理好的 time 参数,由此实现了用户使用组件内部值自定义渲染内容。
多说一句,除了放到属性里,我们也可以放到 children 里,是一样的:
function Timer({children}) {
// ...
return (
<div>
{children(time)}
</div>
)
}
<Timer>
{(time) => {
return <CustomContent time={time} />
}}
</Timer>
我们可以视情况选择合适的传入方法。
React 系列
讲解 React 源码、React API 背后的实现机制,React 最佳实践、React 的发展与历史等,预计 50 篇左右,欢迎关注
如果喜欢或者有所启发,欢迎 star,对作者也是一种鼓励。