Buttons are an essential element in iOS apps. If you are developing an app using UIKit, you will probably use UIButton class to create buttons. Creating a button is a straightforward process, but it becomes problematic when it comes to customizations. Soon you will find yourself writing hacks for achieving your desired result. We all have been there, and we have done it. You are not alone. Luckily, iOS 15.0 gives us a new method to customize Buttons much easier using UIButton.Configuration. Let’s get started!
A gentle request. Before getting started, show your support to indie devs by downloading their apps from the banner displayed below. It will help them in building great apps.
Winya: Live Stream Games
Become a Streamer by starting a live stream from your iPhone/iPad to Twitch/YouTube or any live streaming service of your choice. Download the app and become a creator now!
Configuration types in UIButton
UIButton.Configuration comes in four different types, namely plain, filled, gray, and tinted. In this article, we will be focusing only on filled configuration. I will leave the rest of the configurations for you to experiment.
Setting a title in a UIButton
Setting a title is done by using the configuration’s title property.
Setting a subtitle in a UIButton
Again, we can make use of the configuration’s subtitle property to set a subtitle. It would be tough to set a subtitle without the configuration API.
Changing the background color of a UIButton
The color of the UIButton’s background view can be changed using baseBackgroundColor property.
Setting an attributed title in a UIButton
Yes, you read it right. You can set attributed titles as well using the attributedTitle property on the configuration.
Some of you might have noticed that I am using AttribtedString instead of NSAttributedString. Yes, from iOS 15.0, NSAttributedString has been replaced by AttributedString API. I will be writing more about it in the upcoming articles.
Customizing the background property of a UIButton
We can easily manipulate the shape of the button by using the background property.
Setting the size of a UIButton
We can set the button’s size to some presets like large, medium, small, and mini.
Setting the content insets in a UIButton
If we want to adjust the insets of a button, we can use the contentInsets API.
Setting the cornerStyle in a UIButton
The cornerStyle API provides a predefined set of corner style customizations like capsule, large, medium, small, dynamic, and fixed.
Setting an image in a UIButton
Adding an image to the button and customizing it has become effortless. An important point to note here is that, the image respects the language’s direction.
Padding between an image and a title in a UIButton
The UIButton configuration makes it easy to set a padding between the image and the button’s
Changing the position of an image in a UIButton
The imagePlacement is my favorite property. I have written so many nasty hacks for just changing the position of the image in a UIButton, before iOS 15.0 The imagePlacement property supports the following options - leading, trailing, top, or bottom.
Changing the alignment of the title in a UIButton
The title alignment property of the configuration API allows us to align the title as per our choice. The supported options are leading, automatic, trialing, and center.
Finally, we initialize the button with the configuration and add it to a view.
I hope the article was informative and you got to know about the modern ways to customize a UIButton. However, I haven’t explained about UIButton.ConfigurationUpdateHandler, so I will be covering about it in a separate article.
About the author
- Rizwan Ahmed - iOS Engineer. Twitter - https://twitter.com/rizwanasifahmed