StickyFooterScrollView

StickyFooterScrollView is a lightweight and powerful Swift library that simplifies the creation of UIScrollView with a sticky footer. It eliminates the complexity of manually setting up constraints and provides an intuitive API for creating scrollable content with persistently visible footer elements.

🎯 Problem Solved

When creating UIScrollView in iOS development, developers often struggle with:

• Complex constraint management for scroll views
• Sticky footer implementation that remains visible during scrolling
• Content layout calculations for proper scrolling behavior
• Boilerplate code repetition across projects

StickyFooterScrollView solves these problems by providing a simple, declarative API that handles all the complexity internally.

✨ Features

• 🔧 Simple Setup: Initialize with just one line of code
• 📌 Sticky Footer: Footer remains visible at the bottom while content scrolls
• 📱 Auto Layout: Automatic constraint handling and layout management
• 🎨 Flexible Content: Support for any UIView as content and footer
• ⚙️ Customizable: Configurable spacing and padding options
• 🚀 Performance Optimized: Efficient scrolling and memory management
• 📦 Easy Integration: CocoaPods support with minimal setup

📋 Requirements

• iOS: 11.0+
• Swift: 5.0+
• Xcode: 11.0+

📦 Installation

CocoaPods

CocoaPods is the recommended way to install StickyFooterScrollView. Add the following line to your Podfile:

pod 'StickyFooterScrollView'

Then run:

pod install

Manual Installation

1. Download the project
2. Drag and drop the StickyFooterScrollView folder into your Xcode project
3. Make sure to add it to your target

🚀 Quick Start

import StickyFooterScrollView

class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        setupScrollView()
    }
    
    private func setupScrollView() {
        // 1. Create StickyFooterScrollView
        let scrollView = StickyFooterScrollView(minimumFooterTopOffset: 24)
        
        // 2. Add to parent view
        view.addSubview(scrollView)
        
        // 3. Setup constraints
        scrollView.translatesAutoresizingMaskIntoConstraints = false
        NSLayoutConstraint.activate([
            scrollView.topAnchor.constraint(equalTo: view.topAnchor),
            scrollView.leadingAnchor.constraint(equalTo: view.leadingAnchor),
            scrollView.trailingAnchor.constraint(equalTo: view.trailingAnchor),
            scrollView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor)
        ])
        
        // 4. Setup content and footer
        setupContent(scrollView)
        setupFooter(scrollView)
    }
}

📖 Usage Guide

1. Initialize StickyFooterScrollView

let scrollView = StickyFooterScrollView(minimumFooterTopOffset: 24)

The minimumFooterTopOffset parameter defines the minimum spacing between the content and the footer.

2. Setup Content View

Create your main content and add it to the scroll view:

private func setupContent(_ scrollView: StickyFooterScrollView) {
    // Create a stack view for organizing content
    let mainContentView = UIStackView()
    mainContentView.axis = .vertical
    mainContentView.spacing = 16
    
    // Add your content elements
    let imageView = UIImageView(image: UIImage(named: "hero_image"))
    imageView.contentMode = .scaleAspectFill
    imageView.clipsToBounds = true
    mainContentView.addArrangedSubview(imageView)
    
    let titleLabel = UILabel()
    titleLabel.text = "Welcome to Our App"
    titleLabel.font = UIFont.boldSystemFont(ofSize: 24)
    titleLabel.textColor = .black
    titleLabel.textAlignment = .center
    mainContentView.addArrangedSubview(titleLabel)
    
    let descriptionLabel = UILabel()
    descriptionLabel.text = "Experience the power of StickyFooterScrollView for creating beautiful, scrollable interfaces with persistent footer elements."
    descriptionLabel.font = UIFont.systemFont(ofSize: 16)
    descriptionLabel.textColor = .gray
    descriptionLabel.numberOfLines = 0
    descriptionLabel.textAlignment = .center
    mainContentView.addArrangedSubview(descriptionLabel)
    
    // Apply content view with padding
    scrollView.applyContentView(
        mainContentView,
        with: UIEdgeInsets(top: 24, left: 24, bottom: 24, right: 24)
    )
}

3. Setup Footer View

Create your footer content (typically buttons or actions):

