【HarmonyOS之旅】基于ArkTS开发(三) -＞兼容JS的类Web开发(五) -＞ Svg

枫叶丹

发布于 2025-02-24 08:28:02

5600

代码可运行

文章被收录于专栏：C++C++

运行总次数：0

代码可运行

1 -> 基础知识

Svg组件主要作为svg画布的根节点使用，也可以在svg中嵌套使用。

说明

从API version 7开始支持。
svg父组件或者svg组件需要定义宽高值，否则不进行绘制。

1.1 -> 创建Svg组件

在pages/index目录下的hml文件中创建一个Svg组件。

<!-- test.hml -->
<div class="container">
  <svg width="400" height="400">  </svg>
</div>

/* test.css */
.container{
  width: 100%;
  height: 100%;
  flex-direction: column;
  align-items: center;
  justify-content: center;
  background-color: #F1F3F5;
}
svg{
  background-color: blue;
}

1.2 -> 设置属性

通过设置width、height、x、y和viewBox属性为Svg设置宽度、高度、x轴坐标、y轴坐标和Svg视口。

<!-- test.hml -->
<div class="container">
  <svg width="400" height="400" viewBox="0 0 100 100">    <svg class="rect" width="100" height="100" x="20" y="10">    </svg>  </svg>
</div>

/* test.css */
.container{
  width: 100%;
  height: 100%;
  flex-direction: column;
  align-items: center;
  justify-content: center;
  background-color: #F1F3F5;
}
svg{
  background-color: yellow;
}
.rect{
  background-color: red;
}

说明

x和y设置的的是当前Svg的x轴和y轴坐标，如果当前Svg为根节点，x轴和y轴属性无效。
viewBox的宽高和svg的宽高不一致，会以中心对齐进行缩放。

2 -> 绘制图形

Svg组件可以用来绘制常见图形和线段，如矩形(<rect>)、圆形(<circle>)、线条(<line>)等。

在本场景中，绘制各种图形拼接组成一个小房子。

<!-- test.hml -->
<div class="container">
  <svg width="1000" height="1000">
    <polygon points="100,400 300,200 500,400" fill="red"></polygon>     //屋顶
    <polygon points="375,275 375,225 425,225 425,325" fill="orange"></polygon>   //烟囱
    <rect width="300" height="300" x="150" y="400" fill="orange">      //房子
    </rect>
    <rect width="100" height="100" x="180" y="450" fill="white">    //窗户
    </rect>
    <line x1="180" x2="280" y1="500" y2="500" stroke-width="4" fill="white" stroke="black"></line>     //窗框
    <line x1="230" x2="230" y1="450" y2="550" stroke-width="4" fill="white" stroke="black"></line>     //窗框
    <polygon points="325,700 325,550 400,550 400,700" fill="red"></polygon>     //门
    <circle cx="380" cy="625" r="20" fill="black"></circle>      //门把手
  </svg>
</div>

/* test.css */
.container {
  width: 100%;
  height: 100%;
  flex-direction: column;
  justify-content: center;
  align-items: center;
  background-color: #F1F3F5;
}

3 -> 绘制路径

Svg组件绘制路径时，通过Path中的M(起点)、H(水平线)、a(绘制弧形到指定位置)路径控制指令，并填充颜色实现饼状图效果。

<!-- test.hml -->
<div class="container">
  <svg fill="#00FF00" x="100" y="400">
    <path d="M300,200 h-150 a150 150 0 1 0 150 -150 z" fill="red" stroke="blue" stroke-width="5" >    </path> <path d="M275,175 v-150 a150 150 0 0 0 -150 150 z" fill="yellow" stroke="blue" stroke-width="5">    </path>
  </svg>
</div>

/* test.css */
.container {
  flex-direction: row;
  justify-content: flex-start;
  align-items: flex-start;
  height: 1200px;
  width: 600px;
  background-color: #F1F3F5;
}

说明

M/m = moveto参数x和y表示需要移动到点的x轴和y轴的坐标。在使用M命令移动画笔后，只会移动画笔，但不会在两点之间画线。所以M命令经常出现在路径的开始处，用来指明从何处开始画。
L/l = lineto参数x和y表示一个点的x轴和y轴坐标，L命令将会在当前位置和新位置(L前面画笔所在的点)之间画一条线段。
H/h = horizontal lineto绘制平行线。
V/v = vertical lineto绘制垂直线。
C/c = curveto三次贝塞尔曲线设置三组坐标参数： x1 y1, x2 y2, x y。
S/s = smooth curveto三次贝塞尔曲线命令设置两组坐标参数： x2 y2, x y。
Q/q = quadratic Belzier curve二次贝塞尔曲线设置两组坐标参数： x1 y1, x y。
T/t = smooth quadratic Belzier curveto二次贝塞尔曲线命令设置参数： x y。
A/a = elliptical Arc弧形命令设置参数： rx ry x-axis-rotation(旋转角度)large-arc-flag(角度大小）)sweep-flag(弧线方向)x y。large-arc-flag决定弧线是大于还是小于180度，0表示小角度弧，1表示大角度弧。sweep-flag表示弧线的方向，0表示从起点到终点沿逆时针画弧，1表示从起点到终点沿顺时针画弧。
Z/z = closepath从当前点画一条直线到路径的起点。

4 -> 绘制文本

Svg组件还可以绘制文本。

4.1 -> 文本

说明

文本的展示内容需要写在元素标签text内，可嵌套tspan子元素标签分段。
只支持被父元素标签svg嵌套。
只支持默认字体sans-serif。

通过设置x(x轴坐标)、y(y轴坐标)、dx(文本x轴偏移)、dy(文本y轴偏移)、fill(字体填充颜色)、stroke(文本边框颜色)、stroke-width(文本边框宽度)等属性实现文本的不同展示样式。

<!-- test.hml -->
<div class="container">
  <svg>
    <text x="200" y="300" font-size="80px" fill="blue" >Hello World</text>    <text x="200" y="300" dx="20" dy="80" font-size="80px" fill="blue" fill-opacity="0.5" stroke="red" stroke-width="2">Hello World</text>
    <text x="20" y="550" fill="#D2691E">
      <tspan dx="40" fill="red" font-size="80" fill-opacity="0.4">Hello World </tspan>
    </text>
  </svg>
</div>

4.2 -> 沿路径绘制文本

textpath文本内容沿着属性path中的路径绘制文本。

<!-- test.hml -->
<div class="container">
  <svg fill="#00FF00" x="100" y="400">
    <path d="M40,360 Q360,360 360,180 Q360,20 200,20 Q40,40 40,160 Q40,280 180,180 Q180,180 200,100" stroke="red" fill="none"></path>
      <text>
        <textpath fill="blue" startOffset="20%" path="M40,360 Q360,360 360,180 Q360,20 200,20 Q40,40 40,160 Q40,280 180,180 Q180,180 200,100" font-size="30px">
          This is textpath test.
        </textpath>
      </text>
  </svg>
</div>