# UILabel文字渲染

# 概述

负责基础的文本渲染,支持 ttf字体 与 位图字体。

UISprite

# 属性

# 字体

# ttf字体

fontFamily: string类型,ttf 字体的名称,通常用于运行时设置。

  • 注意:不同的 ttf 字体在不同平台的别名不同,需要获取 Font资源 解析 ttf 后返回的 fontFamily 来设置。无效的fontFamily会使用系统字渲染。

fontFont字体类型,使用该类型资源所使用的 ttf 字体渲染,设置时会同时设置fontFamily。

# 位图字体

bitmapFontBitmapFont字体类型,使用该类型资源所使用的位图字体渲染。

  • 注意:位图字体中缺省的字,会使用系统字进行渲染;可结合 bitmapFontUseFontSize(是否使用组件字体大小而非资源字体大小),bitmapFontUseFontColor(是否使用组件字体颜色)使用。

三种字体属性同时使用时,生效的优先级: bitmapFont > font > fontFamily

# 排版

# 使用方法

# 代码使用

UILabel 是渲染组件,因此需要挂载到非渲染节点上。

const entity = engine.Entity.createEntity2D("UILabel");
const label = entity.addComponent(engine.UILabel);
label.text = "Hello World";
label.fontSize = 40;
// ...

# 编辑器使用

右键 - UI - 新建Label

# 使用案例

使用各类渲染元素