HamzaGhazouani/HGPlaceholders

🎯 HGPlaceholders - Thư viện Swift thông minh cho placeholder & empty state

Thêm placeholder đẹp cho UITableView/UICollectionView chỉ trong 1 dòng code, không cần viết giao diện.

HGPlaceholders là một thư viện Swift nhẹ cho phép bạn dễ dàng thêm các trạng thái placeholder (loading, no results, error, no connection) vào bất kỳ UITableView hay UICollectionView nào trong dự án. Thư viện cung cấp nhiều theme mặc định đẹp mắt và hỗ trợ tùy biến hoàn toàn nếu bạn muốn thiết kế riêng.

✨ Điểm nổi bật

• Kế thừa từ TableView/CollectionView: Chỉ cần kế thừa lớp, placeholder tự động hoạt động.
• Bốn trạng thái mặc định: Loading, No Results, Error, No Connection — đều có hình ảnh và nút hành động.
• Nhiều theme đẹp: Hỗ trợ .basic, .default, .default2, .halloween và cho phép tạo theme riêng.
• Tùy biến hình ảnh: Thay đổi ảnh bằng cách đặt trong asset với tên hg_default-loading, hg_default-no_results, v.v.
• Cài đặt toàn cục: Áp dụng theme mặc định cho toàn bộ TableView/CollectionView trong dự án.
• Hỗ trợ CocoaPods & Carthage: Cài đặt nhanhan chóng qua cả hai công cụ quản lý gói.
• Tự động động: Placeholder tự động chiếm toàn bộ frame của bảng và hỗ trợ một hành động người dùng.

💡 Vì sao đáng chú ý

Thư viện không yêu cầu bạn phải xây dựng giao diện placeholder phức tạp hay quản lý trạng thái hiển thị thủ công. Chỉ với vài dòng code, HGPlaceholders tự động xử lý việc hiển thị placeholder dựa trên trạng thái dữ liệu. Đặc biệt, khả năng tùy biến theme theo phong cách dự án (như ví dụ "summer") giúp bạn dễ dàng duy trì nhất quán thiết kế.

#Swift #iOS #Placeholder #EmptyState #UITableView #UICollectionView #TiniX