前端技术揭秘：React与SVG联手打造完美图形UI

发表时间: 2020-06-10 15:50

本文最初发布于 Data Language 网站，经网站授权由 InfoQ 中文站翻译并分享。

React 和 SVG 是一种强大的组合：声明式 UI 组件库与声明式图形语言堪称绝配，是前端开发人员的福音。

声明式图形

React 开发人员都很满意 JSX 中对 HTML 元素的一流支持：

复制代码

const SomeComponent = () => (  <div>    <p>hi!</p>  </div>);

但其实这也适用于内联 SVG 元素：

复制代码

const SomeComponent = () => (  <div>    <p>hi!</p>  </div>);

我们可以直接使用组成 SVG 图元的组件来创建复杂的交互式 UI，用法和更典型的基于 HTML 的组件是一样的。

针对 React-Native 开发人员的注释：你需要安装 react-native-svg，我上次用到它时看起来它挺不错的。我在几年前创建了一个简单但功能强大的示例：
https://stackoverflow.com/a/39041997/473338

声明式图形组件的简单组合（https://62zqd.csb.app/）

请注意，我们在绘制所有这些图形时都没有写过哪怕一行命令式代码，而且只要你熟悉 React，就可以很容易地阅读并理解我们的声明式标记。如果我们要用 Canvas API 来做的话，结果会相去甚远。

所有的元素都尽在掌握

要使用 SVG 绘制内容，我们首先需要一个 < svg> 元素来定义绘图上下文，在其中将渲染所有后代元素。

我们的页面中可以有很多 < svg> 元素，每个元素描述一个孤立的绘图上下文。每个图标、图表或其他漂亮的图形小部件都搭配一个 < svg>。

另外，我们可以在同一个 < svg> 中创建许多图形组件，并在单个绘图上下文中创建整个 UI。

Viewport 和 ViewBox

< svg> 元素至少应指定它要占据多大的屏幕空间，也就是它的 viewport（视口）。这可以通过 CSS 样式或 width 和 height 属性来完成。

复制代码

<svg width="200px" height="200px">...</svg>

我们一般也会指定一个 viewBox，以明确定义绘图的“用户空间”部分，这一部分在 viewport 中是可见的。

可以将 viewport 视为通向由 SVG（“用户空间”）定义的世界的窗口，并将 viewBox 视为缩放和平移的设置，它们决定你可以通过窗口看到用户空间的哪些部分。

viewBox 属性是一个字符串，其按顺序指定用户空间可视部分左上角的 x 和 y 坐标，以及 viewBox 的宽度和高度。

复制代码

<svg viewBox="x y width height">...</svg>

例如，“-100 -100 200 200”就描述了一个正方形的 viewBox，高 200 个单位，宽 200 个单位，以（0,0）的原点为中心。

复制代码

<svg width="10" height="10" viewBox="-100 -100 200 200">...</svg>

如果我们没有明确指定，则 viewBox 的宽度和高度会和 viewport 一比一对应，并且用户空间原点（0,0）位于左上角。

重申一下：viewport 描述了 < svg> 元素在 HTML 页面中占据了多少空间。viewBox 描述了在该 viewport 中可见的那部分图像。通过更改 viewBox，我们可以放大或缩小 SVG 图像，或者显示出来完全不同的部分。

这两张 SVG 图像的唯一区别是 viewBox 和背景色

如果你的 SVG viewport 的比例（以像素为单位）与 viewBox 的比例不匹配，则默认行为是保留宽高比，居中显示，并使 viewBox 适应可用 viewport。可以通过更改 prepareAspectRatio 属性来控制此行为。

默认情况下，viewBox 将居中并“适应”SVG viewport

viewBox 和 viewport 之间的坐标系是分离的，这意味着在我们的 SVG 中，我们可以针对特定的绘制使用对应的坐标。

例如，如果我们正在绘制一个交互式小部件，则可以使用百分比来控制图像，并将 viewBox 设置为“0 0 100 100”来简化数学运算。

或者，如果我们的小部件是纵向对称的，并且我们想从中心开始绘制，则可以使用一个以原点（0,0）为中心的“-50 -50 100 100”viewBox。

在这个文章系列中我们将绘制的是房间平面图，因此我们可以选择公制、英制或其他合适的度量系统。实际上我们要使用的是毫米单位，这样就可以只涉及整数运算了。

我们将使用一些简单的 JSON 描述平面图，房间的形状用房间各个角的坐标（按顺时针方向）来定义。

现在我们可以设置 viewport 和 viewBox，在平面图周围留一点空隙，以免在 viewport 中太过拥挤。

复制代码

import data from './floorplan-data.json';const App = () => (  <svg    width="500px"    height="500px"    viewBox="-1000 -1000 14000 11000"    style={{backgroundColor:'blue'}}  >    // ... floorplan components here ...  </svg>);

搞定 viewport 和 viewBox 后，就可以处理绘图工作了。

声明式图元

SVG 包含许多图元，既有简单的和，也有更灵活的。Mozilla Developer Network 有一篇参考资料介绍了这些可用元素。

形状可以被填充和 / 或描边。填充是在形状定义的边界内应用颜色，描边是对形状的轮廓应用颜色。描边的宽度和其他样式可以通过属性或 CSS 控制。

我们将使用两个简单的图元 < line> 和 < circle> 来绘制初始平面图。

< line> 描述一对 (x,y) 坐标之间的一条线段。

复制代码

<line x1={100} y1={100} x2={200} y2={200} stroke="red"/>

< circle> 描述一个以 (cx,cy) 为中心，半径为 r 的圆。

复制代码

<line x1={100} y1={100} x2={200} y2={200} stroke="red"/>

房间的视图

绘制我们的房间时，我们将数据传递到一个 Floorplan 组件中，该组件将渲染平面图的各种元素——一开始图上只有各个房间。

复制代码

const Floorplan = ({ data: { rooms } }) => (  rooms.map(r => <Room {...r} />));

要使用 Room 组件绘制墙壁，我们需要使用成对的连续角坐标，并将它们链接在一起以形成墙。例如，一个具有角 a、b、c 和 d 的矩形房间会有四面墙：(a-b),(b-c), (c-d), (d-a)。

我们可以使用一个简单的函数来提取这些坐标对，还可以把它们打包在一个 useMemo hook 中以实现高效的重渲染。

复制代码

const walls = useMemo(() =>  coords.map((_, i) => {    const a = coords[i];    const b = coords[(i + 1) % coords.length];    return [a, b];  }),  [coords]);

现在绘制墙壁时，只需使用 SVG 元素描述各个角之间的线段即可。