在AGS中实现日历控件自动显示当前日期

问题背景

在使用AGS（Aylur's Gnome Shell）框架开发应用时，开发者可能会遇到一个常见的用户体验问题：日历控件在重新打开时会保持上次选择的日期状态，而不是自动重置为当前日期。这种行为可能会让用户感到困惑，特别是在需要频繁查看当前日期的场景下。

解决方案

通过AGS提供的API，我们可以监听窗口的显示事件，并在窗口每次打开时自动将日历控件的日期重置为当前日期。这需要以下几个关键步骤：

1. 获取当前日期信息：使用JavaScript的Date对象获取当前的日、月和年。
2. 监听窗口事件：通过App.connect方法监听窗口的显示/隐藏状态变化。
3. 更新日历控件：当目标窗口显示时，调用日历控件的select_day和select_month方法更新显示。

实现代码

以下是完整的实现代码示例：

// 假设cld是你的日历控件变量
App.connect("window-toggled", (_, name, visible) => {
    if (visible && name == 'calendar') {  // 'calendar'替换为你的窗口名称
        const currentDate = new Date();
        // 更新日历控件的日期显示
        cld.select_day(currentDate.getDate());
        cld.select_month(currentDate.getMonth(), currentDate.getFullYear());
    }
});

技术要点解析

1. 事件监听机制：AGS通过App.connect提供了全局的事件监听能力，"window-toggled"事件会在任何窗口显示状态改变时触发。
2. 日期处理：JavaScript的Date对象提供了方便的日期获取方法，getDate()返回当月中的某一天，getMonth()返回月份（0-11），getFullYear()返回四位数的年份。
3. 日历控件API：GTK的Calendar控件提供了select_day和select_month方法来编程控制显示日期。

注意事项

1. 确保在代码中正确替换窗口名称（示例中的'calendar'）为你实际使用的窗口名称。
2. 日历控件的月份参数是从0开始的（0表示一月，11表示十二月），这与JavaScript的Date.getMonth()行为一致。
3. 这种方法适用于所有基于GTK的日历控件，不仅限于AGS项目。

通过这种实现方式，可以显著提升日历控件的用户体验，确保用户每次打开都能看到最新的日期信息。