drewster99/swiftui-auto-scrolling-scrollview

Getting Started

Requires iOS 18 / macOS 15 or higher.

Include SwiftUIAutoScrollingScrollView in your project.

In Xcode:

• Add this package dependency by pasting the URL: https://github.com/drewster99/swiftui-auto-scrolling-scrollview

As a dependency in your own Swift Package

In a Swift Package's Package.swift file, add this to your package's "dependencies" array:

.package(url: "https://github.com/drewster99/swiftui-auto-scrolling-scrollview.git", branch: "main")

Then, add the dependency to any target's you've declared. If it doesn't already have one, add one after name:

.target(
  name: "MyTarget",
  dependencies: [
      .product(name: "SwiftUIAutoScrollingScrollView", package: "swiftui-auto-scrolling-scrollview")
]

Use it in your own Swift code

Use it like you'd use ScrollView, with the addition of the autoScrollingOnChangeOf parameter, like this:

import Foundation
import SwiftUI
import SwiftUIAutoScrollingScrollView

struct ContentView: View {
    /// This would be the "data model" that will drive auto scrolling
    @State var items: [String] = []
    
    var body: some View {
        AutoScrollingScrollView(.vertical, autoScrollingOnChangeOf: dataModel) {
            LazyVStack {
                ForEach(items, id: \.self) { item in
                    Text("Item: \(item)")
                        .padding()
                }
            }
        }
    }
}   

Example Project

Check out the AutoScrollingScrollViewExample project within the Examples folder. It simulates a chat message list, where some number of messages are static, and there is current message at the bottom which is "streamed" in continuously, with many rapid updates.

Package Metadata

Repository: drewster99/swiftui-auto-scrolling-scrollview

Default branch: main

README: README.md