Skip to content

entity.player.dialog

警告

该 API 文档:dialog

提示

修改原因:
由于官方原先提供的 d.ts 文件中,该 API 的接口定义与 TypeScript 的编码标准不匹配,导致许多创作者使用上的困难,我们进行了必要的优化调整。

功能分类

对话框类型

  • 文本对话框:显示纯文本信息
  • 选项对话框:提供多个选项供用户选择
  • 输入对话框:允许用户输入文本

使用示例

文本对话框

选项对话框

输入对话框

优势与特点

  1. 类型安全:通过定义明确的类型,TypeScript 能够在编译时捕获潜在的错误,比如传递了错误类型的参数或遗漏了必需的属性。

  2. 清晰的 API 文档:类型定义本身就是一种文档,它清楚地说明了每个 API 调用需要什么参数以及这些参数的类型。

  3. 增强的代码可读性:当其他创作者阅读你的代码时,类型定义提供了额外的上下文,使他们更容易理解你的意图。

  4. 减少运行时错误:通过静态类型检查,你可以在代码运行之前捕获许多常见的错误,从而减少运行时出现问题的可能性。

最佳实践

  • 合理使用对话框类型,确保用户交互体验
  • 保持对话框内容的简洁性和易读性
  • 注意对话框的视觉设计,确保与游戏整体风格一致