Canvas提供画布组件,用于自定义绘制图形,开发者使用CanvasRenderingContext2D对象和OffscreenCanvasRenderingContext2D对象在Canvas组件上进行绘制,绘制对象可以是基础形状、文本、图片等。
完整参考示例如下:
import { PromptAction } from '@kit.ArkUI';
@Entry
@Component
struct CanvasExample {
private settings: RenderingContextSettings = new RenderingContextSettings(true);
private context: CanvasRenderingContext2D = new CanvasRenderingContext2D(this.settings);
testText =
'人生恰似逆旅,我们皆是行者。在时光长河中穿梭,所遇挫折是暗礁,亦是磨砺心智的基石;收获的喜乐为星光,却也不可溺于其中。万物恒变,心守正道,以清醒之思驾驭命运扁舟,于起伏间悟存在真意,方不负这一路奔逐。';
lineHeight: number = 0;
letterSpacing: number = 0;
fontSize: number = 16;
isBold: boolean = false;
isUnderline: boolean = false;
isItalic: boolean = false;
promptAction: PromptAction = this.getUIContext().getPromptAction();
handleDrawText() {
// 多个连续空格只保留一个
let tempText = this.testText.replace(/(^\s*)|(\s*$)/g, ' ').replace(/ +/g, ' ');
let textLen = tempText.length;
this.context.font = `${this.fontSize}vp YaHei`;
// 如果绘制的文本总宽度并没有超过最大宽度,那么直接绘制
if (this.context.measureText(tempText).width + textLen * this.letterSpacing < this.context.width) {
this.context.fillText(tempText, 0, 0);
} else {
let strArray: string[] = [];
let tempStr = '';
for (let i = 0; i < textLen; i++) {
let currStr = tempText[i];
// 判断当前字符是否是换行符,如果是,那么新增下一行
let isWrap = !/\r?\n/.test(currStr);
if (isWrap && (this.context.measureText(tempStr + currStr).width + (tempStr.length + 1) * this.letterSpacing) <
this.context.width) {
// 如果不是换行符且当前绘制的文本宽度加字距小于最大宽度,直接当前行字符串直接拼接
tempStr += currStr;
} else {
// 否则就是当前行的宽度已经达到极限,进行换行
strArray.push(tempStr);
if (isWrap) {
// 如果不是换行符,直接新的一行开头就是这个字符
tempStr = currStr;
} else {
// 否则,新的一行开头将换行符替换为空字符串
tempStr = '';
}
}
}
// 如果还有剩余结尾的字符串,直接就算作一行
if (tempStr !== '') {
strArray.push(tempStr);
tempStr = '';
}
strArray.forEach((str, index) => {
// 逐行绘制,绘制的y坐标当前行行数加上字体大小加上行高近似的模拟
this.handleDrawOneLineText(str, (index + 1) * (this.fontSize + this.lineHeight));
});
}
}
handleDrawOneLineText(str: string, y: number) {
let tempStr = '';
for (let i = 0, len = str.length; i < len; i++) {
// 逐字绘制,每行的y不变,单个字符的x是前面绘制文本的宽度加上每个字符的间距和
this.context.fillText(str[i], i * this.letterSpacing + (this.context.measureText(tempStr).width), y);
tempStr += str[i];
}
}
build() {
Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
Row({ space: 10 }) {
Button('字间距+').controlSize(ControlSize.SMALL).onClick(() => {
this.letterSpacing++;
this.context.clearRect(0, 0, this.context.width, this.context.height);
this.handleDrawText();
});
Button('字间距-').controlSize(ControlSize.SMALL).onClick(() => {
if (this.letterSpacing <= 0) {
this.promptAction.openToast({ message: '最小字间距为0' });
return;
}
this.letterSpacing--;
this.context.clearRect(0, 0, this.context.width, this.context.height);
this.handleDrawText();
});
Button('字号+').controlSize(ControlSize.SMALL).onClick(() => {
this.fontSize++;
this.context.clearRect(0, 0, this.context.width, this.context.height);
this.handleDrawText();
});
Button('字号-').controlSize(ControlSize.SMALL).onClick(() => {
if (this.fontSize <= 10) {
this.promptAction.openToast({ message: '最小字号为10' });
return;
}
this.fontSize--;
this.context.clearRect(0, 0, this.context.width, this.context.height);
this.handleDrawText();
});
};
Column() {
Canvas(this.context)
.width('100%')
.layoutWeight(1)
.backgroundColor('#aaccee')
.onReady(() => {
this.handleDrawText();
});
}
.width('100%')
.padding({ left: 16, right: 16 })
.margin(10)
.backgroundColor('#aaccee');
}
.width('100%')
.height('100%');
}
}