Themes

Sendbird UIKit for iOS provides themes to help you customize the style of your app. Through simple configurations, you can easily switch between Light and Dark themes and apply custom colors and fonts to the views.

SBUTheme is a singleton class that is used to configure themes. If you don't want to use the default user interfaces provided by UIKit, you can customize them by using the SBUTheme class. By customizing the theme of the view controller, you can apply the same custom theme to all its module components.

If you wish to set a global theme to each key function in the client app, you can do so by using setter methods such as setChannel and setChannelList in the corresponding theme class of each view controller.

UIKit for iOS provides two global themes: Light and Dark. The Light theme is the default global theme but you can change it by using the setWithTheme: method.

This is the default theme for UIKit.

SBUTheme.set(theme: .light)

To view the image in full screen, click on the

You can also apply the Dark theme to your app by following the code below.

SBUTheme.set(theme: .dark)

To view the image in full screen, click on the

Note : The global theme should be configured prior to setting the view controller or creating a chat view.

Instead of using the provided Light and Dark themes, you can customize the global theme by configuring SBUTheme and passing it as an argument to a parameter in the SBUTheme.set(theme:) method.

Initialize SBUTheme with default values as shown below.

let newTheme = SBUTheme(channelListTheme: .dark,
    channelCellTheme: .dark,
    channelTheme: .dark,
    messageInputTheme: .dark,
    messageCellTheme: .dark,
    userListTheme: .dark,
    userCellTheme: .dark,
    channelSettingTheme: .dark,
    componentTheme: .dark)

SBUTheme.set(theme: newTheme)

If you wish to customize the SBUTheme class instead of using the default values, refer to the code below.

// Set a channel list theme.
let channelListTheme = SBUChannelListTheme(
    leftBarButtonTintColor: SBUColorSet.primary300,
    backgroundColor: SBUColorSet.background100,
    // Set the necessary theme properties.
)

// Set a component theme.
let componentTheme = SBUComponentTheme(
    emptyViewBackgroundColor: SBUColorSet.background100,
    menuTitleFont: SBUFontSet.subtitle1,
    // Set the necessary theme properties.
)

// Set a new theme.
let newTheme = SBUTheme(
    channelListTheme: channelListTheme
    componentTheme: componentTheme,
    // Set the necessary theme properties.
)

SBUTheme.set(theme: newTheme)

The Light theme appears by default when a view controller is initialized. The following table shows the customizable properties of the SBUTheme class.

To change the theme of the channel list, refer to the code below.

let channelListTheme = SBUChannelListTheme(
    leftBarButtonTintColor: SBUColorSet.primary300
    // Set the necessary theme properties.
)

let channelCellTheme = SBUChannelCellTheme(
    backgroundColor: SBUColorSet.background100
    // Set the necessary theme properties.
)

SBUTheme.setChannelList(
    channelListTheme: channelListTheme,
    channelCellTheme: channelCellTheme
)

Note : Call the setupStyle method to update your user interface.