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

「Mac畅玩鸿蒙与硬件53」UI互动应用篇30 - 打卡提醒小应用

本篇教程将实现一个打卡提醒小应用，通过用户输入时间进行提醒设置，并展示实时提醒状态，实现提醒设置和取消等功能。

在这里插入图片描述

关键词

打卡提醒
状态管理
定时任务
输入校验
UI交互

一、功能说明

打卡提醒小应用包含以下功能：

提醒时间输入与设置：支持输入格式化时间并进行提醒设置。
提醒触发与状态提示：在设定时间到达时触发提醒通知。
取消提醒：支持用户取消已设置的提醒。
图片装饰：通过图片展示提升界面趣味性。

二、所需组件

@Entry 和 @Component 装饰器
TextInput 和 Button 组件用于用户输入和操作
Text 组件用于展示提醒状态
Image 组件用于装饰界面
@State 修饰符用于状态管理

三、项目结构

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

四、代码实现

1. 打卡提醒页面代码

// 文件名：ReminderPage.ets

@Component
export struct ReminderPage {
  @State reminderTime: string = ''; // 提醒时间输入
  @State reminderStatus: string = '未设置提醒'; // 提醒状态
  private timerId: number | null = null; // 定时器ID

  // 设置提醒
  setReminder(): void {
    if (!this.reminderTime.includes(':')) {
      this.reminderStatus = '请输入正确格式的时间 (HH:mm)';
      return;
    }

    const timeParts = this.reminderTime.split(':');
    if (timeParts.length !== 2) {
      this.reminderStatus = '时间格式错误，请使用 HH:mm 格式';
      return;
    }

    const hours = parseInt(timeParts[0], 10);
    const minutes = parseInt(timeParts[1], 10);

    if (isNaN(hours) || isNaN(minutes) || hours < 0 || hours >= 24 || minutes < 0 || minutes >= 60) {
      this.reminderStatus = '时间值不合法，请检查输入';
      return;
    }

    const now = new Date();
    const targetTime = new Date();
    targetTime.setHours(hours, minutes, 0, 0);

    const delay = targetTime.getTime() - now.getTime();
    if (delay <= 0) {
      this.reminderStatus = '提醒时间已过，请设置未来时间';
      return;
    }

    this.reminderStatus = `提醒已设置，时间：${this.reminderTime}`;
    this.timerId = setTimeout(() => {
      this.showNotification();
    }, delay);
  }

  // 提醒触发
  showNotification(): void {
    this.reminderStatus = '时间到！请打卡';
  }

  // 取消提醒
  cancelReminder(): void {
    if (this.timerId !== null) {
      clearTimeout(this.timerId);
      this.timerId = null;
    }
    this.reminderStatus = '提醒已取消';
  }

  build(): void {
    Column({ space: 20 }) {
      Text('打卡提醒小应用')
        .fontSize(24)
        .fontWeight(FontWeight.Bold)
        .alignSelf(ItemAlign.Center);

      // 输入提醒时间
      Row({ space: 10 }) {
        TextInput({
          placeholder: '请输入提醒时间 (HH:mm)',
          text: this.reminderTime,
        }).width(200)
          .onChange((value: string) => (this.reminderTime = value));

        Button('设置提醒')
          .onClick(() => this.setReminder())
          .width(120)
          .height(40);

        Button('取消提醒')
          .onClick(() => this.cancelReminder())
          .width(120)
          .height(40);
      }
      .alignSelf(ItemAlign.Center);

      // 提醒状态展示
      Text(`当前状态：${this.reminderStatus}`)
        .fontSize(18)
        .margin({ top: 20 });

      // 添加图片装饰
      Image($r('app.media.cat'))
        .width(305)
        .height(360)
        .alignSelf(ItemAlign.Center);
    }
    .padding(20)
    .width('100%')
    .height('100%');
  }
}

2. 主入口文件

// 文件名：Index.ets

import { ReminderPage } from './ReminderPage';

@Entry
@Component
struct Index {
  build() {
    Column() {
      ReminderPage() // 调用提醒页面
    }
    .padding(20);
  }
}

效果示例：用户可以输入提醒时间，并在设定时间到达时收到提醒通知。

效果展示：

五、代码解读

时间输入校验与解析
- 提醒时间通过 TextInput 输入，并使用 split 拆分成小时和分钟，通过 parseInt 分别解析为整数。
状态更新与定时任务
- 使用 setTimeout 设置定时任务，到达提醒时间时更新状态提示用户打卡。
取消提醒功能
- 提供“取消提醒”按钮，通过 clearTimeout 取消定时任务，并更新提醒状态。
图片装饰
- 使用 Image 组件展示 cat.png 图片，提升界面趣味性和视觉效果。