AppearanceNavigationController 项目教程

AppearanceNavigationController 项目教程

AppearanceNavigationControllerExample with advanced configuration of the navigation controller's appearance项目地址:https://gitcode.com/gh_mirrors/ap/AppearanceNavigationController

1. 项目的目录结构及介绍

AppearanceNavigationController/
├── AppearanceNavigationController.xcodeproj
├── AppearanceNavigationController
│   ├── AppearanceNavigationController.swift
│   ├── ContentViewController.swift
│   ├── Appearance.swift
│   ├── README.md
│   ├── LICENSE
│   └── .gitignore
└── README.md

• AppearanceNavigationController.xcodeproj: Xcode 项目文件。
• AppearanceNavigationController: 项目源代码目录。
  • AppearanceNavigationController.swift: 导航控制器的主要实现文件。
  • ContentViewController.swift: 示例内容视图控制器的实现文件。
  • Appearance.swift: 外观配置的实现文件。
  • README.md: 项目说明文档。
  • LICENSE: 项目许可证。
  • .gitignore: Git 忽略文件配置。

2. 项目的启动文件介绍

项目的启动文件是 AppearanceNavigationController.swift，它包含了导航控制器的主要实现逻辑。以下是该文件的关键部分：

public class AppearanceNavigationController: UINavigationController, UINavigationControllerDelegate {
    public required init(coder decoder: NSCoder) {
        super.init(coder: decoder)
        delegate = self
    }

    override public init(nibName nibNameOrNil: String?, bundle nibBundleOrNil: Bundle?) {
        super.init(nibName: nibNameOrNil, bundle: nibBundleOrNil)
        delegate = self
    }

    public func navigationController(_ navigationController: UINavigationController, willShow viewController: UIViewController, animated: Bool) {
        updateAppearance(for: viewController)
    }

    func updateAppearance(for viewController: UIViewController) {
        if let context = viewController as? NavigationControllerAppearanceContext, viewController == topViewController && transitionCoordinator == nil {
            setNavigationBarHidden(context.prefersBarHidden(for: self), animated: true)
            setToolbarHidden(context.prefersToolbarHidden(for: self), animated: true)
            applyAppearance(appearance: context.preferredAppearance(for: self), animated: true)
        }
    }

    public func updateAppearance() {
        if let top = topViewController {
            updateAppearance(for: top)
        }
    }
}

3. 项目的配置文件介绍

项目的配置文件主要是 .gitignore 和 LICENSE。

• .gitignore: 用于指定 Git 版本控制系统忽略的文件和目录。
• LICENSE: 项目许可证，本项目使用 MIT 许可证。

# .gitignore
*.xcuserstate
*.swp
*.swo
*.DS_Store

# LICENSE
MIT License

Copyright (c) 2023 Yalantis

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

以上是 AppearanceNavigationController 项目的基本教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。

AppearanceNavigationControllerExample with advanced configuration of the navigation controller's appearance项目地址:https://gitcode.com/gh_mirrors/ap/AppearanceNavigationController