• ProgressBar 组件参考
    • ProgressBar 属性
    • 详细说明

    ProgressBar 组件参考

    ProgressBar(进度条)经常被用于在游戏中显示某个操作的进度,在节点上添加 ProgressBar 组件,然后给该组件关联一个Bar Sprite 就可以在场景中控制 Bar Sprite 来显示进度了。

    add-progressbar

    点击 属性检查器 下面的添加组件按钮,然后从添加 UI 组件中选择ProgressBar,即可添加 ProgressBar 组件到节点上。

    进度条的脚本接口请参考ProgressBar API。

    ProgressBar 属性

    属性功能说明
    Bar Sprite进度条渲染所需要的 Sprite 组件,可以通过拖拽一个带有 Sprite组件的节点到该属性上来建立关联。
    Mode支持 HORIZONTAL(水平)、VERTICAL(垂直)和 FILLED(填充)三种模式,可以通过配合 reverse 属性来改变起始方向。
    Total Length当进度条为 100%时 Bar Sprite 的总长度/总宽度。在 FILLED 模式下 Total Length 表示取 Bar Sprite 总显示范围的百分比,取值范围从 0 ~ 1。
    Progress浮点,取值范围是 0~1,不允许输入之外的数值。
    Reverse布尔值,默认的填充方向是从左至右/从下到上,开启后变成从右到左/从上到下。

    详细说明

    添加 ProgressBar 组件之后,通过从 层级管理器 中拖拽一个带有Sprite组件的节点到 Bar Sprite 属性上,此时便可以通过拖动 progress 滑块来控制进度条的显示了。

    Bar Sprite 可以是自身节点,子节点,或者任何一个带有Sprite组件的节点。另外,Bar Sprite 可以自由选择 Simple、Sliced 和 Filled 渲染模式。

    进度条的模式选择 FILLED 的情况下,Bar Sprite 的 Type 也需要设置为 FILLED,否则会报警告。详细使用说明请查阅ProgressBar UI 控件介绍。