RtkControlBarButton (2)
Last updated Oct 19, 2026 Base button class for control bar items. Supports normal and selected states, notification badges, and theming through appearance configuration.
Initializer parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
image |
RtkImage |
✅ | - | The icon image for the button |
title |
String |
❌ | "" |
The title text displayed below the icon |
appearance |
RtkControlBarButtonAppearance |
❌ | - | Appearance configuration for colors and styling |
Properties
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
selectedStateTintColor |
UIColor |
❌ | - | Tint color applied when the button is in the selected state |
normalStateTintColor |
UIColor |
❌ | - | Tint color applied when the button is in the normal state |
notificationBadge |
RtkNotificationBadgeView |
- | - | Badge view for displaying notification counts |
Methods
| Method | Return Type | Description |
|---|---|---|
setSelected(image:title:) |
Void |
Sets the button to the selected state with a custom image and title |
setDefault(image:title:) |
Void |
Sets the button to the default state with a custom image and title |
Usage Examples
Basic Usage
import RealtimeKitUI
let button = RtkControlBarButton(
image: RtkImage(image: UIImage(systemName: "mic")),
title: "Mute"
)
view.addSubview(button)
With state changes
import RealtimeKitUI
let button = RtkControlBarButton(
image: RtkImage(image: UIImage(systemName: "mic")),
title: "Mute"
)
// Switch to selected state
button.setSelected(
image: RtkImage(image: UIImage(systemName: "mic.slash")),
title: "Unmute"
)
// Switch back to default state
button.setDefault(
image: RtkImage(image: UIImage(systemName: "mic")),
title: "Mute"
)
view.addSubview(button)
Was this helpful?
YesNo
On this page
{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/realtime/realtimekit/humans/ui-kit/api-reference/ios/rtk-control-bar-button/#page","headline":"RtkControlBarButton","description":"API reference for RtkControlBarButton component (iOS Library)","url":"https://developers.cloudflare.com/realtime/realtimekit/humans/ui-kit/api-reference/ios/rtk-control-bar-button/","inLanguage":"en","image":"https://developers.cloudflare.com/realtime/realtimekit/humans/ui-kit/api-reference/ios/rtk-control-bar-button/og.png?v=1fd291aff9381827","dateModified":"2026-10-19","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}
description: API reference for RtkEndMeetingControlBarButton component (iOS Library) title: RtkEndMeetingControlBarButton image: https://developers.cloudflare.com/realtime/realtimekit/humans/ui-kit/api-reference/ios/rtk-end-meeting-control-bar-button/og.png?v=6357cfd87ff39575
Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/realtime/llms.txt
Use this file to discover all available pages before exploring further.
Docs