文本类拼图参考 - Soft8Soft
Description: 文本拼图提供了各种在拼图场景中操作文本的方法。

# 文本 | Text

文本拼图提供了各种在拼图场景中操作文本的方法。

## Contents

- Puzzles Reference
  - text
  - text multi-line
  - create text
  - append text
  - replace
  - reverse
  - length
  - is empty
  - find
  - get letter
  - get region
  - adjust case
  - trim spaces
  - count
  - new line
  - convert to number
  - prompt

#

## Puzzles Reference

#

### text

这个常用拼图实现了为拼图场景提供一些文本（字，词或句子）的方法。

文本拼图经常与不同类别的拼图一起使用。例如，您可以为 场景加载器拼图 指定URL输入，为 HTML拼图 指定HTML元素ID、CSS规则和颜色，以及为其他一些拼图指定ID和URL。

这个拼图也可以用来为对象、材质、动画或组提供名称，取代相对应 selector(选择器)拼图，这对于动态加载的内容会很有用。

最后，有些拼图可以配置为提供文本输入取代默认的下拉菜单，这在动态加载的场景中也很有用。

#

### text multi-line

此拼图实现了在拼图场景提供多行文本的方法。它使用 Ace编辑器 来显示和编辑内容。请查看相关的键盘快捷键简介：默认键盘快捷键。

本拼图支持CSS、HTML、JavaScript和纯文本高亮模式，可即时切换。拼图可以调整大小来改变编辑器的宽度和高度。

#

### create text

此拼图允许您将2个或更多的文本合并（连接）成一行。如果您提供非文本的数值，比如数字，它们将被自动转换为文本。可从左边的灰色工具箱中拖出 item 块到 join 块中来添加额外的输入插槽。

示例：创建一个由一些文本和对象名称组成的标注。

#

### append text

这个拼图将给定的文本添加到指定的变量中。

示例：创建一个由一些文本和对象名称组成的标注。

#

### replace

此拼图会搜索给定的文本，并将其用指定的文本替换（区分大小写）。

示例：

#

### reverse

这个拼图可反转给定的文本。

示例：

#

### length

此拼图用于计算指定文本中的字符数。

示例：

#

### is empty

此拼图用于检查指定的文本是否为空（长度为0）。如果是，结果为true，如果不是，结果为false。可与 逻辑 拼图一起使用。

示例：

#

### find

此拼图可以用来检查一个文本是否在另一个文本中，以及位置状态。如果该文本被找到，它将返回其位置（文本中的字符从0开始索引）。如果没有找到该文本，拼图返回值 -1 。

示例：

#

### get letter

此拼图从指定的位置提取字符（文本中的字符从0开始索引）。

示例：

#

### get region

此拼图允许提取两个指定位置之间的文本区域（文本中的字符从0开始索引）。

示例：

#

### adjust case

此拼图可为输入的文本为创建不同版本：大写字母（全部都大写），小写字母或者标题字母（第一个字母大写，其他字母小写）。非字母的字符，以及没有大小写的语言的文本，比如中文，不受影响。

示例：

#

### trim spaces

此图可以从文本的开头，文本的结尾或者文本的两边去除空格字符。

示例：

#

### count

此拼图可计算一个文本在指定文本中出现了多少次。

示例：

#

### new line

一个换行符（也成为 "end of line" 或 "line break" ）。在 create text 或 append text 拼图中使用该字符来创建多行文本。

#

### convert to number

此拼图将尝试转换指定文本为数字，这样得到的数值就可以作为数字运算的输入。如果转换失败，则返回0。

示例：

#

### prompt

此拼图用于创建带有输入字段的弹出式窗口。代码执行进程会暂停，直到用户点击确定或取消按钮，之后拼图会返回输入值。

示例：

## 在使用拼图时遇到困难？

欢迎您随时在 论坛上提问！您还可以加入中文用户社区QQ群(171678760)，在线寻求帮助。