styled-text
A declarative text styling library for iOS with streamlined Dynamic Type support.
What is styled-text?
StyledText is an iOS library that simplifies text styling by replacing attributed strings with declarative TextStyle objects. It provides drop-in replacements for UILabel, UITextView, and UIButton that automatically apply consistent styling, and includes built-in support for Apple's Dynamic Type font scaling.
iOS developers building apps that require consistent text styling, dynamic font scaling, or accessibility support for varying text sizes.
Developers choose StyledText to eliminate verbose attributed string boilerplate, ensure consistent text styling across their app, and seamlessly integrate Dynamic Type support with minimal code.
Overview
Declarative text styles and streamlined Dynamic Type support for iOS
Use Cases
Best For
- Simplifying text styling in iOS apps with reusable TextStyle objects
- Implementing Dynamic Type support for accessibility font scaling
- Replacing verbose NSAttributedString code with declarative styles
- Creating consistent text styling across UILabel, UITextView, and UIButton
- Building apps that need state-aware text styles for buttons
- Reducing boilerplate when updating text in iOS interfaces
Not Ideal For
- Projects built primarily with SwiftUI, as StyledText is UIKit-only and won't integrate seamlessly without workarounds.
- Apps requiring complex attributed string manipulations like custom text attachments or advanced paragraph styles beyond basic font, color, and spacing.
- Teams that prefer to avoid third-party UI dependencies to maintain full control over their codebase and minimize library updates.
Pros & Cons
Pros
Replaces verbose NSAttributedString code with reusable TextStyle objects, making text updates cleaner and more maintainable, as shown in the README's before/after example with StyledLabel.
Supports automatic font scaling for accessibility with configurable behaviors like scaleToStandardSizes or scaleToAllSizes, simplifying compliance with iOS accessibility guidelines without extra setup.
Provides StyledLabel, StyledTextView, and StyledButton that automatically apply text styles, reducing boilerplate and ensuring consistency across text elements in UIKit apps.
StyledButton supports separate text styles for each UIControlState (normal, highlighted, disabled, selected), enabling dynamic UI responses without additional code.
Cons
Requires calling refreshStyle() on components when system font size changes, adding complexity and potential for missed updates, as noted in the README's need for DynamicTypeControllerDelegate.
Not compatible with SwiftUI, making it unsuitable for modern iOS projects adopting Apple's newer UI framework without cumbersome wrappers like UIViewRepresentable.
Focuses on basic styling attributes (font, color, spacing) and lacks support for advanced attributed string features such as text attachments or custom underlines, which might require fallbacks to NSAttributedString.
Frequently Asked Questions
Related Projects
JVFloatLabeledTextFieldUITextField subclass with floating labels - inspired by Matt D. Smith's design: http://dribbble.com/shots/1254439--GIF-Mobile-Form-Interaction?list=users
TextFieldEffectsCustom UITextFields effects inspired by Codrops, built using Swift
SkyFloatingLabelTextFieldA beautiful and flexible text field control implementation of "Float Label Pattern". Written in Swift.
PYSearch🔍 An elegant search controller which replaces the UISearchController for iOS (iPhone & iPad) .
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.