Tokamak/Sources/TokamakCore/Views/Layout/ScrollView.swift

132 lines
3.7 KiB
Swift

// Copyright 2020 Tokamak contributors
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
// Created by Carson Katri on 06/29/2020.
//
import Foundation
/// A scrollable view along a given axis.
///
/// By default, your app will overflow without the ability to scroll. Embed it in a `ScrollView`
/// to enable scrolling.
///
/// ScrollView {
/// ForEach(0..<10) {
/// Text("\($0)")
/// }
/// }
///
/// By default, the view will only expand to fit its children.
/// To make it fill its parent along the cross-axis, insert a stack with a `Spacer`:
///
/// ScrollView {
/// HStack { Spacer() } // Use VStack for a horizontal ScrollView
/// ForEach(0..<10) {
/// Text("\($0)")
/// }
/// }
public struct ScrollView<Content>: _PrimitiveView where Content: View {
public let content: Content
public let axes: Axis.Set
public let showsIndicators: Bool
public init(
_ axes: Axis.Set = .vertical,
showsIndicators: Bool = true,
@ViewBuilder content: () -> Content
) {
self.axes = axes
self.showsIndicators = showsIndicators
self.content = content()
}
public func _visitChildren<V>(_ visitor: V) where V: ViewVisitor {
visitor.visit(content)
}
}
extension ScrollView: ParentView {
@_spi(TokamakCore)
public var children: [AnyView] {
(content as? GroupView)?.children ?? [AnyView(content)]
}
}
public struct PinnedScrollableViews: OptionSet {
public let rawValue: UInt32
public init(rawValue: UInt32) {
self.rawValue = rawValue
}
public static let sectionHeaders: Self = .init(rawValue: 1 << 0)
public static let sectionFooters: Self = .init(rawValue: 1 << 1)
}
extension ScrollView: Layout {
public func sizeThatFits(
proposal: ProposedViewSize,
subviews: Subviews,
cache: inout ()
) -> CGSize {
let proposal = proposal.replacingUnspecifiedDimensions()
if axes.isEmpty {
return proposal
}
let contentProposal = ProposedViewSize(
width: axes.contains(.horizontal) ? nil : proposal.width,
height: axes.contains(.vertical) ? nil : proposal.height
)
let contentSize = subviews.reduce(into: CGSize.zero) {
let size = $1.sizeThatFits(contentProposal)
if size.width > $0.width {
$0.width = size.width
}
if size.height > $0.height {
$0.height = size.height
}
}
return .init(
width: axes.contains(.horizontal) ? proposal.width : contentSize.width,
height: axes.contains(.vertical) ? proposal.height : contentSize.height
)
}
public func placeSubviews(
in bounds: CGRect,
proposal: ProposedViewSize,
subviews: Subviews,
cache: inout ()
) {
let contentProposal = ProposedViewSize(
width: axes.contains(.horizontal) ? nil : proposal.width,
height: axes.contains(.vertical) ? nil : proposal.height
)
for subview in subviews {
if axes.contains(.horizontal) && axes.contains(.vertical) {
subview.place(
at: .init(x: bounds.midX, y: bounds.midY),
anchor: .center,
proposal: contentProposal
)
} else {
subview.place(
at: bounds.origin,
proposal: contentProposal
)
}
}
}
}