• 2022/10/11
• 3分

【Swift UIKit】UITabBarControllerの実装方法！UITabBarItemの使い方

＼ アプリをリリースしました ／

友達や家族の誕生日をメモ！通知も届く-みんなの誕生日-

posted withアプリーチ

UITabBarControllerとは？

UIKitフレームワークを使用している場合に以下のようなタブでページを切り変えられる機能を構築できるのがUITabBarControllerです。

Swift UIの場合はTabview構造体を使って実装します。

タブページの実装方法

新規のプロジェクトを立ち上げたら「Main.storyboard」を開きます。Interface Builderが起動するので、新しく「Tab Bar Controller」を追加します。すると以下画像のように3枚の画面が追加で表示されます。

元からあった1枚の左横にある「→」を新しく追加した「Tab Bar Controller」の移動させておきます。これでアプリ起動時にこのViewControllerを表示させることができます。元からあった画面は消しておきましょう。

あとは2つの画面にラベルやボタンなどのビューを設置すればタブページが完成します。

タブページの見た目を変更する

タブページの見た目はインスペクタから変更できます。画面内のタブ部分をクリックすると以下の画像のようにインスペクタ部分から変更できるようになります。

コードのみで実装する

Interface Builderを使って実装する方法をまとめましたが、続いてはコードのみで実装する方法をまとめていきます。目標は以下のような2枚のページをタブで移動できるようにしていきます。

コードで実装する流れ

1. タブページ1用のViewControllerを作成
2. タブページ2用のViewControllerを作成
3. タブ部分を定義するUITabBarControllerを作成
4. 起動時に表示されるようにSceneDelegateを変更

1.タブページ1用のViewControllerを作成

1つ目のタブで表示させたいビューを構築していきます。ここは普通のページのためUIViewControllerに準拠させて記述していきます。特に特別なことはしていませんが、loadViewメソッド内で背景色のついたビューを構築し、viewDidLoadメソッド内で表示させるUI部品を追加しています。

FirstViewController.swift
class FirstViewController: UIViewController {

    override func loadView() {
        view = UIView()
        view.backgroundColor = .white
    }
    
    override func viewDidLoad() {
        super.viewDidLoad()
        let screenWidth = UIScreen.main.bounds.width
        let screenHeight = UIScreen.main.bounds.height
        let label = UILabel(frame: CGRect(x:screenWidth/3, y:screenHeight/2,width:screenWidth/2, height:60))
        label.text = "Hello World!!"
        label.font = UIFont.boldSystemFont(ofSize: 20.0)
        view.addSubview(label)
    }
}

2.タブページ2用のViewControllerを作成

1つ目のタブページと同様に2つ目のタブで表示させるようのViewControllerを作成しておきます。

SecondViewController.swift
class SecondViewController: UIViewController {
    
    override func loadView() {
        view = UIView()
        view.backgroundColor = .black
    }
    
    override func viewDidLoad() {
        
        super.viewDidLoad()
        let screenWidth = UIScreen.main.bounds.width
        let screenHeight = UIScreen.main.bounds.height
        let label = UILabel(frame: CGRect(x:screenWidth/3, y:screenHeight/2,width:screenWidth/2, height:60))
        label.text = "こんにちは 世界!!"
        label.font = UIFont.boldSystemFont(ofSize: 20.0)
        label.textColor = UIColor.white
        view.addSubview(label)
    }
}

3.タブ部分を定義するUITabBarControllerを作成

タブページを構築するための肝となるUITabBarControllerに準拠したViewControllerを作成します。この中では適当なメソッド(今回はinitTab)を用意してその中に記述していきます。

タブで表示させるようの各ViewControllerをインスタンス化し、tabBarItemプロパティにUITabBarItem型の値を格納します。イニシャライザは複数ありますが、今回はinit(tabBarSystemItem systemItem: UITabBarItem.SystemItem,tag: Int)を使用してシステムアイコンを表示させるようにします。

最後にviewControllersプロパティにタブページとして表示させたいViewControllerを配列形式で渡します。

TabBarController.swift
class TabBarController: UITabBarController {
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        initTab()
    }
    
    func initTab() {
        let firstViewController = FirstViewController()
        firstViewController.tabBarItem = UITabBarItem(tabBarSystemItem: .search, tag: 0)
        
        let secondViewController = SecondViewController()
        secondViewController.tabBarItem = UITabBarItem(tabBarSystemItem: .downloads, tag: 1)
        
        self.viewControllers = [firstViewController, secondViewController]
    }
    
}

4.起動時に表示されるようにSceneDelegateを変更

これでタブページの実装は完了しました。ですがまだ新規で作成したTabBarControllerが紐づいていないのでテストすることができません。

「SceneDelegate.swift」内に以下のコードを追記することで起動時にTabBarControllerが呼び出されるように設定を変更しておきます。

SceneDelegate.swift
class SceneDelegate: UIResponder, UIWindowSceneDelegate {

    var window: UIWindow?


    func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
        // Use this method to optionally configure and attach the UIWindow `window` to the provided UIWindowScene `scene`.
        // If using a storyboard, the `window` property will automatically be initialized and attached to the scene.
        // This delegate does not imply the connecting scene or session are new (see `application:configurationForConnectingSceneSession` instead).
        guard let _ = (scene as? UIWindowScene) else { return }
+       let window = UIWindow(windowScene: scene as! UIWindowScene)
+       self.window = window

+       let vc = TabBarController()
+       window.rootViewController = vc
    }
  

ビルドして問題なく動作するか確認して見てください。

UITabBarItemクラス

UITabBarItemクラスを使用することでタブアイテムの見た目を変更することができます。

イニシャライザ1

UITabBarItem(tabBarSystemItem: .search, tag: 0)

タブのアイコンをあらかじめシステムに定義してあるUITabBarItem.SystemItem型の値から選択することができるイニシャライザです。tagにはオブジェクトを識別するようの数字を渡します。

enum SystemItem : Int, @unchecked  Sendable {
    case bookmarks   // ブックマーク
    case contacts    // 連絡先
    case downloads   // ダウンロード 
    case favorites   // お気に入り：★
    case featured    // 注目：★
    case history     // 履歴
    case more        // …
    case mostRecent  // 時計
    case mostViewed  // 数字付きリスト
    case recents     // 時計
    case search      // 検索
    case topRated    // 最高評価：★
}

イニシャライザ2

UITabBarItem(title: "アイテム", image: .init(systemName: "iphone"),tag: 1)

Assetに保存した画像やAppleが設計、提供しているシンボルセットライブラリ「SF-Symbols」を使用するには上記のイニシャライザを使用します。

イニシャライザ3

UITabBarItem(title: "アイテム", image: .init(systemName: "iphone"), selectedImage: .checkmark)

選択されているタブのアイコンのみを変更する場合は上記のイニシャライザを使用します。

まだまだ勉強中ですので間違っている点や至らぬ点がありましたら教えていただけると助かります。

ご覧いただきありがとうございました。