Appearance
🖼️游戏用户界面
- GameUI 是管理游戏界面的对象,用于对玩家界面UI的操作。
- 在
客户端脚本
中,可以通过全局对象ui
,input
,navigator
,screenWidth
,screenHeight
来使用它。
提示
在推出此功能前,已有GUI功能,基于xml编写。但已不推荐使用,因有更优方案且支持可视化编辑。推荐使用最新的GameUI。 对旧版GUI感兴趣可查阅d.ts文件。
类
typescript
declare const ui: UiNode;
declare const navigator: Navigator;
declare const input: InputSystem;
declare const screenWidth: number; // 全局对象,获取当前玩家屏幕宽度
declare const screenHeight: number; // 全局对象,获取当前玩家屏幕高度
declare class InputSystem {
//...
}
declare class Navigator {
//...
}
declare class UiNode {
//...
}
属性
name
: 该节点的标识,可重复parent
: 节点的父节点,非根节点的父节点为空时,该节点将不会被渲染children
: 节点的子节点。如需要调整子节点结构,应修改子节点的parent
属性events
: 管理节点相关的事件uiScale
: 节点等比例缩放数据visible
: 屏幕是否可见zIndex
: 屏幕层级,层级越高的屏幕会显示在顶部,遮盖住层级较低的屏幕anchor
: 节点的锚点,用于确定节点的位置position
: 节点的位置,相对于父节点的位置backgroundColor
: 节点的背景颜色backgroundOpacity
: 节点的背景透明度size
: 节点的尺寸zIndex
: 节点的层级,用于确定节点的渲染顺序autoResize
: 节点的自动调整尺寸的方式visible
: 节点的可见性pointerEventBehavior
: 配置鼠标指针事件的响应方式image
: 图片元素的内容,应为图片的路径或者 URLimageOpacity
: 图片元素的透明度imageDisplayMode
: 图像显示模式的声明textContent
: 文本元素的内容richText
: 文本内容是否支持富文本textFontSize
: 节点显示的文本的字体大小textColor
: 节点显示的文本的颜色textXAlignment
: 节点显示的文本的水平对齐方式textYAlignment
: 节点显示的文本的垂直对齐方式autoWordWrap
: 是否开启自动换行textLineHeight
: 文本的行高textStrokeColor
: 文本的描边颜色textStrokeOpacity
: 文本描边的不透明度textStrokeThickness
: 文本描边的厚度textStrokeColor
: 文本的描边颜色textFontFamily
: 文本使用的字体placeholderColor
: 输入框显示的占位文本的颜色placeholderOpacity
: 输入框提示文本的不透明度isFocus
: 输入框是否聚焦
方法
findChildByName
: 按名称查找子节点,返回对应子节点对象clone
: 按名称查找子节点,返回对应子节点对象create
: 创建一个新的Ui屏幕
实例getAllScreen
: 获取当前所有存在的屏幕实例create
: 创建一个新的Ui盒子
实例create
: 创建一个新的Ui图片
实例create
: 创建一个新的Ui文本
实例create
: 创建一个新的Ui输入
实例focus
: 使输入框聚焦blur
: 使输入框失去焦点getDeviceInfo
: 获取该客户端当前设备以及屏幕分辨率unlockPointer
: 调用后在游戏界面显示鼠标指针lockPointer
: 调用后在游戏界面隐藏鼠标指针on
: 监听指定的事件once
: 与 on 的区别是仅触发一次remove
: 移除找到的第一个 listenerremoveAll
: 移除找到的所有 listener,不传则移除事件下所有add
: 与 on 是同一个方法,只是方法名不同emit
: 触发指定的事件off
: 与 remove 是同一个方法,只是方法名不同
枚举
PointerEventBehavior
: 表示界面元素对鼠标指针按下事件的行为方式ImageDisplayMode
: 控制图像的显示方式UITextFontFamily
: 字体样式