layabox 文本 html,Laya Text(文本类)

Laya Text(文本类)

简介

文本是项目中必不可少的元素，通过文本我们可以显示各种各样的文字信息。在Laya中，Text 类用于创建显示对象以显示文本。下面介绍文本类以及展示其基本的使用。

项

值

Package

laya.display

类

public class Text

Inheritance

Text -> Sprite -> Node -> EventDispatcher -> Object

子类

Input

常用方法

Property

类型

说明

取值

默认值

align

String

表示文本的水平显示方式。

"left"

"center"

"right"

bgColor

String

文本背景颜色，以字符串表示。

bold

Boolean

指定文本是否为粗体字。

true:粗体

flase:不使用粗体

false

borderColor

String

文本边框背景颜色，以字符串表示。

color

String

表示文本的颜色值。

默认值为黑色

可通过 Text.defaultColor 设置默认颜色。

font

String

文本的字体名称，以字符串形式表示。

默认值为："Arial"

可通过Font.defaultFont设置默认字体。

fontSize

int

指定文本的字体大小(以像素为单位)。

默认为20像素

可通过Text.defaultSize 设置默认大小。

height

Number

[override] 显示对象的高度，

单位为像素。

此高度用于鼠标碰撞检测，

并不影响显示对象图像大小。

需要对显示对象的图像进行缩放，

请使用scale、scaleX、scaleY。

可通过getbounds获取显示对象图像的实际高度。

0

HIDDEN

String

[static] hidden 不显示超出文本域的字符。

hidden

italic

Boolean

表示使用此文本格式的文本是否为斜体。

true，则文本为斜体。

false,则文本不是斜体。

false

langPacks

Object

[static] 语言包

leading

Number

垂直行间距(以像素为单位)。

lines

Array

read-only]

maxScrollX

int

[read-only] 获取横向可滚动最大值。

maxScrollY

int

[read-only] 获取纵向可滚动最大值。

创建空项目

打开scr目录下的LayaSample.js。文件，以下代码均在此文件中进行修改。

文本基础样式示例

文本对齐示例

PS:不设置文本区域的直接设置文本的水平对齐和垂直对齐将不会有效果。

自动换行示例

PS:要设置好文本区域的宽和高，要不然文字会按照默认的text宽进行自动换行。

超出文本区域的处理

hidden:不显示超出文本域的字符。

visible:不进行任何裁切。

scroll:不显示文本域外的字符像素，并且支持scroll接口。

PS:性能从高到低依次为：hidden > visible > scroll

滚动文本

设置文本区域属性为overflow后，还可以通过使用scrollX和scrollY滚动文本视口，通过滚动文本来显示全部的文本内容。

PS:在没有设置overflow为Text.SCROLL的情况下，滚动无效!

textInput的单行输入&多行输入

文本输入框是游戏中经常会用到的一个UI组件。在Laya中,任何需要输入的时候都要使用到textInput这个类。

单行输入只能在一行内输入；多行可以通过回车在上一行未满的情况下在下一行输入。

下面展示这个类的单行和多行输入。

从上述代码可以看出，只需设置multiline的值为true即可开启多行输入。