CustomNavigationTitle

日本語はこちら

CustomNavigationTitle 是一个简单的 SwiftUI 包，它根据滚动动画显示和隐藏导航栏标题。（此效果用于 Apple 的原生设置、邮件和 App Store 应用中。）

• 标题根据滚动淡入和淡出。
• 使用简单的 API 可以轻松地与现有代码集成。
• 与 SwiftUI 的 ScrollView、List 和 Form 兼容。

• iOS 16.0+

使用 Swift Package Manager (SPM) 安装。

1. 在 Xcode 中打开你的项目。
2. 选择 File > Add Package Dependency...。
3. 输入 https://github.com/Chronos2500/CustomNavigationTitle.git。
4. 配置版本要求并单击 Add Package。

1. 将 .scrollAwareTitle("CustomTitle") 修饰符添加到你的 ScrollView、List 或 Form 中的一个。
2. 然后，将 titleVisibilityAnchor() 修饰符添加到触发标题显示和消失的视图。当此视图移出可见区域时，将显示标题。

• 如果视图包含在 NavigationStack（或类似结构）中，这就是你所需要的一切。
• 虽然 .scrollAwareTitle() 优先于 .navigationTitle()，但建议也设置 .navigationTitle() 以实现导航历史堆栈功能。
• 有关详细示例，请参阅 Examples 文件夹中的项目。

import SwiftUI
import CustomNavigationTitle

struct ContentView: View {
    var body: some View {
        NavigationStack {
            ScrollView {
                Text("First")
                    .font(.largeTitle)
                    .padding()
                Text("Second")
                    .font(.largeTitle)
                    .padding()
                    .titleVisibilityAnchor()
                Text("Third")
                    .font(.largeTitle)
                    .padding()
            }
            .scrollAwareTitle("CustomTitle")
        }
    }
}

.scrollAwareTitle {
    HStack {
        Image(systemName: "star.fill")
        Text("Favorites")
    }
}

根据 MIT 许可证提供。

Chronos2500 © 2025