Afloat

KO | EN

gitlite — search

#react #typescript #go #golang #machine-learning #rust #deep-learning #macos #java #windows #awesome #vue #awesome-list #mcp

(★ 109)

Contextual navigation titles for SwiftUI

파일 탐색기

최종 버전 다운로드 (.zip)

- FUNDING.yml
- - Afloat.swift
- - ContextualNavigationManagerTests.swift
  - ContextualNavigationTagTests.swift
  - ContextualNavigationTransitionTests.swift
  - IdenticalTitlesTests.swift
  - NavigationStyleTests.swift
  - ViewModifierIntegrationTests.swift
  - VisibilityAwareModifierTests.swift
.gitignore
LICENSE
Package.swift
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">
  <img width="128" height="128" src="./Sources/Afloat/Afloat.docc/Resources/Icon.png" alt="Afloat Icon">
  <h1><b>Afloat</b></h1>
  <p>
    Contextual navigation titles that animate based on scroll position for SwiftUI.
  </p>
</div>

## Overview

Afloat provides dynamic navigation titles and subtitles that respond to scroll events in SwiftUI. Perfect for list-based interfaces where you want the navigation bar to display context about what the user is viewing.

- **Contextual Navigation** — Titles and subtitles that change as users scroll
- **Native Look & Feel** — Animations match iOS's default behavior
- **Cross-Platform** — iOS, macOS, and visionOS
- **SwiftUI Native** — Drop-in replacements for standard modifiers
- **Lightweight** — No dependencies, small footprint

## Installation

```swift
dependencies: [
    .package(url: "https://github.com/AdelaideSky/Afloat.git", from: "1.0.0")
]
```

## Usage

```swift
import Afloat

NavigationStack {
    ScrollView {
        ForEach(sections) { section in
            SectionHeader(section)
                .navigationTitle(.contextual, section.name)
                .navigationSubtitle(.contextual, "\(section.items.count) items")
        }
    }
    .contextualNavigation(defaultTitle: "All Sections")
}
```

See [RecipeBookExample.swift](Sources/Afloat/Examples/RecipeBookExample.swift) for a complete example.

## Customization

Use `.contextualNavigationTransition()` to customize the animation between titles (e.g., `.opacity`, `.numericText()`, `.interpolate`). Defaults to `.identity`.

## How It Works

Afloat uses SwiftUI's `PreferenceKey` system to track the position of views marked with contextual navigation modifiers. When a view scrolls past the top edge of the screen, its title and subtitle are collected and displayed in the navigation bar. The `ContextualNavigationManager` monitors these preference updates and determines which title should be active based on scroll position, creating smooth transitions between sections.

## Documentation

Full API reference and guides are available in the DocC documentation.

## Roadmap

- [ ] Add support for Large navigation title
- [x] More animation options (.numericText etc)
- [ ] Toolbars support

## License

MIT. See [LICENSE](LICENSE) for details.

## Contact

- [Website](https://adesky.fr/)
- [Twitter](https://x.com/ade_sky_/)
- [LinkedIn](https://www.linkedin.com/in/adelaidehumez/)

Afloat

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Afloat

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README