21 KiB
基础图形
上一篇《容器与坐标》讲的是怎么把元素摆到位置上:坐标从哪里来、loc 与锚点怎么配合、容器嵌套后子元素怎么算。位置有了,这一篇开始画东西。界面里的图形元素一共八种:矩形 g-rect、圆 g-circle、椭圆 g-ellipse、直线 g-line、三次贝塞尔 g-bezier、二次贝塞尔 g-quad、路径 g-path 和圆角矩形 g-rectr。
在逐个看图形之前,先弄清所有图形共用的填充、描边与颜色规则,后面每种图形的用法都建立在这套规则上。每种图形都有一个用数组传参的简写,日常写 UI 用简写最省事;逐个属性写的普通写法只在需要拆分或复用单个值时再用,下面每节只提一句。每种图形配一个 live,最后再把八种放在一起。
通用规则:填充、描边与颜色
图形有两种绘制模式:填充和描边。fill、stroke、strokeAndFill 是模式开关,值都是布尔值,不是颜色;颜色分别写在 fillStyle 与 strokeStyle 里。写 fill="#f00" 不会把图形变成红色,要写 fill fillStyle="#f00";默认填充的图形本来就不用写 fill。
每种图形有自己的默认模式:
| 图形 | 默认模式 |
|---|---|
g-rect / g-circle / g-ellipse / g-rectr / g-path |
填充 |
g-line / g-bezier / g-quad |
描边 |
默认填充的图形只写 fillStyle;默认描边的图形只写 strokeStyle。需要同时填充和描边时,写 fill 与 stroke:渲染时先填充、后描边,所以描边会覆盖 fill,边框完整地画在填充之上。strokeAndFill 是另一套顺序——先描边、后填充,fill 会覆盖描边,描边的内半边被填充盖住,边框看起来更细;strokeAndFill 优先级最高,写它会忽略 fill 与 stroke。
这里有个容易踩的地方:默认填充的图形只要写了 stroke、又没写过 fill,模式就会切换成只描边,原来的填充不再生效。也就是说,默认填充只在「没写 stroke、也没写 strokeAndFill」时成立。想同时填充和描边,必须显式写 fill + stroke,或者直接用 strokeAndFill。
// 默认填充的矩形只写 stroke:只画边框,不填充
<g-rect loc={[40, 40, 160, 100]} stroke strokeStyle="#58c4dd" lineWidth={4} />
// 想同时填充和描边:必须显式写 fill + stroke
<g-rect
loc={[240, 40, 160, 100]}
fill
stroke
fillStyle="#2f6fed"
strokeStyle="#e8f0ff"
lineWidth={4}
/>
这四种模式放在一起对照:
// 默认填充:颜色用 fillStyle
<g-rect loc={[40, 40, 120, 80]} fillStyle="#2f6fed" />
// 默认描边:颜色用 strokeStyle
<g-line line={[40, 160, 200, 160]} strokeStyle="#7ee787" />
// 同时填充与描边:先填充后描边,描边盖住 fill
<g-circle
circle={[300, 100, 50]}
fill
stroke
fillStyle="#58c4dd"
strokeStyle="#e8f0ff"
lineWidth={4}
/>
// 先描边后填充:fill 盖住描边,strokeAndFill 优先级最高
<g-rect
loc={[260, 180, 120, 80]}
strokeAndFill
fillStyle="#f2b84b"
strokeStyle="#141a22"
lineWidth={6}
/>
同一个矩形分别用四种模式,对照看边框和填充;重点对照 fill + stroke 与 strokeAndFill 的覆盖关系。
fillRule 只在填充路径时起作用,可选 nonzero 与 evenodd,具体在后面的路径一节展开。所有图形的默认颜色都是浅灰 #ddd;示例里通常显式写 fillStyle 或 strokeStyle。
描边细节
默认描边的图形,以及任何写了 stroke 的图形,都可以用下面这些属性控制描边:
| 属性 | 作用 | 常见值 |
|---|---|---|
lineWidth |
线宽,默认 2 |
2 / 6 / 12 |
lineDash |
虚线样式,数组按「实线长度、空白长度」交替 | [18, 10] |
lineDashOffset |
虚线起始偏移,改变虚线从哪里开始 | 0 / 12 |
lineCap |
端点样式,只影响线段两端 | butt / round / square |
lineJoin |
拐角样式,只影响线段连接处 | miter / round / bevel |
miterLimit |
尖角限制,miter 拐角过长时会被截断 |
默认 10 |
lineDash 的数组会按「画一段、空一段」交替;写 [18, 10] 就是画 18、空 10。超过两项时继续交替,例如 [16, 6, 2, 6] 是长线、空白、短线、空白,常用来画点划线。lineDashOffset 把整个虚线图案向后平移,可以做流动的虚线。
lineCap 只改变两个端点,lineJoin 只改变拐角,两者互不影响。miterLimit 只在 lineJoin="miter" 时有意义,尖角被拉得太长时会被切成斜角。
<g-line
line={[80, 80, 400, 80]}
strokeStyle="#7ee787"
lineWidth={6}
lineDash={[18, 10]}
lineDashOffset={4}
lineCap="round"
/>
<g-path
path={arrow}
stroke
strokeStyle="#58c4dd"
lineWidth={6}
lineJoin="miter"
miterLimit={8}
/>
这个 live 分四组对比:线宽、虚线、端点与拐角。
这些属性对所有描边图形通用:默认描边的直线、贝塞尔曲线能直接用,矩形、圆、椭圆、路径写了 stroke 之后也能用。例如给矩形加虚线描边:
<g-rect
loc={[40, 40, 180, 100]}
stroke
strokeStyle="#58c4dd"
lineWidth={6}
lineDash={[12, 8]}
/>
矩形 g-rect
矩形用 loc 简写,四个值依次是左上角 x、左上角 y、宽度、高度。矩形默认填充,颜色用 fillStyle。也可以把四个值拆成 x、y、width、height 分别写,效果一样。
<g-rect loc={[80, 80, 240, 140]} fillStyle="#2f6fed" />
这个 live 里放了四组参数,分别对比 loc 不同时的位置与宽高。
矩形默认锚点在左上角,所以前两个值是左上角的位置。想改锚点时,可以把 loc 写成六个值,最后两项是 anchorX、anchorY;也可以单独写 anchorX / anchorY。例如把锚点改成 0.5 后,前两个值就变成矩形中心。
// 锚点在中心:前两个值是矩形中心坐标
<g-rect loc={[240, 160, 120, 80, 0.5, 0.5]} fillStyle="#2f6fed" />
g-rect 本身没有圆角参数,需要圆角时用后面的 g-rectr。
圆 g-circle
圆用 circle 简写,三个值依次是圆心 x、圆心 y、半径。圆默认填充,颜色用 fillStyle。也可以写 x、y、radius,效果一样。
<g-circle circle={[240, 170, 80]} fillStyle="#58c4dd" />
这个 live 上排放三个整圆对比半径,下排三个圆弧分别用 fill、stroke、fill+stroke 三种模式,start / end 只控制角度;标签上写的是度数,代码里按弧度写。
circle 还能写五个值:[圆心 x, 圆心 y, 半径, 起始角度, 终止角度],这时画的是从起始角到终止角的圆弧。start / end 的单位是弧度,不是度数;0 指向右侧,角度增大沿顺时针方向。live 标签用度数只是为了好读,代码里仍要换算成弧度:
| 度数 | 弧度 |
|---|---|
0° |
0 |
90° |
π / 2 |
180° |
π |
270° |
1.5π |
360° |
2π |
圆弧也按填充 / 描边两种模式画:默认填充,start 与 end 之间的圆弧和两端连线围成的区域会被填满,颜色用 fillStyle;只想看弧线时写 stroke,颜色改用 strokeStyle;两者都要就同时写 fill 和 stroke,fillStyle 与 strokeStyle 分别给色。
// 完整圆
<g-circle circle={[120, 100, 60]} fillStyle="#58c4dd" />
// 圆弧 0° → 180°:默认填充,弧与两端连线围成的区域被填满
<g-circle circle={[320, 100, 60, 0, Math.PI]} fillStyle="#58c4dd" />
// 同一个圆弧只描边:写 stroke,颜色改用 strokeStyle
<g-circle
circle={[320, 100, 60, 0, Math.PI]}
stroke
strokeStyle="#58c4dd"
lineWidth={4}
/>
// 填充与描边都要:同时写 fill 和 stroke,两种颜色分别给
<g-circle
circle={[320, 100, 60, 0, Math.PI]}
fill
stroke
fillStyle="#58c4dd"
strokeStyle="#e8f0ff"
lineWidth={3}
/>
椭圆 g-ellipse
椭圆用 ellipse 简写,四个值依次是圆心 x、圆心 y、横向半径 rx、纵向半径 ry。椭圆默认填充。也可以写 x、y、radiusX、radiusY。
<g-ellipse ellipse={[240, 170, 130, 70]} fillStyle="#c58af9" />
这个 live 上排放三个整椭圆对比 rx / ry,下排三个部分椭圆分别用 fill、stroke、fill+stroke 三种模式,start / end 只控制角度;标签上写的是度数,代码里按弧度写。
ellipse 还能写六个值:[圆心 x, 圆心 y, 横向半径, 纵向半径, 起始角度, 终止角度],用来画部分椭圆。角度规则与圆相同:start / end 用弧度,不是度数,0 指向右侧,角度增大沿顺时针方向;换算见上面的度数对照表。部分椭圆也按填充 / 描边两种模式画:默认填充,圆弧与两端连线围成的区域会被填满,颜色用 fillStyle;只想看弧线时写 stroke,颜色改用 strokeStyle;两者都要就同时写 fill 和 stroke,fillStyle 与 strokeStyle 分别给色。
// 完整椭圆
<g-ellipse ellipse={[120, 100, 70, 40]} fillStyle="#c58af9" />
// 部分椭圆 180° → 360°:默认填充
<g-ellipse
ellipse={[330, 100, 80, 45, Math.PI, Math.PI * 2]}
fillStyle="#c58af9"
/>
// 同一个部分椭圆只描边:写 stroke,颜色改用 strokeStyle
<g-ellipse
ellipse={[330, 100, 80, 45, Math.PI, Math.PI * 2]}
stroke
strokeStyle="#c58af9"
lineWidth={4}
/>
// 填充与描边都要:同时写 fill 和 stroke,两种颜色分别给
<g-ellipse
ellipse={[330, 100, 80, 45, Math.PI, Math.PI * 2]}
fill
stroke
fillStyle="#c58af9"
strokeStyle="#e8f0ff"
lineWidth={3}
/>
直线 g-line
直线用 line 简写,四个值依次是两个端点 x1、y1、x2、y2。直线默认描边,strokeStyle 给颜色,lineWidth 给线宽。也可以逐个写 x1、y1、x2、y2。
<g-line line={[80, 240, 400, 100]} strokeStyle="#7ee787" lineWidth={6} />
这个 live 里放了四组参数,分别对比端点、lineWidth、lineDash 与颜色。
直线是最简单的描边图形,描边细节一节讲的 lineDash、lineDashOffset、lineCap 都能直接写在 g-line 上。lineCap 只改变两个端点,虚线则从起点开始按 lineDash 交替。
<g-line
line={[80, 200, 400, 200]}
strokeStyle="#f2b84b"
lineWidth={10}
lineDash={[18, 10]}
lineCap="round"
/>
三次贝塞尔 g-bezier
三次贝塞尔用 curve 简写,八个值依次是起点 sx、sy,第一个控制点 cp1x、cp1y,第二个控制点 cp2x、cp2y,终点 ex、ey。曲线默认描边,strokeStyle 与 lineWidth 控制颜色和粗细。也可以逐个写这八个属性。
<g-bezier
curve={[80, 240, 140, 70, 340, 250, 400, 100]}
strokeStyle="#f2b84b"
lineWidth={4}
/>
这个 live 里放了四组曲线,分别对比控制点靠近、拉远、交叉与 S 形;白点是控制点,虚线是起点 → cp1 → cp2 → 终点的控制多边形。
起点与终点决定曲线两端,两个控制点决定中间的弯曲:第一个控制点主要拉住起点附近的走向,第二个控制点主要拉住终点附近的走向。控制点离端点越远,曲线被拉得越开;两个控制点分居曲线两侧时会出现 S 形。
二次贝塞尔 g-quad
二次贝塞尔用 curve 简写,六个值依次是起点 sx、sy,控制点 cpx、cpy,终点 ex、ey。曲线默认描边。也可以逐个写这六个属性。
<g-quad
curve={[90, 230, 240, 80, 390, 230]}
strokeStyle="#58c4dd"
lineWidth={4}
/>
这个 live 里放了四组曲线,分别对比控制点在上、下、左、右;白点是控制点,虚线是起点 → 控制点 → 终点的控制多边形。
二次曲线只有一个控制点,它同时影响起点与终点两侧的走向,曲线在控制点方向达到最大弯曲。控制点离两个端点越远,弧线越鼓;做简单的弧线或装饰够用。
路径 g-path
路径用 path 属性,值是一个 Path2D。Path2D 是浏览器自带的全局构造器,直接 new Path2D() 即可,不需要 import。路径默认填充;只想画线时写 stroke。路径坐标相对元素自身,元素默认在父容器的原点,所以不写 x / y 时,坐标看起来就是从父容器原点开始。
// Path2D 是浏览器全局对象,直接 new
const badge = new Path2D();
badge.moveTo(240, 80);
badge.lineTo(340, 140);
badge.lineTo(315, 255);
badge.lineTo(165, 255);
badge.lineTo(140, 140);
badge.closePath();
// 默认填充:给颜色即可
<g-path path={badge} fillStyle="#7ee787" />;
// 只想画轮廓:写 stroke
<g-path path={badge} stroke strokeStyle="#7ee787" lineWidth={3} />;
// 自交或多段重叠时,用 fillRule 指定填充规则
<g-path path={badge} fillStyle="#7ee787" fillRule="evenodd" />;
这个 live 里放了三个路径,分别对比折线、闭合填充与圆弧。
moveTo 决定从哪里开始,lineTo 连到下一个点,closePath 把最后一点连回起点。路径可以有多段;arc 画圆弧,bezierCurveTo 画三次贝塞尔。开放路径通常写 stroke,闭合路径适合填充;有自交或多段重叠时,用 fillRule 决定哪些区域算内部:nonzero 按环绕方向,evenodd 按奇偶,默认是 nonzero。
同一个 Path2D 可以交给多个 g-path 复用;但 Path2D 不能序列化,不能直接放进存档。需要保存路径时,保存构造它用到的点或参数,读档后重新构造。
圆角矩形 g-rectr
圆角矩形用 g-rectr。g-rect 没有圆角参数,需要圆角时换用 g-rectr。圆角用 circle 或 ellipse 简写:circle 给圆形圆角,ellipse 给椭圆圆角。
circle 可以写 1 到 4 项,按项数决定每个角用哪个半径:
- 1 项
[r1]:四个角都用r1。 - 2 项
[r1, r2]:左上、右下用r1,右上、左下用r2。 - 3 项
[r1, r2, r3]:左上用r1,右上和左下用r2,右下用r3。 - 4 项
[r1, r2, r3, r4]:依次对应左上、右上、右下、左下。
ellipse 每两个值为一组(横向半径、纵向半径),按组数决定每个角用哪一组:
- 2 项
[rx1, ry1]:四个角都用这一组。 - 4 项
[rx1, ry1, rx2, ry2]:左上、右下用第 1 组,右上、左下用第 2 组。 - 6 项
[rx1, ry1, rx2, ry2, rx3, ry3]:左上用第 1 组,右上和左下用第 2 组,右下用第 3 组。 - 8 项
[rx1, ry1, rx2, ry2, rx3, ry3, rx4, ry4]:依次对应左上、右上、右下、左下,每组两个值。
只想让某几个角是圆角时,把不需要的角写成 0。
// 四个角同样圆
<g-rectr loc={[30, 70, 120, 90]} circle={[24]} fillStyle="#2f6fed" />
// 依次左上、右上、右下、左下
<g-rectr
loc={[180, 70, 120, 90]}
circle={[36, 0, 36, 0]}
fillStyle="#58c4dd"
/>
// 椭圆圆角:横向与纵向半径不同
<g-rectr
loc={[330, 70, 120, 90]}
ellipse={[48, 24]}
fillStyle="#c58af9"
/>
这个 live 里放了四组圆角参数,分别对比一项半径、四项半径、椭圆圆角与大半径。
圆角矩形默认填充;圆角半径超过宽高一半时会被限制在宽高的一半以内,不会画到矩形外面。
所有图形的组合
把八种图形放进同一个标准 container,用 FULL_LOC 铺满整块 UI。下面是一段完整 TSX;路径先构造一次 Path2D,再交给 g-path。
const badge = new Path2D();
badge.moveTo(300, 205);
badge.lineTo(345, 230);
badge.lineTo(333, 280);
badge.lineTo(267, 280);
badge.lineTo(255, 230);
badge.closePath();
<container loc={FULL_LOC}>
<g-rect loc={FULL_LOC} fillStyle="#141a22" />
<text loc={[24, 14]} text="八种图形" fillStyle="#e8f0ff" />
{/* 上排:矩形、圆、椭圆、直线 */}
<g-rect loc={[20, 72, 80, 62]} fillStyle="#2f6fed" />
<g-circle circle={[180, 103, 34]} fillStyle="#58c4dd" />
<g-ellipse ellipse={[300, 103, 50, 32]} fillStyle="#c58af9" />
<g-line line={[370, 133, 460, 75]} strokeStyle="#7ee787" lineWidth={4} />
{/* 下排:三次贝塞尔、二次贝塞尔、路径、圆角矩形 */}
<g-bezier
curve={[20, 275, 45, 205, 80, 280, 105, 212]}
strokeStyle="#f2b84b"
lineWidth={4}
/>
<g-quad
curve={[140, 270, 180, 205, 220, 270]}
strokeStyle="#58c4dd"
lineWidth={4}
/>
<g-path path={badge} fillStyle="#7ee787" />
<g-rectr loc={[370, 215, 80, 62]} circle={[24]} fillStyle="#f2b84b" />
{/* 每个图形的短标签 */}
<text loc={[44, 146]} text="矩形" fillStyle="#cfe0ff" />
<text loc={[170, 146]} text="圆" fillStyle="#cfe0ff" />
<text loc={[285, 146]} text="椭圆" fillStyle="#cfe0ff" />
<text loc={[405, 146]} text="直线" fillStyle="#cfe0ff" />
<text loc={[20, 292]} text="三次贝塞尔" fillStyle="#cfe0ff" />
<text loc={[140, 292]} text="二次贝塞尔" fillStyle="#cfe0ff" />
<text loc={[290, 292]} text="路径" fillStyle="#cfe0ff" />
<text loc={[380, 292]} text="圆角矩形" fillStyle="#cfe0ff" />
</container>;
这段代码里每种图形只出现一次,位置按 4×2 排开;换成自己的布局时,改各自的 loc、圆心或端点即可。
默认值与注意
- 圆与椭圆的默认锚点是
0.5,x/y指圆心;矩形与容器的默认锚点是0,x/y指左上角。 curve数组长度写错不会报错,只会画出错误形状:三次贝塞尔要 8 个值,二次贝塞尔要 6 个值。lineDash建议写偶数项;写奇数项时浏览器会自动复制一份再交替,容易看不出规律。- 默认填充只在没写
stroke时生效:给默认填充的图形加stroke会变成只描边,要同时填充和描边就显式写fill+stroke。
下一篇《文字》讲怎么在图形旁边写字:内容、字体、颜色与简单排版。