alamkanak/Android-Week-View

📅 Android Week View — Thư viện lịch tuần/ngày mạnh mẽ cho Android

Thư viện mã nguồn mở giúp bạn nhúng lịch dạng tuần hoặc ngày vào app Android chỉ với vài dòng code, kèm khả năng tùy biến giao diện cực linh hoạt.

Android Week View là một thư viện Android (viết bằng Java) để hiển thị lịch dạng week view hoặc day view ngay trong ứng dụng. Thư viện này đặc biệt hữu ích cho các app cần quản lý lịch biểu, đặt lịch hẹn, hoặc hiển thị sự kiện theo thời gian thực. Với hơn 3.400 sao trên GitHub, đây là một trong những thư viện lịch được cộng đồng Android tin dùng.

✨ Điểm nổi bật

• Hiển thị tuần hoặc ngày: Hỗ trợ cả hai chế độ xem lịch week view và day view, linh hoạt cho nhiều use-case.
• Cuộn vô hạn theo chiều ngang: Lướt qua các tuần liên tiếp mượt mà, với cơ chế pre-load sự kiện 3 tháng để tránh giật lag.
• Tùy biến giao diện sâu: Hơn 30 thuộc tính XML để thay đổi màu sắc, kích thước, khoảng cách, font chữ, đường kẻ, v.v.
• Live preview trong XML: Xem trước trực tiếp giao diện tùy chỉnh ngay trong cửa sổ preview của Android Studio.
• Tương tác sự kiện: Hỗ trợ đầy đủ listener cho click, long-press trên sự kiện, và cả click vào vùng trống.
• Đường "now" (hiện tại): Hiển thị đường kẻ đánh dấu thời điểm hiện tại, với màu sắc và độ dày tùy chỉnh.
• Phân biệt màu quá khứ/tương lai/cuối tuần: Tô màu khác nhau cho ngày đã qua, ngày tương lai, và ngày cuối tuần để dễ quan sát.
• Nhiều cách nạp dữ liệu: Dùng MonthChangeListener để nạp sự kiện theo tháng, hoặc tự định nghĩa loader riêng.

💡 Vì sao đáng chú ý

Điểm mạnh lớn nhất của Android Week View là khả năng tùy biến mạnh mẽ đi kèm với API đơn giản. Bạn có thể thay đổi gần như toàn bộ giao diện chỉ qua XML attributes — từ màu nền, màu chữ, màu ngày hôm nay, cho đến độ cao của mỗi giờ — mà không cần viết thêm code phức tạp. Tất cả attribute đều có getter/setter tương ứng để thay đổi động theo logic ứng dụng.

Thư viện này phù hợp nhất cho các app dạng lịch biểu, đặt lịch, quản lý công việc, hoặc bất kỳ ứng dụng nào cần hiển thị sự kiện theo mốc thời gian cụ thể. Cơ chế cuộn vô hạn ngang cùng pre-load 3 tháng giúp trải nghiệm lướt lịch rất mượt, và việc có sẵn sample app giúp bạn bắt đầu nhanh chóng. Mặc dù phiên bản 1.2.6 đã khá ổn định với nhiều tính năng như pinch-to-zoom, đường now line, và phân biệt màu ngày, dự án vẫn còn một số việc cần làm như xử lý đúng các sự kiện kéo dài nhiều ngày.

---

#Android #Calendar #WeekView #OpenSource #TiniX