egret-docs-master/Lakeshore/manual/module/textField/README.md

101 lines
3.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

![](564ad9fa78d4b.png)
文本组件用来显示文字。可以显示静态文本和动态文本,并且可以设置为可输入文本框。
- 静态文本为内容固定的文本,内容不会在游戏中改变,比如剧情介绍等。
- 动态文本的内容会根据游戏进展而改变,比如得分,血量等。
- 可输入文本框指的是在游戏中提供给玩家输入内容的文字框。
### 特有属性
![](564ad9fa4164f.png)
- 默认文本:设置文本框默认显示的文本。(只支持静态文本,不支持表达式。若要实现动态文本显示,需要在文本动作中设置。)
- 字体:设置文本的默认字体。默认为“宋体”。
- 字体大小设置文本的字体大小。默认大小为12。
- 字体颜色:设置文本的颜色。默认值为白色。
- 粗体:设置文本是否为粗体。默认为“是”。
- 允许输入:设置是否为可输入文本框。默认为“否”。
- 水平布局:设置文本的水平对齐方式。默认为“水平居中”,可选项有:
- 左对齐
- 右对齐
- 水平居中
- 垂直布局:设置文本的垂直对齐方式。默认为“垂直居中”,可选项有:
- 上对齐
- 下对齐
- 垂直居中
- 字数上限设置文本框中显示字符数的上限。默认值为100。
- 斜体:设置文本是否为斜体。默认为“否”。
- 密码显示:设置是否按密码形式显示。默认为“否”。
- 支持换行:设置是否支持换行。默认为“否”。
*注:文本不支持碰撞。
------------
### 文本条件
文本组件除特有条件外,也适用部分通用条件(文本不支持“碰撞”相关条件)。参见:[通用条件](../../commonElements/conditions/README.md)
![](564ad9fa5cfc5.png)
#### 比较文本内容
如果文本框的文本内容和指定文本内容相同时。【持续性触发】
比较文本内容,若相同,条件为真,会一直触发动作。
![](564ad9fa66759.png)
------------
### 文本动作
文本组件除特有动作外,也适用部分通用动作(文本不支持“碰撞”相关动作)。参见:[通用动作](../../commonElements/action/README.md)
![](564ad9f917a87.png)
#### 文本内容
设置文本显示内容。可以使用表达式,以设置动态文本。
![](564ad9f99f3d2.png)
#### 追加文本
在已有文本内容后面追加新的文本内容。
![](564ad9f9e4d50.png)
#### 颜色
设置文本的颜色。默认为“黑色”。
![](564ad9f9d0e07.png)
#### 字体
设置文本的字体。默认为“宋体”。
![](564ad9fa147d3.png)
#### 字体大小
设置文本的字体大小。默认大小为12。
![](564ad9fa23aae.png)
#### 水平对齐方式
设置文本的对齐方式。默认为“水平居中”。
可选项有:
- 左对齐
- 右对齐
- 水平居中
![](564ad9f984c7f.png)
#### 垂直对齐方式
设置文本的垂直对齐方式。默认为“垂直居中”。
可选项有:
- 上对齐
- 下对齐
- 垂直居中
![](564ad9f9243f6.png)
#### 粗体
设置文本是否为粗体。默认为“粗体”。
![](564ad9f940ede.png)
#### 斜体
设置文本是否为斜体。默认为“斜体”。
![](564ad9f9b4638.png)
#### 字符数上限
设置文本框内的字符数上限。默认值为100。
![](564ad9fa081d9.png)
#### 密码显示
设置是否以密码形式显示文本。默认为“密码”。
![](564ad9f97669e.png)
#### 动态/可输入
设置是动态文本还是可输入文本。默认为“动态”。
![](564ad9f95a82a.png)
#### 换行
设置文本是否支持换行。默认为“支持”。
![](564ad9f969f63.png)