uni-app 签到日历功能实现：从标记到交互的完整指南
在uni-app项目中实现一个签到日历，听起来简单，但实际动手时，不少开发者都会在日期标记和交互逻辑上踩坑。核心问题往往在于：官方组件的能力边界在哪，以及如何在其框架内优雅地实现定制需求。今天，我们就来把这些问题彻底理清。
需要明确一个前提：uni-calendar 组件本身并不支持动态标记任意日期（比如签到红点或自定义图标）。它严格依赖一个按固定格式传入的 dateInfo 数组来工作，任何字段缺失或格式错误都可能导致标记消失。试图用CSS覆盖来“蒙混过关”是行不通的，因为它的渲染逻辑是基于内部的条件判断和插槽控制的。
uni-app 里怎么用 `uni-calendar` 标记签到日期
直接说结论：想让日期上出现标记，你必须严格遵守它的数据“契约”。
具体怎么操作？记住下面这几个要点：
- 数据格式是硬性规定：
dateInfo必须是一个数组。数组里的每个对象，都必须包含date字段（格式必须是"YYYY-MM-DD"的字符串，时间戳或 Date 对象都不行）和info或tip字段中的一个。 - 标记内容有讲究：
info字段用于在日期右上角显示一个小红点或单字符，比如一个对勾“✓”或圆点“●”。注意，这里最好只放一个字符，多了会显示异常。如果想在日期底部显示更详细的文字提示，那就该用tip字段。 - 注意渲染范围：组件默认只渲染当前月份的视图。如果你准备的标记日期不在当前显示的月份内，那么无论你的数据多正确，标记都不会出现。
为什么 `dateInfo` 写了但没显示红点
数据明明传了，日历上却一片空白？这可能是新手最常遇到的困惑。问题根源，十有八九出在细节上。
首先，检查一下是不是字段名拼写错误或者数据类型不对。比如，把 info 错写成 text，或者给 info 传了一个数字 1 而不是字符串 "1"。另外，不同平台下组件的响应机制也有差异：在App和微信小程序端，组件可能在首次渲染后才读取 dateInfo；而在H5端，有时可能需要手动触发视图更新。
遇到这种情况，别慌，按步骤排查：
- 第一步，确认数据：在代码里用
console.log打印出this.dateInfo，确保数组不为空，且每个对象都包含了格式正确的date和info（或tip）字段。 - 第二步，核对格式：重点检查
date字符串。必须是"2024-06-15"这种形式，连字符是“-”，而不是“/”。 - 第三步，视图层验证：如果是在微信小程序中，可以打开开发者工具的WXML面板，找到对应的日期节点，查看其
data-info属性是否被正确绑定。
如何让签到日历支持「今天可点、昨天不可点、前天已签」这种交互逻辑
这才是实现签到功能的核心挑战。uni-calendar 组件只负责“画”出日历和标记，至于哪些日期能点、点击后做什么，这些交互逻辑完全需要开发者自己来补全。
关键在于组合使用 beforeDate 属性和 bind:select 事件：
- 利用 `beforeDate` 控制可选范围：这个属性接受一个日期字符串（如
"2024-06-10"），表示该日期及之前的所有日期都变为不可选状态。如果设为空字符串或null，则表示不限制。 - 在点击事件中做最终判断：通过
bind:select事件，我们可以拿到用户点击的日期e.detail.date。在这里，你需要编写业务逻辑进行二次校验，比如判断该日期是否在活动期内、是否晚于上次签到日等，确认无误后再调用签到接口。 - 状态更新与视图刷新：签到成功后，记得将新的日期数据
push到dateInfo数组中。在H5平台，可能需要调用this.$forceUpdate()来强制刷新视图；在小程序平台，通常需要重新为dateInfo赋值以触发组件的重新渲染。
自定义样式时容易忽略的两个坑
样式调整看似简单，但跨端兼容性问题常常在此处埋下隐患。
第一个坑是样式类名的平台差异。用于定制日期项的 .uni-calendar__item 类，在不同端的表现并不一致。例如，在App端你可能可以用 ::after 伪元素添加图标，但在微信小程序里，这套可能行不通，更稳妥的方式是使用组件提供的 slot 插槽或者用额外的 view 标签包裹。
第二个坑是字体缩放导致的样式错乱。组件内部的小红点（info）其实是靠设置 font-size: 12px 和 line-height: 1 来实现的。如果你的项目全局修改了根字体大小（比如设置了 html { font-size: 14px; }），这个红点就可能被意外放大，变得很难看。
如何规避这些坑？可以参考以下做法：
- 统一红点实现：使用
info: "●"，并在组件内部通过内联样式锁定其大小，例如style="font-size:10px; line-height:1;"。 - 使用深度选择器：尽量避免直接修改组件的根类名。在Vue项目中，使用Scoped CSS配合深度选择器（如
:deep(.uni-calendar__item)）来覆盖样式，是更安全可控的方式。 - 复杂图标用图片：如果想显示更复杂的图标（比如一个自定义的✅图标），最好不要依赖字体。更推荐的做法是利用
slot插入一个
说到底，最复杂的地方在于，日历的“标记状态”（哪些日子有红点）和“交互状态”（哪些日子可点击）是两套独立的逻辑。很多开发者卡住，不是因为代码写不对，而是没有提前设计好一个清晰的“日期状态映射表”来统一管理这些信息。理清了状态，问题就解决了一大半。
