#打卡不停更#ArkUI eTS健康饮食APP之自定义PieChart组件 原创 精华

@toc

前言

        自上一篇 #打卡不停更#健康饮食APP分解 总体介绍显示健康饮食APP的效果，此帖详细介绍基于画布组件Canvas上，画一个饼图自定义组件，这里先来了解一下Canvas组件的属性和方法，下面先显示此帖子Demo的效果：

Canvas组件

        这里只是此自定义组件用到Canvas画布组件的关键属性，接口；要查看更多的关于Canvas参数接口，请移步到官方文档：https://developer.harmonyos.com/cn/docs/documentation/doc-references/ts-canvasrenderingcontext2d-0000001333720961

Demo介绍

        创建一个新的eTS文件，用来编写自定义PicChart组件，代码如下：

@Component
export struct CustomPieChart {
    // 饼图数据
    private picChartElements: PicChartElement[]
    // 圆半径
    @State circle_radius:number = 80
    // 单位
    @State unit: string = "克"
    // 获取上下文
    private settings: RenderingContextSettings = new RenderingContextSettings(true)
    private context: CanvasRenderingContext2D = new CanvasRenderingContext2D(this.settings)

    aboutToAppear() {
        let total = 0
        // 统计总数量
        this.picChartElements.forEach((value) => {
            total += value.quantity
        })

        // 初始化 弧线的终止弧度
        let lastEndAngle = -0.5 * Math.PI
        // 封装饼图数据
        this.picChartElements.forEach((value) => {
            // 占用百分比
            let percent = value.quantity / total
            // 四舍五入，获取整数
            value.percent = Math.round(percent * 100)
            // 初始化终止弧度为 弧线的起始弧度
            value.beginAngle = lastEndAngle
            // 计算弧线的终止弧度
            value.endAngle = (percent * 2 * Math.PI) + lastEndAngle
            // 赋值终止弧度为变量，作为下次的起始弧度
            lastEndAngle = value.endAngle
            // 返回封装好的对象
            return value
        })
    }

    build() {
        Column({space: 30}) {
            Canvas(this.context)
                // 高度为半径2倍
                .height(this.circle_radius * 2)
                // 纵横比，宽度和高度一样
                .aspectRatio(1)
                // 画布组件的事件回调，可以在此时进行绘制
                .onReady(() => {
                    this.picChartElements.forEach((item) => {
                        // 创建一个新的控制路径
                        this.context.beginPath()
                        // 路径从当前点移动到指定点
                        this.context.moveTo(this.circle_radius, this.circle_radius)
                        // 绘制弧线路径(弧线圆心的x坐标值,弧线圆心的y坐标值,弧线的圆半径,弧线的起始弧度,弧线的终止弧度)
                        this.context.arc(this.circle_radius, this.circle_radius, this.circle_radius, item.beginAngle, item.endAngle)
                        // 指定绘制的填充色
                        this.context.fillStyle = item.color
                        // 对封闭路径进行填充
                        this.context.fill()
                    })
                })
            Flex({direction: FlexDirection.Row, wrap: FlexWrap.Wrap, justifyContent: FlexAlign.SpaceAround}) {
                ForEach(this.picChartElements, (item: PicChartElement) => {
                    Row({ space: 4 }) {
                        // 标注圆点颜色
                        Circle({ width: 8, height: 8 }).fill(item.color)
                        // 标注文本
                        Text(item.element).fontSize(12)
                        // 标注数量
                        Text(item.quantity + ' ' + this.unit).fontSize(12)
                    }
                    .height(30)
                })
            }
            .width('100%')
        }
        .width('100%')
    }

}

export class PicChartElement {
    element: Resource | string  // 显示文本
    quantity: number            // 数量
    percent: number             // 百分比
    beginAngle: number          // 弧线的起始弧度
    endAngle: number            // 弧线的终止弧度
    color: string               // 颜色

    constructor(element: Resource | string, quantity: number, color: string) {
        this.element = element
        this.quantity = quantity
        this.color = color
    }
}

        通过import引用自定义PieChart组件到要使用的页面，创建Sample页面，根据PieChart数据实体类定义饼图数据源，文本，数量，颜色对象，饼图半径，显示单位可选，默认半径为80，单位为克。具体使用方法看Sample代码如下：

// 引用自定义组件
import { CustomPieChart, PicChartElement } from '../components/CustomPieChart'

@Entry
@Component
struct SampleCustomPicChart {
  // 饼图1数据
  private picChartElements: PicChartElement[] = [
    new PicChartElement('蛋白质', 14.9, '#ff9421'),
    new PicChartElement('脂肪', 39.8, '#ffd100'),
    new PicChartElement('碳水', 19.1, '#4cd041'),
    new PicChartElement('甜点', 9.1, '#4cd0ee'),
    new PicChartElement('海鲜', 11.1, '#999999')
  ]

  // 饼图2数据
  private picChartElements2: PicChartElement[] = [
    new PicChartElement('蛋白质', 5.9, '#ff9421'),
    new PicChartElement('脂肪', 9.8, '#ffd100'),
    new PicChartElement('碳水', 7.1, '#4cd041')
  ]

  build() {
    Column({ space: 10 }) {
      // 饼图1 (半径，单位使用默认值)
      CustomPieChart({picChartElements: this.picChartElements})
      // 饼图2 (半径指定为120， 单位指定为kcal)
      CustomPieChart({picChartElements: this.picChartElements2, circle_radius: 120, unit: 'kcal'})
    }
    .width('100%')
    .padding(30)
  }
}

总结

        通过此帖，可以简单学会自定义PieChart组件，如何引用使用，在健康饮食APP里，再次完成了一小部分内容，下来继续一个个组件完成，然后拼装就出来一个健康饮食APP了。