项目升级到 React19 难度如何?生态初探:利用 React-markdown 实现代码高亮

开发 前端
在我尝试了几个三方库之后,总体感受就是基本上都能正常在 React19 项目中使用,即使这些三方库还没有升级到 React19。当然我也把我某一个 React18 的项目升级到 React19,小幅度更改之后,也成功升级了。

经过前面几个实践案例的学习,我们都已经知道,React19 有非常吸引开发者的特性值得我们去升级。但是与此同时,我们也感受到了某些改动确实挺大的。因此在交流群里,大家会有一个比较明显的担忧,这种比较大的版本更新,是否会导致升级困难?

其实在官方文档中的升级指引中,有明确提到这个问题,开发团队预计这些重大更改不会影响到大多数程序。并且我们看到,react 删除的功能中,大多数都是几年前都已经标记弃用不建议大家使用的内容。

例如,class 语法中,曾经支持了字符串引用 ref。

// before
class MyComponent extends React.Component {
  componentDidMount() {
    this.refs.input.focus();
  }

  render() {
    return <input ref='input' />;
  }
}

这种使用方式因为存在多个缺点,在 2018 年 3 月(V16.3.0)中被标记为不推荐使用,直到现在才明确要删除代码。调整之后,开发者需要迁移到 ref 回调函数的使用。这个也并非新功能,而是一直都支持的写法,因此开发者有充裕的时间来解决这个问题。

// after
class MyComponent extends React.Component {
  componentDidMount() {
    this.input.focus();
  }

  render() {
    return <input ref={input => this.input = input} />;
  }
}

又例如,React19 决定要移出 ReactDOM.findDOMNode,这个 API 曾经在三方库中被大量使用,但是他已经在 2018 年 10 月被标记为废弃。由于他是一个性能较差,又容易受到重构影响,因此风险会比较大。

// Before
import {findDOMNode} from 'react-dom';

function AutoselectingInput() {
  useEffect(() => {
    const input = findDOMNode(this);
    input.select()
  }, []);

  return <input defaultValue="Hello" />;
}

在 React18 的版本中,提供了新的方案来替换该用法。

// After
function AutoselectingInput() {
  const ref = useRef(null);
  useEffect(() => {
    ref.current.select();
  }, []);

  return <input ref={ref} defaultValue="Hello" />
}

当然,其他的变化还有很多,我们就不一一列举,许多破坏性变更早在 React18 中就已经存在,因此对于长期维护的三方库而言,React19 的升级压力非常小。并且为了简化升级过程,React 发布了一个过渡版本 React 18.3,该版本功能与 React 18.2 相同,但是增加了对已弃用 API 代码的删除,并且调整了相关的警告。

目前,该过渡版本已经发布了刚好半个月,但已经被开发者大规模使用了。如下图所示,这个下载量,已经大概相当于 Vue 的整体使用水平了,所以整个行业对于 React19 的升级响应非常积极。

与此同时,我们还可以利用 react 团队之前发布的一个工具用于在代码中自动替换弃用的写法,他就是 react-codemod。

因此总体来说,我们应该可以轻松的在 react19 中应用大多数目前仍然保持维护的三方工具库。为了验证我的猜想,我在 React19 项目中引入了许多我正在使用的三方工具库来尝试。这里就以 react-markdown 为例,跟大家分享一下在新项目中的运用情况。

react-markdown 是 react 生态中,一个非常好用 的 md 文件解析工具。依据这个工具,我们可以轻松创建一个 md 编辑器。

如果你要设计一个个人博客,并且需要展示技术类文章,这个工具可以很好帮助到你。我们这里以展示一个高亮代码块为目标,分享引入过程。

首先我们在项目中,引入 react-markdown。

npm i react-markdown

有了这个之后,我们就可以在项目中解析一些简单的 md 格式。

例如,我们可以解析如下格式。

const input = '# This is a header\n\nAnd this is a paragraph'

在页面中引入 react-markdown。

import Markdown from 'react-markdown'

然后直接在 JSX 中使用即可。

<Markdown>{input}</Markdown>

渲染结果如下:

完了之后,有一些比较复杂的格式,react-markdown 可以引入不同的插件来支持。

例如,react-gfm,可以帮助我们解析列表等格式,如下所示:

const text2 = `A paragraph with *emphasis* and **strong importance**.

> A block quote with ~strikethrough~ and a URL: https://reactjs.org.

* Lists
* [ ] todo
* [x] done

A table:

| a | b |
| - | - |
`

安装插件。

npm i remark-gfm

然后直接在组件中使用即可。

import remarkGfm from 'remark-gfm'

// jsx
<Markdown remarkPlugins={[remarkGfm]}>
  {text2}
</Markdown>

渲染结果如下。由于我没有引入 css,因此样式比较原始。

我们可以通过查看 html 标签来查看渲染结果。验证之后发现已经渲染成功。

当然,如果我们要渲染代码快,也需要引入特定的插件,我这里使用了 rehype-highlight。

npm i rehype-highlight

安装好之后,我们可以专门在 .md 文件中编写好 md 内容,在 vite 项目中,可以直接通过如下方式引入 .md 文件。

import code from './code.md?raw'

然后在页面组件中使用。

import rehypeHighlight from 'rehype-highlight'

// jsx
<Markdown 
  remarkPlugins={[remarkGfm]} 
  rehypePlugins={[rehypeHighlight]}
>{code}</Markdown>

此时,我们观察页面,发现标签已经渲染好了。

但是此时我们还没有样式文件。当然,我们可以直接自己根据对应元素中的 class 名来写样式。

由于设计能力有限,我一般引用别人已经设计好的样式文件。

如下这个网站收集了大量的高亮风格,我们直接复制代码使用即可。

https://highlightjs.tiddlyhost.com

我选择了一个,把他单独写在一个 css 文件中,并引入对应的组件。渲染结果如下:

搞定!

总结

在我尝试了几个三方库之后,总体感受就是基本上都能正常在 React19 项目中使用,即使这些三方库还没有升级到 react19。当然我也把我某一个 React18 的项目升级到 React19,小幅度更改之后,也成功升级了。

因此我预计我们有希望在 react19 正式版本发布之后不久把项目正式升级。

但是,一个不太好的消息是,antd 由于使用了一些很早版本就弃用的方法,例如 findDOMNode,还有一些 React19 会弃用的 api, 例如 forwardRef,导致了 antd 一运行就各种报错。许多组件无法正常使用。这种就只能等 antd 适配进度了,他们应该会很快更新。

责任编辑:姜华 来源: 这波能反杀
相关推荐

2024-06-18 09:36:45

2022-03-25 08:31:09

ReactReact 18升级

2024-04-28 09:01:06

React 19更新前端

2024-02-20 07:44:43

2024-05-08 08:50:39

React19模式UI

2024-10-28 12:46:22

2011-09-27 09:13:16

Ubuntu 11.0

2024-02-22 17:54:30

React编译器团队

2021-06-03 09:31:56

React状态模式

2020-01-13 10:00:32

升级Windows 10Windows

2024-06-06 09:17:25

2021-06-08 09:35:11

Cleaner ReaReact开发React代码

2023-02-23 18:14:21

2024-05-11 09:38:05

React编译器React 19

2024-06-12 07:44:28

2023-04-07 15:12:46

ReactReact-Intl

2013-11-27 09:38:11

OpenSUSE 13OpenSUSE 12

2015-07-29 10:21:03

微软Windows 10升级

2018-06-13 16:38:33

React Nativ组件Android

2024-11-01 08:34:08

点赞
收藏

51CTO技术栈公众号