CanvasRenderingContext2D是Canvas组件的2D绘图上下文对象,用于在Canvas组件上进行自定义绘图。支持绘制形状(矩形、圆形、椭圆、路径等)、文本、图片、渐变、阴影等多种绘制类型,适用于数据可视化、游戏开发、图像编辑、自定义UI绘制等场景。通过该对象,开发者可以灵活控制绘制过程,实现复杂的2D图形效果。
本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
建议使用时将CanvasRenderingContext2D对象与Canvas组件封装到同一个自定义组件中,保证两者一一对应且生命周期保持一致。
本文绘制接口在调用时会存入被关联的Canvas组件的指令队列中。仅当当前帧进入渲染阶段且关联的Canvas组件处于可见状态时,这些指令才会从队列中被提取并执行。因此,在Canvas组件不可见的情况下,应尽量避免频繁调用绘制接口,以防止指令在队列中堆积,从而避免内存占用过大的问题,具体示例请参考控制在画布组件不可见时不进行绘制。
beginPath、moveTo、lineTo、closePath、bezierCurveTo、quadraticCurveTo、arc、arcTo、ellipse、rect和roundRect接口只能对CanvasRenderingContext2D中的路径生效,无法对OffscreenCanvasRenderingContext2D和Path2D对象中设置的路径生效。
Canvas组件的宽或高超过8000px时使用CPU渲染,会导致性能明显下降,此时推荐使用自定义渲染节点 (RenderNode)。
图形变换接口(rotate、scale、transform、setTransform、translate)与getPixelMap/getImageData/toDataURL接口在不同帧执行时,后者创建出来的内容没有图形变换效果。
constructor(settings?: RenderingContextSettings)
构造Canvas画布对象,支持配置CanvasRenderingContext2D对象的参数。
建议使用时将CanvasRenderingContext2D对象与Canvas组件封装到同一个自定义组件中,保证两者一一对应且生命周期保持一致。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| settings | RenderingContextSettings | 否 | 用于配置CanvasRenderingContext2D对象的参数,当需要开启抗锯齿等高级配置时传入此参数,不传入时使用默认配置(不开启抗锯齿)。见RenderingContextSettings。 异常值undefined和null按RenderingContextSettings的默认值处理。 |
constructor(settings?: RenderingContextSettings, unit?: LengthMetricsUnit)
构造Canvas画布对象,支持配置CanvasRenderingContext2D对象的参数和单位模式。
建议使用时将CanvasRenderingContext2D对象与Canvas组件封装到同一个自定义组件中,保证两者一一对应且生命周期保持一致。
卡片能力: 从API version 12开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| settings | RenderingContextSettings | 否 | 用于配置CanvasRenderingContext2D对象的参数,当需要开启抗锯齿等高级配置时传入此参数,不传入时使用默认配置(不开启抗锯齿)。见RenderingContextSettings。 异常值undefined和null按RenderingContextSettings的默认值处理。 |
| unit | LengthMetricsUnit | 否 | 用于配置CanvasRenderingContext2D对象的单位模式,配置后无法更改。DEFAULT(默认vp单位,适合大多数场景)、PX(px像素单位,适合需要精确像素控制的场景)。 异常值undefined、NaN和Infinity按默认值处理。 默认值:DEFAULT |
示例:
以下示例展示了配置CanvasRenderingContext2D对象的单位模式,默认单位模式为LengthMetricsUnit.DEFAULT,对应默认单位vp,配置后无法动态更改。详细说明见LengthMetricsUnit。
// xxx.ets
import { LengthMetricsUnit } from '@kit.ArkUI'
@Entry
@Component
struct LengthMetricsUnitDemo {
private settings: RenderingContextSettings = new RenderingContextSettings(true);
private contextPX: CanvasRenderingContext2D = new CanvasRenderingContext2D(this.settings, LengthMetricsUnit.PX);
private contextVP: CanvasRenderingContext2D = new CanvasRenderingContext2D(this.settings);
build() {
Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
Canvas(this.contextPX)
.width('100%')
.height(150)
.backgroundColor('#ffff00')
.onReady(() => {
// 使用px单位模式绘制图形
this.contextPX.fillRect(10, 10, 100, 100)
this.contextPX.clearRect(10, 10, 50, 50)
})
Canvas(this.contextVP)
.width('100%')
.height(150)
.backgroundColor('#ffff00')
.onReady(() => {
this.contextVP.fillRect(10, 10, 100, 100)
this.contextVP.clearRect(10, 10, 50, 50)
})
}
.width('100%')
.height('100%')
}
} 
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| width | number | 是 | 否 | CanvasRenderingContext2D的组件宽度。 默认单位:vp 卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
| height | number | 是 | 否 | CanvasRenderingContext2D的组件高度。 默认单位:vp 卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
| canvas13+ | FrameNode | 是 | 否 | 获取和CanvasRenderingContext2D关联的Canvas组件的FrameNode实例,可用于监听关联的Canvas组件的可见状态。 默认值:null 元服务API: 从API version 13开始,该接口支持在元服务中使用。 模型约束: 此接口仅可在Stage模型下使用。 |
toDataURL(type?: string, quality?: any): string
生成一个包含图片展示的URL,该接口存在内存拷贝行为,高耗时,应避免频繁使用。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | string | 否 | 用于指定图像格式。 可选参数为:"image/png"(无损压缩,适合需要精确像素的场景)、"image/jpeg"(有损压缩,适合照片类图像)、"image/webp"(高效压缩,适合网络传输场景)。 异常值undefined或null按默认值处理。 默认值:image/png |
| quality | any | 否 | 在指定图片格式为image/jpeg或image/webp的情况下,可以从0到1的区间内选择图片的质量,0-0.5适合快速传输或低带宽场景,0.6-0.8适合普通场景,0.9-1.0适合高质量需求。如果超出取值范围,将会使用默认值0.92。 异常值undefined、null、NaN和Infinity按默认值处理。 默认值:0.92 |
返回值:
| 类型 | 说明 |
|---|---|
| string | 图像的URL地址。 |
示例:
// xxx.ets
@Entry
@Component
struct CanvasExample {
private settings: RenderingContextSettings = new RenderingContextSettings(true)
private context: CanvasRenderingContext2D = new CanvasRenderingContext2D(this.settings)
@State toDataURL: string = ""
build() {
Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
Canvas(this.context)
.width(100)
.height(100)
.onReady(() =>{
this.context.fillStyle = "#00ff00"
this.context.fillRect(0,0,100,100)
// 生成PNG格式的图像URL
this.toDataURL = this.context.toDataURL("image/png", 0.92)
})
Text(this.toDataURL)
}
.width('100%')
.height('100%')
.backgroundColor('#ffff00')
}
} 
on(type: 'onAttach', callback: Callback<void>): void
订阅CanvasRenderingContext2D与Canvas组件发生绑定的场景。
元服务API: 从API version 13开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | string | 是 | 订阅CanvasRenderingContext2D与Canvas组件发生绑定的事件类型,固定为'onAttach'。 异常值undefined或null按无效值处理。 |
| callback | Callback<void> | 是 | 订阅CanvasRenderingContext2D与Canvas组件发生绑定后触发的回调。 异常值undefined或null按无效值处理。 |
错误码:
以下错误码的详细介绍请参见通用错误码。
| 错误码ID | 错误信息 |
|---|---|
| 401 | Input parameter error. Possible causes: 1. Mandatory parameters are left unspecified;2. Incorrect parameter types;3. Parameter verification failed. |
on(type: 'onDetach', callback: Callback<void>): void
订阅CanvasRenderingContext2D与Canvas组件解除绑定的场景。
元服务API: 从API version 13开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | string | 是 | 订阅CanvasRenderingContext2D与Canvas组件解除绑定的事件类型,固定为'onDetach'。 异常值undefined或null按无效值处理。 |
| callback | Callback<void> | 是 | 订阅CanvasRenderingContext2D与Canvas组件解除绑定后触发的回调。 异常值undefined或null按无效值处理。 |
错误码:
以下错误码的详细介绍请参见通用错误码。
| 错误码ID | 错误信息 |
|---|---|
| 401 | Input parameter error. Possible causes: 1. Mandatory parameters are left unspecified;2. Incorrect parameter types;3. Parameter verification failed. |
当CanvasRenderingContext2D对象和Canvas组件解除绑定时,会触发'onDetach'回调,表示应停止绘制行为。
触发'onDetach'回调的一般场景:
Canvas组件销毁时解除绑定CanvasRenderingContext2D对象;
CanvasRenderingContext2D对象新绑定一个Canvas组件,会先解除已有的绑定。
off(type: 'onAttach', callback?: Callback<void>): void
取消订阅CanvasRenderingContext2D与Canvas组件发生绑定的场景。
元服务API: 从API version 13开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | string | 是 | 取消订阅CanvasRenderingContext2D与Canvas组件发生绑定的事件类型,固定为'onAttach'。 异常值undefined或null按无效值处理。 |
| callback | Callback<void> | 否 | 为空表示取消所有订阅CanvasRenderingContext2D与Canvas组件发生绑定后触发的回调。 非空则取消订阅发生绑定对应的回调。 异常值undefined或null按无效值处理。 |
错误码:
以下错误码的详细介绍请参见通用错误码。
| 错误码ID | 错误信息 |
|---|---|
| 401 | Input parameter error. Possible causes: 1. Mandatory parameters are left unspecified;2. Incorrect parameter types;3. Parameter verification failed. |
off(type: 'onDetach', callback?: Callback<void>): void
取消订阅CanvasRenderingContext2D与Canvas组件解除绑定的场景。
元服务API: 从API version 13开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| type | string | 是 | 取消订阅CanvasRenderingContext2D与Canvas组件解除绑定的事件类型,固定为'onDetach'。 异常值undefined或null按无效值处理。 |
| callback | Callback<void> | 否 | 为空代表取消所有订阅CanvasRenderingContext2D与Canvas组件解除绑定后触发的回调。 非空代表取消订阅解除绑定对应的回调。 异常值undefined或null按无效值处理。 |
错误码:
以下错误码的详细介绍请参见通用错误码。
| 错误码ID | 错误信息 |
|---|---|
| 401 | Input parameter error. Possible causes: 1. Mandatory parameters are left unspecified;2. Incorrect parameter types;3. Parameter verification failed. |
示例:
import { BusinessError } from '@kit.BasicServicesKit';
import { FrameNode } from '@kit.ArkUI'
// xxx.ets
@Entry
@Component
struct AttachDetachExample {
private settings: RenderingContextSettings = new RenderingContextSettings(true)
private context: CanvasRenderingContext2D = new CanvasRenderingContext2D(this.settings)
private scroller: Scroller = new Scroller()
private arr: number[] = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15]
private node: FrameNode | null = null
attachCallback = () => {
console.info('CanvasRenderingContext2D attached to the canvas frame node.')
this.node = this.context.canvas
}
detachCallback = () => {
console.info('CanvasRenderingContext2D detach from the canvas frame node.')
this.node = null
}
aboutToAppear(): void {
try {
this.context.on('onAttach', this.attachCallback)
this.context.on('onDetach', this.detachCallback)
} catch (error) {
let e: BusinessError = error as BusinessError;
console.error(`Error code: ${e.code}, message: ${e.message}`);
}
}
aboutToDisappear(): void {
try {
this.context.off('onAttach')
this.context.off('onDetach')
} catch (error) {
let e: BusinessError = error as BusinessError;
console.error(`Error code: ${e.code}, message: ${e.message}`);
}
}
build() {
Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
Scroll(this.scroller) {
Flex({ direction: FlexDirection.Column }) {
ForEach(this.arr, (item: number) => {
Row() {
if (item == 3) {
Canvas(this.context)
.width('100%')
.height(150)
.backgroundColor('rgb(213,213,213)')
.onReady(() => {
this.context.font = '30vp sans-serif'
this.node?.commonEvent.setOnVisibleAreaApproximateChange(
{ ratios: [0, 1], expectedUpdateInterval: 10 },
(isVisible: boolean, currentRatio: number) => {
if (!isVisible && currentRatio <= 0.0) {
console.info('Canvas is completely invisible.')
}
if (isVisible && currentRatio >= 1.0) {
console.info('Canvas is fully visible.')
}
}
)
})
} else {
Text(item.toString())
.width('100%')
.height(150)
.backgroundColor('rgb(39,135,217)')
.borderRadius(15)
.fontSize(16)
.textAlign(TextAlign.Center)
.margin({ top: 5 })
}
}
}, (item: number) => item.toString())
}
}
.width('90%')
.scrollBar(BarState.Off)
.scrollable(ScrollDirection.Vertical)
}
.width('100%')
.height('100%')
}
} 
startImageAnalyzer(config: ImageAnalyzerConfig): Promise<void>
配置并启动AI分析功能,使用Promise异步回调。使用前需先设置enableAnalyzer为true,启用图像AI分析能力。
该方法调用时,将截取调用时刻的画面帧进行分析,使用时需注意启动分析的时机,避免出现画面和分析内容不一致的情况。
未执行完重复调用该方法会触发错误回调。示例代码同stopImageAnalyzer。
分析类型不支持动态修改。
当检测到画面有变化时,分析结果将自动销毁,可重新调用本接口启动分析。
该特性依赖设备能力,不支持该能力的情况下,将返回错误码。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| config | ImageAnalyzerConfig | 是 | 执行AI分析所需要的入参,用于配置AI分析的类型(如主体识别、文字识别等)。详见ImageAnalyzerConfig。 异常值undefined或null按无效值处理。 |
返回值:
| 类型 | 说明 |
|---|---|
| Promise<void> | Promise对象,无返回结果。 |
错误码:
以下错误码的详细介绍请参见图像AI分析错误码。
| 错误码ID | 错误信息 |
|---|---|
| 110001 | Image analysis feature is unsupported. |
| 110002 | Image analysis is currently being executed. |
| 110003 | Image analysis is stopped. |
stopImageAnalyzer(): void
停止AI分析功能,AI分析展示的内容将被销毁。
在startImageAnalyzer方法未返回结果时调用本方法,会触发其错误回调。
该特性依赖设备能力。
元服务API: 从API version 12开始,该接口支持在元服务中使用。
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
示例:
// xxx.ets
import { BusinessError } from '@kit.BasicServicesKit';
@Entry
@Component
struct ImageAnalyzerExample {
private settings: RenderingContextSettings = new RenderingContextSettings(true)
private context: CanvasRenderingContext2D = new CanvasRenderingContext2D(this.settings)
private config: ImageAnalyzerConfig = {
types: [ImageAnalyzerType.SUBJECT, ImageAnalyzerType.TEXT]
}
// 'common/images/example.png'需要替换为开发者所需的图像资源文件
private img = new ImageBitmap('common/images/example.png')
private aiController: ImageAnalyzerController = new ImageAnalyzerController()
private options: ImageAIOptions = {
types: [ImageAnalyzerType.SUBJECT, ImageAnalyzerType.TEXT],
aiController: this.aiController
}
build() {
Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
Button('start')
.width(100)
.height(50)
.margin(5)
.onClick(() => {
this.context.startImageAnalyzer(this.config)
.then(() => {
console.info('analysis complete');
})
.catch((error: BusinessError) => {
let e: BusinessError = error as BusinessError
console.error(`Error code: ${e.code}, message: ${e.message}`)
})
})
Button('stop')
.width(100)
.height(50)
.margin(5)
.onClick(() => {
this.context.stopImageAnalyzer()
})
Button('getTypes')
.width(100)
.height(50)
.margin(5)
.onClick(() => {
this.aiController.getImageAnalyzerSupportTypes()
})
Canvas(this.context, this.options)
.width(200)
.height(200)
.enableAnalyzer(true)
.onReady(() => {
this.context.drawImage(this.img, 0, 0, 200, 200)
})
}
.width('100%')
.height('100%')
}
} 
static getContext2DFromDrawingContext(drawingContext: DrawingRenderingContext, options?: RenderingContextOptions): CanvasRenderingContext2D
从一个DrawingRenderingContext对象中获取一个CanvasRenderingContext2D对象,该CanvasRenderingContext2D对象与入参的DrawingRenderingContext对象绑定了相同的Canvas组件。
从该接口获取的CanvasRenderingContext2D对象不允许作为参数创建Canvas组件,否则会导致应用崩溃。
当入参的DrawingRenderingContext对象未绑定Canvas组件时,将返回错误码。
元服务API: 从API version 23开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
模型约束: 此接口仅可在Stage模型下使用。
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| drawingContext | DrawingRenderingContext | 是 | 一个DrawingRenderingContext类型的对象。 异常值undefined或null按无效值处理。 |
| options | RenderingContextOptions | 否 | 渲染上下文的配置选项。 异常值undefined或null按默认值处理。 默认值:{ antialias: false } |
返回值:
| 类型 | 说明 |
|---|---|
| CanvasRenderingContext2D | 返回一个CanvasRenderingContext2D对象,其与入参的DrawingRenderingContext绑定了相同的Canvas组件。 |
错误码:
以下错误码的详细介绍请参见Canvas组件错误码。
| 错误码ID | 错误信息 |
|---|---|
| 103702 | The drawingContext is not bound to a canvas component. |
示例:
// xxx.ets
import { LengthMetricsUnit } from '@kit.ArkUI';
@Entry
@Component
struct CanvasExample {
build() {
Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
Canvas({ unit: LengthMetricsUnit.DEFAULT })
.onReady((drawingContext?: DrawingRenderingContext) => {
if (!drawingContext) {
return
}
let context2D: CanvasRenderingContext2D =
CanvasRenderingContext2D.getContext2DFromDrawingContext(drawingContext, { antialias: true })
context2D.fillStyle = 'rgb(39,135,217)'
context2D.fillRect(10, 30, 100, 100)
})
}
.width('100%')
.height('100%')
}
} 
定义渲染上下文的具体配置参数。
元服务API: 从API version 23开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
模型约束: 此接口仅可在Stage模型下使用。
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| antialias | boolean | 否 | 是 | 表明RenderingContext是否需要开启抗锯齿。 异常值undefined或null按默认值处理。 true:开启抗锯齿;false:不开启抗锯齿。 默认值:false |
constructor(antialias?: boolean)
构造RenderingContextSettings对象,支持配置开启抗锯齿。
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| antialias | boolean | 否 | 表明canvas是否开启抗锯齿。 异常值undefined或null按默认值处理。 true:表示开启抗锯齿,false:表示不开启抗锯齿功能。 默认值:false 说明: 绘制文本默认开启抗锯齿效果,RenderingContextSettings的antialias无法影响绘制文本的抗锯齿效果,如需修改文本抗锯齿效果,请使用antialias24+接口。 |
卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| antialias | boolean | 否 | 是 | 表明canvas是否开启抗锯齿。 异常值undefined或null按默认值处理。 true:表示开启抗锯齿,false:表示不开启抗锯齿功能。 默认值:false 说明: 绘制文本默认开启抗锯齿效果,RenderingContextSettings的antialias无法影响绘制文本的抗锯齿效果,如需修改文本抗锯齿效果,请使用antialias24+接口。 |
type FrameNode = import('../api/arkui/FrameNode').FrameNode
为Canvas导入的FrameNode类型对象。
元服务API: 从API version 13开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
模型约束: 此接口仅可在Stage模型下使用。
| 类型 | 说明 |
|---|---|
| import('../api/arkui/FrameNode').FrameNode | FrameNode类型对象。 |
// xxx.ets
@Entry
@Component
struct WidthExample {
private settings: RenderingContextSettings = new RenderingContextSettings(true)
private context: CanvasRenderingContext2D = new CanvasRenderingContext2D(this.settings)
build() {
Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
Canvas(this.context)
.width(300)
.height(300)
.backgroundColor('#ffff00')
.onReady(() => {
let w = this.context.width
this.context.fillRect(0, 0, w / 2, 300)
})
}
.width('100%')
.height('100%')
}
} 
// xxx.ets
@Entry
@Component
struct HeightExample {
private settings: RenderingContextSettings = new RenderingContextSettings(true)
private context: CanvasRenderingContext2D = new CanvasRenderingContext2D(this.settings)
build() {
Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
Canvas(this.context)
.width(300)
.height(300)
.backgroundColor('#ffff00')
.onReady(() => {
let h = this.context.height
this.context.fillRect(0, 0, 300, h / 2)
})
}
.width('100%')
.height('100%')
}
} 
import { FrameNode } from '@kit.ArkUI'
// xxx.ets
@Entry
@Component
struct CanvasExample {
private settings: RenderingContextSettings = new RenderingContextSettings(true)
private context: CanvasRenderingContext2D = new CanvasRenderingContext2D(this.settings)
private text: string = ''
build() {
Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
Canvas(this.context)
.width('100%')
.height('100%')
.backgroundColor('#ffff00')
.onReady(() => {
let node: FrameNode = this.context.canvas
node?.commonEvent.setOnVisibleAreaApproximateChange(
{ ratios: [0, 1], expectedUpdateInterval: 10},
(isVisible: boolean, currentRatio: number) => {
if (!isVisible && currentRatio <= 0.0) {
this.text = 'Canvas is completely invisible.'
}
if (isVisible && currentRatio >= 1.0) {
this.text = 'Canvas is fully visible.'
}
this.context.reset()
this.context.font = '30vp sans-serif'
this.context.fillText(this.text, 50, 50)
}
)
})
}
.width('100%')
.height('100%')
}
} 