private func setupFooter(_ scrollView: StickyFooterScrollView) {
    // Create footer container
    let footerContainer = UIStackView()
    footerContainer.axis = .vertical
    footerContainer.spacing = 12
    
    // Primary action button
    let primaryButton = UIButton(type: .system)
    primaryButton.setTitle("Get Started", for: .normal)
    primaryButton.titleLabel?.font = UIFont.boldSystemFont(ofSize: 18)
    primaryButton.setTitleColor(.white, for: .normal)
    primaryButton.backgroundColor = .systemBlue
    primaryButton.layer.cornerRadius = 12
    primaryButton.heightAnchor.constraint(equalToConstant: 50).isActive = true
    
    // Secondary action button
    let secondaryButton = UIButton(type: .system)
    secondaryButton.setTitle("Learn More", for: .normal)
    secondaryButton.titleLabel?.font = UIFont.systemFont(ofSize: 16)
    secondaryButton.setTitleColor(.systemBlue, for: .normal)
    secondaryButton.backgroundColor = .clear
    secondaryButton.layer.borderWidth = 1
    secondaryButton.layer.borderColor = UIColor.systemBlue.cgColor
    secondaryButton.layer.cornerRadius = 12
    secondaryButton.heightAnchor.constraint(equalToConstant: 50).isActive = true
    
    footerContainer.addArrangedSubview(primaryButton)
    footerContainer.addArrangedSubview(secondaryButton)
    
    // Apply footer view with padding
    scrollView.applyFooterView(
        footerContainer,
        with: UIEdgeInsets(top: 16, left: 24, bottom: 24, right: 24)
    )
}

4. Update Layout (Important!)

In your viewDidAppear method, call updateLayout() to ensure proper constraint setup:

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    scrollView.updateLayout()
}

🎨 Advanced Usage

Custom Spacing and Padding

You can customize the spacing and padding for both content and footer:

// Content with custom padding
scrollView.applyContentView(
    contentView,
    with: UIEdgeInsets(top: 32, left: 16, bottom: 32, right: 16)
)

// Footer with custom padding
scrollView.applyFooterView(
    footerView,
    with: UIEdgeInsets(top: 20, left: 20, bottom: 40, right: 20)
)

Dynamic Content

You can update the content dynamically:

func updateContent() {
    let newContentView = createDynamicContent()
    scrollView.applyContentView(newContentView, with: standardPadding)
    scrollView.updateLayout()
}

Complex Footer Layouts

Create sophisticated footer layouts with multiple elements:

private func createComplexFooter() -> UIView {
    let container = UIView()
    container.backgroundColor = UIColor.systemBackground
    
    // Add shadow
    container.layer.shadowColor = UIColor.black.cgColor
    container.layer.shadowOffset = CGSize(width: 0, height: -2)
    container.layer.shadowRadius = 4
    container.layer.shadowOpacity = 0.1
    
    // Add your complex layout here
    // ...
    
    return container
}

💡 Best Practices

1. Always call updateLayout() in viewDidAppear for proper constraint setup
2. Use UIStackView for organizing content to leverage auto layout
3. Set proper height constraints for footer elements to ensure consistent appearance
4. Consider safe area insets when setting up the scroll view constraints
5. Test on different device sizes to ensure responsive design

🔧 Example Project

To run the example project:

1. Clone the repository
2. Navigate to the Example directory
3. Run pod install
4. Open the .xcworkspace file
5. Build and run the project

🎯 Use Cases

StickyFooterScrollView is perfect for:

• Onboarding screens with persistent action buttons
• Product detail pages with add-to-cart buttons
• Forms with submit buttons always visible
• Terms and conditions with accept/decline buttons
• Article readers with sharing options
• E-commerce product listings with checkout buttons

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

Development Guidelines

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

🐛 Known Issues

• Make sure to call updateLayout() in viewDidAppear for proper layout
• When updating content dynamically, always call updateLayout() afterward

📞 Support

If you encounter any issues or have questions:

1. Check the Issues page
2. Create a new issue with detailed information
3. Contact the maintainer at thinhnguyen12389@gmail.com

🏆 Acknowledgments

• The iOS developer community for inspiration and feedback
• Contributors who help improve the library
• Developers who test and provide valuable feedback

📄 License

StickyFooterScrollView is available under the MIT license. See the LICENSE file for more information.

👤 Author

fanta1ty

• GitHub: @fanta1ty
• Email: thinhnguyen12389@gmail.com

---

Made with ❤️ for the iOS development community

If this library helps you in your projects, please consider giving it a ⭐️ on GitHub!