Files
template/docs/render-guide/basics/basic-shapes.md

21 KiB
Raw Permalink Blame History

基础图形

上一篇《容器与坐标》讲的是怎么把元素摆到位置上:坐标从哪里来、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、圆心或端点即可。

<script setup> import RenderDemo from '../../.vitepress/components/renderDemo.vue'; const modesLoader = () => import('../../.vitepress/components/demos/ui/shapes-modes.tsx'); const strokeLoader = () => import('../../.vitepress/components/demos/ui/shapes-stroke.tsx'); const rectLoader = () => import('../../.vitepress/components/demos/ui/shapes-rect.tsx'); const circleLoader = () => import('../../.vitepress/components/demos/ui/shapes-circle.tsx'); const ellipseLoader = () => import('../../.vitepress/components/demos/ui/shapes-ellipse.tsx'); const lineLoader = () => import('../../.vitepress/components/demos/ui/shapes-line.tsx'); const bezierLoader = () => import('../../.vitepress/components/demos/ui/shapes-bezier.tsx'); const quadLoader = () => import('../../.vitepress/components/demos/ui/shapes-quad.tsx'); const pathLoader = () => import('../../.vitepress/components/demos/ui/shapes-path.tsx'); const rectrLoader = () => import('../../.vitepress/components/demos/ui/shapes-rectr.tsx'); const allLoader = () => import('../../.vitepress/components/demos/ui/shapes-all.tsx'); </script>

默认值与注意

  • 圆与椭圆的默认锚点是 0.5,x / y 指圆心;矩形与容器的默认锚点是 0,x / y 指左上角。
  • curve 数组长度写错不会报错,只会画出错误形状:三次贝塞尔要 8 个值,二次贝塞尔要 6 个值。
  • lineDash 建议写偶数项;写奇数项时浏览器会自动复制一份再交替,容易看不出规律。
  • 默认填充只在没写 stroke 时生效:给默认填充的图形加 stroke 会变成只描边,要同时填充和描边就显式写 fill + stroke。

下一篇《文字》讲怎么在图形旁边写字:内容、字体、颜色与简单排版。