Awesome Open Source
Awesome Open Source

ElegantTimeline

ElegantTimeline is a SwiftUI demonstration of a multi-faceted timline view with interactions between the calendar, list, and app theme.

If you are a developer or designer, this repository is meant for you. Down below, I've listed all the features this demonstration app includes so you can learn more about a feature you're interested in implementing yourself.

ALSO, please do this repository justice and run it on an actual device. It will look so much more elegant with the bezels and rounded corners and run smoother as the simulator isn't suited for hardcore renders like deez. The app is compatible and looks good on any iPhone but for best experience, run it on an iPhone X or above. The list snaps to the nearest cell based on the top notch bezel. How cool is that.

Requirements

  • iOS 13.1+(Weird bug on iOS 13.0 with SwiftUI.AccessibilityNode`)
  • Xcode 11

Introduction

ElegantTimeline is inspired by TimePage and is part of a larger repository of elegant demonstrations like this: TimePage Clone. It uses ElegantColorPalette(theme picker), ElegantPages and ElegantCalendar, libraries I wrote specifically for this demonstration. Specifically, check out ElegantColorPalette as it is UIKit and SwiftUI compatible!

Also, make sure to check out TimePrints, an app that I'm working on that'll utilize this UI for visits tracking. Funny thing is, I've been so busy developing the components that eventually be implemented inside my app that I haven't actually worked much on my app in the past month.

Features

The screenshots below link to embedded youtube videos demonstrating the feature even further

Startup Theme Picker

What you can learn:

  • Leveraging ElegantColorPalette and SpriteKit to create a totally unique and amazing theme picker
  • The physics behind SKNodes
  • The custom fade and splash animation when the user finalizes their color choice

Relevant code:

Paging + Theme Change

What you can learn:

  • Custom gestures for different page turns: the calendar has a different animation for its page turn than the other views
  • The paging animation when you move from the list to the menu view: rounding the corners and decreasing the height of the list view
    • This feature actually gave me a headache. If you actually try to round the corners of the list view itself, the list gets offset and all kinds of wack happens. I've actually reduced all the sideeffects by just layering a view with a transparent inner RoundedRectangle with its edges in black.
  • Use of GestureMask while paging
  • Animating and offsetting the monthly calendar properly to have that bit of list background showing to the right
  • Overlaying the list and configuring opacity to achieve a smooth fade effect while paging
  • Animating and rotating a partial screen menu
  • The animation behind the theme change
  • Propogation of new theme down to all subviews. Actually quite tricky because if you propogate new theme changes everytime you select a new theme, there'll be a lot of lag. Thus, theme propogation happens as the user exits the theme picker view. But again, propogation doesn't apply immediately to all the views. First, it propogates the new theme to the list overlay view, as rerendering that view with a new theme is super quick. Doing so allows the spring transition animation to remain stable and only after the animation completes is the calendar's theme rerendered(which is more render intensive).

Relevant code:

  • HomeView: The root view that acts as the page view. You can command click into all the other views from here.
  • ResizingOverlayView: The view behind the list to menu animation.
  • ThemePickerView: Responsible for the theme scene with the balls.
  • PageScrollState: Logic behind different animations for different page turns
  • HomeManager: Logic behind the theme propogation.

SideBar that tracks current month and year + Visits slideshow list + Weeks/Months ago popup

What you can learn:

  • The SideBar really is just 2 Text that are juggled depending on the current offset. So you can see the logic behind that
  • The list is really just a UITableView UIViewRepresentable
    • How to make sure @State isn't transferred over for reused cells
    • How to make sure visible cells move onto the next "slide" at the same time
  • The weeks/months ago popup relies heavily on the list logic, depending on whether the list is dragging or not, etc

Relevant code:

Monthly Calendar and list interaction

What you can learn:

  • The interaction
    • When you scroll to a new month in the list, the calendar also scrolls to that same month
    • When you scroll to a new month in the calendar, the list scrolls to the last day of that month
    • When you tap a day in the calendar, the list scrolls to that day
  • Learn which UITableViewDelegate methods to implement that make this really efficient
    • The calendar isn't scrolling to a new month everytime the list scrolls to a new month
    • Only after the list stops scrolling does the calendar then scroll to the current month
    • Swiping to a different page - the calendar or menu - is forbidden while scrolling in the list so you can look into the code to find out how that works

Relevant code:

  • HomeManager: Handles the communication between the list and calendar
  • ListScrollState: Implements the necessary UITableViewDelegate methods for this to work

Yearly Calendar and list interaction

What you can learn:

  • The interaction
    • When you tap a month in the yearly calendar, the monthly calendar switches over to that month and the list also scrolls ot the last day of that month
      • This is great if you want to get to a date that's far away quick
    • When you scroll to a new year in the list, the yearly calendar doesn't immediately scroll to that year
      • Only after you scroll back to the yearly calendar does it scroll to that year

Relevant code:

  • HomeManager: Handles the communication between the list and calendar
  • ListScrollState: Implements the necessary UITableViewDelegate methods for this to work

Fast Scrolling

What you can learn:

  • How it works
    • Make sure you're on the list view. Start dragging the month-year sidebar in whichever direction you want to fast scroll in.
    • Make sure that this gesture is entirely vertical because just a bit of horizontal translation will cease the fast scroll
    • Just a very intuitive gesture that makes sense if the user doesn't feel like scrolling to the calendar
    • The same calendar interactions apply here too: whatever month the fast scroll ends on is also the month the calendar scrolls to
  • Learn about how custom scrolling is simulated in the list through interacting with the contentOffset of the UITableView
    • There is a specific timing function needed in order to animate the custom scroll elegantly
    • The fast scroll also snaps to whatever cell it ends near, in a smooth manner

Relevant code:

Scrolling back to today

What you can learn:

  • The custom scale animation that occurs when you tap the button and the fade out animation afterwards
  • Logic behind scrolling to the current day and when to show the button

Relevant code:

Header and footer quote

What you can learn:

  • Just a pretty cool easter egg I added. Based off of the current list's scroll offset and whether it's scrolled past its edges or not

Relevant code:

Resources

Also, here's a dump of resources I found useful when working on this

License

This project is licensed under the MIT License - see the LICENSE file for details

Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Swift (65,849
Theme (43,403
Animation (17,632
Calendar (9,878
Interaction (4,629
Swiftui (2,258
Swiftui Example (136
Swiftui Components (69
Swiftui Learning (59
Swiftui Animations (47
Swiftui Demo (32
Timelineview (15