「Mac畅玩鸿蒙与硬件39」UI互动应用篇16

「Mac畅玩鸿蒙与硬件39」UI互动应用篇16 - 倒计时环形进度条

本篇将带你实现一个倒计时环形进度条应用。用户可以设置倒计时的时间，启动倒计时后，应用会动态显示一个随着时间递减的环形进度条，同时伴有数字倒计时显示。这是结合动画效果和时间管理的实用示例。
在这里插入图片描述

关键词

UI互动应用
倒计时器
环形进度条
动画效果
状态管理

一、功能说明

倒计时环形进度条允许用户设置一个初始倒计时时间，并以环形进度条和数字的方式动态显示剩余时间。倒计时结束时，环形进度条归零并显示“时间到”提示。

二、所需组件

@Entry 和 @Component 装饰器
Canvas 组件用于绘制环形进度条
TextInput 组件用于用户输入倒计时时间
Text 组件用于显示倒计时剩余时间
Button 组件用于控制倒计时
定时器函数 setInterval 和 clearInterval 用于时间管理
@State 修饰符用于状态管理

三、项目结构

项目名称：CountdownRingApp
自定义组件名称：CountdownRingPage
代码文件：CountdownRingPage.ets、Index.ets

四、代码实现

@Entry
@Component
export struct CountdownProgress {
  @State remainingTime: number = 10; // 剩余时间（默认10秒）
  @State totalTime: number = 10; // 总时间（倒计时时间）
  @State isRunning: boolean = false; // 是否正在倒计时
  private intervalId: number | null = null; // 定时器ID

  build() {
    Column({ space: 20 }) { // 创建垂直布局容器
      // 设置倒计时的时间滑动条
      Text('设置倒计时时间（秒）')
        .fontSize(18)
        .fontWeight(FontWeight.Medium)
        .textAlign(TextAlign.Center);

      // 滑动条，调整倒计时时间
      Slider({
        value: this.remainingTime,
        min: 0,
        max: 60,
      })
        .blockColor(Color.Blue) // 设置滑块颜色
        .trackColor(Color.Gray) // 设置轨道颜色
        .onChange((newValue) => {
          this.remainingTime = newValue;
          this.totalTime = newValue; // 更新总时间
        })
        .width('80%')
        .margin({ top: 10 });

      // 显示倒计时的剩余时间
      Text(`${this.remainingTime}秒`)
        .fontSize(24)
        .fontWeight(FontWeight.Bold)
        .textAlign(TextAlign.Center)
        .margin({ top: 20 });

      // 环形进度条显示倒计时进度
      Progress({
        value: (this.remainingTime / this.totalTime) * 100, // 设置进度
        total: 100, // 最大进度为100
        type: ProgressType.Ring, // 使用环形进度条
      })
        .color(Color.Green)
        .backgroundColor(Color.Gray)
        .width(200)
        .height(200)
        .margin({ top: 20 });

      // 开始或停止倒计时按钮
      Button(this.isRunning ? '停止倒计时' : '开始倒计时')
        .onClick(() => {
          if (this.isRunning) {
            this.stopCountdown();
          } else {
            this.startCountdown();
          }
        })
        .fontSize(20)
        .backgroundColor(this.isRunning ? Color.Red : Color.Green)
        .fontColor(Color.White)
        .width('60%')
        .alignSelf(ItemAlign.Center);
    }
    .padding(20)
    .width('100%')
    .height('100%')
    .alignItems(HorizontalAlign.Center);
  }

  // 开始倒计时的方法
  private startCountdown() {
    this.isRunning = true;
    this.intervalId = setInterval(() => {
      if (this.remainingTime > 0) {
        this.remainingTime--;
      } else {
        this.stopCountdown();
        this.showTimeUp();
      }
    }, 1000); // 每秒更新一次
  }

  // 停止倒计时的方法
  private stopCountdown() {
    this.isRunning = false;
    if (this.intervalId !== null) {
      clearInterval(this.intervalId);
      this.intervalId = null;
    }
  }

  // 显示倒计时结束信息
  private showTimeUp() {
    // 可以添加一个提示框来显示倒计时结束
    console.log("时间到！"); // 这里是控制台输出，实际可以使用弹窗或者其他UI组件
  }
}

// 文件名：Index.ets

import { CountdownProgress } from './CountdownProgress';

@Entry
@Component
struct Index {
  build() {
    Column() {
      CountdownProgress() // 调用倒计时进度条组件
    }
    .padding(20)
  }
}