SimpleExpandableView
ExpandableView structure
Example
ExpandableView(
headerSize: CGSize(width: 250.0, height: 50.0),
cardSize: CGSize(width: 250.0, height: 250.0), header: {
Text("Hello world")
.foregroundColor(.white)
.frame(maxWidth: .infinity, maxHeight: .infinity)
.background(LinearGradient(colors: [.blue, .cyan], startPoint: .top, endPoint: .bottom))
}, content: {
VStack {
Image(systemName: "heart.fill")
.resizable()
.frame(width: 180, height: 180)
Text("Hi")
.font(.title2)
}
.foregroundColor(.white)
})
.cardBackgroundColor(.cyan)
.shadow(shadowRadius: 0.0)
.listRowSeparator(.hidden)
.frame(maxWidth: .infinity) // align center
.padding(.vertical, 5.0)
To run the example project, clone the repo, and run pod install
from the Example directory first.
ExpandableView Interfaces
Initialization
init(
headerSize: CGSize,
cardSize: CGSize,
@ViewBuilder header: () -> Header,
@ViewBuilder content: () -> Content,
onTapped action: (() -> ())? = nil // action to do when the header view is tapped
)
Methods
// Change the background color of header view
func headerBackgroundColor(_ color: Color)
// Change the background color of the card view
func cardBackgroundColor(_ color: Color)
// Change the corner radius of the header view
func headerCornerRadius(_ radius: CGFloat)
// Change the corner radius of the card view
func cardCornerRadius(_ radius: CGFloat)
// Change the shadow of the whole view (both header view and card view will render shadow)
func shadow(shadowRadius: CGFloat = 6.0, color: Color = .gray, x: CGFloat = 0.0, y: CGFloat = 0.0)
// Determine the height of the card view by the `contentView` you passed instead of a fixed height
func dynamicCardHeight()
ExpandableViewsGroup Interfaces
Initialization
// Share the same `headerView`
init<Header>(
headerSize: CGSize,
cardSize: CGSize,
headerView: () -> Header,
contentViews: () -> [AnyView]
) where Header : View
// Using generics
init<Header, Content>(
headerSize: CGSize,
cardSize: CGSize,
headerViews: () -> [Header],
contentViews: () -> [Content]
) where Header : View, Content : View
// Using AnyView array
init(
headerSize: CGSize,
cardSize: CGSize,
headerViews: () -> [AnyView],
contentViews: () -> [AnyView]
)
// Using variadic parameters
init(
headerSize: CGSize,
cardSize: CGSize,
headerViews: AnyView...,
contentViews: AnyView...
)
Methods
// Set the vertical spacing between two `ExpandableView`
func verticalSpacing(_ spacing: CGFloat)
// Change the background color of the group
func backgroundColor(_ color: Color)
// Change the background color of all header views
func headersBackgroundColor(_ color: Color)
// Change the background color of all card views
func cardBackgroundColor(_ color: Color)
// Change the corner radius of all header views
func headerCornerRadius(_ radius: CGFloat)
// Change the corner radius of all card views
func cardCornerRadius(_ radius: CGFloat)
// Change the shadow of all views in the group (header views and card views included)
func shadow(shadowRadius: CGFloat = 6.0, color: Color = .gray, x: CGFloat = 0.0, y: CGFloat = 0.0)
// Set all `ExpandableView` in the group with `.dynamicCardHeight()`
func dynamicCardHeight()
Execute Xcode's Product > Build Documentation
and go to SimpleExpandableView
's documentation for more details.
Requirements
Swift >= 5.0
Installation
SimpleExpandableView is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'SimpleExpandableView'
# Note that if cocoapods cannot find `SimpleExpandableView`, please try the command below
# pod `SimpleExpandableView`, :git => 'https://github.com/Tomortec/SimpleExpandableView.git'
Author
Tomortec, [email protected]
License
SimpleExpandableView is available under the MIT license. See the LICENSE file for more info.