{"id":18357025,"url":"https://github.com/gumob/fluidable","last_synced_at":"2025-04-06T12:32:26.855Z","repository":{"id":56911495,"uuid":"194376085","full_name":"gumob/Fluidable","owner":"gumob","description":"A Swift library that allows you to create a custom transition conforming to Fluid Interfaces.","archived":false,"fork":false,"pushed_at":"2020-07-03T09:12:36.000Z","size":8729,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-03-22T00:33:59.779Z","etag":null,"topics":["carthage","framework","interface","swift"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gumob.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-06-29T07:10:55.000Z","updated_at":"2023-04-10T02:10:14.000Z","dependencies_parsed_at":"2022-08-20T20:20:36.271Z","dependency_job_id":null,"html_url":"https://github.com/gumob/Fluidable","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gumob%2FFluidable","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gumob%2FFluidable/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gumob%2FFluidable/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gumob%2FFluidable/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gumob","download_url":"https://codeload.github.com/gumob/Fluidable/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247484495,"owners_count":20946388,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["carthage","framework","interface","swift"],"created_at":"2024-11-05T22:12:35.360Z","updated_at":"2025-04-06T12:32:21.843Z","avatar_url":"https://github.com/gumob.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg)](https://github.com/gumob/Fluidable)\n[![Version](http://img.shields.io/cocoapods/v/Fluidable.svg)](http://cocoadocs.org/docsets/Fluidable)\n[![Platform](http://img.shields.io/cocoapods/p/Fluidable.svg)](http://cocoadocs.org/docsets/Fluidable)\n[![Build Status](https://travis-ci.com/gumob/Fluidable.svg?branch=master)](https://travis-ci.com/gumob/Fluidable)\n[![codecov](https://codecov.io/gh/gumob/Fluidable/branch/master/graph/badge.svg)](https://codecov.io/gh/gumob/Fluidable)\n[![Reviewed by Hound](https://img.shields.io/badge/Reviewed_by-Hound-8E64B0.svg)](https://houndci.com)\n![Language](https://img.shields.io/badge/Language-Swift%205.0-orange.svg)\n![Packagist](https://img.shields.io/packagist/l/doctrine/orm.svg)\n\n# Fluidable\nA Swift library that allows you to create a custom transition conforming to Fluid Interfaces.\n\n## Features \u0026 To-Do\n- [x] Support `UINavigationControllerDelegate` and `UIViewControllerTransitioningDelegate`\n- [x] Interactive and intrruptible transition with `UIScrollView`, `UITableView`, and `UICollectionView`\n- [x] Additional animations for view controllers that can be defined in the delegate method (supports both `UIViewPropertyAnimator` and` Core Animation`)\n- [x] Monitor transition states and progress with delegate methods\n- [x] Customizable presentation style (Fluid, Drawer, and Slide)\n- [x] Resizable drawer\n- [x] Customizable style (rounded corner, shadow, and background effect)\n- [x] Customizable animation easing and duration\n- [ ] Interact with underlying views like Apple Maps\n- [ ] Custom transitions with user-definable plug-ins\n- [ ] Support iOS 10\n\nFluid                      |  Drawer                   | Slide\n:-------------------------:|:-------------------------:|:-------------------------:\n![](https://media.githubusercontent.com/media/gumob/Fluidable-Metadata/master/Movies/Exports/Fluidable-fluid-modal.gif)  |  ![](https://media.githubusercontent.com/media/gumob/Fluidable-Metadata/master/Movies/Exports/Fluidable-drawer-bottom.gif)  |  ![](https://media.githubusercontent.com/media/gumob/Fluidable-Metadata/master/Movies/Exports/Fluidable-slide-bottom.gif)\n![](https://media.githubusercontent.com/media/gumob/Fluidable-Metadata/master/Movies/Exports/Fluidable-fluid-fullscreen.gif)  |  ![](https://media.githubusercontent.com/media/gumob/Fluidable-Metadata/master/Movies/Exports/Fluidable-drawer-right.gif)  |  ![](https://media.githubusercontent.com/media/gumob/Fluidable-Metadata/master/Movies/Exports/Fluidable-slide-right.gif)\n\n## Requirements\n\n- iOS 10.0 or later\n- Swift 5.0\n\n## Installation\n\n### Carthage\n\nAdd the following to your `Cartfile` and follow [these instructions](https://github.com/Carthage/Carthage#adding-frameworks-to-an-application).\n\n```\ngithub \"gumob/Fluidable\"\n```\n\n### CocoaPods\n\nTo integrate Fluidable into your project, add the following to your `Podfile`.\n\n```ruby\nplatform :ios, '10.0'\nuse_frameworks!\n\npod 'Fluidable'\n```\n\n## Example application\nRepository contains example sources under [Example](https://github.com/gumob/Fluidable/tree/master/Example) directory. Structure of the application is simple, but the project contains mutiple case of UI petterns to showcase capabilities of the library.\nYou can build an example app by choosing `FluidableExample` from the Xcode schemes.\n\n## Usage\n\nFull documentation is available at [https://gumob.github.io/Fluidable/](https://gumob.github.io/Fluidable/).\u003cbr/\u003e\nYou can find more specific implementations by searching the [Example](https://github.com/gumob/Fluidable/tree/master/Example) sources with \"`IMPORTANT: 🌊`\".\n\n\n### Custom transition using [`UIViewControllerTransitioningDelegate`](https://developer.apple.com/documentation/uikit/uiviewcontrollertransitioningdelegate)\n\n1) Import [`Fluidable`](https://gumob.github.io/Fluidable/Protocols/Fluidable.html) framework to your project files:\n```swift\nimport UIKit\nimport Fluidable\n```\n\n2) Initialze [`Fluidable`](https://gumob.github.io/Fluidable/Protocols/Fluidable.html) framework in `AppDelegate`:\n```swift\nclass AppDelegate: UIResponder, UIApplicationDelegate {\n  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -\u003e Bool {\n      FluidableInit()\n      return true\n  }\n}\n```\n\n3) Conform to [`Fluidable`](https://gumob.github.io/Fluidable/Protocols/Fluidable.html) protocol in the \u003cspan style=\"color:magenta\"\u003esource\u003c/span\u003e view controller:\n```swift\nclass RootViewController: UICollectionViewController, Fluidable {\n  required init?(coder aDecoder: NSCoder) {\n      super.init(coder: aDecoder)\n      self.fluidDelegate = self\n  }\n}\n```\n\n4) Conform to [`FluidTransitionSourceConfigurationDelegate`](https://gumob.github.io/Fluidable/Protocols/FluidTransitionSourceConfigurationDelegate.html) and [`FluidTransitionSourceActionDelegate`](https://gumob.github.io/Fluidable/Protocols/FluidTransitionSourceActionDelegate.html) protocols in the \u003cspan style=\"color:magenta\"\u003esource\u003c/span\u003e view controller:\n```swift\nextension RootViewController: FluidTransitionSourceConfigurationDelegate {\n  /* Implement delegate methods */\n}\nextension RootViewController: FluidTransitionSourceActionDelegate {\n  /* Implement delegate methods */\n}\n```\n\n5) Conform to [`Fluidable`](https://gumob.github.io/Fluidable/Protocols/Fluidable.html) protocol in the \u003cspan style=\"color:magenta\"\u003edestination\u003c/span\u003e view controller:\n```swift\nclass TransitionScrollViewController: TransitionBaseViewController, Fluidable {\n  var fluidableTransitionDelegate: FluidViewControllerTransitioningDelegate = FluidViewControllerTransitioningDelegate()\n  required init?(coder aDecoder: NSCoder) {\n      super.init(coder: aDecoder)\n        self.transitioningDelegate = self.fluidableTransitionDelegate\n        self.fluidDelegate = self\n  }\n}\n```\n\n6) Conform to [`FluidTransitionDestinationConfigurationDelegate`](https://gumob.github.io/Fluidable/Protocols/FluidTransitionDestinationConfigurationDelegate.html) and [`FluidTransitionDestinationActionDelegate`](https://gumob.github.io/Fluidable/Protocols/FluidTransitionDestinationActionDelegate.html) protocols in the \u003cspan style=\"color:magenta\"\u003edestination\u003c/span\u003e view controller:\n```swift\nextension TransitionScrollViewController: FluidTransitionDestinationConfigurationDelegate {\n  /* Implement delegate methods */\n}\nextension TransitionScrollViewController: FluidTransitionDestinationActionDelegate {\n  /* Implement delegate methods */\n}\n```\n\n\n### Custom transition using [`UINavigationControllerDelegate`](https://developer.apple.com/documentation/uikit/uinavigationcontrollerdelegate)\n\n1) Import `Fluidable` framework to your project files:\n```swift\nimport UIKit\nimport Fluidable\n```\n\n2) Initialze `Fluidable` framework in `AppDelegate`:\n```swift\nclass AppDelegate: UIResponder, UIApplicationDelegate {\n  func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -\u003e Bool {\n      FluidableInit()\n      return true\n  }\n}\n```\n\n3) Conform to [`Fluidable`](https://gumob.github.io/Fluidable/Protocols/Fluidable.html) protocol in the \u003cspan style=\"color:magenta\"\u003esource\u003c/span\u003e view controller:\n```swift\nclass RootViewController: UICollectionViewController, Fluidable {\n  required init?(coder aDecoder: NSCoder) {\n      super.init(coder: aDecoder)\n      self.fluidDelegate = self\n  }\n}\n```\n\n4) Conform to [`FluidTransitionSourceConfigurationDelegate`](https://gumob.github.io/Fluidable/Protocols/FluidTransitionSourceConfigurationDelegate.html) and [`FluidTransitionSourceActionDelegate`](https://gumob.github.io/Fluidable/Protocols/FluidTransitionSourceActionDelegate.html) protocols in the \u003cspan style=\"color:magenta\"\u003esource\u003c/span\u003e view controller:\n```swift\nextension RootViewController: FluidTransitionSourceConfigurationDelegate {\n  /* Implement delegate methods */\n}\nextension RootViewController: FluidTransitionSourceActionDelegate {\n  /* Implement delegate methods */\n}\n```\n\n5) Conform to [`Fluidable`](https://gumob.github.io/Fluidable/Protocols/Fluidable.html) protocol in the \u003cspan style=\"color:magenta\"\u003edestination\u003c/span\u003e view controller:\n```swift\nclass TransitionScrollViewController: TransitionBaseViewController, Fluidable {\n  var fluidableTransitionDelegate: FluidViewControllerTransitioningDelegate = FluidViewControllerTransitioningDelegate()\n  required init?(coder aDecoder: NSCoder) {\n      super.init(coder: aDecoder)\n        self.transitioningDelegate = self.fluidableTransitionDelegate\n        self.fluidDelegate = self\n  }\n}\n```\n\n6) Conform to [`FluidTransitionDestinationConfigurationDelegate`](https://gumob.github.io/Fluidable/Protocols/FluidTransitionDestinationConfigurationDelegate.html) and [`FluidTransitionDestinationActionDelegate`](https://gumob.github.io/Fluidable/Protocols/FluidTransitionDestinationActionDelegate.html) protocols in the \u003cspan style=\"color:magenta\"\u003edestination\u003c/span\u003e view controller:\n```swift\nextension TransitionScrollViewController: FluidTransitionDestinationConfigurationDelegate {\n  /* Implement delegate methods */\n}\nextension TransitionScrollViewController: FluidTransitionDestinationActionDelegate {\n  /* Implement delegate methods */\n}\n```\n\n### Resizable drawer\n\nThe [`FluidResizableTransitionDelegate`](https://gumob.github.io/Fluidable/Protocols/FluidResizableTransitionDelegate.html) is available for only bottom drawer.\n\n1) Conform to [`FluidResizableTransitionDelegate`](https://gumob.github.io/Fluidable/Protocols/FluidResizableTransitionDelegate.html) protocol in the \u003cspan style=\"color:magenta\"\u003edestination\u003c/span\u003e view controller:\n```swift\nclass TransitionScrollViewController: TransitionBaseViewController, Fluidable, FluidResizable {\n  required init?(coder aDecoder: NSCoder) {\n      super.init(coder: aDecoder)\n      self.transitioningDelegate = self.fluidableTransitionDelegate\n      self.fluidDelegate = self\n      self.fluidResizableDelegate = self\n  }\n}\n\nextension TransitionScrollViewController: FluidResizableTransitionDelegate {\n    func transitionShouldPerformResizing() -\u003e Bool { return true }\n    func transitionMinimumMarginForResizing() -\u003e CGFloat { return 64 }\n    func transitionSnapPositionsForResizing() -\u003e [CGFloat]? { return [0.0, 0.5, 1.0] }\n    func transitionInteractiveResizeDidProgress(state: FluidProgressState, position: CGFloat, info: FluidGestureInfo) {\n    }\n}\n```\n\n\n\n\n## Copyright\n\nFluidable is released under MIT license, which means you can modify it, redistribute it or use it however you like.\n\nAll image embedded in the example project are downloaded from [Pexels](https://www.pexels.com/royalty-free-images/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgumob%2Ffluidable","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgumob%2Ffluidable","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgumob%2Ffluidable/lists"}