ビジネスメッセンジャーのウィジェット画面のカスタマイズ

ビジネスメッセンジャーのウィジェット画面のカスタマイズ

テーマのカスタマイズ 

標準のテーマ

ビジネスメッセンジャーのウィジェット画面には、ライトとダークの2種類の標準テーマが用意されています。

以下の画像は、ライトテーマとダークテーマの適用例です。



ZDTHEMETYPE.LIGHT




ZDTHEMETYPE.DARK

ライトテーマ（標準）を適用するメソッド

Swift

  1. ZDThemeManager.setTheme(type: .white)

Objective-C

  1. [ZDThemeManager setTheme:ZDThemeTypeWhite];

ダークテーマを適用するメソッド

Swift

  1. ZDThemeManager.setTheme(type: .dark)

Objective-C

  1. [ZDThemeManager setTheme:ZDThemeTypeDark];
iOSのバージョン13以降では、ビジネスメッセンジャーのウィジェット画面のテーマをデバイスのテーマと連動させることが可能です。
Notes
この場合、ウィジェット画面にはOSと同じテーマが設定されます。

Swift

  1. ZDThemeManager.setTheme(type: .system)

Objective-C

  1. [ZDThemeManager setTheme:ZDThemeTypeSystem];
Notes•    「ZDThemeType.system」は、iOS 13以降のバージョンでのみ利用できます。
    •    iOS 13以降のバージョンの場合、標準のテーマにはiOSのテーマが適用されます。iOS 13以前のバージョンの場合、ライトテーマが適用されます。

テーマのカスタマイズ

必要に応じて、標準のテーマをカスタマイズできます。標準のテーマの内容をもとに、操作画面の背景や要素の色を変更することが可能です。

ライトテーマ（標準）をカスタマイズするメソッド

Swift

  1. ZDThemeManager.updateTheme(theme:<#ZDThemeProtocol#>)

Objective-C

  1. [ZDThemeManager updateThemeWithTheme:<#ZDThemeProtocol#>];

ダークテーマをカスタマイズするメソッド

Swift

  1. ZDThemeManager.updateDarkTheme(theme: <#ZDThemeProtocol#>)

Objective-C

  1. [ZDThemeManager updateDarkThemeWithTheme:<#ZDThemeProtocol#>];
「ZDThemeProtocol」には、ウィジェット画面で使用したい色の属性のリストを指定できます。（例：「primaryTextColor」、「navigationBarTextColor」）。これにより、標準のテーマの色をクラスで設定した色に変更することが可能です。

なお、プロトコル内の属性はすべて任意です。独自のクラスを作成した上で、対象のクラスの属性を実装し、「updateLightTheme」メソッドや「updateDarkTheme」メソッドの「ZDThemeProtocol」内に複数指定することもできます。
Notes
テーマの色をカスタマイズする場合も、テーマの種類の設定が必要です。ビジネスメッセンジャーのウィジェットのテーマには、設定内容に応じて、ダークテーマまたはライトテーマのいずれかが適用されます。