React高级开发技巧(前端福音为什么使用)
React高级开发技巧(前端福音为什么使用)https://stackoverflow.com/a/39041997/473338针对 React-Native 开发人员的注释:你需要安装 react-native-svg,我上次用到它时看起来它挺不错的。我在几年前创建了一个简单但功能强大的示例:const SomeComponent = () => ( <div> <p>hi!</p> </div>);但其实这也适用于内联 SVG 元素:复制代码const SomeComponent = () => ( <div> <p>hi!</p> </div>);我们可以直接使用组成 SVG 图元的组件来创建复杂的交互式 UI,用法和更典型的基于 HTML 的组件是一样的。
本文最初发布于 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 元素描述各个角之间的线段即可。
效果是可以了,但代码不是很漂亮。我们来点创新,提取一个 Wall 组件和一个 Corner 组件。
在 Wall 组件中,我们现在给每面墙绘制两条线:首先是一条粗的白线,然后用一条较细的深蓝色虚线覆盖白线。
Corner 非常简单:只画一个圆,描边为白色,深蓝色填充。
现在,Room 组件里就只有这些更高级别的 Wall 和 Corner 组件,替代之前的一堆 SVG 图元,简洁多了。
你可能注意到了,我们将墙和角嵌套在了一个 SVG 元素中。这是一个逻辑分组元素:本身不会渲染任何可见内容,但是它为我们提供了一种在 SVG 的整个子结构上执行旋转和平移之类变换的巧妙方法;我们还可以将事件处理程序附加到元素,进而从这些子结构中捕获事件。
小结
在这篇文章中,我们看到了:
- 我们可以使用 SVG 图元和简单明了的声明式 React 代码轻松地绘制任意形状——无需插件、库或命令式代码。
- 就像其他 React 应用程序一样,可以将越来越高级的组件组合在一起来构建复杂的图形 UI。
- viewBox 和 viewport 的分离使你可以在适合自己需求的坐标空间中绘制图像,然后在适合最终显示需求的 viewport 中渲染结果。