How do I change the star images in FloatRatingView?

Set custom empty and full images by assigning UIImage objects to the emptyImage and fullImage properties. The README provides a demo app for reference, making customization straightforward.

Can FloatRatingView be used in SwiftUI?

No, it's built on UIKit and designed for nib/xib files or programmatic UIKit code. For SwiftUI, you need to wrap it in a UIViewRepresentable or use a native SwiftUI alternative.

FloatRatingView vs Cosmos: which is better for iOS ratings?

FloatRatingView excels in precise decimal ratings and simplicity, while Cosmos offers more features like animations. Choose based on whether you need floating point support or a more feature-rich component.

How to implement half-star ratings with FloatRatingView?

Simply set the rating value to a half-integer like 2.5, and the control automatically displays half-filled stars using its layer masking technique, as explained in the how-it-works section.

Is FloatRatingView compatible with Objective-C?

Yes, but it requires enabling Swift support in build settings and importing the generated Swift header file. The README provides step-by-step instructions for Objective-C integration.

What Swift versions does FloatRatingView support?

It has separate pod versions: v1.0.3 for Swift 2.3 and v4.0 for Swift 5.0, so use the correct version for your project to avoid compatibility issues.

How to handle touch events in FloatRatingView?

The control supports tap gestures for setting ratings, but for advanced interactions, you may need to extend it or use delegate methods; check the demo app for implementation details.

Open-Awesome

FloatRatingView

MITSwift4.0

A customizable iOS rating control written in Swift that supports whole, half, or floating point values.

Visit Website GitHub

545 stars97 forks0 contributors

What is FloatRatingView?

FloatRatingView is an open-source iOS UI component written in Swift that provides a customizable star rating control. It solves the problem of implementing precise rating inputs by supporting whole, half, or floating point values, which many existing controls lack. Developers can easily integrate it into their apps to collect detailed user ratings.

Target Audience

iOS developers building apps that require user rating systems, such as e-commerce, review platforms, or media applications where precise feedback is valuable.

Value Proposition

It offers a straightforward, reusable solution with floating point support that isn't commonly available in other rating controls, saving development time and providing greater flexibility in rating precision.

Overview

Whole, half or floating point ratings control written in Swift

Use Cases

Best For

Adding star ratings to product review sections in e-commerce apps
Implementing user feedback systems with decimal precision
Building media apps that require detailed content ratings
Creating custom review platforms where users can give fractional ratings
Enhancing iOS apps with visually consistent, customizable rating controls
Supporting Objective-C projects needing modern Swift UI components

Not Ideal For

Apps built exclusively with SwiftUI, as it relies on UIKit and nib/xib files
Projects requiring highly animated or interactive rating controls beyond static star displays
Teams that need rating components with built-in server synchronization or multi-symbol support

Pros & Cons

Pros

Floating Point Precision

Supports decimal ratings like 3.7 or 4.5, addressing a gap in many existing controls, as highlighted in the key features.

Easy Customization

Allows setting custom empty and full star images to match app design, mentioned in the README for seamless integration.

Dual Initialization Methods

Can be created programmatically or via Interface Builder, offering flexibility for different iOS development workflows.

Objective-C Compatibility

Usable in Objective-C projects with proper Swift settings, making it versatile for mixed-language environments.

Efficient Mask-Based Rendering

Uses CALayer masks for precise fractional star display, ensuring accurate visuals without performance issues.

Cons

UIKit Dependency

Limited to UIKit-based projects, not compatible with SwiftUI, restricting use in modern iOS development trends.

Basic Feature Set

Lacks advanced features like animations or support for non-star symbols, making it less suitable for interactive apps.

Version Fragmentation

Different pod versions for Swift 2.3 and Swift 5.0 indicate potential maintenance issues and breaking changes.

Objective-C Setup Complexity

Integrating into Objective-C requires additional build settings and imports, which can be error-prone.

Frequently Asked Questions

Related Projects

SkeletonView

☠️ An elegant way to show users that something is happening and also prepare them to which contents they are awaiting

Stars12,886

Forks1,125

Last commit1 month ago

Material

A UI/UX framework for creating beautiful applications.

Stars12,005

Forks1,257

Last commit4 years ago

NVActivityIndicatorView

A collection of awesome loading animations

Stars10,706

Forks1,158

Last commit4 months ago

Macaw

Powerful and easy-to-use vector graphics Swift library with SVG support

Stars6,046

Forks569

Last commit2 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub