Release v1.3.3

Expand the surface mask's height

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,27 @@
+> Please fill out this template when filing an issue.
+>
+> Please remove this line and everything above it before submitting.
+
+### Short description
+
+### Expected behavior
+
+### Actual behavior
+
+### Steps to reproduce
+
+**Code example that reproduces the issue**
+
+### Environment
+
+**Library version**
+
+**Installation method**
+
+- [ ] CocoaPods
+- [ ] Carthage
+- [ ] Git submodules
+
+**iOS version(s)**
+
+**Xcode version**

.travis.yml

@@ -0,0 +1,55 @@
+language: swift
+branches:
+  only:
+    - master
+    - next
+cache:
+  directories:
+  - /usr/local/Homebrew
+  - $HOME/Library/Caches/Homebrew
+before_cache:
+  - brew cleanup
+env:
+  global:
+  - LANG=en_US.UTF-8
+  - LC_ALL=en_US.UTF-8
+skip_cleanup: true
+jobs:
+  include:
+  - stage: Build framework(swift 4.1)
+    osx_image: xcode9.4
+    script:
+    - xcodebuild -scheme FloatingPanel clean build
+
+  - stage: Build framework(swift 4.2)
+    osx_image: xcode10
+    script:
+    - xcodebuild -scheme FloatingPanel clean build
+
+  - stage: Carthage
+    osx_image: xcode10
+    before_install:
+    - brew update
+    - brew outdated carthage || brew upgrade carthage
+    script:
+    - carthage build --no-skip-current
+
+  - stage: Podspec
+    osx_image: xcode10
+    script:
+    - pod spec lint
+
+  - stage: Build maps example
+    osx_image: xcode10
+    script:
+    - xcodebuild -scheme Maps -sdk iphonesimulator clean build
+
+  - stage: Build stocks example
+    osx_image: xcode10
+    script:
+    - xcodebuild -scheme Stocks -sdk iphonesimulator clean build
+
+  - stage: Build samples example
+    osx_image: xcode10
+    script:
+    - xcodebuild -scheme Samples -sdk iphonesimulator clean build

Examples/Maps/Maps/Base.lproj/Main.storyboard

@@ -60,9 +60,9 @@
                         <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
                         <subviews>
                             <visualEffectView opaque="NO" contentMode="scaleToFill" translatesAutoresizingMaskIntoConstraints="NO" id="Ye3-uU-bq3">
-                                <rect key="frame" x="0.0" y="0.0" width="375" height="778"/>
+                                <rect key="frame" x="0.0" y="0.0" width="375" height="900"/>
                                 <view key="contentView" opaque="NO" clipsSubviews="YES" multipleTouchEnabled="YES" contentMode="center" insetsLayoutMarginsFromSafeArea="NO" id="ED1-gT-FBj">
-                                    <rect key="frame" x="0.0" y="0.0" width="375" height="778"/>
+                                    <rect key="frame" x="0.0" y="0.0" width="375" height="900"/>
                                     <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
                                     <subviews>
                                         <searchBar contentMode="redraw" searchBarStyle="minimal" translatesAutoresizingMaskIntoConstraints="NO" id="Zcj-SE-gb8">
@@ -70,7 +70,7 @@
                                             <textInputTraits key="textInputTraits"/>
                                         </searchBar>
                                         <tableView clipsSubviews="YES" contentMode="scaleToFill" alwaysBounceVertical="YES" showsHorizontalScrollIndicator="NO" showsVerticalScrollIndicator="NO" dataMode="prototypes" style="plain" separatorStyle="default" rowHeight="-1" estimatedRowHeight="-1" sectionHeaderHeight="28" sectionFooterHeight="28" translatesAutoresizingMaskIntoConstraints="NO" id="D7r-re-InH">
-                                            <rect key="frame" x="0.0" y="66" width="375" height="712"/>
+                                            <rect key="frame" x="0.0" y="66" width="375" height="748"/>
                                             <color key="backgroundColor" white="0.0" alpha="0.0" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
                                             <view key="tableHeaderView" contentMode="scaleToFill" id="u28-LY-hIh" customClass="SearchHeaderView" customModule="Maps" customModuleProvider="target">
                                                 <rect key="frame" x="0.0" y="0.0" width="375" height="116"/>
@@ -227,7 +227,7 @@
                                         <constraint firstAttribute="trailing" secondItem="D7r-re-InH" secondAttribute="trailing" id="BES-GA-Btp"/>
                                         <constraint firstItem="D7r-re-InH" firstAttribute="leading" secondItem="ED1-gT-FBj" secondAttribute="leading" id="UTe-YL-17h"/>
                                         <constraint firstItem="Zcj-SE-gb8" firstAttribute="top" secondItem="ED1-gT-FBj" secondAttribute="top" constant="6" id="apU-Pd-PEO"/>
-                                        <constraint firstAttribute="bottom" secondItem="D7r-re-InH" secondAttribute="bottom" id="vfS-Lx-TXz"/>
+                                        <constraint firstAttribute="bottom" secondItem="D7r-re-InH" secondAttribute="bottom" constant="86" id="vfS-Lx-TXz"/>
                                         <constraint firstItem="D7r-re-InH" firstAttribute="top" secondItem="Zcj-SE-gb8" secondAttribute="bottom" constant="4" id="vro-cd-B9c"/>
                                         <constraint firstItem="Zcj-SE-gb8" firstAttribute="leading" secondItem="ED1-gT-FBj" secondAttribute="leading" id="wMb-L2-Z0W"/>
                                     </constraints>
@@ -238,7 +238,7 @@
                         <color key="backgroundColor" white="0.0" alpha="0.0" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
                         <constraints>
                             <constraint firstItem="Ye3-uU-bq3" firstAttribute="leading" secondItem="G74-X7-Za8" secondAttribute="leading" id="Kr2-sU-ZWZ"/>
-                            <constraint firstItem="Ye3-uU-bq3" firstAttribute="bottom" secondItem="G74-X7-Za8" secondAttribute="bottom" id="aWM-s3-3o4"/>
+                            <constraint firstItem="Ye3-uU-bq3" firstAttribute="bottom" secondItem="Ncl-E9-yRn" secondAttribute="bottom" constant="88" id="aWM-s3-3o4"/>
                             <constraint firstItem="Ye3-uU-bq3" firstAttribute="trailing" secondItem="G74-X7-Za8" secondAttribute="trailing" id="fEL-8y-Acc"/>
                             <constraint firstItem="Ye3-uU-bq3" firstAttribute="top" secondItem="Ncl-E9-yRn" secondAttribute="top" id="w77-ba-FrJ"/>
                         </constraints>
@@ -247,6 +247,7 @@
                     <connections>
                         <outlet property="searchBar" destination="Zcj-SE-gb8" id="BH7-Gy-RG5"/>
                         <outlet property="tableView" destination="D7r-re-InH" id="nRN-fY-b8j"/>
+                        <outlet property="visualEffectView" destination="Ye3-uU-bq3" id="rS6-Mq-OKs"/>
                     </connections>
                 </viewController>
                 <placeholder placeholderIdentifier="IBFirstResponder" id="EqR-Hp-zhc" userLabel="First Responder" sceneMemberID="firstResponder"/>

Examples/Maps/Maps/ViewController.swift

@@ -26,8 +26,8 @@ class ViewController: UIViewController, MKMapViewDelegate, UISearchBarDelegate,
 
         searchVC = storyboard?.instantiateViewController(withIdentifier: "SearchPanel") as? SearchPanelViewController
 
-        // Add a content view controller
-        fpc.show(searchVC, sender: self)
+        // Set a content view controller
+        fpc.set(contentViewController: searchVC)
         fpc.track(scrollView: searchVC.tableView)
 
         setupMapView()
@@ -84,15 +84,16 @@ class ViewController: UIViewController, MKMapViewDelegate, UISearchBarDelegate,
     // MARK: FloatingPanelControllerDelegate
     
     func floatingPanel(_ vc: FloatingPanelController, layoutFor newCollection: UITraitCollection) -> FloatingPanelLayout? {
-        switch traitCollection.verticalSizeClass {
+        switch newCollection.verticalSizeClass {
         case .compact:
             fpc.surfaceView.borderWidth = 1.0 / traitCollection.displayScale
             fpc.surfaceView.borderColor = UIColor.black.withAlphaComponent(0.2)
+            return SearchPanelLandscapeLayout()
         default:
             fpc.surfaceView.borderWidth = 0.0
             fpc.surfaceView.borderColor = nil
+            return nil
         }
-        return nil
     }
 
     func floatingPanelDidMove(_ vc: FloatingPanelController) {
@@ -133,7 +134,8 @@ class SearchPanelViewController: UIViewController, UITableViewDataSource, UITabl
 
     @IBOutlet weak var tableView: UITableView!
     @IBOutlet weak var searchBar: UISearchBar!
-
+    @IBOutlet weak var visualEffectView: UIVisualEffectView!
+    
     override func viewDidLoad() {
         super.viewDidLoad()
         tableView.dataSource = self
@@ -143,6 +145,15 @@ class SearchPanelViewController: UIViewController, UITableViewDataSource, UITabl
         textField.font = UIFont(name: textField.font!.fontName, size: 15.0)
 
         hideHeader()
+
+    }
+
+    override func viewDidLayoutSubviews() {
+        super.viewDidLayoutSubviews()
+        if #available(iOS 10, *) {
+            visualEffectView.layer.cornerRadius = 9.0
+            visualEffectView.clipsToBounds = true
+        }
     }
 
     func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
@@ -193,6 +204,42 @@ class SearchPanelViewController: UIViewController, UITableViewDataSource, UITabl
     }
 }
 
+public class SearchPanelLandscapeLayout: FloatingPanelLayout {
+    public var initialPosition: FloatingPanelPosition {
+        return .tip
+    }
+    
+    public var supportedPositions: Set<FloatingPanelPosition> {
+        return [.full, .tip]
+    }
+
+    public func insetFor(position: FloatingPanelPosition) -> CGFloat? {
+        switch position {
+        case .full: return 16.0
+        case .tip: return 69.0
+        default: return nil
+        }
+    }
+
+    public func prepareLayout(surfaceView: UIView, in view: UIView) -> [NSLayoutConstraint] {
+        if #available(iOS 11.0, *) {
+            return [
+                surfaceView.leftAnchor.constraint(equalTo: view.safeAreaLayoutGuide.leftAnchor, constant: 8.0),
+                surfaceView.widthAnchor.constraint(equalToConstant: 291),
+            ]
+        } else {
+            return [
+                surfaceView.leftAnchor.constraint(equalTo: view.leftAnchor, constant: 8.0),
+                surfaceView.widthAnchor.constraint(equalToConstant: 291),
+            ]
+        }
+    }
+
+    public func backdropAlphaFor(position: FloatingPanelPosition) -> CGFloat {
+        return 0.0
+    }
+}
+
 class SearchCell: UITableViewCell {
     @IBOutlet weak var iconImageView: UIImageView!
     @IBOutlet weak var titleLabel: UILabel!

Examples/Samples/Samples.xcodeproj/project.pbxproj

@@ -165,6 +165,7 @@
 			isa = PBXNativeTarget;
 			buildConfigurationList = 545DBA1221511E6400CA77B8 /* Build configuration list for PBXNativeTarget "Samples" */;
 			buildPhases = (
+				54D7209621D4DB970054A255 /* ShellScript */,
 				545DB9E621511E6300CA77B8 /* Sources */,
 				545DB9E721511E6300CA77B8 /* Frameworks */,
 				545DB9E821511E6300CA77B8 /* Resources */,
@@ -285,6 +286,26 @@
 		};
 /* End PBXResourcesBuildPhase section */
 
+/* Begin PBXShellScriptBuildPhase section */
+		54D7209621D4DB970054A255 /* ShellScript */ = {
+			isa = PBXShellScriptBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			inputFileListPaths = (
+			);
+			inputPaths = (
+			);
+			outputFileListPaths = (
+			);
+			outputPaths = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+			shellPath = /bin/sh;
+			shellScript = "/usr/libexec/PlistBuddy -c \"Set :CFBundleVersion $(git rev-parse --abbrev-ref HEAD)($(git rev-parse --short HEAD))\" $SRCROOT/$INFOPLIST_FILE\n";
+		};
+/* End PBXShellScriptBuildPhase section */
+
 /* Begin PBXSourcesBuildPhase section */
 		545DB9E621511E6300CA77B8 /* Sources */ = {
 			isa = PBXSourcesBuildPhase;

Examples/Samples/Sources/Base.lproj/Main.storyboard

@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="14313.18" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" useSafeAreas="YES" colorMatched="YES" initialViewController="RoN-h0-uBD">
-    <device id="retina4_7" orientation="portrait">
+<document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="14460.31" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" useSafeAreas="YES" colorMatched="YES" initialViewController="RoN-h0-uBD">
+    <device id="retina5_9" orientation="portrait">
         <adaptation id="fullscreen"/>
     </device>
     <dependencies>
         <deployment identifier="iOS"/>
-        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="14283.14"/>
+        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="14460.20"/>
         <capability name="Safe area layout guides" minToolsVersion="9.0"/>
         <capability name="documents saved in the Xcode 8 format" minToolsVersion="8.0"/>
     </dependencies>
@@ -14,8 +14,8 @@
         <scene sceneID="Cjh-iX-VQw">
             <objects>
                 <navigationController id="RoN-h0-uBD" sceneMemberID="viewController">
-                    <navigationBar key="navigationBar" contentMode="scaleToFill" insetsLayoutMarginsFromSafeArea="NO" id="hNW-5m-Omi">
-                        <rect key="frame" x="0.0" y="20" width="375" height="44"/>
+                    <navigationBar key="navigationBar" contentMode="scaleToFill" insetsLayoutMarginsFromSafeArea="NO" largeTitles="YES" id="hNW-5m-Omi">
+                        <rect key="frame" x="0.0" y="44" width="375" height="96"/>
                         <autoresizingMask key="autoresizingMask"/>
                     </navigationBar>
                     <connections>
@@ -31,22 +31,22 @@
             <objects>
                 <viewController id="jF4-A0-Eq6" customClass="SampleListViewController" customModule="Samples" customModuleProvider="target" sceneMemberID="viewController">
                     <view key="view" contentMode="scaleToFill" id="Smh-Bd-AAc">
-                        <rect key="frame" x="0.0" y="0.0" width="375" height="667"/>
+                        <rect key="frame" x="0.0" y="0.0" width="375" height="812"/>
                         <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
                         <subviews>
                             <tableView clipsSubviews="YES" contentMode="scaleToFill" alwaysBounceVertical="YES" dataMode="prototypes" style="plain" separatorStyle="default" rowHeight="-1" estimatedRowHeight="-1" sectionHeaderHeight="28" sectionFooterHeight="28" translatesAutoresizingMaskIntoConstraints="NO" id="7IS-PU-x0P">
-                                <rect key="frame" x="0.0" y="0.0" width="375" height="667"/>
+                                <rect key="frame" x="0.0" y="0.0" width="375" height="778"/>
                                 <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
                                 <prototypes>
                                     <tableViewCell clipsSubviews="YES" contentMode="scaleToFill" preservesSuperviewLayoutMargins="YES" selectionStyle="default" indentationWidth="10" reuseIdentifier="Cell" textLabel="M0G-C8-hAO" style="IBUITableViewCellStyleDefault" id="ySY-oA-g81">
                                         <rect key="frame" x="0.0" y="28" width="375" height="44"/>
                                         <autoresizingMask key="autoresizingMask"/>
                                         <tableViewCellContentView key="contentView" opaque="NO" clipsSubviews="YES" multipleTouchEnabled="YES" contentMode="center" preservesSuperviewLayoutMargins="YES" insetsLayoutMarginsFromSafeArea="NO" tableViewCell="ySY-oA-g81" id="sXB-nH-2g2">
-                                            <rect key="frame" x="0.0" y="0.0" width="375" height="43.5"/>
+                                            <rect key="frame" x="0.0" y="0.0" width="375" height="43.666666666666664"/>
                                             <autoresizingMask key="autoresizingMask"/>
                                             <subviews>
                                                 <label opaque="NO" multipleTouchEnabled="YES" contentMode="left" insetsLayoutMarginsFromSafeArea="NO" text="Title" textAlignment="natural" lineBreakMode="tailTruncation" baselineAdjustment="alignBaselines" adjustsFontSizeToFit="NO" id="M0G-C8-hAO">
-                                                    <rect key="frame" x="15" y="0.0" width="345" height="43.5"/>
+                                                    <rect key="frame" x="15" y="0.0" width="345" height="43.666666666666664"/>
                                                     <autoresizingMask key="autoresizingMask"/>
                                                     <fontDescription key="fontDescription" type="system" pointSize="17"/>
                                                     <nil key="textColor"/>
@@ -61,60 +61,445 @@
                         <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
                         <constraints>
                             <constraint firstItem="7IS-PU-x0P" firstAttribute="top" secondItem="Smh-Bd-AAc" secondAttribute="top" id="6yd-jv-ey3"/>
-                            <constraint firstItem="7IS-PU-x0P" firstAttribute="leading" secondItem="TkN-Oh-wF8" secondAttribute="leading" id="Z6Y-Dc-cei"/>
-                            <constraint firstItem="7IS-PU-x0P" firstAttribute="bottom" secondItem="TkN-Oh-wF8" secondAttribute="bottom" id="fNW-DP-lhV"/>
-                            <constraint firstItem="7IS-PU-x0P" firstAttribute="trailing" secondItem="TkN-Oh-wF8" secondAttribute="trailing" id="vfY-Rc-FOI"/>
+                            <constraint firstItem="7IS-PU-x0P" firstAttribute="leading" secondItem="39L-Nq-qfp" secondAttribute="leading" id="Z6Y-Dc-cei"/>
+                            <constraint firstItem="7IS-PU-x0P" firstAttribute="bottom" secondItem="39L-Nq-qfp" secondAttribute="bottom" id="fNW-DP-lhV"/>
+                            <constraint firstItem="7IS-PU-x0P" firstAttribute="trailing" secondItem="39L-Nq-qfp" secondAttribute="trailing" id="vfY-Rc-FOI"/>
                         </constraints>
-                        <viewLayoutGuide key="safeArea" id="TkN-Oh-wF8"/>
+                        <viewLayoutGuide key="safeArea" id="39L-Nq-qfp"/>
                     </view>
-                    <navigationItem key="navigationItem" title="Samples" id="wCF-su-7up"/>
+                    <navigationItem key="navigationItem" title="Samples" id="wCF-su-7up">
+                        <barButtonItem key="rightBarButtonItem" title="Settings" id="rbH-U3-XyA">
+                            <connections>
+                                <action selector="showDebugMenu:" destination="jF4-A0-Eq6" id="j02-db-ZM5"/>
+                            </connections>
+                        </barButtonItem>
+                    </navigationItem>
                     <connections>
                         <outlet property="tableView" destination="7IS-PU-x0P" id="YFM-9W-eP4"/>
-                        <segue destination="bYI-y3-Rzb" kind="presentation" identifier="GoToTextView" id="6Ym-J6-Q6X"/>
                     </connections>
                 </viewController>
                 <placeholder placeholderIdentifier="IBFirstResponder" id="eP2-DG-flv" userLabel="First Responder" sceneMemberID="firstResponder"/>
             </objects>
             <point key="canvasLocation" x="57" y="27"/>
         </scene>
-        <!--Modal View Controller-->
-        <scene sceneID="C9P-Ns-Qrq">
+        <!--Settings View Controller-->
+        <scene sceneID="Bd0-D2-agO">
             <objects>
-                <viewController storyboardIdentifier="ModalViewController" id="bYI-y3-Rzb" customClass="ModalViewController" customModule="Samples" customModuleProvider="target" sceneMemberID="viewController">
-                    <view key="view" contentMode="scaleToFill" id="qwo-GK-p1U">
-                        <rect key="frame" x="0.0" y="0.0" width="375" height="667"/>
+                <viewController storyboardIdentifier="SettingsViewController" id="C1X-9Z-TyQ" customClass="SettingsViewController" customModule="Samples" customModuleProvider="target" sceneMemberID="viewController">
+                    <view key="view" contentMode="scaleToFill" insetsLayoutMarginsFromSafeArea="NO" id="af9-Zr-Ppc">
+                        <rect key="frame" x="0.0" y="0.0" width="375" height="197.33000000000001"/>
                         <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
                         <subviews>
-                            <view contentMode="scaleToFill" translatesAutoresizingMaskIntoConstraints="NO" id="vut-mK-Y4t" customClass="SafeAreaView" customModule="Samples" customModuleProvider="target">
-                                <rect key="frame" x="0.0" y="667" width="375" height="0.0"/>
-                                <color key="backgroundColor" white="0.66666666666666663" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
-                            </view>
-                            <button opaque="NO" contentMode="scaleToFill" contentHorizontalAlignment="center" contentVerticalAlignment="center" buttonType="roundedRect" lineBreakMode="middleTruncation" translatesAutoresizingMaskIntoConstraints="NO" id="sbF-Az-7sy">
-                                <rect key="frame" x="20" y="20" width="39" height="30"/>
+                            <stackView opaque="NO" contentMode="scaleToFill" axis="vertical" distribution="fillProportionally" alignment="center" spacing="16" translatesAutoresizingMaskIntoConstraints="NO" id="n93-ZL-fmC">
+                                <rect key="frame" x="32" y="16" width="311" height="147.33333333333334"/>
+                                <subviews>
+                                    <label opaque="NO" userInteractionEnabled="NO" contentMode="left" horizontalHuggingPriority="251" verticalHuggingPriority="251" text="Version: 1.0" textAlignment="natural" lineBreakMode="tailTruncation" baselineAdjustment="alignBaselines" adjustsFontSizeToFit="NO" translatesAutoresizingMaskIntoConstraints="NO" id="WmC-Tq-NDN">
+                                        <rect key="frame" x="118.33333333333334" y="0.0" width="74.333333333333343" height="17"/>
+                                        <fontDescription key="fontDescription" type="system" pointSize="14"/>
+                                        <nil key="textColor"/>
+                                        <nil key="highlightedColor"/>
+                                    </label>
+                                    <label opaque="NO" userInteractionEnabled="NO" contentMode="left" horizontalHuggingPriority="251" verticalHuggingPriority="251" text="UINavigationBar" textAlignment="natural" lineBreakMode="tailTruncation" baselineAdjustment="alignBaselines" adjustsFontSizeToFit="NO" translatesAutoresizingMaskIntoConstraints="NO" id="Ulg-gS-ah0">
+                                        <rect key="frame" x="90.666666666666686" y="33" width="130" height="20.333333333333329"/>
+                                        <fontDescription key="fontDescription" style="UICTFontTextStyleHeadline"/>
+                                        <nil key="textColor"/>
+                                        <nil key="highlightedColor"/>
+                                    </label>
+                                    <stackView opaque="NO" contentMode="scaleToFill" alignment="center" spacing="126" translatesAutoresizingMaskIntoConstraints="NO" id="uEf-g4-CeU">
+                                        <rect key="frame" x="23.333333333333343" y="69.333333333333329" width="264.33333333333326" height="31"/>
+                                        <subviews>
+                                            <label opaque="NO" userInteractionEnabled="NO" contentMode="left" horizontalHuggingPriority="251" verticalHuggingPriority="251" text="Large Titles" textAlignment="natural" lineBreakMode="tailTruncation" baselineAdjustment="alignBaselines" adjustsFontSizeToFit="NO" translatesAutoresizingMaskIntoConstraints="NO" id="ogl-S5-4tJ">
+                                                <rect key="frame" x="0.0" y="5.3333333333333428" width="89.333333333333329" height="20.333333333333332"/>
+                                                <fontDescription key="fontDescription" type="system" pointSize="17"/>
+                                                <nil key="textColor"/>
+                                                <nil key="highlightedColor"/>
+                                            </label>
+                                            <switch opaque="NO" contentMode="scaleToFill" horizontalHuggingPriority="750" verticalHuggingPriority="750" contentHorizontalAlignment="center" contentVerticalAlignment="center" translatesAutoresizingMaskIntoConstraints="NO" id="js8-Qv-lUC">
+                                                <rect key="frame" x="215.33333333333334" y="0.0" width="51.000000000000028" height="31"/>
+                                                <connections>
+                                                    <action selector="toggleLargeTitle:" destination="C1X-9Z-TyQ" eventType="valueChanged" id="FJS-Ty-mCY"/>
+                                                </connections>
+                                            </switch>
+                                        </subviews>
+                                    </stackView>
+                                    <stackView opaque="NO" contentMode="scaleToFill" spacing="126" translatesAutoresizingMaskIntoConstraints="NO" id="ZtZ-Dz-4cC">
+                                        <rect key="frame" x="23.333333333333343" y="116.33333333333334" width="264.66666666666663" height="31"/>
+                                        <subviews>
+                                            <label opaque="NO" userInteractionEnabled="NO" contentMode="left" horizontalHuggingPriority="251" verticalHuggingPriority="251" text="Translucent" textAlignment="natural" lineBreakMode="tailTruncation" baselineAdjustment="alignBaselines" adjustsFontSizeToFit="NO" translatesAutoresizingMaskIntoConstraints="NO" id="Z5i-rm-QgL">
+                                                <rect key="frame" x="0.0" y="0.0" width="89.666666666666671" height="31"/>
+                                                <fontDescription key="fontDescription" type="system" pointSize="17"/>
+                                                <nil key="textColor"/>
+                                                <nil key="highlightedColor"/>
+                                            </label>
+                                            <switch opaque="NO" contentMode="scaleToFill" horizontalHuggingPriority="750" verticalHuggingPriority="750" contentHorizontalAlignment="center" contentVerticalAlignment="center" translatesAutoresizingMaskIntoConstraints="NO" id="s6b-j9-8Kw">
+                                                <rect key="frame" x="215.66666666666666" y="0.0" width="50.999999999999972" height="31"/>
+                                                <connections>
+                                                    <action selector="toggleTranslucent:" destination="C1X-9Z-TyQ" eventType="valueChanged" id="nL4-3L-9hh"/>
+                                                </connections>
+                                            </switch>
+                                        </subviews>
+                                    </stackView>
+                                </subviews>
+                            </stackView>
+                        </subviews>
+                        <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
+                        <constraints>
+                            <constraint firstItem="0hr-ty-yWm" firstAttribute="bottom" secondItem="n93-ZL-fmC" secondAttribute="bottom" id="2Ey-ou-E1M"/>
+                            <constraint firstAttribute="trailing" secondItem="n93-ZL-fmC" secondAttribute="trailing" constant="32" id="DdZ-eB-F5s"/>
+                            <constraint firstItem="n93-ZL-fmC" firstAttribute="leading" secondItem="af9-Zr-Ppc" secondAttribute="leading" constant="32" id="TyK-GP-Ari"/>
+                            <constraint firstItem="n93-ZL-fmC" firstAttribute="top" secondItem="af9-Zr-Ppc" secondAttribute="topMargin" constant="16" id="mbC-6H-z9M"/>
+                        </constraints>
+                        <viewLayoutGuide key="safeArea" id="0hr-ty-yWm"/>
+                    </view>
+                    <size key="freeformSize" width="375" height="197.33000000000001"/>
+                    <connections>
+                        <outlet property="largeTitlesSwicth" destination="js8-Qv-lUC" id="FOm-6k-ffi"/>
+                        <outlet property="translucentSwicth" destination="s6b-j9-8Kw" id="jmf-WH-bzZ"/>
+                        <outlet property="versionLabel" destination="WmC-Tq-NDN" id="Woh-kK-U0m"/>
+                    </connections>
+                </viewController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="M9h-4V-3M0" userLabel="First Responder" sceneMemberID="firstResponder"/>
+            </objects>
+            <point key="canvasLocation" x="708" y="-200"/>
+        </scene>
+        <!--Layout 2-->
+        <scene sceneID="lRc-OZ-sL4">
+            <objects>
+                <viewController id="RpE-lI-27a" customClass="TabBarContentViewController" customModule="Samples" customModuleProvider="target" sceneMemberID="viewController">
+                    <view key="view" contentMode="scaleToFill" id="JER-jz-KSq">
+                        <rect key="frame" x="0.0" y="0.0" width="375" height="812"/>
+                        <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
+                        <subviews>
+                            <button opaque="NO" contentMode="scaleToFill" contentHorizontalAlignment="center" contentVerticalAlignment="center" buttonType="roundedRect" lineBreakMode="middleTruncation" translatesAutoresizingMaskIntoConstraints="NO" id="IvG-yp-yzI">
+                                <rect key="frame" x="20" y="44" width="39" height="30"/>
                                 <state key="normal" title="Close"/>
                                 <connections>
-                                    <action selector="closeWithSender:" destination="bYI-y3-Rzb" eventType="touchUpInside" id="MSC-ch-YJK"/>
+                                    <action selector="closeWithSender:" destination="RpE-lI-27a" eventType="touchUpInside" id="hj3-Xv-6Gq"/>
+                                    <action selector="closeWithSender:" destination="bYI-y3-Rzb" eventType="touchUpInside" id="rg4-OH-Ojn"/>
                                 </connections>
                             </button>
                         </subviews>
                         <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
                         <constraints>
-                            <constraint firstItem="sbF-Az-7sy" firstAttribute="top" secondItem="GBa-yx-8to" secondAttribute="top" id="3VR-hj-zeQ"/>
-                            <constraint firstAttribute="bottom" secondItem="vut-mK-Y4t" secondAttribute="bottom" id="6eq-Kt-heZ"/>
-                            <constraint firstItem="sbF-Az-7sy" firstAttribute="leading" secondItem="GBa-yx-8to" secondAttribute="leading" constant="20" id="T2G-1L-PRs"/>
-                            <constraint firstItem="vut-mK-Y4t" firstAttribute="leading" secondItem="qwo-GK-p1U" secondAttribute="leading" id="gVC-jv-VJX"/>
-                            <constraint firstItem="vut-mK-Y4t" firstAttribute="trailing" secondItem="GBa-yx-8to" secondAttribute="trailing" id="jkq-p2-lUm"/>
-                            <constraint firstItem="vut-mK-Y4t" firstAttribute="top" secondItem="GBa-yx-8to" secondAttribute="bottom" id="rMy-JT-t4B"/>
+                            <constraint firstItem="IvG-yp-yzI" firstAttribute="top" secondItem="954-Dk-zvc" secondAttribute="top" id="18k-sV-PgT"/>
+                            <constraint firstItem="954-Dk-zvc" firstAttribute="trailing" relation="greaterThanOrEqual" secondItem="IvG-yp-yzI" secondAttribute="trailing" id="mpr-u5-MZu"/>
+                            <constraint firstItem="IvG-yp-yzI" firstAttribute="leading" secondItem="954-Dk-zvc" secondAttribute="leading" constant="20" id="pYt-jE-CTF"/>
                         </constraints>
-                        <viewLayoutGuide key="safeArea" id="GBa-yx-8to"/>
+                        <viewLayoutGuide key="safeArea" id="954-Dk-zvc"/>
                     </view>
+                    <tabBarItem key="tabBarItem" tag="1" title="Layout 2" id="qb3-RB-B28"/>
+                </viewController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="NhZ-u5-Beh" userLabel="First Responder" sceneMemberID="firstResponder"/>
+            </objects>
+            <point key="canvasLocation" x="-308" y="1546"/>
+        </scene>
+        <!--Layout 3-->
+        <scene sceneID="r9h-Ql-gIv">
+            <objects>
+                <viewController id="pOk-Zm-vD9" customClass="TabBarContentViewController" customModule="Samples" customModuleProvider="target" sceneMemberID="viewController">
+                    <view key="view" contentMode="scaleToFill" id="85d-ub-G8k">
+                        <rect key="frame" x="0.0" y="0.0" width="375" height="812"/>
+                        <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
+                        <subviews>
+                            <button opaque="NO" contentMode="scaleToFill" contentHorizontalAlignment="center" contentVerticalAlignment="center" buttonType="roundedRect" lineBreakMode="middleTruncation" translatesAutoresizingMaskIntoConstraints="NO" id="NbG-e8-HdI">
+                                <rect key="frame" x="20" y="44" width="39" height="30"/>
+                                <state key="normal" title="Close"/>
+                                <connections>
+                                    <action selector="closeWithSender:" destination="pOk-Zm-vD9" eventType="touchUpInside" id="111-PD-Pop"/>
+                                    <action selector="closeWithSender:" destination="bYI-y3-Rzb" eventType="touchUpInside" id="1Rg-YG-TtU"/>
+                                </connections>
+                            </button>
+                        </subviews>
+                        <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
+                        <constraints>
+                            <constraint firstItem="0ao-SI-QZW" firstAttribute="trailing" relation="greaterThanOrEqual" secondItem="NbG-e8-HdI" secondAttribute="trailing" id="K9F-6x-KWn"/>
+                            <constraint firstItem="NbG-e8-HdI" firstAttribute="top" secondItem="0ao-SI-QZW" secondAttribute="top" id="nsE-so-rTl"/>
+                            <constraint firstItem="NbG-e8-HdI" firstAttribute="leading" secondItem="0ao-SI-QZW" secondAttribute="leading" constant="20" id="sF4-Dm-aoY"/>
+                        </constraints>
+                        <viewLayoutGuide key="safeArea" id="0ao-SI-QZW"/>
+                    </view>
+                    <tabBarItem key="tabBarItem" tag="2" title="Layout 3" id="RJD-TF-Sdh"/>
+                </viewController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="Oe3-FT-q1C" userLabel="First Responder" sceneMemberID="firstResponder"/>
+            </objects>
+            <point key="canvasLocation" x="332" y="1546"/>
+        </scene>
+        <!--Layout 1-->
+        <scene sceneID="m6X-j6-yBM">
+            <objects>
+                <viewController id="lto-Zc-Vtp" customClass="TabBarContentViewController" customModule="Samples" customModuleProvider="target" sceneMemberID="viewController">
+                    <view key="view" contentMode="scaleToFill" id="ji9-Ez-N7i">
+                        <rect key="frame" x="0.0" y="0.0" width="375" height="812"/>
+                        <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
+                        <subviews>
+                            <button opaque="NO" contentMode="scaleToFill" contentHorizontalAlignment="center" contentVerticalAlignment="center" buttonType="roundedRect" lineBreakMode="middleTruncation" translatesAutoresizingMaskIntoConstraints="NO" id="eFN-tN-4Ct">
+                                <rect key="frame" x="20" y="44" width="39" height="30"/>
+                                <state key="normal" title="Close"/>
+                                <connections>
+                                    <action selector="closeWithSender:" destination="bYI-y3-Rzb" eventType="touchUpInside" id="YL4-GP-ZEZ"/>
+                                    <action selector="closeWithSender:" destination="lto-Zc-Vtp" eventType="touchUpInside" id="llo-9x-fQv"/>
+                                </connections>
+                            </button>
+                        </subviews>
+                        <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
+                        <constraints>
+                            <constraint firstItem="eFN-tN-4Ct" firstAttribute="leading" secondItem="5Ns-4l-Ufg" secondAttribute="leading" constant="20" id="5BT-yZ-EKe"/>
+                            <constraint firstItem="5Ns-4l-Ufg" firstAttribute="trailing" relation="greaterThanOrEqual" secondItem="eFN-tN-4Ct" secondAttribute="trailing" id="OzZ-Dz-RNF"/>
+                            <constraint firstItem="eFN-tN-4Ct" firstAttribute="top" secondItem="5Ns-4l-Ufg" secondAttribute="top" id="hUV-3a-XkY"/>
+                        </constraints>
+                        <viewLayoutGuide key="safeArea" id="5Ns-4l-Ufg"/>
+                    </view>
+                    <tabBarItem key="tabBarItem" title="Layout 1" id="HEV-kf-jxH"/>
+                </viewController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="bkL-bc-hZC" userLabel="First Responder" sceneMemberID="firstResponder"/>
+            </objects>
+            <point key="canvasLocation" x="-962" y="1546"/>
+        </scene>
+        <!--Intrinsic View Controller-->
+        <scene sceneID="wtJ-qZ-aCl">
+            <objects>
+                <viewController storyboardIdentifier="IntrinsicViewController" title="Intrinsic View Controller" id="aK0-kv-mTu" sceneMemberID="viewController">
+                    <view key="view" contentMode="scaleToFill" id="eLM-xc-d9e">
+                        <rect key="frame" x="0.0" y="0.0" width="375" height="778"/>
+                        <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
+                        <subviews>
+                            <label opaque="NO" userInteractionEnabled="NO" contentMode="left" horizontalHuggingPriority="1000" verticalHuggingPriority="1000" horizontalCompressionResistancePriority="1000" verticalCompressionResistancePriority="1000" text="Change this text" textAlignment="center" lineBreakMode="tailTruncation" numberOfLines="0" baselineAdjustment="alignBaselines" adjustsFontSizeToFit="NO" translatesAutoresizingMaskIntoConstraints="NO" id="ge4-RW-Gmz">
+                                <rect key="frame" x="24" y="24" width="327" height="20.333333333333329"/>
+                                <fontDescription key="fontDescription" type="system" pointSize="17"/>
+                                <nil key="textColor"/>
+                                <nil key="highlightedColor"/>
+                            </label>
+                        </subviews>
+                        <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
+                        <constraints>
+                            <constraint firstAttribute="trailing" secondItem="ge4-RW-Gmz" secondAttribute="trailing" constant="24" id="V59-MD-Lcg"/>
+                            <constraint firstItem="ge4-RW-Gmz" firstAttribute="leading" secondItem="eLM-xc-d9e" secondAttribute="leading" constant="24" id="hAO-P0-7Kw"/>
+                            <constraint firstItem="ge4-RW-Gmz" firstAttribute="top" secondItem="eLM-xc-d9e" secondAttribute="top" constant="24" id="j0s-fd-MYj"/>
+                            <constraint firstAttribute="bottom" relation="greaterThanOrEqual" secondItem="ge4-RW-Gmz" secondAttribute="bottom" constant="24" id="tEn-PO-nVD"/>
+                        </constraints>
+                        <viewLayoutGuide key="safeArea" id="ouu-g9-OiX"/>
+                    </view>
+                    <size key="freeformSize" width="375" height="778"/>
+                </viewController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="DfE-fL-zy5" userLabel="First Responder" sceneMemberID="firstResponder"/>
+            </objects>
+            <point key="canvasLocation" x="2753" y="734"/>
+        </scene>
+        <!--Tab Bar View Controller-->
+        <scene sceneID="nQ5-PV-qFw">
+            <objects>
+                <tabBarController storyboardIdentifier="TabBarViewController" id="c7K-XJ-TlT" customClass="TabBarViewController" customModule="Samples" customModuleProvider="target" sceneMemberID="viewController">
+                    <tabBar key="tabBar" contentMode="scaleToFill" insetsLayoutMarginsFromSafeArea="NO" id="BPL-Dp-5pJ">
+                        <rect key="frame" x="0.0" y="0.0" width="375" height="49"/>
+                        <autoresizingMask key="autoresizingMask"/>
+                        <color key="backgroundColor" white="0.0" alpha="0.0" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
+                    </tabBar>
+                    <connections>
+                        <segue destination="lto-Zc-Vtp" kind="relationship" relationship="viewControllers" id="6hP-AH-YiH"/>
+                        <segue destination="RpE-lI-27a" kind="relationship" relationship="viewControllers" id="g6X-Sq-uSW"/>
+                        <segue destination="pOk-Zm-vD9" kind="relationship" relationship="viewControllers" id="OPp-iO-iDK"/>
+                    </connections>
+                </tabBarController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="Z9x-EI-p2b" userLabel="First Responder" sceneMemberID="firstResponder"/>
+            </objects>
+            <point key="canvasLocation" x="-706" y="749"/>
+        </scene>
+        <!--Modal View Controller-->
+        <scene sceneID="C9P-Ns-Qrq">
+            <objects>
+                <viewController storyboardIdentifier="ModalViewController" id="bYI-y3-Rzb" customClass="ModalViewController" customModule="Samples" customModuleProvider="target" sceneMemberID="viewController">
+                    <view key="view" contentMode="scaleToFill" id="qwo-GK-p1U">
+                        <rect key="frame" x="0.0" y="0.0" width="375" height="778"/>
+                        <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
+                        <subviews>
+                            <view contentMode="scaleToFill" translatesAutoresizingMaskIntoConstraints="NO" id="vut-mK-Y4t" customClass="SafeAreaView" customModule="Samples" customModuleProvider="target">
+                                <rect key="frame" x="0.0" y="744" width="375" height="34"/>
+                                <color key="backgroundColor" white="0.66666666666666663" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
+                            </view>
+                            <button opaque="NO" contentMode="scaleToFill" contentHorizontalAlignment="center" contentVerticalAlignment="center" buttonType="roundedRect" lineBreakMode="middleTruncation" translatesAutoresizingMaskIntoConstraints="NO" id="sbF-Az-7sy">
+                                <rect key="frame" x="20" y="44" width="39" height="30"/>
+                                <state key="normal" title="Close"/>
+                                <connections>
+                                    <action selector="closeWithSender:" destination="bYI-y3-Rzb" eventType="touchUpInside" id="MSC-ch-YJK"/>
+                                </connections>
+                            </button>
+                            <stackView opaque="NO" contentMode="scaleToFill" axis="vertical" alignment="top" spacing="44" translatesAutoresizingMaskIntoConstraints="NO" id="9p4-06-y2T">
+                                <rect key="frame" x="139.66666666666666" y="132" width="96" height="252"/>
+                                <subviews>
+                                    <button opaque="NO" contentMode="scaleToFill" contentHorizontalAlignment="center" contentVerticalAlignment="center" buttonType="roundedRect" lineBreakMode="middleTruncation" translatesAutoresizingMaskIntoConstraints="NO" id="i9x-x5-n1q">
+                                        <rect key="frame" x="0.0" y="0.0" width="80" height="30"/>
+                                        <state key="normal" title="Move to full"/>
+                                        <connections>
+                                            <action selector="moveToFullWithSender:" destination="bYI-y3-Rzb" eventType="touchUpInside" id="TDe-3J-gIR"/>
+                                        </connections>
+                                    </button>
+                                    <button opaque="NO" contentMode="scaleToFill" contentHorizontalAlignment="center" contentVerticalAlignment="center" buttonType="roundedRect" lineBreakMode="middleTruncation" translatesAutoresizingMaskIntoConstraints="NO" id="2u5-cH-RAN">
+                                        <rect key="frame" x="0.0" y="74" width="85" height="30"/>
+                                        <state key="normal" title="Move to half"/>
+                                        <connections>
+                                            <action selector="moveToHalfWithSender:" destination="bYI-y3-Rzb" eventType="touchUpInside" id="12s-o7-Et5"/>
+                                        </connections>
+                                    </button>
+                                    <button opaque="NO" contentMode="scaleToFill" contentHorizontalAlignment="center" contentVerticalAlignment="center" buttonType="roundedRect" lineBreakMode="middleTruncation" translatesAutoresizingMaskIntoConstraints="NO" id="M4A-iO-RIE">
+                                        <rect key="frame" x="0.0" y="148" width="77" height="30"/>
+                                        <state key="normal" title="Move to tip"/>
+                                        <connections>
+                                            <action selector="moveToTipWithSender:" destination="bYI-y3-Rzb" eventType="touchUpInside" id="BmL-91-9ai"/>
+                                        </connections>
+                                    </button>
+                                    <button opaque="NO" contentMode="scaleToFill" contentHorizontalAlignment="center" contentVerticalAlignment="center" buttonType="roundedRect" lineBreakMode="middleTruncation" translatesAutoresizingMaskIntoConstraints="NO" id="szf-HE-QTk">
+                                        <rect key="frame" x="0.0" y="222" width="96" height="30"/>
+                                        <state key="normal" title="Update layout"/>
+                                        <connections>
+                                            <action selector="updateLayout:" destination="bYI-y3-Rzb" eventType="touchUpInside" id="Woz-a7-YMJ"/>
+                                        </connections>
+                                    </button>
+                                </subviews>
+                            </stackView>
+                        </subviews>
+                        <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
+                        <constraints>
+                            <constraint firstItem="sbF-Az-7sy" firstAttribute="top" secondItem="kjr-TP-fcM" secondAttribute="top" id="3VR-hj-zeQ"/>
+                            <constraint firstItem="9p4-06-y2T" firstAttribute="top" secondItem="kjr-TP-fcM" secondAttribute="top" constant="88" id="41n-Fn-hi3"/>
+                            <constraint firstAttribute="bottom" secondItem="vut-mK-Y4t" secondAttribute="bottom" id="6eq-Kt-heZ"/>
+                            <constraint firstItem="sbF-Az-7sy" firstAttribute="leading" secondItem="kjr-TP-fcM" secondAttribute="leading" constant="20" id="T2G-1L-PRs"/>
+                            <constraint firstItem="vut-mK-Y4t" firstAttribute="leading" secondItem="kjr-TP-fcM" secondAttribute="leading" id="gVC-jv-VJX"/>
+                            <constraint firstItem="vut-mK-Y4t" firstAttribute="trailing" secondItem="kjr-TP-fcM" secondAttribute="trailing" id="jkq-p2-lUm"/>
+                            <constraint firstItem="9p4-06-y2T" firstAttribute="centerX" secondItem="kjr-TP-fcM" secondAttribute="centerX" id="l8t-p3-ETf"/>
+                            <constraint firstItem="vut-mK-Y4t" firstAttribute="top" secondItem="kjr-TP-fcM" secondAttribute="bottom" id="rMy-JT-t4B"/>
+                        </constraints>
+                        <viewLayoutGuide key="safeArea" id="kjr-TP-fcM"/>
+                    </view>
+                    <size key="freeformSize" width="375" height="778"/>
                     <connections>
                         <outlet property="safeAreaView" destination="vut-mK-Y4t" id="r9P-XF-wLd"/>
                     </connections>
                 </viewController>
                 <placeholder placeholderIdentifier="IBFirstResponder" id="fbi-LZ-M4Y" userLabel="First Responder" sceneMemberID="firstResponder"/>
             </objects>
-            <point key="canvasLocation" x="57" y="-758"/>
+            <point key="canvasLocation" x="1375" y="734"/>
+        </scene>
+        <!--Nested Scroll View Controller-->
+        <scene sceneID="TfC-A3-4R0">
+            <objects>
+                <viewController storyboardIdentifier="NestedScrollViewController" id="LAe-jm-k6f" customClass="NestedScrollViewController" customModule="Samples" customModuleProvider="target" sceneMemberID="viewController">
+                    <view key="view" contentMode="scaleToFill" id="414-Wy-0t1">
+                        <rect key="frame" x="0.0" y="0.0" width="375" height="778"/>
+                        <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
+                        <subviews>
+                            <scrollView clipsSubviews="YES" multipleTouchEnabled="YES" contentMode="scaleToFill" translatesAutoresizingMaskIntoConstraints="NO" id="sBe-tN-uMi">
+                                <rect key="frame" x="0.0" y="32" width="375" height="746"/>
+                                <subviews>
+                                    <stackView opaque="NO" contentMode="scaleToFill" axis="vertical" translatesAutoresizingMaskIntoConstraints="NO" id="lFR-Sp-Sj1">
+                                        <rect key="frame" x="0.0" y="0.0" width="375" height="968"/>
+                                        <subviews>
+                                            <scrollView clipsSubviews="YES" multipleTouchEnabled="YES" contentMode="scaleToFill" alwaysBounceHorizontal="YES" pagingEnabled="YES" showsVerticalScrollIndicator="NO" bouncesZoom="NO" translatesAutoresizingMaskIntoConstraints="NO" id="xba-kG-VQ2">
+                                                <rect key="frame" x="0.0" y="0.0" width="375" height="242"/>
+                                                <subviews>
+                                                    <stackView opaque="NO" contentMode="scaleToFill" translatesAutoresizingMaskIntoConstraints="NO" id="WRe-tD-KTb">
+                                                        <rect key="frame" x="0.0" y="0.0" width="1125" height="242"/>
+                                                        <subviews>
+                                                            <view contentMode="scaleToFill" translatesAutoresizingMaskIntoConstraints="NO" id="WuE-iq-0GW">
+                                                                <rect key="frame" x="0.0" y="0.0" width="375" height="242"/>
+                                                                <color key="backgroundColor" red="1" green="0.57810515169999999" blue="0.0" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
+                                                            </view>
+                                                            <view contentMode="scaleToFill" translatesAutoresizingMaskIntoConstraints="NO" id="w5Y-44-79g">
+                                                                <rect key="frame" x="375" y="0.0" width="375" height="242"/>
+                                                                <color key="backgroundColor" red="0.0078431372550000003" green="0.72156862749999995" blue="0.45882352939999999" alpha="1" colorSpace="calibratedRGB"/>
+                                                            </view>
+                                                            <view contentMode="scaleToFill" translatesAutoresizingMaskIntoConstraints="NO" id="jQf-k3-eAa">
+                                                                <rect key="frame" x="750" y="0.0" width="375" height="242"/>
+                                                                <color key="backgroundColor" red="0.016804177310000001" green="0.19835099580000001" blue="1" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
+                                                            </view>
+                                                        </subviews>
+                                                        <constraints>
+                                                            <constraint firstItem="w5Y-44-79g" firstAttribute="width" secondItem="WuE-iq-0GW" secondAttribute="width" id="kHy-eU-guw"/>
+                                                            <constraint firstAttribute="height" constant="242" id="qzg-fI-j20"/>
+                                                            <constraint firstItem="jQf-k3-eAa" firstAttribute="width" secondItem="WuE-iq-0GW" secondAttribute="width" id="zDe-Uj-FO0"/>
+                                                        </constraints>
+                                                    </stackView>
+                                                </subviews>
+                                                <constraints>
+                                                    <constraint firstItem="WRe-tD-KTb" firstAttribute="leading" secondItem="xba-kG-VQ2" secondAttribute="leading" id="7QG-dB-afb"/>
+                                                    <constraint firstAttribute="height" constant="242" id="Efw-D6-ksg"/>
+                                                    <constraint firstAttribute="trailing" secondItem="WRe-tD-KTb" secondAttribute="trailing" id="ReM-cV-k0J"/>
+                                                    <constraint firstItem="WRe-tD-KTb" firstAttribute="top" secondItem="xba-kG-VQ2" secondAttribute="top" id="Xla-QL-qwm"/>
+                                                    <constraint firstItem="WuE-iq-0GW" firstAttribute="width" secondItem="xba-kG-VQ2" secondAttribute="width" id="qm0-cd-P69"/>
+                                                    <constraint firstAttribute="bottom" secondItem="WRe-tD-KTb" secondAttribute="bottom" id="uha-Eo-lsv"/>
+                                                </constraints>
+                                            </scrollView>
+                                            <view contentMode="scaleToFill" translatesAutoresizingMaskIntoConstraints="NO" id="j8d-Tc-XQn">
+                                                <rect key="frame" x="0.0" y="242" width="375" height="242"/>
+                                                <color key="backgroundColor" red="0.0078431372550000003" green="0.72156862749999995" blue="0.45882352939999999" alpha="1" colorSpace="calibratedRGB"/>
+                                                <constraints>
+                                                    <constraint firstAttribute="height" constant="242" id="Kw8-aw-DIp"/>
+                                                </constraints>
+                                            </view>
+                                            <view contentMode="scaleToFill" translatesAutoresizingMaskIntoConstraints="NO" id="bxy-HF-a7J">
+                                                <rect key="frame" x="0.0" y="484" width="375" height="242"/>
+                                                <color key="backgroundColor" red="1" green="0.2527923882" blue="1" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
+                                                <constraints>
+                                                    <constraint firstAttribute="height" constant="242" id="AIb-xl-srX"/>
+                                                </constraints>
+                                            </view>
+                                            <view contentMode="scaleToFill" translatesAutoresizingMaskIntoConstraints="NO" id="ZzA-fs-Va5">
+                                                <rect key="frame" x="0.0" y="726" width="375" height="242"/>
+                                                <color key="backgroundColor" red="0.016804177310000001" green="0.19835099580000001" blue="1" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
+                                                <constraints>
+                                                    <constraint firstAttribute="height" constant="242" id="TC1-jO-Wcz"/>
+                                                </constraints>
+                                            </view>
+                                        </subviews>
+                                    </stackView>
+                                </subviews>
+                                <constraints>
+                                    <constraint firstItem="lFR-Sp-Sj1" firstAttribute="width" secondItem="sBe-tN-uMi" secondAttribute="width" id="AtD-2C-97K"/>
+                                    <constraint firstAttribute="trailing" secondItem="lFR-Sp-Sj1" secondAttribute="trailing" id="F7t-Kr-VGd"/>
+                                    <constraint firstItem="lFR-Sp-Sj1" firstAttribute="leading" secondItem="sBe-tN-uMi" secondAttribute="leading" id="LzI-O9-5i0"/>
+                                    <constraint firstItem="lFR-Sp-Sj1" firstAttribute="top" secondItem="sBe-tN-uMi" secondAttribute="top" id="VwX-Hz-e8V"/>
+                                    <constraint firstAttribute="bottom" secondItem="lFR-Sp-Sj1" secondAttribute="bottom" id="hJt-0Z-dF3"/>
+                                </constraints>
+                            </scrollView>
+                        </subviews>
+                        <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
+                        <gestureRecognizers/>
+                        <constraints>
+                            <constraint firstItem="sBe-tN-uMi" firstAttribute="leading" secondItem="ufS-Rf-F2F" secondAttribute="leading" id="8Qd-my-knA"/>
+                            <constraint firstItem="sBe-tN-uMi" firstAttribute="top" secondItem="414-Wy-0t1" secondAttribute="top" constant="32" id="9Js-LU-lNr"/>
+                            <constraint firstAttribute="bottom" secondItem="sBe-tN-uMi" secondAttribute="bottom" id="jzB-47-P7e"/>
+                            <constraint firstItem="ufS-Rf-F2F" firstAttribute="trailing" secondItem="sBe-tN-uMi" secondAttribute="trailing" id="nHG-wg-pLP"/>
+                        </constraints>
+                        <viewLayoutGuide key="safeArea" id="ufS-Rf-F2F"/>
+                        <connections>
+                            <outletCollection property="gestureRecognizers" destination="tOa-bf-zGz" appends="YES" id="zle-Sz-M3U"/>
+                            <outletCollection property="gestureRecognizers" destination="SCk-hG-weZ" appends="YES" id="OcK-FK-Lac"/>
+                            <outletCollection property="gestureRecognizers" destination="Fvp-Z6-eVc" appends="YES" id="Fds-J5-YCg"/>
+                        </connections>
+                    </view>
+                    <size key="freeformSize" width="375" height="778"/>
+                    <connections>
+                        <outlet property="nestedScrollView" destination="xba-kG-VQ2" id="ddV-kf-37A"/>
+                        <outlet property="scrollView" destination="sBe-tN-uMi" id="h4S-Zl-cLO"/>
+                    </connections>
+                </viewController>
+                <placeholder placeholderIdentifier="IBFirstResponder" id="QSd-gF-l5h" userLabel="First Responder" sceneMemberID="firstResponder"/>
+                <pongPressGestureRecognizer allowableMovement="10" minimumPressDuration="0.5" id="tOa-bf-zGz">
+                    <connections>
+                        <action selector="longPressed:" destination="LAe-jm-k6f" id="sE8-3l-Aos"/>
+                    </connections>
+                </pongPressGestureRecognizer>
+                <tapGestureRecognizer id="SCk-hG-weZ">
+                    <connections>
+                        <action selector="tapped:" destination="LAe-jm-k6f" id="0Cw-vR-zRP"/>
+                    </connections>
+                </tapGestureRecognizer>
+                <swipeGestureRecognizer direction="right" id="Fvp-Z6-eVc">
+                    <connections>
+                        <action selector="swipped:" destination="LAe-jm-k6f" id="Hav-7p-Tg8"/>
+                    </connections>
+                </swipeGestureRecognizer>
+            </objects>
+            <point key="canvasLocation" x="2097" y="734"/>
         </scene>
         <!--Detail View Controller-->
         <scene sceneID="b6k-zi-3wn">
@@ -124,8 +509,19 @@
                         <rect key="frame" x="0.0" y="0.0" width="375" height="778"/>
                         <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
                         <subviews>
+                            <view contentMode="scaleToFill" translatesAutoresizingMaskIntoConstraints="NO" id="8yw-OC-Ubk">
+                                <rect key="frame" x="0.0" y="690" width="375" height="88"/>
+                                <color key="backgroundColor" white="0.66666666666666663" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
+                                <constraints>
+                                    <constraint firstAttribute="height" constant="88" id="jwV-YU-tXG"/>
+                                </constraints>
+                            </view>
+                            <view alpha="0.5" contentMode="scaleToFill" translatesAutoresizingMaskIntoConstraints="NO" id="Kva-Z7-0qY" customClass="OnSafeAreaView" customModule="Samples" customModuleProvider="target">
+                                <rect key="frame" x="0.0" y="44" width="375" height="700"/>
+                                <color key="backgroundColor" red="0.0078431372550000003" green="0.72156862749999995" blue="0.45882352939999999" alpha="1" colorSpace="calibratedRGB"/>
+                            </view>
                             <button opaque="NO" contentMode="scaleToFill" contentHorizontalAlignment="center" contentVerticalAlignment="center" buttonType="roundedRect" lineBreakMode="middleTruncation" translatesAutoresizingMaskIntoConstraints="NO" id="noi-1a-5bZ" customClass="CloseButton" customModule="Samples" customModuleProvider="target">
-                                <rect key="frame" x="319" y="12" width="44" height="44"/>
+                                <rect key="frame" x="319" y="44" width="44" height="44"/>
                                 <constraints>
                                     <constraint firstAttribute="height" constant="44" id="0jg-5D-A1F"/>
                                     <constraint firstAttribute="width" constant="44" id="1Cq-PA-wgW"/>
@@ -134,22 +530,81 @@
                                     <action selector="closeWithSender:" destination="YC8-ae-15L" eventType="touchUpInside" id="Z2v-19-S5k"/>
                                 </connections>
                             </button>
+                            <stackView opaque="NO" contentMode="scaleToFill" axis="vertical" spacing="22" translatesAutoresizingMaskIntoConstraints="NO" id="tP3-oJ-4EB">
+                                <rect key="frame" x="130.66666666666666" y="132" width="114" height="134"/>
+                                <subviews>
+                                    <button opaque="NO" contentMode="scaleToFill" contentHorizontalAlignment="center" contentVerticalAlignment="center" buttonType="roundedRect" lineBreakMode="middleTruncation" translatesAutoresizingMaskIntoConstraints="NO" id="c5r-jU-haj">
+                                        <rect key="frame" x="0.0" y="0.0" width="114" height="30"/>
+                                        <state key="normal" title="Show"/>
+                                        <connections>
+                                            <action selector="buttonPressed:" destination="YC8-ae-15L" eventType="touchUpInside" id="Mi1-o6-TWt"/>
+                                        </connections>
+                                    </button>
+                                    <button opaque="NO" contentMode="scaleToFill" contentHorizontalAlignment="center" contentVerticalAlignment="center" buttonType="roundedRect" lineBreakMode="middleTruncation" translatesAutoresizingMaskIntoConstraints="NO" id="wmd-ab-Nz3">
+                                        <rect key="frame" x="0.0" y="52" width="114" height="30"/>
+                                        <state key="normal" title="Present Modallly"/>
+                                        <connections>
+                                            <action selector="buttonPressed:" destination="YC8-ae-15L" eventType="touchUpInside" id="tjH-Ev-kpx"/>
+                                            <segue destination="bYI-y3-Rzb" kind="presentation" identifier="PresentModallySegue" id="3yq-HE-Tgn"/>
+                                        </connections>
+                                    </button>
+                                    <button opaque="NO" contentMode="scaleToFill" contentHorizontalAlignment="center" contentVerticalAlignment="center" buttonType="roundedRect" lineBreakMode="middleTruncation" translatesAutoresizingMaskIntoConstraints="NO" id="01L-lp-oy6">
+                                        <rect key="frame" x="0.0" y="104" width="114" height="30"/>
+                                        <state key="normal" title="Update Layout"/>
+                                        <connections>
+                                            <action selector="buttonPressed:" destination="YC8-ae-15L" eventType="touchUpInside" id="zTb-sq-B6f"/>
+                                        </connections>
+                                    </button>
+                                </subviews>
+                            </stackView>
                         </subviews>
-                        <color key="backgroundColor" white="1" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
+                        <color key="backgroundColor" red="1" green="0.83234566450000003" blue="0.47320586440000001" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
+                        <gestureRecognizers/>
                         <constraints>
-                            <constraint firstItem="noi-1a-5bZ" firstAttribute="top" secondItem="g7l-kO-y7q" secondAttribute="top" constant="12" id="EQy-cr-F2Y"/>
-                            <constraint firstItem="tAi-nk-rDB" firstAttribute="trailing" secondItem="noi-1a-5bZ" secondAttribute="trailing" constant="12" id="lv9-Nf-HNB"/>
+                            <constraint firstItem="noi-1a-5bZ" firstAttribute="top" secondItem="aOK-7l-cA6" secondAttribute="top" id="EQy-cr-F2Y"/>
+                            <constraint firstItem="tP3-oJ-4EB" firstAttribute="centerX" secondItem="aOK-7l-cA6" secondAttribute="centerX" id="EsD-Vf-dNZ"/>
+                            <constraint firstItem="Kva-Z7-0qY" firstAttribute="top" secondItem="aOK-7l-cA6" secondAttribute="top" id="Fff-HL-4mo"/>
+                            <constraint firstItem="8yw-OC-Ubk" firstAttribute="bottom" secondItem="g7l-kO-y7q" secondAttribute="bottom" id="JOL-wC-w74"/>
+                            <constraint firstItem="8yw-OC-Ubk" firstAttribute="leading" secondItem="aOK-7l-cA6" secondAttribute="leading" id="RiJ-Hb-OOZ"/>
+                            <constraint firstItem="8yw-OC-Ubk" firstAttribute="trailing" secondItem="aOK-7l-cA6" secondAttribute="trailing" id="Sof-yL-mwK"/>
+                            <constraint firstItem="tP3-oJ-4EB" firstAttribute="top" secondItem="aOK-7l-cA6" secondAttribute="top" constant="88" id="Zhb-Ss-epe"/>
+                            <constraint firstItem="Kva-Z7-0qY" firstAttribute="trailing" secondItem="aOK-7l-cA6" secondAttribute="trailing" id="kkp-Yo-FQW"/>
+                            <constraint firstItem="aOK-7l-cA6" firstAttribute="trailing" secondItem="noi-1a-5bZ" secondAttribute="trailing" constant="12" id="lv9-Nf-HNB"/>
+                            <constraint firstItem="Kva-Z7-0qY" firstAttribute="leading" secondItem="aOK-7l-cA6" secondAttribute="leading" id="oVC-i1-TwS"/>
+                            <constraint firstItem="aOK-7l-cA6" firstAttribute="bottom" secondItem="Kva-Z7-0qY" secondAttribute="bottom" id="rW2-mF-5DR"/>
+                            <constraint firstItem="8yw-OC-Ubk" firstAttribute="top" relation="greaterThanOrEqual" secondItem="tP3-oJ-4EB" secondAttribute="bottom" constant="88" id="vKQ-h9-uKt"/>
                         </constraints>
-                        <viewLayoutGuide key="safeArea" id="tAi-nk-rDB"/>
+                        <viewLayoutGuide key="safeArea" id="aOK-7l-cA6"/>
+                        <connections>
+                            <outletCollection property="gestureRecognizers" destination="6Ca-p8-7uF" appends="YES" id="xOy-f1-NZE"/>
+                            <outletCollection property="gestureRecognizers" destination="SPY-Vr-XDT" appends="YES" id="vgS-Am-jhQ"/>
+                            <outletCollection property="gestureRecognizers" destination="Jg4-it-qJ5" appends="YES" id="ONf-5y-phY"/>
+                        </connections>
                     </view>
                     <size key="freeformSize" width="375" height="778"/>
                     <connections>
                         <outlet property="closeButton" destination="noi-1a-5bZ" id="eWQ-ha-8y7"/>
+                        <segue destination="bYI-y3-Rzb" kind="show" identifier="ShowSegue" id="r1P-2i-NDe"/>
                     </connections>
                 </viewController>
                 <placeholder placeholderIdentifier="IBFirstResponder" id="Wqk-xl-O3I" userLabel="First Responder" sceneMemberID="firstResponder"/>
+                <tapGestureRecognizer id="6Ca-p8-7uF">
+                    <connections>
+                        <action selector="tapped:" destination="YC8-ae-15L" id="KFd-eT-RLn"/>
+                    </connections>
+                </tapGestureRecognizer>
+                <swipeGestureRecognizer direction="right" id="SPY-Vr-XDT">
+                    <connections>
+                        <action selector="swipped:" destination="YC8-ae-15L" id="OFa-4C-8rI"/>
+                    </connections>
+                </swipeGestureRecognizer>
+                <pongPressGestureRecognizer allowableMovement="10" minimumPressDuration="0.5" id="Jg4-it-qJ5">
+                    <connections>
+                        <action selector="longPressed:" destination="YC8-ae-15L" id="1G4-cf-RDE"/>
+                    </connections>
+                </pongPressGestureRecognizer>
             </objects>
-            <point key="canvasLocation" x="836" y="493.5960591133005"/>
+            <point key="canvasLocation" x="655" y="734"/>
         </scene>
         <!--Debug Text View Controller-->
         <scene sceneID="Bkq-O7-q4A">
@@ -207,21 +662,26 @@ Section 1.10.33 of "de Finibus Bonorum et Malorum", written by Cicero in 45 BC
                         </subviews>
                         <color key="backgroundColor" white="0.0" alpha="0.0" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
                         <constraints>
-                            <constraint firstItem="rN1-HL-YHv" firstAttribute="leading" secondItem="ix0-2W-gQN" secondAttribute="leading" id="7V3-KL-vXd"/>
+                            <constraint firstItem="rN1-HL-YHv" firstAttribute="leading" secondItem="5ET-zC-lCb" secondAttribute="leading" id="7V3-KL-vXd"/>
                             <constraint firstAttribute="bottom" secondItem="rN1-HL-YHv" secondAttribute="bottom" id="efD-U5-Tet"/>
                             <constraint firstItem="rN1-HL-YHv" firstAttribute="top" secondItem="9YG-0j-Zzg" secondAttribute="top" constant="17" id="fiO-LL-nSC"/>
-                            <constraint firstItem="rN1-HL-YHv" firstAttribute="trailing" secondItem="ix0-2W-gQN" secondAttribute="trailing" id="lfg-EE-euw"/>
+                            <constraint firstItem="rN1-HL-YHv" firstAttribute="trailing" secondItem="5ET-zC-lCb" secondAttribute="trailing" id="lfg-EE-euw"/>
                         </constraints>
-                        <viewLayoutGuide key="safeArea" id="ix0-2W-gQN"/>
+                        <viewLayoutGuide key="safeArea" id="5ET-zC-lCb"/>
                     </view>
                     <size key="freeformSize" width="375" height="778"/>
                     <connections>
                         <outlet property="textView" destination="rN1-HL-YHv" id="gmr-Uf-jd8"/>
+                        <outlet property="textViewTopConstraint" destination="fiO-LL-nSC" id="Rum-TN-c2e"/>
+                        <outlet property="view" destination="9YG-0j-Zzg" id="jhb-eT-nEn"/>
                     </connections>
                 </viewController>
                 <placeholder placeholderIdentifier="IBFirstResponder" id="x1h-y1-h8q" userLabel="First Responder" sceneMemberID="firstResponder"/>
             </objects>
-            <point key="canvasLocation" x="836" y="-446"/>
+            <point key="canvasLocation" x="-1" y="734"/>
         </scene>
     </scenes>
+    <inferredMetricsTieBreakers>
+        <segue reference="r1P-2i-NDe"/>
+    </inferredMetricsTieBreakers>
 </document>

Examples/Samples/Sources/UIComponents.swift

@@ -86,3 +86,18 @@ class SafeAreaView: UIView {
             ])
     }
 }
+
+
+@IBDesignable
+class OnSafeAreaView: UIView {
+    override func prepareForInterfaceBuilder() {
+        let label = UILabel()
+        label.text = "On Safe Area"
+        addSubview(label)
+        label.translatesAutoresizingMaskIntoConstraints = false
+        NSLayoutConstraint.activate([
+            label.centerXAnchor.constraint(equalTo: self.centerXAnchor),
+            label.centerYAnchor.constraint(equalTo: self.centerYAnchor, constant: -4.0),
+            ])
+    }
+}

Examples/Samples/Sources/UIExtensions.swift

@@ -5,21 +5,39 @@
 
 import UIKit
 
-extension UIView {
-    var layoutInsets: UIEdgeInsets {
-        if #available(iOS 11.0, *) {
-            return safeAreaInsets
-        } else {
-            return layoutMargins
-        }
-    }
+protocol LayoutGuideProvider {
+    var topAnchor: NSLayoutYAxisAnchor { get }
+    var bottomAnchor: NSLayoutYAxisAnchor { get }
+}
+extension UILayoutGuide: LayoutGuideProvider {}
 
-    var layoutGuide: UILayoutGuide {
-        if #available(iOS 11.0, *) {
-            return safeAreaLayoutGuide
-        } else {
-            return layoutMarginsGuide
-        }
+class CustomLayoutGuide: LayoutGuideProvider {
+    let topAnchor: NSLayoutYAxisAnchor
+    let bottomAnchor: NSLayoutYAxisAnchor
+    init(topAnchor: NSLayoutYAxisAnchor, bottomAnchor: NSLayoutYAxisAnchor) {
+        self.topAnchor = topAnchor
+        self.bottomAnchor = bottomAnchor
     }
 }
 
+extension UIViewController {
+    var layoutInsets: UIEdgeInsets {
+        if #available(iOS 11.0, *) {
+            return view.safeAreaInsets
+        } else {
+            return UIEdgeInsets(top: topLayoutGuide.length,
+                                left: 0.0,
+                                bottom: bottomLayoutGuide.length,
+                                right: 0.0)
+        }
+    }
+
+    var layoutGuide: LayoutGuideProvider {
+        if #available(iOS 11.0, *) {
+            return view!.safeAreaLayoutGuide
+        } else {
+            return CustomLayoutGuide(topAnchor: topLayoutGuide.bottomAnchor,
+                                     bottomAnchor: bottomLayoutGuide.topAnchor)
+        }
+    }
+}

Examples/Samples/Sources/ViewController.swift

@@ -9,7 +9,7 @@
 import UIKit
 import FloatingPanel
 
-class SampleListViewController: UIViewController, UITableViewDataSource, UITableViewDelegate {
+class SampleListViewController: UIViewController, UITableViewDataSource, UITableViewDelegate, FloatingPanelControllerDelegate, FloatingPanelLayout {
     @IBOutlet weak var tableView: UITableView!
 
     enum Menu: Int, CaseIterable {
@@ -17,13 +17,23 @@ class SampleListViewController: UIViewController, UITableViewDataSource, UITable
         case trackingTextView
         case showDetail
         case showModal
+        case showFloatingPanelModal
+        case showTabBar
+        case showNestedScrollView
+        case showRemovablePanel
+        case showIntrinsicView
 
         var name: String {
             switch self {
-            case .trackingTableView: return "Scroll tracking (UITableView)"
-            case .trackingTextView: return "Scroll tracking (UITextView)"
+            case .trackingTableView: return "Scroll tracking(TableView)"
+            case .trackingTextView: return "Scroll tracking(TextView)"
             case .showDetail: return "Show Detail Panel"
             case .showModal: return "Show Modal"
+            case .showFloatingPanelModal: return "Show Floating Panel Modal"
+            case .showTabBar: return "Show Tab Bar"
+            case .showNestedScrollView: return "Show Nested ScrollView"
+            case .showRemovablePanel: return "Show Removable Panel"
+            case .showIntrinsicView: return "Show Intrinsic View"
             }
         }
 
@@ -33,12 +43,23 @@ class SampleListViewController: UIViewController, UITableViewDataSource, UITable
             case .trackingTextView: return "ConsoleViewController"
             case .showDetail: return "DetailViewController"
             case .showModal: return "ModalViewController"
+            case .showFloatingPanelModal: return nil
+            case .showTabBar: return "TabBarViewController"
+            case .showNestedScrollView: return "NestedScrollViewController"
+            case .showRemovablePanel: return "DetailViewController"
+            case .showIntrinsicView: return "IntrinsicViewController"
             }
         }
     }
 
+    var currentMenu: Menu = .trackingTableView
+
     var mainPanelVC: FloatingPanelController!
     var detailPanelVC: FloatingPanelController!
+    var settingsPanelVC: FloatingPanelController!
+
+    var mainPanelObserves: [NSKeyValueObservation] = []
+    var settingsObserves: [NSKeyValueObservation] = []
 
     override func viewDidLoad() {
         super.viewDidLoad()
@@ -46,31 +67,78 @@ class SampleListViewController: UIViewController, UITableViewDataSource, UITable
         tableView.delegate = self
         tableView.register(UITableViewCell.self, forCellReuseIdentifier: "Cell")
 
-        let contentVC = DebugTableViewController(style: .plain)
+        let searchController = UISearchController(searchResultsController: nil)
+        if #available(iOS 11.0, *) {
+            navigationItem.searchController = searchController
+            navigationItem.hidesSearchBarWhenScrolling = false
+            navigationItem.largeTitleDisplayMode = .automatic
+        } else {
+            // Fallback on earlier versions
+        }
+
+        let contentVC = DebugTableViewController()
         addMainPanel(with: contentVC)
     }
 
+    override func viewDidAppear(_ animated: Bool) {
+        super.viewDidAppear(animated)
+
+        if #available(iOS 11.0, *) {
+            if let observation = navigationController?.navigationBar.observe(\.prefersLargeTitles, changeHandler: { (bar, _) in
+                self.tableView.reloadData()
+            }) {
+                settingsObserves.append(observation)
+            }
+        }
+    }
+
+    override func viewWillDisappear(_ animated: Bool) {
+        super.viewWillDisappear(animated)
+        settingsObserves.removeAll()
+    }
+
     func addMainPanel(with contentVC: UIViewController) {
+        mainPanelObserves.removeAll()
+
         // Initialize FloatingPanelController
         mainPanelVC = FloatingPanelController()
+        mainPanelVC.delegate = self
 
         // Initialize FloatingPanelController and add the view
         mainPanelVC.surfaceView.cornerRadius = 6.0
         mainPanelVC.surfaceView.shadowHidden = false
 
-        // Add a content view controller and connect with the scroll view
-        mainPanelVC.show(contentVC, sender: self)
+        // Set a content view controller
+        mainPanelVC.set(contentViewController: contentVC)
 
+        // Enable tap-to-hide and removal interaction
+        switch currentMenu {
+        case .showRemovablePanel, .showIntrinsicView:
+            mainPanelVC.isRemovalInteractionEnabled = true
+
+            let backdropTapGesture = UITapGestureRecognizer(target: self, action: #selector(handleBackdrop(tapGesture:)))
+            mainPanelVC.backdropView.addGestureRecognizer(backdropTapGesture)
+        default:
+            break
+        }
+
+        // Track a scroll view
         switch contentVC {
         case let consoleVC as DebugTextViewController:
             mainPanelVC.track(scrollView: consoleVC.textView)
 
         case let contentVC as DebugTableViewController:
+            let ob = contentVC.tableView.observe(\.isEditing) { (tableView, _) in
+                self.mainPanelVC.panGestureRecognizer.isEnabled = !tableView.isEditing
+            }
+            mainPanelObserves.append(ob)
             mainPanelVC.track(scrollView: contentVC.tableView)
-
+        case let contentVC as NestedScrollViewController:
+            mainPanelVC.track(scrollView: contentVC.scrollView)
         default:
-            fatalError()
+            break
         }
+
         //  Add FloatingPanel to self.view
         mainPanelVC.addPanel(toParent: self, belowView: nil, animated: true)
     }
@@ -79,32 +147,84 @@ class SampleListViewController: UIViewController, UITableViewDataSource, UITable
         detailPanelVC.removePanelFromParent(animated: true, completion: nil)
     }
 
+    @objc func handleBackdrop(tapGesture: UITapGestureRecognizer) {
+        switch tapGesture.view {
+        case mainPanelVC.backdropView:
+            mainPanelVC.hide(animated: true, completion: nil)
+        case settingsPanelVC.backdropView:
+            settingsPanelVC.removePanelFromParent(animated: true)
+            settingsPanelVC = nil
+        default:
+            break
+        }
+    }
+
     // MARK:- TableViewDatasource
 
     func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
-        return Menu.allCases.count
+        if #available(iOS 11.0, *) {
+            if navigationController?.navigationBar.prefersLargeTitles == true {
+                return Menu.allCases.count + 30
+            } else {
+                return Menu.allCases.count
+            }
+        } else {
+            return Menu.allCases.count
+        }
     }
 
     func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
         let cell = tableView.dequeueReusableCell(withIdentifier: "Cell", for: indexPath)
-        let menu = Menu.allCases[indexPath.row]
-        cell.textLabel?.text = menu.name
+        if Menu.allCases.count > indexPath.row {
+            let menu = Menu.allCases[indexPath.row]
+            cell.textLabel?.text = menu.name
+        } else {
+            cell.textLabel?.text = "\(indexPath.row) row"
+        }
         return cell
     }
 
+    // MARK:- Actions
+    @IBAction func showDebugMenu(_ sender: UIBarButtonItem) {
+        guard settingsPanelVC == nil else { return }
+        // Initialize FloatingPanelController
+        settingsPanelVC = FloatingPanelController()
+
+        // Initialize FloatingPanelController and add the view
+        settingsPanelVC.surfaceView.cornerRadius = 6.0
+        settingsPanelVC.surfaceView.shadowHidden = false
+        settingsPanelVC.isRemovalInteractionEnabled = true
+
+        let backdropTapGesture = UITapGestureRecognizer(target: self, action: #selector(handleBackdrop(tapGesture:)))
+        settingsPanelVC.backdropView.addGestureRecognizer(backdropTapGesture)
+
+        settingsPanelVC.delegate = self
+
+        let contentVC = storyboard?.instantiateViewController(withIdentifier: "SettingsViewController")
+
+        // Set a content view controller
+        settingsPanelVC.set(contentViewController: contentVC)
+
+        //  Add FloatingPanel to self.view
+        settingsPanelVC.addPanel(toParent: self, belowView: nil, animated: true)
+    }
+
     // MARK:- TableViewDelegate
 
     func tableView(_ tableView: UITableView, didSelectRowAt indexPath: IndexPath) {
+        guard Menu.allCases.count > indexPath.row else { return }
         let menu = Menu.allCases[indexPath.row]
         let contentVC: UIViewController = {
-            guard let storyboardID = menu.storyboardID else { return DebugTableViewController(style: .plain) }
+            guard let storyboardID = menu.storyboardID else { return DebugTableViewController() }
             guard let vc = self.storyboard?.instantiateViewController(withIdentifier: storyboardID) else { fatalError() }
             return vc
         }()
 
+        self.currentMenu = menu
+
         switch menu {
         case .showDetail:
-            detailPanelVC?.removeFromParent()
+            detailPanelVC?.removePanelFromParent(animated: false)
 
             // Initialize FloatingPanelController
             detailPanelVC = FloatingPanelController()
@@ -113,16 +233,26 @@ class SampleListViewController: UIViewController, UITableViewDataSource, UITable
             detailPanelVC.surfaceView.cornerRadius = 6.0
             detailPanelVC.surfaceView.shadowHidden = false
 
-            // Add a content view controller and connect with the scroll view
-            detailPanelVC.show(contentVC, sender: self)
-
-            // (contentVC as? DetailViewController)?.closeButton?.addTarget(self, action: #selector(dismissDetailPanelVC), for: .touchUpInside)
+            // Set a content view controller
+            detailPanelVC.set(contentViewController: contentVC)
 
             //  Add FloatingPanel to self.view
             detailPanelVC.addPanel(toParent: self, belowView: nil, animated: true)
-        case .showModal:
+        case .showModal, .showTabBar:
             let modalVC = contentVC
             present(modalVC, animated: true, completion: nil)
+        case .showFloatingPanelModal:
+            let fpc = FloatingPanelController()
+            let contentVC = self.storyboard!.instantiateViewController(withIdentifier: "DetailViewController")
+            fpc.set(contentViewController: contentVC)
+            fpc.delegate = self
+
+            fpc.surfaceView.cornerRadius = 38.5
+            fpc.surfaceView.shadowHidden = false
+
+            fpc.isRemovalInteractionEnabled = true
+
+            self.present(fpc, animated: true, completion: nil)
         default:
             detailPanelVC?.removePanelFromParent(animated: true, completion: nil)
             mainPanelVC?.removePanelFromParent(animated: true) {
@@ -130,19 +260,156 @@ class SampleListViewController: UIViewController, UITableViewDataSource, UITable
             }
         }
     }
+
+    func floatingPanel(_ vc: FloatingPanelController, layoutFor newCollection: UITraitCollection) -> FloatingPanelLayout? {
+        if vc == settingsPanelVC {
+            return IntrinsicPanelLayout()
+        }
+
+        switch currentMenu {
+        case .showRemovablePanel:
+            return newCollection.verticalSizeClass == .compact ? RemovablePanelLandscapeLayout() :  RemovablePanelLayout()
+        case .showIntrinsicView:
+            return IntrinsicPanelLayout()
+        case .showFloatingPanelModal:
+            if vc != mainPanelVC && vc != detailPanelVC {
+                return ModalPanelLayout()
+            }
+            fallthrough
+        default:
+            return (newCollection.verticalSizeClass == .compact) ? nil  : self
+        }
+    }
+
+    func floatingPanel(_ vc: FloatingPanelController, shouldRecognizeSimultaneouslyWith gestureRecognizer: UIGestureRecognizer) -> Bool {
+        switch currentMenu {
+        case .showNestedScrollView:
+            return (vc.contentViewController as? NestedScrollViewController)?.nestedScrollView.gestureRecognizers?.contains(gestureRecognizer) ?? false
+        default:
+            return false
+        }
+    }
+
+    func floatingPanelDidEndRemove(_ vc: FloatingPanelController) {
+        switch vc {
+        case settingsPanelVC:
+            settingsPanelVC = nil
+        default:
+            break
+        }
+    }
+
+    var initialPosition: FloatingPanelPosition {
+        return .half
+    }
+
+    func insetFor(position: FloatingPanelPosition) -> CGFloat? {
+        switch position {
+        case .full: return UIScreen.main.bounds.height == 667.0 ? 18.0 : 16.0
+        case .half: return 262.0
+        case .tip: return 69.0
+        case .hidden: return nil
+        }
+    }
+}
+
+class IntrinsicPanelLayout: FloatingPanelIntrinsicLayout { }
+
+class RemovablePanelLayout: FloatingPanelIntrinsicLayout {
+    var supportedPositions: Set<FloatingPanelPosition> {
+        return [.full, .half]
+    }
+    var initialPosition: FloatingPanelPosition {
+        return .half
+    }
+    var topInteractionBuffer: CGFloat {
+        return 200.0
+    }
+    var bottomInteractionBuffer: CGFloat {
+        return 261.0 - 22.0
+    }
+
+    func insetFor(position: FloatingPanelPosition) -> CGFloat? {
+        switch position {
+        case .half: return 130.0
+        default: return nil
+        }
+    }
+    func backdropAlphaFor(position: FloatingPanelPosition) -> CGFloat {
+        return 0.3
+    }
+}
+
+class RemovablePanelLandscapeLayout: FloatingPanelIntrinsicLayout {
+    var supportedPositions: Set<FloatingPanelPosition> {
+        return [.full, .half]
+    }
+    var bottomInteractionBuffer: CGFloat {
+        return 261.0 - 22.0
+    }
+    func insetFor(position: FloatingPanelPosition) -> CGFloat? {
+        switch position {
+        case .half: return 261.0
+        default: return nil
+        }
+    }
+    func backdropAlphaFor(position: FloatingPanelPosition) -> CGFloat {
+        return 0.3
+    }
+}
+
+class ModalPanelLayout: FloatingPanelIntrinsicLayout {
+    var topInteractionBuffer: CGFloat {
+        return 100.0
+    }
+    func backdropAlphaFor(position: FloatingPanelPosition) -> CGFloat {
+        return 0.3
+    }
+}
+
+class NestedScrollViewController: UIViewController {
+    @IBOutlet weak var scrollView: UIScrollView!
+    @IBOutlet weak var nestedScrollView: UIScrollView!
+
+    @IBAction func longPressed(_ sender: Any) {
+        print("LongPressed!")
+    }
+    @IBAction func swipped(_ sender: Any) {
+        print("Swipped!")
+    }
+    @IBAction func tapped(_ sender: Any) {
+        print("Tapped!")
+    }
 }
 
 class DebugTextViewController: UIViewController, UITextViewDelegate {
     @IBOutlet weak var textView: UITextView!
+    @IBOutlet weak var textViewTopConstraint: NSLayoutConstraint!
 
     override func viewDidLoad() {
         super.viewDidLoad()
         textView.delegate = self
+        print("viewDidLoad: TextView --- ", textView.contentOffset, textView.contentInset)
+
         if #available(iOS 11.0, *) {
             textView.contentInsetAdjustmentBehavior = .never
         }
     }
 
+    override func viewWillLayoutSubviews() {
+        print("viewWillLayoutSubviews: TextView --- ", textView.contentOffset, textView.contentInset, textView.frame)
+    }
+
+    override func viewDidLayoutSubviews() {
+        super.viewDidLayoutSubviews()
+        print("viewDidLayoutSubviews: TextView --- ", textView.contentOffset, textView.contentInset, textView.frame)
+    }
+
+    override func viewDidAppear(_ animated: Bool) {
+        super.viewDidAppear(animated)
+        print("TextView --- ", textView.contentOffset, textView.contentInset, textView.frame)
+    }
+
     func scrollViewDidScroll(_ scrollView: UIScrollView) {
         print("TextView --- ", scrollView.contentOffset, scrollView.contentInset)
         if #available(iOS 11.0, *) {
@@ -151,114 +418,261 @@ class DebugTextViewController: UIViewController, UITextViewDelegate {
     }
 
     @IBAction func close(sender: UIButton) {
-        // Now impossible
-        // dismiss(animated: true, completion: nil)
-        (self.parent as? FloatingPanelController)?.removePanelFromParent(animated: true, completion: nil)
+        // (self.parent as? FloatingPanelController)?.removePanelFromParent(animated: true, completion: nil)
+        dismiss(animated: true, completion: nil)
     }
 }
 
-class DebugTableViewController: UITableViewController {
+class InspectableViewController: UIViewController {
+    override func viewWillLayoutSubviews() {
+        super.viewWillLayoutSubviews()
+        print(">>> Content View: viewWillLayoutSubviews", layoutInsets)
+    }
+
+    override func viewDidLayoutSubviews() {
+        super.viewDidLayoutSubviews()
+        print(">>> Content View: viewDidLayoutSubviews", layoutInsets)
+    }
+
+    override func viewWillAppear(_ animated: Bool) {
+        super.viewWillAppear(animated)
+        print(">>> Content View: viewWillAppear", layoutInsets)
+    }
+
+    override func viewDidAppear(_ animated: Bool) {
+        super.viewDidAppear(animated)
+        print(">>> Content View: viewDidAppear", view.bounds, layoutInsets)
+    }
+
+    override func viewWillDisappear(_ animated: Bool) {
+        super.viewWillDisappear(animated)
+        print(">>> Content View: viewWillDisappear")
+    }
+
+    override func viewDidDisappear(_ animated: Bool) {
+        super.viewDidDisappear(animated)
+        print(">>> Content View: viewDidDisappear")
+    }
+
+    override func willMove(toParent parent: UIViewController?) {
+        super.willMove(toParent: parent)
+        print(">>> Content View: willMove(toParent: \(String(describing: parent))")
+    }
+
+    override func didMove(toParent parent: UIViewController?) {
+        super.didMove(toParent: parent)
+        print(">>> Content View: didMove(toParent: \(String(describing: parent))")
+    }
+    public override func willTransition(to newCollection: UITraitCollection, with coordinator: UIViewControllerTransitionCoordinator) {
+        print(">>> Content View: willTransition(to: \(newCollection), with: \(coordinator))", layoutInsets)
+    }
+}
+
+class DebugTableViewController: InspectableViewController, UITableViewDataSource, UITableViewDelegate {
+    weak var tableView: UITableView!
     var items: [String] = []
+    var itemHeight: CGFloat = 66.0
+
+    enum Menu: String, CaseIterable {
+        case animateScroll = "Animate Scroll"
+        case changeContentSize = "Change content size"
+        case reorder = "Reorder"
+    }
+
+    var reorderButton: UIButton!
     override func viewDidLoad() {
         super.viewDidLoad()
+
+        let tableView = UITableView(frame: .zero,
+                                    style: .plain)
+        view.addSubview(tableView)
+        tableView.translatesAutoresizingMaskIntoConstraints = false
+        NSLayoutConstraint.activate([
+            tableView.topAnchor.constraint(equalTo: view.topAnchor),
+            tableView.bottomAnchor.constraint(equalTo: view.bottomAnchor),
+            tableView.leftAnchor.constraint(equalTo: view.leftAnchor),
+            tableView.rightAnchor.constraint(equalTo: view.rightAnchor)
+            ])
+        tableView.dataSource = self
+        tableView.delegate = self
+        self.tableView = tableView
+
+        let stackView = UIStackView()
+        view.addSubview(stackView)
+        stackView.axis = .vertical
+        stackView.distribution = .fillEqually
+        stackView.alignment = .trailing
+        stackView.spacing = 10.0
+        stackView.translatesAutoresizingMaskIntoConstraints = false
+        NSLayoutConstraint.activate([
+            stackView.topAnchor.constraint(equalTo: view.topAnchor, constant: 22.0),
+            stackView.rightAnchor.constraint(equalTo: view.rightAnchor, constant: -22.0),
+            ])
+
+        for menu in Menu.allCases {
+            let button = UIButton()
+            button.setTitle(menu.rawValue, for: .normal)
+            button.setTitleColor(view.tintColor, for: .normal)
+            switch menu {
+            case .animateScroll:
+                button.addTarget(self, action: #selector(animateScroll), for: .touchUpInside)
+            case .changeContentSize:
+                button.addTarget(self, action: #selector(changeContentSize), for: .touchUpInside)
+            case .reorder:
+                button.addTarget(self, action: #selector(reorderItems), for: .touchUpInside)
+                reorderButton = button
+            }
+            stackView.addArrangedSubview(button)
+        }
+
         for i in 0...100 {
             items.append("Items \(i)")
         }
         tableView.register(UITableViewCell.self, forCellReuseIdentifier: "Cell")
     }
 
+    @objc func animateScroll() {
+        tableView.scrollToRow(at: IndexPath(row: lround(Double(items.count) / 2.0),
+                                            section: 0),
+                              at: .top, animated: true)
+    }
+
+    @objc func changeContentSize() {
+        let actionSheet = UIAlertController(title: "Change content size", message: "", preferredStyle: .actionSheet)
+        actionSheet.addAction(UIAlertAction(title: "Large", style: .default, handler: { (_) in
+            self.itemHeight = 66.0
+            self.changeItems(100)
+        }))
+        actionSheet.addAction(UIAlertAction(title: "Match", style: .default, handler: { (_) in
+            switch self.tableView.bounds.height {
+            case 585: // iPhone 6,7,8
+                self.itemHeight = self.tableView.bounds.height / 13.0
+                self.changeItems(13)
+            case 656: // iPhone {6,7,8} Plus
+                self.itemHeight = self.tableView.bounds.height / 16.0
+                self.changeItems(16)
+            default: // iPhone X family
+                self.itemHeight = self.tableView.bounds.height / 12.0
+                self.changeItems(12)
+            }
+        }))
+        actionSheet.addAction(UIAlertAction(title: "Short", style: .default, handler: { (_) in
+            self.itemHeight = 66.0
+            self.changeItems(3)
+        }))
+
+        self.present(actionSheet, animated: true, completion: nil)
+    }
+
+    @objc func reorderItems() {
+        if reorderButton.titleLabel?.text == Menu.reorder.rawValue {
+            tableView.isEditing = true
+            reorderButton.setTitle("Cancel", for: .normal)
+        } else {
+            tableView.isEditing = false
+            reorderButton.setTitle(Menu.reorder.rawValue, for: .normal)
+        }
+    }
+
+    func changeItems(_ count: Int) {
+        items.removeAll()
+        for i in 0..<count {
+            items.append("Items \(i)")
+        }
+        tableView.reloadData()
+    }
+
     @objc func close(sender: UIButton) {
         //  Remove FloatingPanel from a view
         (self.parent as! FloatingPanelController).removePanelFromParent(animated: true, completion: nil)
     }
 
-    override func viewWillLayoutSubviews() {
-        super.viewWillLayoutSubviews()
-        //print("Content View: viewWillLayoutSubviews")
-    }
-
-    override func viewDidLayoutSubviews() {
-        super.viewDidLayoutSubviews()
-        //print("Content View: viewDidLayoutSubviews")
-    }
-
-    override func viewWillAppear(_ animated: Bool) {
-        super.viewWillAppear(animated)
-        print("Content View: viewWillAppear")
-    }
-
-    override func viewDidAppear(_ animated: Bool) {
-        super.viewDidAppear(animated)
-        print("Content View: viewDidAppear")
-    }
-
-    override func viewWillDisappear(_ animated: Bool) {
-        super.viewWillDisappear(animated)
-        print("Content View: viewWillDisappear")
-    }
-
-    override func viewDidDisappear(_ animated: Bool) {
-        super.viewDidDisappear(animated)
-        print("Content View: viewDidDisappear")
-    }
-
-    override func willMove(toParent parent: UIViewController?) {
-        super.willMove(toParent: parent)
-        print("Content View: willMove(toParent: \(String(describing: parent))")
-    }
-
-    override func didMove(toParent parent: UIViewController?) {
-        super.didMove(toParent: parent)
-        print("Content View: didMove(toParent: \(String(describing: parent))")
-    }
-
-    public override func willTransition(to newCollection: UITraitCollection, with coordinator: UIViewControllerTransitionCoordinator) {
-        print("Content View: willTransition(to: \(newCollection), with: \(coordinator))")
-    }
-
-    override func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
+    func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
         return items.count
     }
 
-    override func tableView(_ tableView: UITableView, heightForRowAt indexPath: IndexPath) -> CGFloat {
-        return 66.0
+    func tableView(_ tableView: UITableView, heightForRowAt indexPath: IndexPath) -> CGFloat {
+        return itemHeight
     }
 
-    override func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
+    func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
         let cell = tableView.dequeueReusableCell(withIdentifier: "Cell", for: indexPath)
         cell.textLabel?.text = items[indexPath.row]
         return cell
     }
-}
 
-class DetailViewController: UIViewController {
-    @IBOutlet weak var closeButton: UIButton!
-    @IBAction func close(sender: UIButton) {
-        // Now impossible
-        // dismiss(animated: true, completion: nil)
-        (self.parent as? FloatingPanelController)?.removePanelFromParent(animated: true, completion: nil)
+    func tableView(_ tableView: UITableView, editActionsForRowAt indexPath: IndexPath) -> [UITableViewRowAction]? {
+        return [
+            UITableViewRowAction(style: .destructive, title: "Delete", handler: { (action, path) in
+                self.items.remove(at: path.row)
+                tableView.deleteRows(at: [path], with: .automatic)
+            }),
+        ]
+    }
+
+    func tableView(_ tableView: UITableView, canMoveRowAt indexPath: IndexPath) -> Bool {
+        return true
+    }
+
+    func tableView(_ tableView: UITableView, moveRowAt sourceIndexPath: IndexPath, to destinationIndexPath: IndexPath) {
+        items.insert(items.remove(at: sourceIndexPath.row), at: destinationIndexPath.row)
     }
 }
 
-class ModalViewController: UIViewController {
+class DetailViewController: InspectableViewController {
+    @IBOutlet weak var closeButton: UIButton!
+    @IBAction func close(sender: UIButton) {
+        // (self.parent as? FloatingPanelController)?.removePanelFromParent(animated: true, completion: nil)
+        dismiss(animated: true, completion: nil)
+    }
+
+    @IBAction func buttonPressed(_ sender: UIButton) {
+        switch sender.titleLabel?.text {
+        case "Show":
+            performSegue(withIdentifier: "ShowSegue", sender: self)
+        case "Present Modally":
+            performSegue(withIdentifier: "PresentModallySegue", sender: self)
+        default:
+            break
+        }
+    }
+
+    @IBAction func tapped(_ sender: Any) {
+        print("Detail panel is tapped!")
+    }
+    @IBAction func swipped(_ sender: Any) {
+        print("Detail panel is swipped!")
+    }
+    @IBAction func longPressed(_ sender: Any) {
+        print("Detail panel is longPressed!")
+    }
+}
+
+class ModalViewController: UIViewController, FloatingPanelControllerDelegate {
     var fpc: FloatingPanelController!
     var consoleVC: DebugTextViewController!
+
     @IBOutlet weak var safeAreaView: UIView!
+
+    var isNewlayout: Bool = false
+
     override func viewWillAppear(_ animated: Bool) {
         super.viewWillAppear(animated)
         // Initialize FloatingPanelController
         fpc = FloatingPanelController()
+        fpc.delegate = self
 
         // Initialize FloatingPanelController and add the view
         fpc.surfaceView.cornerRadius = 6.0
         fpc.surfaceView.shadowHidden = false
 
-        // Add a content view controller and connect with the scroll view
+        // Set a content view controller and track the scroll view
         let consoleVC = storyboard?.instantiateViewController(withIdentifier: "ConsoleViewController") as! DebugTextViewController
-        fpc.show(consoleVC, sender: self)
-        self.consoleVC = consoleVC
+        fpc.set(contentViewController: consoleVC)
         fpc.track(scrollView: consoleVC.textView)
 
+        self.consoleVC = consoleVC
+
         //  Add FloatingPanel to self.view
         fpc.addPanel(toParent: self, belowView: safeAreaView)
     }
@@ -272,4 +686,239 @@ class ModalViewController: UIViewController {
     @IBAction func close(sender: UIButton) {
         dismiss(animated: true, completion: nil)
     }
+
+    @IBAction func moveToFull(sender: UIButton) {
+        fpc.move(to: .full, animated: true)
+    }
+    @IBAction func moveToHalf(sender: UIButton) {
+        fpc.move(to: .half, animated: true)
+    }
+    @IBAction func moveToTip(sender: UIButton) {
+        fpc.move(to: .tip, animated: true)
+    }
+
+    @IBAction func updateLayout(_ sender: Any) {
+        isNewlayout = !isNewlayout
+        UIView.animate(withDuration: 0.5) {
+            self.fpc.updateLayout()
+        }
+    }
+
+    func floatingPanel(_ vc: FloatingPanelController, layoutFor newCollection: UITraitCollection) -> FloatingPanelLayout? {
+        return (isNewlayout) ? ModalSecondLayout() : nil
+    }
+}
+
+class ModalSecondLayout: FloatingPanelLayout {
+    var initialPosition: FloatingPanelPosition {
+        return .half
+    }
+
+    func insetFor(position: FloatingPanelPosition) -> CGFloat? {
+        switch position {
+        case .full: return 18.0
+        case .half: return 262.0
+        case .tip: return 44.0
+        case .hidden: return nil
+        }
+    }
+}
+
+class TabBarViewController: UITabBarController {}
+
+class TabBarContentViewController: UIViewController, FloatingPanelControllerDelegate {
+    var fpc: FloatingPanelController!
+    var consoleVC: DebugTextViewController!
+
+    override func viewWillAppear(_ animated: Bool) {
+        super.viewWillAppear(animated)
+        // Initialize FloatingPanelController
+        fpc = FloatingPanelController()
+        fpc.delegate = self
+
+        // Initialize FloatingPanelController and add the view
+        fpc.surfaceView.cornerRadius = 6.0
+        fpc.surfaceView.shadowHidden = false
+
+        // Set a content view controller and track the scroll view
+        let consoleVC = storyboard?.instantiateViewController(withIdentifier: "ConsoleViewController") as! DebugTextViewController
+        fpc.set(contentViewController: consoleVC)
+        fpc.track(scrollView: consoleVC.textView)
+        self.consoleVC = consoleVC
+
+        //  Add FloatingPanel to self.view
+        fpc.addPanel(toParent: self)
+    }
+
+    override func viewWillDisappear(_ animated: Bool) {
+        super.viewWillDisappear(animated)
+        //  Remove FloatingPanel from a view
+        fpc.removePanelFromParent(animated: false)
+    }
+
+    func floatingPanel(_ vc: FloatingPanelController, layoutFor newCollection: UITraitCollection) -> FloatingPanelLayout? {
+        switch self.tabBarItem.tag {
+        case 0:
+            return OneTabBarPanelLayout()
+        case 1:
+            return TwoTabBarPanelLayout()
+        case 2:
+            return ThreeTabBarPanelLayout()
+        default:
+            return nil
+        }
+    }
+
+    func floatingPanelDidMove(_ vc: FloatingPanelController) {
+        guard self.tabBarItem.tag == 2 else { return }
+
+        /* Solution 1: Manipulate scoll content inset */
+        /*
+        guard let scrollView = consoleVC.textView else { return }
+        var insets = vc.adjustedContentInsets
+        if vc.surfaceView.frame.minY < vc.layoutInsets.top {
+            insets.top = vc.layoutInsets.top - vc.surfaceView.frame.minY
+        } else {
+            insets.top = 0.0
+        }
+        scrollView.contentInset = insets
+         */
+
+        // Solution 2: Manipulate top constraint
+        assert(consoleVC.textViewTopConstraint != nil)
+        if vc.surfaceView.frame.minY + 17.0 < vc.layoutInsets.top {
+            consoleVC.textViewTopConstraint?.constant = vc.layoutInsets.top - vc.surfaceView.frame.minY
+        } else {
+            consoleVC.textViewTopConstraint?.constant = 17.0
+        }
+        consoleVC.view.layoutIfNeeded()
+    }
+
+    func floatingPanelDidChangePosition(_ vc: FloatingPanelController) {
+        guard self.tabBarItem.tag == 2 else { return }
+
+        /* Solution 1: Manipulate scoll content inset */
+        /*
+        guard let scrollView = consoleVC.textView else { return }
+        var insets = vc.adjustedContentInsets
+        insets.top = (vc.position == .full) ? vc.layoutInsets.top : 0.0
+        scrollView.contentInset = insets
+        if scrollView.contentOffset.y - scrollView.contentInset.top < 0.0  {
+            scrollView.contentOffset = CGPoint(x: 0.0,
+                                               y: 0.0 - scrollView.contentInset.top)
+        }
+         */
+
+        // Solution 2: Manipulate top constraint
+        assert(consoleVC.textViewTopConstraint != nil)
+        consoleVC.textViewTopConstraint?.constant = (vc.position == .full) ? vc.layoutInsets.top : 17.0
+        consoleVC.view.layoutIfNeeded()
+    }
+
+    @IBAction func close(sender: UIButton) {
+        dismiss(animated: true, completion: nil)
+    }
+}
+
+extension FloatingPanelLayout {
+    func prepareLayout(surfaceView: UIView, in view: UIView) -> [NSLayoutConstraint] {
+        if #available(iOS 11.0, *) {
+            return [
+                surfaceView.leftAnchor.constraint(equalTo: view.safeAreaLayoutGuide.leftAnchor, constant: 0.0),
+                surfaceView.rightAnchor.constraint(equalTo: view.safeAreaLayoutGuide.rightAnchor, constant: 0.0),
+            ]
+        } else {
+            return [
+                surfaceView.leftAnchor.constraint(equalTo: view.leftAnchor, constant: 0.0),
+                surfaceView.rightAnchor.constraint(equalTo: view.rightAnchor, constant: 0.0),
+            ]
+        }
+    }
+}
+
+class OneTabBarPanelLayout: FloatingPanelLayout {
+    var initialPosition: FloatingPanelPosition {
+        return .tip
+    }
+    var supportedPositions: Set<FloatingPanelPosition> {
+        return [.full, .tip]
+    }
+
+    func insetFor(position: FloatingPanelPosition) -> CGFloat? {
+        switch position {
+        case .full: return 16.0
+        case .tip: return 22.0
+        default: return nil
+        }
+    }
+}
+
+class TwoTabBarPanelLayout: FloatingPanelLayout {
+    var initialPosition: FloatingPanelPosition {
+        return .half
+    }
+    var supportedPositions: Set<FloatingPanelPosition> {
+        return [.full, .half]
+    }
+    var bottomInteractionBuffer: CGFloat {
+        return 261.0 - 22.0
+    }
+
+    func insetFor(position: FloatingPanelPosition) -> CGFloat? {
+        switch position {
+        case .full: return 16.0
+        case .half: return 261.0
+        default: return nil
+        }
+    }
+}
+
+class ThreeTabBarPanelLayout: FloatingPanelFullScreenLayout {
+    var initialPosition: FloatingPanelPosition {
+        return .half
+    }
+    var supportedPositions: Set<FloatingPanelPosition> {
+        return [.full, .half]
+    }
+    func insetFor(position: FloatingPanelPosition) -> CGFloat? {
+        switch position {
+        case .full: return 0.0
+        case .half: return 261.0
+        default: return nil
+        }
+    }
+    func backdropAlphaFor(position: FloatingPanelPosition) -> CGFloat {
+        return 0.3
+    }
+}
+
+class SettingsViewController: InspectableViewController {
+    @IBOutlet weak var largeTitlesSwicth: UISwitch!
+    @IBOutlet weak var translucentSwicth: UISwitch!
+    @IBOutlet weak var versionLabel: UILabel!
+
+    override func viewDidLoad() {
+        versionLabel.text = "Version: \(Bundle.main.infoDictionary?["CFBundleVersion"] ?? "--")"
+    }
+    
+    override func viewDidLayoutSubviews() {
+        super.viewDidLayoutSubviews()
+        if #available(iOS 11.0, *) {
+            let prefersLargeTitles = navigationController!.navigationBar.prefersLargeTitles
+            largeTitlesSwicth.setOn(prefersLargeTitles, animated: false)
+        } else {
+            largeTitlesSwicth.isEnabled = false
+        }
+        let isTranslucent = navigationController!.navigationBar.isTranslucent
+        translucentSwicth.setOn(isTranslucent, animated: false)
+    }
+
+    @IBAction func toggleLargeTitle(_ sender: UISwitch) {
+        if #available(iOS 11.0, *) {
+            navigationController?.navigationBar.prefersLargeTitles = sender.isOn
+        }
+    }
+    @IBAction func toggleTranslucent(_ sender: UISwitch) {
+        navigationController?.navigationBar.isTranslucent = sender.isOn
+    }
 }

Examples/Stocks/Stocks/Base.lproj/Main.storyboard

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <document type="com.apple.InterfaceBuilder3.CocoaTouch.Storyboard.XIB" version="3.0" toolsVersion="14313.18" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" useTraitCollections="YES" useSafeAreas="YES" colorMatched="YES" initialViewController="BYZ-38-t0r">
-    <device id="retina5_9" orientation="portrait">
+    <device id="retina4_7" orientation="portrait">
         <adaptation id="fullscreen"/>
     </device>
     <dependencies>
@@ -15,11 +15,11 @@
             <objects>
                 <viewController id="BYZ-38-t0r" customClass="ViewController" customModule="Stocks" customModuleProvider="target" sceneMemberID="viewController">
                     <view key="view" contentMode="scaleToFill" id="8bC-Xf-vdC">
-                        <rect key="frame" x="0.0" y="0.0" width="375" height="812"/>
+                        <rect key="frame" x="0.0" y="0.0" width="375" height="667"/>
                         <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
                         <subviews>
                             <scrollView clipsSubviews="YES" multipleTouchEnabled="YES" contentMode="scaleToFill" translatesAutoresizingMaskIntoConstraints="NO" id="Uop-sw-I6p">
-                                <rect key="frame" x="0.0" y="109" width="375" height="624.66666666666663"/>
+                                <rect key="frame" x="0.0" y="85" width="375" height="537.5"/>
                                 <subviews>
                                     <imageView userInteractionEnabled="NO" contentMode="scaleToFill" horizontalHuggingPriority="251" verticalHuggingPriority="251" placeholderIntrinsicWidth="375" placeholderIntrinsicHeight="625" image="stocks_list" translatesAutoresizingMaskIntoConstraints="NO" id="XJR-iK-fem">
                                         <rect key="frame" x="0.0" y="0.0" width="375" height="625"/>
@@ -34,10 +34,10 @@
                                 </constraints>
                             </scrollView>
                             <view contentMode="scaleToFill" translatesAutoresizingMaskIntoConstraints="NO" id="dFl-81-6ok">
-                                <rect key="frame" x="0.0" y="733.66666666666663" width="375" height="78.333333333333371"/>
+                                <rect key="frame" x="0.0" y="622.5" width="375" height="44.5"/>
                                 <subviews>
                                     <imageView userInteractionEnabled="NO" contentMode="scaleToFill" horizontalHuggingPriority="251" verticalHuggingPriority="251" image="yahoo_bottom_bar" translatesAutoresizingMaskIntoConstraints="NO" id="NKr-gS-mpx">
-                                        <rect key="frame" x="0.0" y="0.0" width="375" height="44.333333333333336"/>
+                                        <rect key="frame" x="0.0" y="0.0" width="375" height="44.5"/>
                                         <color key="backgroundColor" white="0.0" alpha="0.0" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
                                         <constraints>
                                             <constraint firstAttribute="height" relation="greaterThanOrEqual" constant="44.5" id="B5t-ZF-qUj"/>
@@ -52,18 +52,17 @@
                                     <constraint firstItem="NKr-gS-mpx" firstAttribute="leading" secondItem="dFl-81-6ok" secondAttribute="leading" id="T2r-kY-JYy"/>
                                 </constraints>
                             </view>
-                            <stackView opaque="NO" contentMode="scaleToFill" fixedFrame="YES" axis="vertical" alignment="top" spacing="-8" translatesAutoresizingMaskIntoConstraints="NO" id="f7r-Al-pIN">
-                                <rect key="frame" x="16" y="44.000000000000014" width="153.33333333333334" height="56.666666666666664"/>
-                                <autoresizingMask key="autoresizingMask" flexibleMaxX="YES" flexibleMaxY="YES"/>
+                            <stackView opaque="NO" contentMode="scaleToFill" axis="vertical" alignment="top" spacing="-8" translatesAutoresizingMaskIntoConstraints="NO" id="f7r-Al-pIN">
+                                <rect key="frame" x="16" y="20" width="153.5" height="57"/>
                                 <subviews>
                                     <label opaque="NO" userInteractionEnabled="NO" contentMode="left" horizontalHuggingPriority="251" verticalHuggingPriority="251" text="STOCKS" textAlignment="natural" lineBreakMode="tailTruncation" baselineAdjustment="alignBaselines" adjustsFontSizeToFit="NO" translatesAutoresizingMaskIntoConstraints="NO" id="PCG-Wl-fXa">
-                                        <rect key="frame" x="0.0" y="0.0" width="111.66666666666667" height="32.333333333333336"/>
+                                        <rect key="frame" x="0.0" y="0.0" width="111.5" height="32.5"/>
                                         <fontDescription key="fontDescription" type="system" weight="heavy" pointSize="27"/>
                                         <color key="textColor" white="1" alpha="1" colorSpace="custom" customColorSpace="genericGamma22GrayColorSpace"/>
                                         <nil key="highlightedColor"/>
                                     </label>
                                     <label opaque="NO" userInteractionEnabled="NO" contentMode="left" horizontalHuggingPriority="251" verticalHuggingPriority="251" text="OCTOBER 5" textAlignment="natural" lineBreakMode="tailTruncation" baselineAdjustment="alignBaselines" adjustsFontSizeToFit="NO" translatesAutoresizingMaskIntoConstraints="NO" id="XmK-pu-9g4">
-                                        <rect key="frame" x="0.0" y="24.333333333333332" width="153.33333333333334" height="32.333333333333343"/>
+                                        <rect key="frame" x="0.0" y="24.5" width="153.5" height="32.5"/>
                                         <fontDescription key="fontDescription" type="system" weight="heavy" pointSize="27"/>
                                         <color key="textColor" red="0.55308091640472412" green="0.55657511949539185" blue="0.57255202531814575" alpha="1" colorSpace="custom" customColorSpace="displayP3"/>
                                         <nil key="highlightedColor"/>
@@ -75,10 +74,12 @@
                         <constraints>
                             <constraint firstItem="6Tk-OE-BBY" firstAttribute="trailing" secondItem="dFl-81-6ok" secondAttribute="trailing" id="20i-yz-AaQ"/>
                             <constraint firstItem="Uop-sw-I6p" firstAttribute="leading" secondItem="6Tk-OE-BBY" secondAttribute="leading" id="44w-r8-vYl"/>
+                            <constraint firstItem="f7r-Al-pIN" firstAttribute="leading" secondItem="6Tk-OE-BBY" secondAttribute="leading" constant="16" id="4Bq-Km-eET"/>
                             <constraint firstItem="Uop-sw-I6p" firstAttribute="top" secondItem="6Tk-OE-BBY" secondAttribute="top" constant="65" id="CXL-Dk-8MM"/>
                             <constraint firstItem="Uop-sw-I6p" firstAttribute="trailing" secondItem="6Tk-OE-BBY" secondAttribute="trailing" id="CsO-WF-T8L"/>
                             <constraint firstItem="dFl-81-6ok" firstAttribute="top" secondItem="Uop-sw-I6p" secondAttribute="bottom" id="Cz0-dW-r9H"/>
                             <constraint firstAttribute="bottom" secondItem="dFl-81-6ok" secondAttribute="bottom" id="KGl-8W-5ja"/>
+                            <constraint firstItem="f7r-Al-pIN" firstAttribute="top" secondItem="6Tk-OE-BBY" secondAttribute="top" constant="1.4210854715202004e-14" id="Qvt-vQ-PpT"/>
                             <constraint firstItem="dFl-81-6ok" firstAttribute="leading" secondItem="6Tk-OE-BBY" secondAttribute="leading" id="nlX-Ab-1aI"/>
                             <constraint firstItem="6Tk-OE-BBY" firstAttribute="bottom" secondItem="NKr-gS-mpx" secondAttribute="bottom" id="yeu-NH-Pmp"/>
                         </constraints>

Examples/Stocks/Stocks/ViewController.swift

@@ -34,8 +34,8 @@ class ViewController: UIViewController, FloatingPanelControllerDelegate {
 
         newsVC = storyboard?.instantiateViewController(withIdentifier: "News") as? NewsViewController
 
-        // Add a content view controller
-        fpc.show(newsVC, sender: self)
+        // Set a content view controller
+        fpc.set(contentViewController: newsVC)
         fpc.track(scrollView: newsVC.scrollView)
 
         fpc.addPanel(toParent: self, belowView: bottomToolView, animated: false)
@@ -102,30 +102,25 @@ class NewsViewController: UIViewController {
 // MARK: My custom layout
 
 class FloatingPanelStocksLayout: FloatingPanelLayout {
-    public var supportedPositions: [FloatingPanelPosition] {
-        return [.full, .half, .tip]
-    }
-
-    public var initialPosition: FloatingPanelPosition {
+    var initialPosition: FloatingPanelPosition {
         return .tip
     }
 
-    public func insetFor(position: FloatingPanelPosition) -> CGFloat? {
+    var topInteractionBuffer: CGFloat { return 0.0 }
+    var bottomInteractionBuffer: CGFloat { return 0.0 }
+
+    func insetFor(position: FloatingPanelPosition) -> CGFloat? {
         switch position {
         case .full: return 56.0
         case .half: return 262.0
         case .tip: return 85.0 + 44.0 // Visible + ToolView
+        default: return nil
         }
     }
 
-    public func prepareLayout(surfaceView: UIView, in view: UIView) -> [NSLayoutConstraint] {
-        return [
-            surfaceView.leftAnchor.constraint(equalTo: view.safeAreaLayoutGuide.leftAnchor, constant: 0.0),
-            surfaceView.rightAnchor.constraint(equalTo: view.safeAreaLayoutGuide.rightAnchor, constant: 0.0),
-        ]
+    func backdropAlphaFor(position: FloatingPanelPosition) -> CGFloat {
+        return 0.0
     }
-
-    var backdropAlpha: CGFloat = 0.0
 }
 
 // MARK: My custom behavior

FloatingPanel.podspec

@@ -1,10 +1,10 @@
 Pod::Spec.new do |s|
 
   s.name                = "FloatingPanel"
-  s.version             = "1.0.0"
-  s.summary             = "FloatingPanel is a simple and easy-to-use UI component of a floating panel interface"
+  s.version             = "1.3.3"
+  s.summary             = "FloatingPanel is a clean and easy-to-use UI component of a floating panel interface."
   s.description         = <<-DESC
-FloatingPanel is a simple and easy-to-use UI component for a new interface introduced in Apple Maps, Shortcuts and Stocks app.
+FloatingPanel is a clean and easy-to-use UI component for a new interface introduced in Apple Maps, Shortcuts and Stocks app.
 The new interface displays the related contents and utilities in parallel as a user wants.
                    DESC
   s.homepage            = "https://github.com/SCENEE/FloatingPanel"
@@ -13,7 +13,7 @@ The new interface displays the related contents and utilities in parallel as a u
   s.platform            = :ios, "10.0"
   s.source              = { :git => "https://github.com/SCENEE/FloatingPanel.git", :tag => "v#{s.version}" }
   s.source_files        = "Framework/Sources/*.swift"
-  s.swift_version       = "4.2"
+  s.swift_version       = "4.0"
   s.pod_target_xcconfig = { 'SWIFT_WHOLE_MODULE_OPTIMIZATION' => 'YES', 'APPLICATION_EXTENSION_API_ONLY' => 'YES' }
 
   s.framework           = "UIKit"

Framework/FloatingPanel.xcodeproj/project.pbxproj

@@ -7,6 +7,8 @@
 	objects = {
 
 /* Begin PBXBuildFile section */
+		54352E9621A51A2500CBCA08 /* FloatingPanelTransitioning.swift in Sources */ = {isa = PBXBuildFile; fileRef = 54352E9521A51A2500CBCA08 /* FloatingPanelTransitioning.swift */; };
+		54352E9821A521CA00CBCA08 /* FloatingPanelView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 54352E9721A521CA00CBCA08 /* FloatingPanelView.swift */; };
 		5450EEE421646DF500135936 /* FloatingPanelBehavior.swift in Sources */ = {isa = PBXBuildFile; fileRef = 5450EEE321646DF500135936 /* FloatingPanelBehavior.swift */; };
 		545DB9CB2151169500CA77B8 /* FloatingPanel.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 545DB9C12151169500CA77B8 /* FloatingPanel.framework */; };
 		545DB9D02151169500CA77B8 /* ViewTests.swift in Sources */ = {isa = PBXBuildFile; fileRef = 545DB9CF2151169500CA77B8 /* ViewTests.swift */; };
@@ -32,6 +34,8 @@
 /* End PBXContainerItemProxy section */
 
 /* Begin PBXFileReference section */
+		54352E9521A51A2500CBCA08 /* FloatingPanelTransitioning.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = FloatingPanelTransitioning.swift; sourceTree = "<group>"; };
+		54352E9721A521CA00CBCA08 /* FloatingPanelView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = FloatingPanelView.swift; sourceTree = "<group>"; };
 		5450EEE321646DF500135936 /* FloatingPanelBehavior.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = FloatingPanelBehavior.swift; sourceTree = "<group>"; };
 		545DB9C12151169500CA77B8 /* FloatingPanel.framework */ = {isa = PBXFileReference; explicitFileType = wrapper.framework; includeInIndex = 0; path = FloatingPanel.framework; sourceTree = BUILT_PRODUCTS_DIR; };
 		545DB9C42151169500CA77B8 /* FloatingPanelController.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = FloatingPanelController.h; sourceTree = "<group>"; };
@@ -92,9 +96,11 @@
 				545DB9C52151169500CA77B8 /* Info.plist */,
 				545DB9C42151169500CA77B8 /* FloatingPanelController.h */,
 				545DB9DF21511AC100CA77B8 /* FloatingPanelController.swift */,
+				54352E9521A51A2500CBCA08 /* FloatingPanelTransitioning.swift */,
 				54CFBFC4215CD09C006B5735 /* FloatingPanel.swift */,
 				54CFBFC2215CD045006B5735 /* FloatingPanelLayout.swift */,
 				5450EEE321646DF500135936 /* FloatingPanelBehavior.swift */,
+				54352E9721A521CA00CBCA08 /* FloatingPanelView.swift */,
 				54CDC5D2215B6D5A007D205C /* FloatingPanelSurfaceView.swift */,
 				54CDC5D4215B6D8D007D205C /* FloatingPanelBackdropView.swift */,
 				545DBA2A2152383100CA77B8 /* GrabberHandleView.swift */,
@@ -225,11 +231,13 @@
 				54CDC5D3215B6D5A007D205C /* FloatingPanelSurfaceView.swift in Sources */,
 				54CFBFC3215CD045006B5735 /* FloatingPanelLayout.swift in Sources */,
 				54CDC5D5215B6D8D007D205C /* FloatingPanelBackdropView.swift in Sources */,
+				54352E9821A521CA00CBCA08 /* FloatingPanelView.swift in Sources */,
 				54CFBFC5215CD09C006B5735 /* FloatingPanel.swift in Sources */,
 				54ABD7AF216CCFF7002E6C13 /* Logger.swift in Sources */,
 				545DB9E021511AC100CA77B8 /* FloatingPanelController.swift in Sources */,
 				5450EEE421646DF500135936 /* FloatingPanelBehavior.swift in Sources */,
 				545DBA2B2152383100CA77B8 /* GrabberHandleView.swift in Sources */,
+				54352E9621A51A2500CBCA08 /* FloatingPanelTransitioning.swift in Sources */,
 				545DB9DE215118C800CA77B8 /* UIExtensions.swift in Sources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
@@ -398,7 +406,7 @@
 				SKIP_INSTALL = YES;
 				SWIFT_ACTIVE_COMPILATION_CONDITIONS = DEBUG;
 				SWIFT_OPTIMIZATION_LEVEL = "-Onone";
-				SWIFT_VERSION = 4.2;
+				SWIFT_VERSION = 4.0;
 				TARGETED_DEVICE_FAMILY = "1,2";
 			};
 			name = Debug;
@@ -424,7 +432,7 @@
 				PRODUCT_BUNDLE_IDENTIFIER = com.scenee.FloatingPanel;
 				PRODUCT_NAME = "$(TARGET_NAME:c99extidentifier)";
 				SKIP_INSTALL = YES;
-				SWIFT_VERSION = 4.2;
+				SWIFT_VERSION = 4.0;
 				TARGETED_DEVICE_FAMILY = "1,2";
 			};
 			name = Release;

Framework/Sources/FloatingPanel.swift

@@ -8,9 +8,9 @@ import UIKit
 /// FloatingPanel presentation model
 ///
 class FloatingPanel: NSObject, UIGestureRecognizerDelegate, UIScrollViewDelegate {
-    /* Cause 'terminating with uncaught exception of type NSException' error on Swift Playground
-     unowned let view: UIView
-     */
+    // MUST be a weak reference to prevent UI freeze on the presentaion modally
+    weak var viewcontroller: FloatingPanelController!
+
     let surfaceView: FloatingPanelSurfaceView
     let backdropView: FloatingPanelBackdropView
     var layoutAdapter: FloatingPanelLayoutAdapter
@@ -26,20 +26,25 @@ class FloatingPanel: NSObject, UIGestureRecognizerDelegate, UIScrollViewDelegate
     }
     weak var userScrollViewDelegate: UIScrollViewDelegate?
 
-    var safeAreaInsets: UIEdgeInsets! {
-        get { return layoutAdapter.safeAreaInsets }
-        set { layoutAdapter.safeAreaInsets = newValue }
+    private(set) var state: FloatingPanelPosition = .hidden {
+        didSet { viewcontroller.delegate?.floatingPanelDidChangePosition(viewcontroller) }
     }
 
-    unowned let viewcontroller: FloatingPanelController
+    private var isBottomState: Bool {
+        let remains = layoutAdapter.supportedPositions.filter { $0.rawValue > state.rawValue }
+        return remains.count == 0
+    }
 
-    private(set) var state: FloatingPanelPosition = .tip
+    let panGesture: FloatingPanelPanGestureRecognizer
+    var isRemovalInteractionEnabled: Bool = false
 
     private var animator: UIViewPropertyAnimator?
-    private let panGesture: UIPanGestureRecognizer
     private var initialFrame: CGRect = .zero
+    private var initialScrollOffset: CGPoint = .zero
+    private var initialScrollInset: UIEdgeInsets = .zero
     private var transOffsetY: CGFloat = 0
-    private var interactionInProgress: Bool = false
+
+    var interactionInProgress: Bool = false
 
     // Scroll handling
     private var stopScrollDeceleration: Bool = false
@@ -50,7 +55,10 @@ class FloatingPanel: NSObject, UIGestureRecognizerDelegate, UIScrollViewDelegate
 
     init(_ vc: FloatingPanelController, layout: FloatingPanelLayout, behavior: FloatingPanelBehavior) {
         viewcontroller = vc
-        surfaceView = vc.view as! FloatingPanelSurfaceView
+
+        surfaceView = FloatingPanelSurfaceView()
+        surfaceView.backgroundColor = .white
+
         backdropView = FloatingPanelBackdropView()
         backdropView.backgroundColor = .black
         backdropView.alpha = 0.0
@@ -60,7 +68,7 @@ class FloatingPanel: NSObject, UIGestureRecognizerDelegate, UIScrollViewDelegate
                                                         layout: layout)
         self.behavior = behavior
 
-        panGesture = UIPanGestureRecognizer()
+        panGesture = FloatingPanelPanGestureRecognizer()
 
         if #available(iOS 11.0, *) {
             panGesture.name = "FloatingPanelSurface"
@@ -73,24 +81,28 @@ class FloatingPanel: NSObject, UIGestureRecognizerDelegate, UIScrollViewDelegate
         panGesture.delegate = self
     }
 
-    func layoutViews(in vc: UIViewController) {
-        unowned let view = vc.view!
-
-        view.insertSubview(backdropView, belowSubview: surfaceView)
-        backdropView.frame = view.bounds
-
-        layoutAdapter.prepareLayout(toParent: vc)
+    func move(to: FloatingPanelPosition, animated: Bool, completion: (() -> Void)? = nil) {
+        move(from: state, to: to, animated: animated, completion: completion)
     }
 
-    func move(to: FloatingPanelPosition, animated: Bool, completion: (() -> Void)? = nil) {
+    private func move(from: FloatingPanelPosition, to: FloatingPanelPosition, animated: Bool, completion: (() -> Void)? = nil) {
         if to != .full {
             lockScrollView()
         }
 
         if animated {
-            let animator = behavior.presentAnimator(self.viewcontroller, from: state, to: to)
+            let animator: UIViewPropertyAnimator
+            switch (from, to) {
+            case (.hidden, let to):
+                animator = behavior.addAnimator(self.viewcontroller, to: to)
+            case (let from, .hidden):
+                animator = behavior.removeAnimator(self.viewcontroller, from: from)
+            case (let from, let to):
+                animator = behavior.moveAnimator(self.viewcontroller, from: from, to: to)
+            }
+
             animator.addAnimations { [weak self] in
-                guard let self = self else { return }
+                guard let `self` = self else { return }
 
                 self.updateLayout(to: to)
                 self.state = to
@@ -106,50 +118,28 @@ class FloatingPanel: NSObject, UIGestureRecognizerDelegate, UIScrollViewDelegate
         }
     }
 
-    func present(animated: Bool, completion: (() -> Void)? = nil) {
-        self.layoutAdapter.activateLayout(of: nil)
-        move(to: layoutAdapter.layout.initialPosition, animated: animated, completion: completion)
-    }
-
-    func dismiss(animated: Bool, completion: (() -> Void)? = nil) {
-        if animated {
-            let animator = behavior.dismissAnimator(self.viewcontroller, from: state)
-            animator.addAnimations { [weak self] in
-                guard let self = self else { return }
-
-                self.updateLayout(to: nil)
-            }
-            animator.addCompletion { _ in
-                completion?()
-            }
-            animator.startAnimation()
-        } else {
-            self.updateLayout(to: nil)
-            completion?()
-        }
-    }
-
     // MARK: - Layout update
 
-    private func updateLayout(to target: FloatingPanelPosition?) {
+    private func updateLayout(to target: FloatingPanelPosition) {
         self.layoutAdapter.activateLayout(of: target)
-        self.setBackdropAlpha(of: target)
-    }
-
-    private func setBackdropAlpha(of target: FloatingPanelPosition?) {
-        switch target {
-        case .full?:
-            self.backdropView.alpha = layoutAdapter.layout.backdropAlpha
-        default:
-            self.backdropView.alpha = 0.0
-        }
     }
 
     private func getBackdropAlpha(with translation: CGPoint) -> CGFloat {
-        let topY = layoutAdapter.topY
-        let middleY = layoutAdapter.middleY
         let currentY = getCurrentY(from: initialFrame, with: translation)
-        return (1 - (currentY - topY) / (middleY - topY)) * layoutAdapter.layout.backdropAlpha
+
+        let next = directionalPosition(with: translation)
+        let pre = redirectionalPosition(with: translation)
+        let nextY = layoutAdapter.positionY(for: next)
+        let preY = layoutAdapter.positionY(for: pre)
+
+        let nextAlpha = layoutAdapter.layout.backdropAlphaFor(position: next)
+        let preAlpha = layoutAdapter.layout.backdropAlphaFor(position: pre)
+
+        if preY == nextY {
+            return preAlpha
+        } else {
+            return preAlpha + max(min(1.0, 1.0 - (nextY - currentY) / (nextY - preY) ), 0.0) * (nextAlpha - preAlpha)
+        }
     }
 
     // MARK: - UIGestureRecognizerDelegate
@@ -158,59 +148,145 @@ class FloatingPanel: NSObject, UIGestureRecognizerDelegate, UIScrollViewDelegate
                                   shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
         guard gestureRecognizer == panGesture else { return false }
 
-        log.debug("shouldRecognizeSimultaneouslyWith", otherGestureRecognizer)
+        /* log.debug("shouldRecognizeSimultaneouslyWith", otherGestureRecognizer) */
 
-        return otherGestureRecognizer == scrollView?.panGestureRecognizer
+        if viewcontroller.delegate?.floatingPanel(viewcontroller, shouldRecognizeSimultaneouslyWith: otherGestureRecognizer) ?? false {
+            return true
+        }
+
+        // all gestures of the tracking scroll view should be recognized in parallel
+        // and handle them in self.handle(panGesture:)
+        return scrollView?.gestureRecognizers?.contains(otherGestureRecognizer) ?? false
     }
 
     public func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldBeRequiredToFailBy otherGestureRecognizer: UIGestureRecognizer) -> Bool {
         guard gestureRecognizer == panGesture else { return false }
+        /* log.debug("shouldBeRequiredToFailBy", otherGestureRecognizer) */
+        return false
+    }
 
-        // Do not begin any gestures excluding scrollView?.panGestureRecognizer until the pan gesture fails
-        if otherGestureRecognizer == scrollView?.panGestureRecognizer {
+    public func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRequireFailureOf otherGestureRecognizer: UIGestureRecognizer) -> Bool {
+        guard gestureRecognizer == panGesture else { return false }
+
+        /* log.debug("shouldRequireFailureOf", otherGestureRecognizer) */
+
+        // Should begin the pan gesture without waiting for the tracking scroll view's gestures.
+        // `scrollView.gestureRecognizers` can contains the following gestures
+        // * UIScrollViewDelayedTouchesBeganGestureRecognizer
+        // * UIScrollViewPanGestureRecognizer (scrollView.panGestureRecognizer)
+        // * _UIDragAutoScrollGestureRecognizer
+        // * _UISwipeActionPanGestureRecognizer
+        // * UISwipeDismissalGestureRecognizer
+        if let scrollView = scrollView {
+            // On short contents scroll, `_UISwipeActionPanGestureRecognizer` blocks
+            // the panel's pan gesture if not returns false
+            if let scrollGestureRecognizers = scrollView.gestureRecognizers,
+                scrollGestureRecognizers.contains(otherGestureRecognizer) {
+                return false
+            }
+        }
+
+        if viewcontroller.delegate?.floatingPanel(viewcontroller, shouldRecognizeSimultaneouslyWith: otherGestureRecognizer) ?? false {
             return false
-        } else {
+        }
+
+
+        switch otherGestureRecognizer {
+        case is UIPanGestureRecognizer,
+             is UISwipeGestureRecognizer,
+             is UIRotationGestureRecognizer,
+             is UIScreenEdgePanGestureRecognizer,
+             is UIPinchGestureRecognizer:
+            // Do not begin the pan gesture until these gestures fail
             return true
+        default:
+            // Should begin the pan gesture witout waiting tap/long press gestures fail
+            return false
         }
     }
 
-    // MARK: - Gesture handling
+    var grabberAreaFrame: CGRect {
+        let grabberAreaFrame = CGRect(x: surfaceView.bounds.origin.x,
+                                     y: surfaceView.bounds.origin.y,
+                                     width: surfaceView.bounds.width,
+                                     height: FloatingPanelSurfaceView.topGrabberBarHeight * 2)
+        return grabberAreaFrame
+    }
 
+    // MARK: - Gesture handling
+    private let offsetThreshold: CGFloat = 5.0 // Optimal value from testing
     @objc func handle(panGesture: UIPanGestureRecognizer) {
         log.debug("Gesture >>>>", panGesture)
+        let velocity = panGesture.velocity(in: panGesture.view)
 
         switch panGesture {
         case scrollView?.panGestureRecognizer:
             guard let scrollView = scrollView else { return }
+
+            log.debug("SrollPanGesture ScrollView.contentOffset >>>", scrollView.contentOffset.y, scrollView.contentSize, scrollView.bounds.size)
+
+            // Prevent scoll slip by the top bounce when the scroll view's height is
+            // less than the content's height
+            if scrollView.isDecelerating == false, scrollView.contentSize.height > scrollView.bounds.height {
+                scrollView.bounces = (scrollView.contentOffset.y > offsetThreshold)
+            }
+
             if surfaceView.frame.minY > layoutAdapter.topY {
-                scrollView.contentOffset.y = scrollView.contentOffsetZero.y
+                switch state {
+                case .full:
+                    let point = panGesture.location(in: surfaceView)
+                    if grabberAreaFrame.contains(point) {
+                        // Preserve the current content offset in moving from full.
+                        scrollView.contentOffset.y = initialScrollOffset.y
+                    } else {
+                        // Prevent over scrolling in moving from full.
+                        scrollView.contentOffset.y = scrollView.contentOffsetZero.y
+                    }
+                case .half, .tip:
+                    guard scrollView.isDecelerating == false else {
+                        // Don't fix the scroll offset in animating the panel to half and tip.
+                        // It causes a buggy scrolling deceleration because `state` becomes
+                        // a target position in animating the panel on the interaction from full.
+                        return
+                    }
+                    // Fix the scroll offset in moving the panel from half and tip.
+                    scrollView.contentOffset.y = initialScrollOffset.y + (initialScrollInset.top - scrollView.contentInset.top)
+                case .hidden:
+                    fatalError("A floating panel hidden must not be used by a user")
+                }
+
+                // Always hide a scroll indicator at the non-top.
+                if interactionInProgress {
+                    lockScrollView()
+                }
+            } else {
+                // Always show a scroll indicator at the top.
+                if interactionInProgress {
+                    unlockScrollView()
+                }
             }
         case panGesture:
             let translation = panGesture.translation(in: panGesture.view!.superview)
-            let velocity = panGesture.velocity(in: panGesture.view)
             let location = panGesture.location(in: panGesture.view)
 
-            log.debug(panGesture.state, ">>>", "{ translation: \(translation), velocity: \(velocity) }")
+            log.debug(panGesture.state, ">>>", "translation: \(translation.y), velocity: \(velocity.y)")
 
-            if let scrollView = scrollView, scrollView.frame.contains(location) {
-                log.debug("ScrollView.contentOffset >>>", scrollView.contentOffset)
-                if state == .full {
-                    if scrollView.contentOffset.y - scrollView.contentOffsetZero.y > 0 {
-                        return
-                    }
-                    if scrollView.isDecelerating {
-                        return
-                    }
-                    if interactionInProgress == false, velocity.y < 0 || velocity.y > 2500.0 {
-                        return
-                    }
-                }
+            if shouldScrollViewHandleTouch(scrollView, point: location, velocity: velocity) {
+                return
+            }
+
+            if let animator = self.animator, animator.isInterruptible {
+                animator.stopAnimation(true)
+                self.animator = nil
             }
 
             switch panGesture.state {
             case .began:
                 panningBegan()
             case .changed:
+                if interactionInProgress == false {
+                    startInteraction(with: translation)
+                }
                 panningChange(with: translation)
             case .ended, .cancelled, .failed:
                 panningEnd(with: translation, velocity: velocity)
@@ -222,18 +298,56 @@ class FloatingPanel: NSObject, UIGestureRecognizerDelegate, UIScrollViewDelegate
         }
     }
 
+    private func shouldScrollViewHandleTouch(_ scrollView: UIScrollView?, point: CGPoint, velocity: CGPoint) -> Bool {
+        // When no scrollView, nothing to handle.
+        guard let scrollView = scrollView else { return false }
+
+        // For _UISwipeActionPanGestureRecognizer
+        if let scrollGestureRecognizers = scrollView.gestureRecognizers {
+            for gesture in scrollGestureRecognizers {
+                guard gesture.state == .began || gesture.state == .changed
+                else { continue }
+
+                if gesture !=  scrollView.panGestureRecognizer {
+                    return true
+                }
+            }
+        }
+
+        guard
+            state == .full,                   // When not .full, don't scroll.
+            interactionInProgress == false,   // When interaction already in progress, don't scroll.
+            scrollView.frame.contains(point), // When point not in scrollView, don't scroll.
+            !grabberAreaFrame.contains(point) // When point within grabber area, don't scroll.
+        else {
+            return false
+        }
+
+        log.debug("ScrollView.contentOffset >>>", scrollView.contentOffset.y)
+
+        let offset = scrollView.contentOffset.y - scrollView.contentOffsetZero.y
+        if  abs(offset) > offsetThreshold {
+            return true
+        }
+        if scrollView.isDecelerating {
+            return true
+        }
+        if velocity.y < 0 {
+            return true
+        }
+
+        return false
+    }
+
     private func panningBegan() {
         // A user interaction does not always start from Began state of the pan gesture
         // because it can be recognized in scrolling a content in a content view controller.
-        // So I don't nothing here.
-        log.debug("panningBegan \(initialFrame)")
+        // So do nothing here.
+        log.debug("panningBegan")
     }
 
     private func panningChange(with translation: CGPoint) {
         log.debug("panningChange")
-        if interactionInProgress == false {
-            startInteraction(with: translation)
-        }
 
         let currentY = getCurrentY(from: initialFrame, with: translation)
 
@@ -247,40 +361,130 @@ class FloatingPanel: NSObject, UIGestureRecognizerDelegate, UIScrollViewDelegate
 
     private func panningEnd(with translation: CGPoint, velocity: CGPoint) {
         log.debug("panningEnd")
+
+        guard state != .hidden else {
+            log.debug("Already hidden")
+            return
+        }
+
         if interactionInProgress == false {
             initialFrame = surfaceView.frame
         }
 
-        stopScrollDeceleration = (surfaceView.frame.minY > layoutAdapter.topY) // Projecting the dragging to the scroll dragging
+        stopScrollDeceleration = (surfaceView.frame.minY > layoutAdapter.topY) // Projecting the dragging to the scroll dragging or not
 
         let targetPosition = self.targetPosition(with: translation, velocity: velocity)
         let distance = self.distance(to: targetPosition, with: translation)
 
         endInteraction(for: targetPosition)
 
+        if isRemovalInteractionEnabled, isBottomState {
+            let velocityVector = (distance != 0) ? CGVector(dx: 0,
+                                                            dy: max(min(velocity.y/distance, behavior.removalVelocity), 0.0)) : .zero
+
+
+
+            if shouldStartRemovalAnimation(with: translation, velocityVector: velocityVector) {
+
+                viewcontroller.delegate?.floatingPanelDidEndDraggingToRemove(viewcontroller, withVelocity: velocity)
+                self.startRemovalAnimation(with: velocityVector) { [weak self] in
+                    guard let `self` = self else { return }
+                    self.viewcontroller.dismiss(animated: false, completion: { [weak self] in
+                        guard let `self` = self else { return }
+                        self.viewcontroller.delegate?.floatingPanelDidEndRemove(self.viewcontroller)
+                    })
+                }
+                return
+            }
+        }
+
         viewcontroller.delegate?.floatingPanelDidEndDragging(viewcontroller, withVelocity: velocity, targetPosition: targetPosition)
         viewcontroller.delegate?.floatingPanelWillBeginDecelerating(viewcontroller)
 
         startAnimation(to: targetPosition, at: distance, with: velocity)
     }
 
+    private func shouldStartRemovalAnimation(with translation: CGPoint, velocityVector: CGVector) -> Bool {
+        let posY = layoutAdapter.positionY(for: state)
+        let currentY = getCurrentY(from: initialFrame, with: translation)
+        let safeAreaBottomY = layoutAdapter.safeAreaBottomY
+        let vth = behavior.removalVelocity
+        let pth = max(min(behavior.removalProgress, 1.0), 0.0)
+
+        let num = (currentY - posY)
+        let den = (safeAreaBottomY - posY)
+
+        guard num >= 0, den != 0, (num / den >= pth || velocityVector.dy == vth)
+        else { return false }
+
+        return true
+    }
+
+    private func startRemovalAnimation(with velocityVector: CGVector, completion: (() -> Void)?) {
+        let animator = self.behavior.removalInteractionAnimator(self.viewcontroller, with: velocityVector)
+
+        animator.addAnimations { [weak self] in
+            self?.updateLayout(to: .hidden)
+        }
+        animator.addCompletion({ _ in
+            completion?()
+        })
+        animator.startAnimation()
+    }
+
     private func startInteraction(with translation: CGPoint) {
+        /* Don't lock a scroll view to show a scroll indicator after hitting the top */
         log.debug("startInteraction")
         initialFrame = surfaceView.frame
+        if let scrollView = scrollView {
+            initialScrollOffset = scrollView.contentOffset
+            initialScrollInset = scrollView.contentInset
+        }
         transOffsetY = translation.y
+
         viewcontroller.delegate?.floatingPanelWillBeginDragging(viewcontroller)
 
-        lockScrollView()
+        if state == .full {
+            viewcontroller.contentViewController?.view?.constraints.forEach({ (const) in
+                switch viewcontroller.contentViewController?.layoutGuide.bottomAnchor {
+                case const.firstAnchor:
+                    (const.secondItem as? UIView)?.disableAutoLayout()
+                    const.isActive = false
+                case const.secondAnchor:
+                    (const.firstItem as? UIView)?.disableAutoLayout()
+                    const.isActive = false
+                default:
+                    break
+                }
+            })
+        }
 
         interactionInProgress = true
     }
 
     private func endInteraction(for targetPosition: FloatingPanelPosition) {
         log.debug("endInteraction for \(targetPosition)")
-        if targetPosition != .full {
-            lockScrollView(withBounce: true)
-        }
         interactionInProgress = false
+
+        // Prevent to keep a scoll view indicator visible at the half/tip position
+        if targetPosition != .full {
+            lockScrollView()
+        }
+
+        if state == .full {
+            viewcontroller.contentViewController?.view?.constraints.forEach({ (const) in
+                switch viewcontroller.contentViewController?.layoutGuide.bottomAnchor {
+                case const.firstAnchor:
+                    (const.secondItem as? UIView)?.enableAutoLayout()
+                    const.isActive = true
+                case const.secondAnchor:
+                    (const.firstItem as? UIView)?.enableAutoLayout()
+                    const.isActive = true
+                default:
+                    break
+                }
+            })
+        }
     }
 
     private func getCurrentY(from rect: CGRect, with translation: CGPoint) -> CGFloat {
@@ -288,9 +492,7 @@ class FloatingPanel: NSObject, UIGestureRecognizerDelegate, UIScrollViewDelegate
         let y = rect.offsetBy(dx: 0.0, dy: dy).origin.y
 
         let topY = layoutAdapter.topY
-        let topInset = layoutAdapter.topInset
         let topBuffer = layoutAdapter.layout.topInteractionBuffer
-
         let bottomY = layoutAdapter.bottomY
         let bottomBuffer = layoutAdapter.layout.bottomInteractionBuffer
 
@@ -300,26 +502,28 @@ class FloatingPanel: NSObject, UIGestureRecognizerDelegate, UIScrollViewDelegate
                 return max(topY, min(bottomY, y))
             }
         }
-        return max(topY - topInset + topBuffer, min(bottomY + bottomBuffer, y))
+        let topMax = layoutAdapter.topMaxY
+        let bottomMax = layoutAdapter.bottomMaxY
+        return max(max(topY - topBuffer, topMax), min(min(bottomY + bottomBuffer, bottomMax), y))
     }
 
     private func startAnimation(to targetPosition: FloatingPanelPosition, at distance: CGFloat, with velocity: CGPoint) {
+        log.debug("startAnimation", targetPosition, distance, velocity)
         let targetY = layoutAdapter.positionY(for: targetPosition)
         let velocityVector = (distance != 0) ? CGVector(dx: 0, dy: max(min(velocity.y/distance, 30.0), -30.0)) : .zero
         let animator = behavior.interactionAnimator(self.viewcontroller, to: targetPosition, with: velocityVector)
-        animator.isInterruptible = false // To prevent a backdrop color's punk
         animator.addAnimations { [weak self] in
-            guard let self = self else { return }
+            guard let `self` = self else { return }
             if self.state == targetPosition {
                 self.surfaceView.frame.origin.y = targetY
-                self.setBackdropAlpha(of: targetPosition)
+                self.layoutAdapter.setBackdropAlpha(of: targetPosition)
             } else {
                 self.updateLayout(to: targetPosition)
             }
             self.state = targetPosition
         }
         animator.addCompletion { [weak self] pos in
-            guard let self = self else { return }
+            guard let `self` = self else { return }
             guard
                 self.interactionInProgress == false,
                 animator == self.animator,
@@ -336,8 +540,11 @@ class FloatingPanel: NSObject, UIGestureRecognizerDelegate, UIScrollViewDelegate
         self.animator = nil
         self.viewcontroller.delegate?.floatingPanelDidEndDecelerating(self.viewcontroller)
 
+        stopScrollDeceleration = false
         // Don't unlock scroll view in animating view when presentation layer != model layer
-        unlockScrollView()
+        if targetPosition == .full {
+            unlockScrollView()
+        }
     }
 
     private func distance(to targetPosition: FloatingPanelPosition, with translation: CGPoint) -> CGFloat {
@@ -345,6 +552,7 @@ class FloatingPanel: NSObject, UIGestureRecognizerDelegate, UIScrollViewDelegate
         let middleY = layoutAdapter.middleY
         let bottomY = layoutAdapter.bottomY
         let currentY = getCurrentY(from: initialFrame, with: translation)
+
         switch targetPosition {
         case .full:
             return CGFloat(fabs(Double(currentY - topY)))
@@ -352,39 +560,139 @@ class FloatingPanel: NSObject, UIGestureRecognizerDelegate, UIScrollViewDelegate
             return CGFloat(fabs(Double(currentY - middleY)))
         case .tip:
             return CGFloat(fabs(Double(currentY - bottomY)))
+        case .hidden:
+            fatalError("A floating panel hidden must not be used by a user")
+        }
+    }
+
+    private func directionalPosition(with translation: CGPoint) -> FloatingPanelPosition {
+        let currentY = getCurrentY(from: initialFrame, with: translation)
+
+        let supportedPositions = layoutAdapter.supportedPositions
+
+        if supportedPositions.count == 1 {
+            return state
+        }
+
+        switch supportedPositions {
+        case [.full, .half]: return translation.y >= 0 ? .half : .full
+        case [.half, .tip]: return translation.y >= 0 ? .tip : .half
+        case [.full, .tip]: return translation.y >= 0 ? .tip : .full
+        default:
+            let middleY = layoutAdapter.middleY
+
+            switch state {
+            case .full:
+                if translation.y <= 0 {
+                    return .full
+                }
+                return currentY > middleY ? .tip : .half
+            case .half:
+                return currentY > middleY ? .tip : .full
+            case .tip:
+                if translation.y >= 0 {
+                    return .tip
+                }
+                return currentY > middleY ? .half : .full
+            case .hidden:
+                fatalError("A floating panel hidden must not be used by a user")
+            }
+        }
+    }
+
+    private func redirectionalPosition(with translation: CGPoint) -> FloatingPanelPosition {
+        let currentY = getCurrentY(from: initialFrame, with: translation)
+
+        let supportedPositions = layoutAdapter.supportedPositions
+
+        if supportedPositions.count == 1 {
+            return state
+        }
+
+        switch supportedPositions {
+        case [.full, .half]: return translation.y >= 0 ? .full : .half
+        case [.half, .tip]: return translation.y >= 0 ? .half : .tip
+        case [.full, .tip]: return translation.y >= 0 ? .full : .tip
+        default:
+            let middleY = layoutAdapter.middleY
+
+            switch state {
+            case .full:
+                return currentY > middleY ? .half : .full
+            case .half:
+                return .half
+            case .tip:
+                return currentY > middleY ? .tip : .half
+            case .hidden:
+                fatalError("A floating panel hidden must not be used by a user")
+            }
         }
     }
 
     // Distance travelled after decelerating to zero velocity at a constant rate.
     // Refer to the slides p176 of [Designing Fluid Interfaces](https://developer.apple.com/videos/play/wwdc2018/803/)
     private func project(initialVelocity: CGFloat) -> CGFloat {
-        let decelerationRate = UIScrollView.DecelerationRate.normal.rawValue
+        let decelerationRate = UIScrollViewDecelerationRateNormal
         return (initialVelocity / 1000.0) * decelerationRate / (1.0 - decelerationRate)
     }
 
     private func targetPosition(with translation: CGPoint, velocity: CGPoint) -> (FloatingPanelPosition) {
         let currentY = getCurrentY(from: initialFrame, with: translation)
-        let supportedPositions = Set(layoutAdapter.layout.supportedPositions)
+        let supportedPositions = layoutAdapter.supportedPositions
 
-        assert(supportedPositions.count > 1)
+        if supportedPositions.count == 1 {
+            return state
+        }
 
         switch supportedPositions {
-        case Set([.full, .half]):
+        case [.full, .half]:
+            return targetPosition(from: [.full, .half], at: currentY, velocity: velocity)
+        case [.half, .tip]:
             return targetPosition(from: [.half, .tip], at: currentY, velocity: velocity)
-        case Set([.half, .tip]):
-            return targetPosition(from: [.half, .tip], at: currentY, velocity: velocity)
-        case Set([.full, .tip]):
+        case [.full, .tip]:
             return targetPosition(from: [.full, .tip], at: currentY, velocity: velocity)
         default:
             /*
-             [topY|full]---[th1]---[middleY|default]---[th2]---[bottomY|collapsed]
+             [topY|full]---[th1]---[middleY|half]---[th2]---[bottomY|tip]
              */
             let topY = layoutAdapter.topY
             let middleY = layoutAdapter.middleY
             let bottomY = layoutAdapter.bottomY
 
-            let th1 = (topY + middleY) / 2
-            let th2 = (middleY + bottomY) / 2
+            let target: FloatingPanelPosition
+            let forwardYDirection: Bool
+
+            switch state {
+            case .full:
+                target = .half
+                forwardYDirection = true
+            case .half:
+                if (currentY < middleY) {
+                    target = .full
+                    forwardYDirection = false
+                } else {
+                    target = .tip
+                    forwardYDirection = true
+                }
+            case .tip:
+                target = .half
+                forwardYDirection = false
+            case .hidden:
+                fatalError("A floating panel hidden must not be used by a user")
+            }
+
+            let redirectionalProgress = max(min(behavior.redirectionalProgress(viewcontroller, from: state, to: target), 1.0), 0.0)
+
+            let th1: CGFloat
+            let th2: CGFloat
+
+            if forwardYDirection {
+                th1 = topY + (middleY - topY) * redirectionalProgress
+                th2 = middleY + (bottomY - middleY) * redirectionalProgress
+            } else {
+                th1 = middleY - (middleY - topY) * redirectionalProgress
+                th2 = bottomY - (bottomY - middleY) * redirectionalProgress
+            }
 
             switch currentY {
             case ..<th1:
@@ -424,7 +732,10 @@ class FloatingPanel: NSObject, UIGestureRecognizerDelegate, UIScrollViewDelegate
         let topY = layoutAdapter.positionY(for: top)
         let bottomY = layoutAdapter.positionY(for: bottom)
 
-        let th = (topY + bottomY) / 2
+        let target = top == state ? bottom : top
+        let redirectionalProgress = max(min(behavior.redirectionalProgress(viewcontroller, from: state, to: target), 1.0), 0.0)
+
+        let th = topY + (bottomY - topY) * redirectionalProgress
 
         switch currentY {
         case ..<th:
@@ -444,17 +755,15 @@ class FloatingPanel: NSObject, UIGestureRecognizerDelegate, UIScrollViewDelegate
 
     // MARK: - ScrollView handling
 
-    func lockScrollView(withBounce bounce: Bool = false) {
+    private func lockScrollView() {
         guard let scrollView = scrollView else { return }
 
         scrollView.isDirectionalLockEnabled = true
-        if bounce {
-            scrollView.bounces = false
-        }
+        scrollView.bounces = false
         scrollView.showsVerticalScrollIndicator = false
     }
 
-    func unlockScrollView() {
+    private func unlockScrollView() {
         guard let scrollView = scrollView else { return }
 
         scrollView.isDirectionalLockEnabled = false
@@ -476,6 +785,13 @@ class FloatingPanel: NSObject, UIGestureRecognizerDelegate, UIScrollViewDelegate
         }
     }
 
+    func scrollViewDidEndScrollingAnimation(_ scrollView: UIScrollView) {
+        if state != .full {
+            initialScrollOffset = scrollView.contentOffset
+        }
+        userScrollViewDelegate?.scrollViewDidEndScrollingAnimation?(scrollView)
+    }
+
     func scrollViewWillEndDragging(_ scrollView: UIScrollView, withVelocity velocity: CGPoint, targetContentOffset: UnsafeMutablePointer<CGPoint>) {
         if stopScrollDeceleration {
             targetContentOffset.pointee = scrollView.contentOffset
@@ -485,3 +801,21 @@ class FloatingPanel: NSObject, UIGestureRecognizerDelegate, UIScrollViewDelegate
         }
     }
 }
+
+class FloatingPanelPanGestureRecognizer: UIPanGestureRecognizer {
+    override weak var delegate: UIGestureRecognizerDelegate? {
+        get {
+            return super.delegate
+        }
+        set {
+            guard newValue is FloatingPanel else {
+                let exception = NSException(name: .invalidArgumentException,
+                                            reason: "FloatingPanelController's built-in pan gesture recognizer must have its controller as its delegate.",
+                                            userInfo: nil)
+                exception.raise()
+                return
+            }
+            super.delegate = newValue
+        }
+    }
+}

Framework/Sources/FloatingPanelBehavior.swift

@@ -6,32 +6,91 @@
 import UIKit
 
 public protocol FloatingPanelBehavior {
-    // Returns a UIViewPropertyAnimator object in interacting a floating panel by a user pan gesture
+    /// Returns the progress to redirect to the previous position
+    ///
+    /// The progress is represented by a floating-point value between 0.0 and 1.0, inclusive, where 1.0 indicates the floating panel is impossible to move to the next posiiton. The default value is 0.5. Values less than 0.0 and greater than 1.0 are pinned to those limits.
+    func redirectionalProgress(_ fpc: FloatingPanelController, from: FloatingPanelPosition, to: FloatingPanelPosition) -> CGFloat
+
+    /// Returns a UIViewPropertyAnimator object to project a floating panel to a position on finger up if the user dragged.
     func interactionAnimator(_ fpc: FloatingPanelController, to targetPosition: FloatingPanelPosition, with velocity: CGVector) -> UIViewPropertyAnimator
 
-    // Returns a UIViewPropertyAnimator object to present a floating panel
-    func presentAnimator(_ fpc: FloatingPanelController, from: FloatingPanelPosition, to: FloatingPanelPosition) -> UIViewPropertyAnimator
-    // Returns a UIViewPropertyAnimator object to dismiss a floating panel
-    func dismissAnimator(_ fpc: FloatingPanelController, from: FloatingPanelPosition) -> UIViewPropertyAnimator
+    /// Returns a UIViewPropertyAnimator object to add a floating panel to a position.
+    ///
+    /// Its animator instance will be used to animate the surface view in `FloatingPanelController.addPanel(toParent:belowView:animated:)`.
+    /// Default is an animator with ease-in-out curve and 0.25 sec duration.
+    func addAnimator(_ fpc: FloatingPanelController, to: FloatingPanelPosition) -> UIViewPropertyAnimator
+
+    /// Returns a UIViewPropertyAnimator object to remove a floating panel from a position.
+    ///
+    /// Its animator instance will be used to animate the surface view in `FloatingPanelController.removePanelFromParent(animated:completion:)`.
+    /// Default is an animator with ease-in-out curve and 0.25 sec duration.
+    func removeAnimator(_ fpc: FloatingPanelController, from: FloatingPanelPosition) -> UIViewPropertyAnimator
+
+    /// Returns a UIViewPropertyAnimator object to move a floating panel from a position to a position.
+    ///
+    /// Its animator instance will be used to animate the surface view in `FloatingPanelController.move(to:animated:completion:)`.
+    /// Default is an animator with ease-in-out curve and 0.25 sec duration.
+    func moveAnimator(_ fpc: FloatingPanelController, from: FloatingPanelPosition, to: FloatingPanelPosition) -> UIViewPropertyAnimator
+
+    /// Returns a y-axis velocity to invoke a removal interaction at the bottom position.
+    ///
+    /// Default is 10.0. This method is called when FloatingPanelController.isRemovalInteractionEnabled is true.
+    var removalVelocity: CGFloat { get }
+
+    /// Returns the threshold of the transition to invoke a removal interaction at the bottom position.
+    ///
+    /// The progress is represented by a floating-point value between 0.0 and 1.0, inclusive, where 1.0 indicates the floating panel is impossible to invoke the removal interaction. The default value is 0.5. Values less than 0.0 and greater than 1.0 are pinned to those limits. This method is called when FloatingPanelController.isRemovalInteractionEnabled is true.
+    var removalProgress: CGFloat { get }
+
+    /// Returns a UIViewPropertyAnimator object to remove a floating panel with a velocity interactively at the bottom position.
+    ///
+    /// Default is a spring animator with 1.0 damping ratio. This method is called when FloatingPanelController.isRemovalInteractionEnabled is true.
+    func removalInteractionAnimator(_ fpc: FloatingPanelController, with velocity: CGVector) -> UIViewPropertyAnimator
 }
 
 public extension FloatingPanelBehavior {
-    func presentAnimator(_ fpc: FloatingPanelController, from: FloatingPanelPosition, to: FloatingPanelPosition) -> UIViewPropertyAnimator {
+    func redirectionalProgress(_ fpc: FloatingPanelController, from: FloatingPanelPosition, to: FloatingPanelPosition) -> CGFloat {
+        return 0.5
+    }
+
+    func addAnimator(_ fpc: FloatingPanelController, to: FloatingPanelPosition) -> UIViewPropertyAnimator {
         return UIViewPropertyAnimator(duration: 0.25, curve: .easeInOut)
     }
 
-    func dismissAnimator(_ fpc: FloatingPanelController, from: FloatingPanelPosition) -> UIViewPropertyAnimator {
+    func removeAnimator(_ fpc: FloatingPanelController, from: FloatingPanelPosition) -> UIViewPropertyAnimator {
         return UIViewPropertyAnimator(duration: 0.25, curve: .easeInOut)
     }
+
+    func moveAnimator(_ fpc: FloatingPanelController, from: FloatingPanelPosition, to: FloatingPanelPosition) -> UIViewPropertyAnimator {
+        return UIViewPropertyAnimator(duration: 0.25, curve: .easeInOut)
+    }
+
+    var removalVelocity: CGFloat {
+        return 10.0
+    }
+
+    var removalProgress: CGFloat {
+        return 0.5
+    }
+
+    func removalInteractionAnimator(_ fpc: FloatingPanelController, with velocity: CGVector) -> UIViewPropertyAnimator {
+        log.debug("velocity", velocity)
+        let timing = UISpringTimingParameters(dampingRatio: 1.0,
+                                        frequencyResponse: 0.3,
+                                        initialVelocity: velocity)
+        return UIViewPropertyAnimator(duration: 0, timingParameters: timing)
+    }
 }
 
 class FloatingPanelDefaultBehavior: FloatingPanelBehavior {
     func interactionAnimator(_ fpc: FloatingPanelController, to targetPosition: FloatingPanelPosition, with velocity: CGVector) -> UIViewPropertyAnimator {
-        let timing = timeingCurve(to: targetPosition, with: velocity)
-        return UIViewPropertyAnimator(duration: 0, timingParameters: timing)
+        let timing = timeingCurve(with: velocity)
+        let animator = UIViewPropertyAnimator(duration: 0, timingParameters: timing)
+        animator.isInterruptible = false
+        return animator
     }
 
-    private func timeingCurve(to: FloatingPanelPosition, with velocity: CGVector) -> UITimingCurveProvider {
+    private func timeingCurve(with velocity: CGVector) -> UITimingCurveProvider {
         log.debug("velocity", velocity)
         let damping = self.getDamping(with: velocity)
         return UISpringTimingParameters(dampingRatio: damping,

Framework/Sources/FloatingPanelController.swift

@@ -12,6 +12,8 @@ public protocol FloatingPanelControllerDelegate: class {
     // if it returns nil, FloatingPanelController uses the default behavior
     func floatingPanel(_ vc: FloatingPanelController, behaviorFor newCollection: UITraitCollection) -> FloatingPanelBehavior?
 
+    func floatingPanelDidChangePosition(_ vc: FloatingPanelController) // changed the settled position in the model layer
+
     func floatingPanelDidMove(_ vc: FloatingPanelController) // any offset changes
 
     // called on start of dragging (may require some time and or distance to move)
@@ -20,6 +22,13 @@ public protocol FloatingPanelControllerDelegate: class {
     func floatingPanelDidEndDragging(_ vc: FloatingPanelController, withVelocity velocity: CGPoint, targetPosition: FloatingPanelPosition)
     func floatingPanelWillBeginDecelerating(_ vc: FloatingPanelController) // called on finger up as we are moving
     func floatingPanelDidEndDecelerating(_ vc: FloatingPanelController) // called when scroll view grinds to a halt
+
+    // called on start of dragging to remove its views from a parent view controller
+    func floatingPanelDidEndDraggingToRemove(_ vc: FloatingPanelController, withVelocity velocity: CGPoint)
+    // called when its views are removed from a parent view controller
+    func floatingPanelDidEndRemove(_ vc: FloatingPanelController)
+
+    func floatingPanel(_ vc: FloatingPanelController, shouldRecognizeSimultaneouslyWith gestureRecognizer: UIGestureRecognizer) -> Bool
 }
 
 public extension FloatingPanelControllerDelegate {
@@ -29,24 +38,31 @@ public extension FloatingPanelControllerDelegate {
     func floatingPanel(_ vc: FloatingPanelController, behaviorFor newCollection: UITraitCollection) -> FloatingPanelBehavior? {
         return nil
     }
+    func floatingPanelDidChangePosition(_ vc: FloatingPanelController) {}
     func floatingPanelDidMove(_ vc: FloatingPanelController) {}
     func floatingPanelWillBeginDragging(_ vc: FloatingPanelController) {}
     func floatingPanelDidEndDragging(_ vc: FloatingPanelController, withVelocity velocity: CGPoint, targetPosition: FloatingPanelPosition) {}
     func floatingPanelWillBeginDecelerating(_ vc: FloatingPanelController) {}
     func floatingPanelDidEndDecelerating(_ vc: FloatingPanelController) {}
+
+    func floatingPanelDidEndDraggingToRemove(_ vc: FloatingPanelController, withVelocity velocity: CGPoint) {}
+    func floatingPanelDidEndRemove(_ vc: FloatingPanelController) {}
+
+    func floatingPanel(_ vc: FloatingPanelController, shouldRecognizeSimultaneouslyWith gestureRecognizer: UIGestureRecognizer) -> Bool { return false }
 }
 
+
 public enum FloatingPanelPosition: Int {
     case full
     case half
     case tip
+    case hidden
 }
 
 ///
 /// A container view controller to display a floating panel to present contents in parallel as a user wants.
 ///
 public class FloatingPanelController: UIViewController, UIScrollViewDelegate, UIGestureRecognizerDelegate {
-
     /// Constants indicating how safe area insets are added to the adjusted content inset.
     public enum ContentInsetAdjustmentBehavior: Int {
         case always
@@ -54,11 +70,15 @@ public class FloatingPanelController: UIViewController, UIScrollViewDelegate, UI
     }
 
     /// The delegate of the floating panel controller object.
-    public weak var delegate: FloatingPanelControllerDelegate?
+    public weak var delegate: FloatingPanelControllerDelegate?{
+        didSet{
+            didUpdateDelegate()
+        }
+    }
 
     /// Returns the surface view managed by the controller object. It's the same as `self.view`.
     public var surfaceView: FloatingPanelSurfaceView! {
-        return view as? FloatingPanelSurfaceView
+        return floatingPanel.surfaceView
     }
 
     /// Returns the backdrop view managed by the controller object.
@@ -66,87 +86,138 @@ public class FloatingPanelController: UIViewController, UIScrollViewDelegate, UI
         return floatingPanel.backdropView
     }
 
-    /// Returns the scroll view that the conroller tracks.
+    /// Returns the scroll view that the controller tracks.
     public weak var scrollView: UIScrollView? {
         return floatingPanel.scrollView
     }
 
+    // The underlying gesture recognizer for pan gestures
+    public var panGestureRecognizer: UIPanGestureRecognizer {
+        return floatingPanel.panGesture
+    }
+
     /// The current position of the floating panel controller's contents.
     public var position: FloatingPanelPosition {
         return floatingPanel.state
     }
 
-    /// The content insets of the tracking scroll view derived the safe area of the parent view
+    /// The layout object managed by the controller
+    public var layout: FloatingPanelLayout {
+        return floatingPanel.layoutAdapter.layout
+    }
+
+    /// The behavior object managed by the controller
+    public var behavior: FloatingPanelBehavior {
+        return floatingPanel.behavior
+    }
+
+    /// The content insets of the tracking scroll view derived from this safe area
     public var adjustedContentInsets: UIEdgeInsets {
         return floatingPanel.layoutAdapter.adjustedContentInsets
     }
 
     /// The behavior for determining the adjusted content offsets.
     ///
-    /// This property specifies how the content area of the tracking scroll view are modified using `adjustedContentInsets`. The default value of this property is FloatingPanelController.ContentInsetAdjustmentBehavior.always.
+    /// This property specifies how the content area of the tracking scroll view is modified using `adjustedContentInsets`. The default value of this property is FloatingPanelController.ContentInsetAdjustmentBehavior.always.
     public var contentInsetAdjustmentBehavior: ContentInsetAdjustmentBehavior = .always
 
+    /// A Boolean value that determines whether the removal interaction is enabled.
+    public var isRemovalInteractionEnabled: Bool {
+        set { floatingPanel.isRemovalInteractionEnabled = newValue }
+        get { return floatingPanel.isRemovalInteractionEnabled }
+    }
+
+    /// The view controller responsible for the content portion of the floating panel.
+    public var contentViewController: UIViewController? {
+        set { set(contentViewController: newValue) }
+        get { return _contentViewController }
+    }
+    private var _contentViewController: UIViewController?
+
     private var floatingPanel: FloatingPanel!
+    private var safeAreaInsetsObservation: NSKeyValueObservation?
+    private let modalTransition = FloatingPanelModalTransition()
 
-    required init?(coder aDecoder: NSCoder) {
+    required public init?(coder aDecoder: NSCoder) {
         super.init(coder: aDecoder)
+        setUp()
     }
 
-    /// Initialize a newly created a floating panel controller.
-    public init() {
+    /// Initialize a newly created floating panel controller.
+    public init(delegate: FloatingPanelControllerDelegate? = nil) {
         super.init(nibName: nil, bundle: nil)
+        self.delegate = delegate
+        setUp()
     }
 
+    private func setUp() {
+        _ = FloatingPanelController.dismissSwizzling
+
+        modalPresentationStyle = .custom
+        transitioningDelegate = modalTransition
+
+        floatingPanel = FloatingPanel(self,
+                                      layout: fetchLayout(for: self.traitCollection),
+                                      behavior: fetchBehavior(for: self.traitCollection))
+    }
+
+    private func didUpdateDelegate(){
+        floatingPanel.layoutAdapter.layout = fetchLayout(for: traitCollection)
+        floatingPanel.behavior = fetchBehavior(for: self.traitCollection)
+    }
+    
+    // MARK:- Overrides
+
     /// Creates the view that the controller manages.
     override public func loadView() {
         assert(self.storyboard == nil, "Storyboard isn't supported")
 
-        let view = FloatingPanelSurfaceView()
-        view.backgroundColor = .white
+        let view = FloatingPanelPassThroughView()
+        view.backgroundColor = .clear
+
+        backdropView.frame = view.bounds
+        view.addSubview(backdropView)
+
+        surfaceView.frame = view.bounds
+        view.addSubview(surfaceView)
 
         self.view = view as UIView
+    }
 
-        let layout = fetchLayout(for: self.traitCollection)
-        let behavior = fetchBehavior(for: self.traitCollection)
-        floatingPanel = FloatingPanel(self,
-                                      layout: layout,
-                                      behavior: behavior)
+    public override func viewDidLayoutSubviews() {
+        super.viewDidLayoutSubviews()
+        if #available(iOS 11.0, *) {}
+        else {
+            // Because {top,bottom}LayoutGuide is managed as a view
+            self.update(safeAreaInsets: layoutInsets)
+        }
+    }
+
+    public override func viewWillTransition(to size: CGSize, with coordinator: UIViewControllerTransitionCoordinator) {
+        super.viewWillTransition(to: size, with: coordinator)
+
+        if view.translatesAutoresizingMaskIntoConstraints {
+            view.frame.size = size
+            view.layoutIfNeeded()
+        }
     }
 
     public override func willTransition(to newCollection: UITraitCollection, with coordinator: UIViewControllerTransitionCoordinator) {
         super.willTransition(to: newCollection, with: coordinator)
 
         // Change layout for a new trait collection
-        floatingPanel.layoutAdapter.layout = fetchLayout(for: newCollection)
+        reloadLayout(for: newCollection)
+        setUpLayout()
+
         floatingPanel.behavior = fetchBehavior(for: newCollection)
-
-        guard let parent = parent else { fatalError() }
-
-        floatingPanel.layoutAdapter.prepareLayout(toParent: parent)
-        floatingPanel.layoutAdapter.activateLayout(of: floatingPanel.state)
     }
 
-    public override func traitCollectionDidChange(_ previousTraitCollection: UITraitCollection?) {
-        super.traitCollectionDidChange(previousTraitCollection)
-        guard previousTraitCollection != traitCollection else { return }
-
-        if let parent = parent {
-            self.update(safeAreaInsets: parent.layoutInsets)
-        }
-        floatingPanel.layoutAdapter.updateHeight()
-        floatingPanel.backdropView.isHidden = (traitCollection.verticalSizeClass == .compact)
+    public override func viewWillDisappear(_ animated: Bool) {
+        super.viewWillDisappear(animated)
+        safeAreaInsetsObservation = nil
     }
 
-    public override func viewDidAppear(_ animated: Bool) {
-        super.viewDidAppear(animated)
-
-        // I needs to update safeAreaInsets here to ensure that the `adjustedContentInsets` has a correct value.
-        // Because the parent VC does not call viewSafeAreaInsetsDidChange() expectedly and
-        // `view.safeAreaInsets` has a correct value of the bottom inset here.
-        if let parent = parent {
-            self.update(safeAreaInsets: parent.layoutInsets)
-        }
-    }
+    // MARK:- Privates
 
     private func fetchLayout(for traitCollection: UITraitCollection) -> FloatingPanelLayout {
         switch traitCollection.verticalSizeClass {
@@ -162,7 +233,18 @@ public class FloatingPanelController: UIViewController, UIScrollViewDelegate, UI
     }
 
     private func update(safeAreaInsets: UIEdgeInsets) {
-        floatingPanel.safeAreaInsets = safeAreaInsets
+        // Don't re-layout the surface on SafeArea.Bottom enabled/disabled in interaction progress
+        guard
+            floatingPanel.layoutAdapter.safeAreaInsets != safeAreaInsets,
+            self.floatingPanel.interactionInProgress == false
+        else { return }
+
+        log.debug("Update safeAreaInsets", safeAreaInsets)
+
+        floatingPanel.layoutAdapter.safeAreaInsets = safeAreaInsets
+
+        setUpLayout()
+
         switch contentInsetAdjustmentBehavior {
         case .always:
             scrollView?.contentInset = adjustedContentInsets
@@ -172,12 +254,62 @@ public class FloatingPanelController: UIViewController, UIScrollViewDelegate, UI
         }
     }
 
+    private func reloadLayout(for traitCollection: UITraitCollection) {
+        floatingPanel.layoutAdapter.layout = fetchLayout(for: traitCollection)
+        floatingPanel.layoutAdapter.prepareLayout(in: self)
+    }
+
+    private func setUpLayout() {
+        // preserve the current content offset
+        let contentOffset = scrollView?.contentOffset
+
+        floatingPanel.layoutAdapter.updateHeight()
+        floatingPanel.layoutAdapter.activateLayout(of: floatingPanel.state)
+
+        scrollView?.contentOffset = contentOffset ?? .zero
+    }
+
     // MARK: - Container view controller interface
 
-    /// Adds the view managed the controller as a child of the specified view controller.
+    /// Shows the surface view at the initial position defined by the current layout
+    public func show(animated: Bool = false, completion: (() -> Void)? = nil) {
+        // Must apply the current layout here
+        reloadLayout(for: traitCollection)
+        setUpLayout()
+
+        if #available(iOS 11.0, *) {
+            // Must track the safeAreaInsets of `self.view` to update the layout.
+            // There are 2 reasons.
+            // 1. This or the parent VC doesn't call viewSafeAreaInsetsDidChange() on the bottom
+            // inset's update expectedly.
+            // 2. The safe area top inset can be variable on the large title navigation bar(iOS11+).
+            // That's why it needs the observation to keep `adjustedContentInsets` correct.
+            safeAreaInsetsObservation = self.observe(\.view.safeAreaInsets) { [weak self] (vc, chaneg) in
+                guard let `self` = self else { return }
+                self.update(safeAreaInsets: vc.layoutInsets)
+            }
+        } else {
+            // KVOs for topLayoutGuide & bottomLayoutGuide are not effective.
+            // Instead, update(safeAreaInsets:) is called at `viewDidLayoutSubviews()`
+        }
+
+        move(to: floatingPanel.layoutAdapter.layout.initialPosition,
+             animated: animated,
+             completion: completion)
+    }
+
+    /// Hides the surface view to the hidden position
+    public func hide(animated: Bool = false, completion: (() -> Void)? = nil) {
+        safeAreaInsetsObservation = nil
+        move(to: .hidden,
+             animated: animated,
+             completion: completion)
+    }
+
+    /// Adds the view managed by the controller as a child of the specified view controller.
     /// - Parameters:
-    ///     - parent: A parent view controller object that displays FloatingPanelController's view. A conatiner view controller object isn't applicable.
-    ///     - belowView: Insert the surface view managed by the controller below the specified view. As default, the surface view will be added to the end of the parent list of subviews.
+    ///     - parent: A parent view controller object that displays FloatingPanelController's view. A container view controller object isn't applicable.
+    ///     - belowView: Insert the surface view managed by the controller below the specified view. By default, the surface view will be added to the end of the parent list of subviews.
     ///     - animated: Pass true to animate the presentation; otherwise, pass false.
     public func addPanel(toParent parent: UIViewController, belowView: UIView? = nil, animated: Bool = false) {
         guard self.parent == nil else {
@@ -185,24 +317,31 @@ public class FloatingPanelController: UIViewController, UIScrollViewDelegate, UI
             return
         }
         precondition((parent is UINavigationController) == false, "UINavigationController displays only one child view controller at a time.")
-        precondition((parent is UITableViewController) == false, "UITableViewController should not be the parent because the view hierarchy will be break in reusing cells.")
-        precondition((parent is UICollectionViewController) == false, "UICollectionViewController should not be the parent because the view hierarchy will be break in reusing cells.")
+        precondition((parent is UITabBarController) == false, "UITabBarController displays child view controllers with a radio-style selection interface")
+        precondition((parent is UISplitViewController) == false, "UISplitViewController manages two child view controllers in a master-detail interface")
+        precondition((parent is UITableViewController) == false, "UITableViewController should not be the parent because the view is a table view so that a floating panel doens't work well")
+        precondition((parent is UICollectionViewController) == false, "UICollectionViewController should not be the parent because the view is a collection view so that a floating panel doens't work well")
 
-        view.frame = parent.view.bounds
         if let belowView = belowView {
             parent.view.insertSubview(self.view, belowSubview: belowView)
         } else {
             parent.view.addSubview(self.view)
         }
 
-        parent.addChild(self)
+        parent.addChildViewController(self)
 
-        // Must set a layout again here because `self.traitCollection` is applied correctly on it's added to a parent VC
-        floatingPanel.layoutAdapter.layout = fetchLayout(for: traitCollection)
-        floatingPanel.layoutViews(in: parent)
-        floatingPanel.present(animated: animated) { [weak self] in
-            guard let self = self else { return }
-            self.didMove(toParent: parent)
+        view.frame = parent.view.bounds // Needed for a correct safe area configuration
+        view.translatesAutoresizingMaskIntoConstraints = false
+        NSLayoutConstraint.activate([
+            self.view.topAnchor.constraint(equalTo: parent.view.topAnchor, constant: 0.0),
+            self.view.leftAnchor.constraint(equalTo: parent.view.leftAnchor, constant: 0.0),
+            self.view.rightAnchor.constraint(equalTo: parent.view.rightAnchor, constant: 0.0),
+            self.view.bottomAnchor.constraint(equalTo: parent.view.bottomAnchor, constant: 0.0),
+            ])
+
+        show(animated: animated) { [weak self] in
+            guard let `self` = self else { return }
+            self.didMove(toParentViewController: self)
         }
     }
 
@@ -216,12 +355,11 @@ public class FloatingPanelController: UIViewController, UIScrollViewDelegate, UI
             return
         }
 
-        floatingPanel.dismiss(animated: animated) { [weak self] in
-            guard let self = self else { return }
-
-            self.willMove(toParent: nil)
+        hide(animated: animated) { [weak self] in
+            guard let `self` = self else { return }
+            self.willMove(toParentViewController: nil)
             self.view.removeFromSuperview()
-            self.removeFromParent()
+            self.removeFromParentViewController()
             completion?()
         }
     }
@@ -230,25 +368,48 @@ public class FloatingPanelController: UIViewController, UIScrollViewDelegate, UI
     /// - Parameters:
     ///     - to: Pass a FloatingPanelPosition value to move the surface view to the position.
     ///     - animated: Pass true to animate the presentation; otherwise, pass false.
-    ///     - completion: The block to execute after the view controller is dismissed. This block has no return value and takes no parameters. You may specify nil for this parameter.
+    ///     - completion: The block to execute after the view controller has finished moving. This block has no return value and takes no parameters. You may specify nil for this parameter.
     public func move(to: FloatingPanelPosition, animated: Bool, completion: (() -> Void)? = nil) {
+        precondition(floatingPanel.layoutAdapter.vc != nil, "Use show(animated:completion)")
         floatingPanel.move(to: to, animated: animated, completion: completion)
     }
 
-    /// Presents the specified view controller as the content view controller in the surface view interface.
+    /// Sets the view controller responsible for the content portion of the floating panel..
+    public func set(contentViewController: UIViewController?) {
+        if let vc = _contentViewController {
+            vc.willMove(toParentViewController: nil)
+            vc.view.removeFromSuperview()
+            vc.removeFromParentViewController()
+            
+            if let scrollView = floatingPanel.scrollView,
+                let delegate = floatingPanel.userScrollViewDelegate,
+                vc.view.subviews.contains(scrollView) {
+                scrollView.delegate = delegate
+            }
+        }
+
+        if let vc = contentViewController {
+            addChildViewController(vc)
+            let surfaceView = floatingPanel.surfaceView
+            surfaceView.add(contentView: vc.view)
+            vc.didMove(toParentViewController: self)
+        }
+
+        _contentViewController = contentViewController
+    }
+
+    @available(*, unavailable, renamed: "set(contentViewController:)")
     public override func show(_ vc: UIViewController, sender: Any?) {
-        let surfaceView = self.view as! FloatingPanelSurfaceView
-        surfaceView.contentView.addSubview(vc.view)
-        vc.view.frame = surfaceView.contentView.bounds
-        vc.view.translatesAutoresizingMaskIntoConstraints = false
-        NSLayoutConstraint.activate([
-            vc.view.topAnchor.constraint(equalTo: surfaceView.contentView.topAnchor, constant: 0.0),
-            vc.view.leftAnchor.constraint(equalTo: surfaceView.contentView.leftAnchor, constant: 0.0),
-            vc.view.rightAnchor.constraint(equalTo: surfaceView.contentView.rightAnchor, constant: 0.0),
-            vc.view.bottomAnchor.constraint(equalTo: surfaceView.contentView.bottomAnchor, constant: 0.0),
-            ])
-        addChild(vc)
-        vc.didMove(toParent: self)
+        if let target = self.parent?.targetViewController(forAction: #selector(UIViewController.show(_:sender:)), sender: sender) {
+            target.show(vc, sender: sender)
+        }
+    }
+
+    @available(*, unavailable, renamed: "set(contentViewController:)")
+    public override func showDetailViewController(_ vc: UIViewController, sender: Any?) {
+        if let target = self.parent?.targetViewController(forAction: #selector(UIViewController.showDetailViewController(_:sender:)), sender: sender) {
+            target.showDetailViewController(vc, sender: sender)
+        }
     }
 
     // MARK: - Scroll view tracking
@@ -256,18 +417,20 @@ public class FloatingPanelController: UIViewController, UIScrollViewDelegate, UI
     /// Tracks the specified scroll view to correspond with the scroll.
     ///
     /// - Attention:
-    ///     The specified scroll view must be already assigned the delegate property because the controller intemediates the several delegate methods.
+    ///     The specified scroll view must be already assigned to the delegate property because the controller intermediates between the various delegate methods.
     ///
     public func track(scrollView: UIScrollView) {
         floatingPanel.scrollView = scrollView
-        floatingPanel.userScrollViewDelegate = scrollView.delegate
-        scrollView.delegate = floatingPanel
+        if scrollView.delegate !== floatingPanel {
+            floatingPanel.userScrollViewDelegate = scrollView.delegate
+            scrollView.delegate = floatingPanel
+        }
         switch contentInsetAdjustmentBehavior {
         case .always:
             if #available(iOS 11.0, *) {
                 scrollView.contentInsetAdjustmentBehavior = .never
             } else {
-                children.forEach { (vc) in
+                childViewControllers.forEach { (vc) in
                     vc.automaticallyAdjustsScrollViewInsets = false
                 }
             }
@@ -276,7 +439,19 @@ public class FloatingPanelController: UIViewController, UIScrollViewDelegate, UI
         }
     }
 
-    // MARK: - Helpers
+    // MARK: - Utilities
+
+    /// Updates the layout object from the delegate and lays out the views managed
+    /// by the controller immediately.
+    ///
+    /// This method updates the `FloatingPanelLayout` object from the delegate and
+    /// then it calls `layoutIfNeeded()` of the root view to force the view
+    /// to update the floating panel's layout immediately. It can be called in an
+    /// animation block.
+    public func updateLayout() {
+        reloadLayout(for: traitCollection)
+        setUpLayout()
+    }
 
     /// Returns the y-coordinate of the point at the origin of the surface view
     public func originYOfSurface(for pos: FloatingPanelPosition) -> CGFloat {
@@ -287,6 +462,54 @@ public class FloatingPanelController: UIViewController, UIScrollViewDelegate, UI
             return floatingPanel.layoutAdapter.middleY
         case .tip:
             return floatingPanel.layoutAdapter.bottomY
+        case .hidden:
+            return floatingPanel.layoutAdapter.hiddenY
         }
     }
 }
+
+extension FloatingPanelController {
+    private static let dismissSwizzling: Any? = {
+        let aClass: AnyClass! = UIViewController.self //object_getClass(vc)
+        if let imp = class_getMethodImplementation(aClass, #selector(dismiss(animated:completion:))),
+            let originalAltMethod = class_getInstanceMethod(aClass, #selector(fp_original_dismiss(animated:completion:))) {
+            method_setImplementation(originalAltMethod, imp)
+        }
+        let originalMethod = class_getInstanceMethod(aClass, #selector(dismiss(animated:completion:)))
+        let swizzledMethod = class_getInstanceMethod(aClass, #selector(fp_dismiss(animated:completion:)))
+        if let originalMethod = originalMethod, let swizzledMethod = swizzledMethod {
+            // switch implementation..
+            method_exchangeImplementations(originalMethod, swizzledMethod)
+        }
+        return nil
+    }()
+}
+
+public extension UIViewController {
+    @objc public func fp_original_dismiss(animated flag: Bool, completion: (() -> Void)? = nil) {
+        // Implementation will be replaced by IMP of self.dismiss(animated:completion:)
+    }
+    @objc public func fp_dismiss(animated flag: Bool, completion: (() -> Void)? = nil) {
+        // Call dismiss(animated:completion:) to a content view controller
+        if let fpc = parent as? FloatingPanelController {
+            if fpc.presentingViewController != nil {
+                self.fp_original_dismiss(animated: flag, completion: completion)
+            } else {
+                fpc.removePanelFromParent(animated: flag, completion: completion)
+            }
+            return
+        }
+        // Call dismiss(animated:completion:) to FloatingPanelController directly
+        if let fpc = self as? FloatingPanelController {
+            if fpc.presentingViewController != nil {
+                self.fp_original_dismiss(animated: flag, completion: completion)
+            } else {
+                fpc.removePanelFromParent(animated: flag, completion: completion)
+            }
+            return
+        }
+
+        // For other view controllers
+        self.fp_original_dismiss(animated: flag, completion: completion)
+    }
+}

Framework/Sources/FloatingPanelLayout.swift

@@ -5,42 +5,96 @@
 
 import UIKit
 
-public protocol FloatingPanelLayout: class {
-    /// Returns the initial position of a floating panel
-    var initialPosition: FloatingPanelPosition { get }
-    /// Returns an array of FloatingPanelPosition object to tell the applicable position the floating panel controller
-    var supportedPositions: [FloatingPanelPosition] { get }
+/// FloatingPanelFullScreenLayout
+///
+/// Use the layout protocol if you want to configure a full inset from Superview.Top, not SafeArea.Top.
+/// It can't be used with FloatingPanelIntrinsicLayout.
+public protocol FloatingPanelFullScreenLayout: FloatingPanelLayout { }
 
-    /// Return the interaction buffer of full position. Default is 6.0.
+/// FloatingPanelIntrinsicLayout
+///
+/// Use the layout protocol if you want to layout a panel using the intrinsic height.
+/// It can't be used with FloatingPanelFullScreenLayout.
+///
+/// - Attention:
+///     `insetFor(position:)` must return `nil` for the full position. Because
+///     the inset is determined automatically by the intrinsic height.
+///     You can customize insets only for the half, tip and hidden positions.
+public protocol FloatingPanelIntrinsicLayout: FloatingPanelLayout { }
+
+public extension FloatingPanelIntrinsicLayout {
+    var initialPosition: FloatingPanelPosition {
+        return .full
+    }
+
+    var supportedPositions: Set<FloatingPanelPosition> {
+        return [.full]
+    }
+
+    func insetFor(position: FloatingPanelPosition) -> CGFloat? {
+        return nil
+    }
+}
+
+public protocol FloatingPanelLayout: class {
+    /// Returns the initial position of a floating panel.
+    var initialPosition: FloatingPanelPosition { get }
+
+    /// Returns a set of FloatingPanelPosition objects to tell the applicable
+    /// positions of the floating panel controller.
+    ///
+    /// By default, it returns all position except for `hidden` position. Because
+    /// it's always supported by `FloatingPanelController` so you don't need to return it.
+    var supportedPositions: Set<FloatingPanelPosition> { get }
+
+    /// Return the interaction buffer to the top from the top position. Default is 6.0.
     var topInteractionBuffer: CGFloat { get }
-    /// Return the interaction buffer of full position. Default is 6.0.
+
+    /// Return the interaction buffer to the bottom from the bottom position. Default is 6.0.
     var bottomInteractionBuffer: CGFloat { get }
 
-    /// Returns a CGFloat value for a floating panel position(full, half, tip).
-    /// A value for full position indicates an inset from the safe area top.
-    /// On the other hand, values fro half and tip positions indicate insets from the safe area bottom.
-    /// If a position doesn't contain the supported positions, return nil.
+    /// Returns a CGFloat value to determine a Y coordinate of a floating panel for each position(full, half, tip and hidden).
+    ///
+    /// Its returning value indicates a different inset for each position.
+    /// For full position, a top inset from a safe area in `FloatingPanelController.view`.
+    /// For half or tip position, a bottom inset from the safe area.
+    /// For hidden position, a bottom inset from `FloatingPanelController.view`.
+    /// If a position isn't supported or the default value is used, return nil.
     func insetFor(position: FloatingPanelPosition) -> CGFloat?
-    /// Returns layout constraints for a surface view of a floaitng panel.
-    /// The layout constraints must not include ones for topAnchor and bottomAnchor
-    /// because constarints for them will be added by the floating panel controller.
+
+    /// Returns X-axis and width layout constraints of the surface view of a floating panel.
+    /// You must not include any Y-axis and height layout constraints of the surface view
+    /// because their constraints will be configured by the floating panel controller.
+    /// By default, the width of a surface view fits a safe area.
     func prepareLayout(surfaceView: UIView, in view: UIView) -> [NSLayoutConstraint]
 
-    /// Return the backdrop alpha of black color in full position. Default is 0.3.
-    var backdropAlpha: CGFloat { get }
+    /// Returns a CGFloat value to determine the backdrop view's alpha for a position.
+    ///
+    /// Default is 0.3 at full position, otherwise 0.0.
+    func backdropAlphaFor(position: FloatingPanelPosition) -> CGFloat
 }
 
 public extension FloatingPanelLayout {
-    var backdropAlpha: CGFloat { return 0.3 }
     var topInteractionBuffer: CGFloat { return 6.0 }
     var bottomInteractionBuffer: CGFloat { return 6.0 }
+
+    var supportedPositions: Set<FloatingPanelPosition> {
+        return Set([.full, .half, .tip])
+    }
+
+    func prepareLayout(surfaceView: UIView, in view: UIView) -> [NSLayoutConstraint] {
+        return [
+            surfaceView.leftAnchor.constraint(equalTo: view.sideLayoutGuide.leftAnchor, constant: 0.0),
+            surfaceView.rightAnchor.constraint(equalTo: view.sideLayoutGuide.rightAnchor, constant: 0.0),
+        ]
+    }
+
+    func backdropAlphaFor(position: FloatingPanelPosition) -> CGFloat {
+        return position == .full ? 0.3 : 0.0
+    }
 }
 
 public class FloatingPanelDefaultLayout: FloatingPanelLayout {
-    public var supportedPositions: [FloatingPanelPosition] {
-        return [.full, .half, .tip]
-    }
-
     public var initialPosition: FloatingPanelPosition {
         return .half
     }
@@ -50,22 +104,16 @@ public class FloatingPanelDefaultLayout: FloatingPanelLayout {
         case .full: return 18.0
         case .half: return 262.0
         case .tip: return 69.0
+        case .hidden: return nil
         }
     }
-
-    public func prepareLayout(surfaceView: UIView, in view: UIView) -> [NSLayoutConstraint] {
-        return [
-            surfaceView.leftAnchor.constraint(equalTo: view.sideLayoutGuide.leftAnchor, constant: 0.0),
-            surfaceView.rightAnchor.constraint(equalTo: view.sideLayoutGuide.rightAnchor, constant: 0.0),
-        ]
-    }
 }
 
 public class FloatingPanelDefaultLandscapeLayout: FloatingPanelLayout {
     public var initialPosition: FloatingPanelPosition {
         return .tip
     }
-    public var supportedPositions: [FloatingPanelPosition] {
+    public var supportedPositions: Set<FloatingPanelPosition> {
         return [.full, .tip]
     }
 
@@ -76,44 +124,65 @@ public class FloatingPanelDefaultLandscapeLayout: FloatingPanelLayout {
         default: return nil
         }
     }
-
-    public func prepareLayout(surfaceView: UIView, in view: UIView) -> [NSLayoutConstraint] {
-        return [
-            surfaceView.leftAnchor.constraint(equalTo: view.sideLayoutGuide.leftAnchor, constant: 8.0),
-            surfaceView.widthAnchor.constraint(equalToConstant: 291),
-            ]
-    }
 }
 
 
 class FloatingPanelLayoutAdapter {
+    weak var vc: UIViewController!
     private weak var surfaceView: FloatingPanelSurfaceView!
-    private weak var backdropVIew: FloatingPanelBackdropView!
+    private weak var backdropView: FloatingPanelBackdropView!
 
-    var layout: FloatingPanelLayout
+    var layout: FloatingPanelLayout {
+        didSet {
+            checkLayoutConsistance()
+        }
+    }
 
     var safeAreaInsets: UIEdgeInsets = .zero
 
-    private var heightBuffer: CGFloat = 88.0 // For bounce
     private var fixedConstraints: [NSLayoutConstraint] = []
     private var fullConstraints: [NSLayoutConstraint] = []
     private var halfConstraints: [NSLayoutConstraint] = []
     private var tipConstraints: [NSLayoutConstraint] = []
     private var offConstraints: [NSLayoutConstraint] = []
-    private var heightConstraints: NSLayoutConstraint? = nil
+    private var heightConstraints: [NSLayoutConstraint] = []
 
-    var topInset: CGFloat {
-        return layout.insetFor(position: .full) ?? 0.0
+    private var fullInset: CGFloat {
+        if layout is FloatingPanelIntrinsicLayout {
+            return intrinsicHeight
+        } else {
+            return layout.insetFor(position: .full) ?? 0.0
+        }
     }
-    var halfInset: CGFloat {
+    private var halfInset: CGFloat {
         return layout.insetFor(position: .half) ?? 0.0
     }
-    var tipInset: CGFloat {
+    private var tipInset: CGFloat {
         return layout.insetFor(position: .tip) ?? 0.0
     }
+    private var hiddenInset: CGFloat {
+        return layout.insetFor(position: .hidden) ?? 0.0
+    }
+
+    var supportedPositions: Set<FloatingPanelPosition> {
+        var supportedPositions = layout.supportedPositions
+        supportedPositions.remove(.hidden)
+        return supportedPositions
+    }
 
     var topY: CGFloat {
-        return (safeAreaInsets.top + topInset)
+        if supportedPositions.contains(.full) {
+            switch layout {
+            case is FloatingPanelIntrinsicLayout:
+                return surfaceView.superview!.bounds.height - surfaceView.bounds.height
+            case is FloatingPanelFullScreenLayout:
+                return fullInset
+            default:
+                return (safeAreaInsets.top + fullInset)
+            }
+        } else {
+            return middleY
+        }
     }
 
     var middleY: CGFloat {
@@ -121,13 +190,30 @@ class FloatingPanelLayoutAdapter {
     }
 
     var bottomY: CGFloat {
-        return surfaceView.superview!.bounds.height - (safeAreaInsets.bottom + tipInset)
+        if supportedPositions.contains(.tip) {
+            return surfaceView.superview!.bounds.height - (safeAreaInsets.bottom + tipInset)
+        } else {
+            return middleY
+        }
     }
 
+    var hiddenY: CGFloat {
+        return surfaceView.superview!.bounds.height
+    }
+
+    var safeAreaBottomY: CGFloat {
+        return surfaceView.superview!.bounds.height - (safeAreaInsets.bottom + hiddenInset)
+    }
+
+    var topMaxY: CGFloat {
+        return layout is FloatingPanelFullScreenLayout ? 0.0 : -safeAreaInsets.top
+    }
+    var bottomMaxY: CGFloat { return safeAreaBottomY }
+
     var adjustedContentInsets: UIEdgeInsets {
         return UIEdgeInsets(top: 0.0,
                             left: 0.0,
-                            bottom: (safeAreaInsets.top + topInset) + (heightBuffer + safeAreaInsets.bottom),
+                            bottom: safeAreaInsets.bottom,
                             right: 0.0)
     }
 
@@ -139,105 +225,181 @@ class FloatingPanelLayoutAdapter {
             return middleY
         case .tip:
             return bottomY
+        case .hidden:
+            return hiddenY
         }
     }
 
+    var intrinsicHeight: CGFloat = 0.0
+
     init(surfaceView: FloatingPanelSurfaceView, backdropView: FloatingPanelBackdropView, layout: FloatingPanelLayout) {
         self.layout = layout
         self.surfaceView = surfaceView
-        self.backdropVIew = backdropView
-
-        // Verify layout configurations
-        assert(layout.supportedPositions.count > 1)
-        assert(layout.supportedPositions.contains(layout.initialPosition))
-        if halfInset > 0 {
-            assert(halfInset >= tipInset)
-        }
+        self.backdropView = backdropView
     }
 
-    func prepareLayout(toParent parent: UIViewController) {
-        surfaceView.translatesAutoresizingMaskIntoConstraints = false
-        backdropVIew.translatesAutoresizingMaskIntoConstraints = false
+    func updateIntrinsicHeight() {
+        let fittingSize = UILayoutFittingCompressedSize
+        var intrinsicHeight = surfaceView.contentView?.systemLayoutSizeFitting(fittingSize).height ?? 0.0
+        var safeAreaBottom: CGFloat = 0.0
+        if #available(iOS 11.0, *) {
+            safeAreaBottom = surfaceView.contentView?.safeAreaInsets.bottom ?? 0.0
+            if safeAreaBottom > 0 {
+                intrinsicHeight -= safeAreaInsets.bottom
+            }
+        }
+        self.intrinsicHeight = max(intrinsicHeight, 0.0)
+
+        log.debug("Update intrinsic height =", intrinsicHeight,
+                  ", surface(height) =", surfaceView.frame.height,
+                  ", content(height) =", surfaceView.contentView?.frame.height ?? 0.0,
+                  ", content safe area(bottom) =", safeAreaBottom)
+    }
+
+    func prepareLayout(in vc: UIViewController) {
+        self.vc = vc
 
         NSLayoutConstraint.deactivate(fixedConstraints + fullConstraints + halfConstraints + tipConstraints + offConstraints)
 
+        surfaceView.translatesAutoresizingMaskIntoConstraints = false
+        backdropView.translatesAutoresizingMaskIntoConstraints = false
+
         // Fixed constraints of surface and backdrop views
-        let surfaceConstraints = layout.prepareLayout(surfaceView: surfaceView, in: parent.view!)
-        let backdroptConstraints = [
-            backdropVIew.topAnchor.constraint(equalTo: parent.view.topAnchor,
-                                              constant: 0.0),
-            backdropVIew.leftAnchor.constraint(equalTo: parent.view.leftAnchor,
-                                               constant: 0.0),
-            backdropVIew.rightAnchor.constraint(equalTo: parent.view.rightAnchor,
-                                                constant: 0.0),
-            backdropVIew.bottomAnchor.constraint(equalTo: parent.view.bottomAnchor,
-                                                 constant: 0.0),
+        let surfaceConstraints = layout.prepareLayout(surfaceView: surfaceView, in: vc.view!)
+        let backdropConstraints = [
+            backdropView.topAnchor.constraint(equalTo: vc.view.topAnchor, constant: 0.0),
+            backdropView.leftAnchor.constraint(equalTo: vc.view.leftAnchor,constant: 0.0),
+            backdropView.rightAnchor.constraint(equalTo: vc.view.rightAnchor, constant: 0.0),
+            backdropView.bottomAnchor.constraint(equalTo: vc.view.bottomAnchor, constant: 0.0),
             ]
-        fixedConstraints = surfaceConstraints + backdroptConstraints
+
+        fixedConstraints = surfaceConstraints + backdropConstraints
 
         // Flexible surface constarints for full, half, tip and off
-        fullConstraints = [
-            surfaceView.topAnchor.constraint(equalTo: parent.layoutGuide.topAnchor,
-                                             constant: topInset),
-        ]
+        switch layout {
+        case is FloatingPanelIntrinsicLayout:
+            // Set up on updateHeight()
+            break
+        case is FloatingPanelFullScreenLayout:
+            fullConstraints = [
+                surfaceView.topAnchor.constraint(equalTo: vc.view.topAnchor,
+                                                 constant: fullInset),
+            ]
+        default:
+            fullConstraints = [
+                surfaceView.topAnchor.constraint(equalTo: vc.layoutGuide.topAnchor,
+                                                 constant: fullInset),
+            ]
+        }
+
         halfConstraints = [
-            surfaceView.topAnchor.constraint(equalTo: parent.layoutGuide.bottomAnchor,
+            surfaceView.topAnchor.constraint(equalTo: vc.layoutGuide.bottomAnchor,
                                              constant: -halfInset),
         ]
         tipConstraints = [
-            surfaceView.topAnchor.constraint(equalTo: parent.layoutGuide.bottomAnchor,
+            surfaceView.topAnchor.constraint(equalTo: vc.layoutGuide.bottomAnchor,
                                              constant: -tipInset),
         ]
         offConstraints = [
-            surfaceView.topAnchor.constraint(equalTo: parent.layoutGuide.bottomAnchor, constant: 0.0),
+            surfaceView.topAnchor.constraint(equalTo: vc.view.bottomAnchor,
+                                             constant: -hiddenInset),
         ]
     }
 
     // The method is separated from prepareLayout(to:) for the rotation support
     // It must be called in FloatingPanelController.traitCollectionDidChange(_:)
     func updateHeight() {
-        defer {
-            UIView.performWithoutAnimation {
-                surfaceView.superview!.layoutIfNeeded()
-            }
+        guard let vc = vc else { return }
+
+        NSLayoutConstraint.deactivate(heightConstraints)
+
+        switch layout {
+        case is FloatingPanelIntrinsicLayout:
+            updateIntrinsicHeight()
+            heightConstraints = [
+                surfaceView.heightAnchor.constraint(equalToConstant: intrinsicHeight + safeAreaInsets.bottom),
+            ]
+        case is FloatingPanelFullScreenLayout:
+            heightConstraints = [
+                surfaceView.heightAnchor.constraint(equalTo: vc.view.heightAnchor,
+                                                    constant: -fullInset),
+            ]
+        default:
+            heightConstraints = [
+                surfaceView.heightAnchor.constraint(equalTo: vc.view.heightAnchor,
+                                                    constant: -(safeAreaInsets.top + fullInset)),
+            ]
         }
 
-        if let heightConstraints = self.heightConstraints {
-            NSLayoutConstraint.deactivate([heightConstraints])
+        NSLayoutConstraint.activate(heightConstraints)
+
+        surfaceView.bottomOverflow = vc.view.bounds.height + layout.topInteractionBuffer
+
+        if layout is FloatingPanelIntrinsicLayout {
+            NSLayoutConstraint.deactivate(fullConstraints)
+            fullConstraints = [
+                surfaceView.topAnchor.constraint(equalTo: vc.layoutGuide.bottomAnchor,
+                                                 constant: -fullInset),
+            ]
         }
-        let heightConstraints = surfaceView.heightAnchor.constraint(equalToConstant: UIScreen.main.bounds.height + heightBuffer)
-        NSLayoutConstraint.activate([heightConstraints])
-        self.heightConstraints = heightConstraints
     }
 
-    func activateLayout(of state: FloatingPanelPosition?) {
+    func activateLayout(of state: FloatingPanelPosition) {
         defer {
             surfaceView.superview!.layoutIfNeeded()
         }
 
+        var state = state
+
+        setBackdropAlpha(of: state)
+
         NSLayoutConstraint.activate(fixedConstraints)
 
-        guard var state = state else {
-            NSLayoutConstraint.deactivate(fullConstraints + halfConstraints + tipConstraints)
-            NSLayoutConstraint.activate(offConstraints)
-            return
-        }
-
-        if layout.supportedPositions.contains(state) == false {
+        if supportedPositions.union([.hidden]).contains(state) == false {
             state = layout.initialPosition
         }
 
         NSLayoutConstraint.deactivate(fullConstraints + halfConstraints + tipConstraints + offConstraints)
         switch state {
         case .full:
-            NSLayoutConstraint.deactivate(halfConstraints + tipConstraints + offConstraints)
             NSLayoutConstraint.activate(fullConstraints)
         case .half:
-            NSLayoutConstraint.deactivate(fullConstraints + tipConstraints + offConstraints)
             NSLayoutConstraint.activate(halfConstraints)
         case .tip:
-            NSLayoutConstraint.deactivate(fullConstraints + halfConstraints + offConstraints)
             NSLayoutConstraint.activate(tipConstraints)
+        case .hidden:
+            NSLayoutConstraint.activate(offConstraints)
         }
     }
+
+    func setBackdropAlpha(of target: FloatingPanelPosition) {
+        if target == .hidden {
+            self.backdropView.alpha = 0.0
+        } else {
+            self.backdropView.alpha = layout.backdropAlphaFor(position: target)
+        }
+    }
+
+    private func checkLayoutConsistance() {
+        // Verify layout configurations
+        assert(supportedPositions.count > 0)
+        assert(supportedPositions.contains(layout.initialPosition),
+               "Does not include an initial potision(\(layout.initialPosition)) in supportedPositions(\(supportedPositions))")
+
+        if layout is FloatingPanelIntrinsicLayout {
+            assert(layout.insetFor(position: .full) == nil, "Return `nil` for full position on FloatingPanelIntrinsicLayout")
+        }
+
+        if halfInset > 0 {
+            assert(halfInset > tipInset, "Invalid half and tip insets")
+        }
+        // The verification isn't working on orientation change(portrait -> landscape)
+        // of a floating panel in tab bar. Because the `safeAreaInsets.bottom` is
+        // updated in delay so that it can be 83.0(not 53.0) even after the surface
+        // and the super view's frame is fit to landscape already.
+        /*if fullInset > 0 {
+            assert(middleY > topY, "Invalid insets { topY: \(topY), middleY: \(middleY) }")
+            assert(bottomY > topY, "Invalid insets { topY: \(topY), bottomY: \(bottomY) }")
+         }*/
+    }
 }

Framework/Sources/FloatingPanelSurfaceView.swift

@@ -10,7 +10,10 @@ class FloatingPanelSurfaceContentView: UIView {}
 /// A view that presents a surface interface in a floating panel.
 public class FloatingPanelSurfaceView: UIView {
 
-    /// A GrabberHandleView object displayed at the top of the surface view
+    /// A GrabberHandleView object displayed at the top of the surface view.
+    ///
+    /// To use a custom grabber handle, hide this and then add the custom one
+    /// to the surface view at appropirate coordinates.
     public var grabberHandle: GrabberHandleView!
 
     /// The height of the grabber bar area
@@ -18,20 +21,21 @@ public class FloatingPanelSurfaceView: UIView {
         return Default.grabberTopPadding * 2 + GrabberHandleView.Default.height // 17.0
     }
 
-    /// A UIView object that can have the surface view added to it.
-    public var contentView: UIView!
+    /// A root view of a content view controller
+    public weak var contentView: UIView!
 
-    private var color: UIColor? = .white { didSet { setNeedsDisplay() } }
+    private var color: UIColor? = .white { didSet { setNeedsLayout() } }
+    var bottomOverflow: CGFloat = 0.0 // Must not call setNeedsLayout()
 
     public override var backgroundColor: UIColor? {
         get { return color }
-        set {
-            color = newValue
-            setNeedsDisplay()
-        }
+        set { color = newValue }
     }
 
-    /// The radius to use when drawing rounded corners
+    /// The radius to use when drawing top rounded corners.
+    ///
+    /// `self.contentView` is masked with the top rounded corners automatically on iOS 11 and later.
+    /// On iOS 10, they are not automatically masked because of a UIVisualEffectView issue. See https://forums.developer.apple.com/thread/50854
     public var cornerRadius: CGFloat = 0.0 { didSet { setNeedsLayout() } }
 
     /// A Boolean indicating whether the surface shadow is displayed.
@@ -55,7 +59,7 @@ public class FloatingPanelSurfaceView: UIView {
     /// The color of the surface border.
     public var borderWidth: CGFloat = 0.0  { didSet { setNeedsLayout() } }
 
-    private var shadowLayer: CAShapeLayer!  { didSet { setNeedsLayout() } }
+    private var backgroundLayer: CAShapeLayer!  { didSet { setNeedsLayout() } }
 
     private struct Default {
         public static let grabberTopPadding: CGFloat = 6.0
@@ -66,25 +70,18 @@ public class FloatingPanelSurfaceView: UIView {
         render()
     }
 
-    required init?(coder aDecoder: NSCoder) {
+    required public init?(coder aDecoder: NSCoder) {
         super.init(coder: aDecoder)
         render()
     }
 
     private func render() {
         super.backgroundColor = .clear
+        self.clipsToBounds = false
 
-        let contentView = FloatingPanelSurfaceContentView()
-        addSubview(contentView)
-        self.contentView = contentView as UIView
-        // contentView.backgroundColor = .lightGray
-        contentView.translatesAutoresizingMaskIntoConstraints = false
-        NSLayoutConstraint.activate([
-            contentView.topAnchor.constraint(equalTo: topAnchor, constant: 0.0),
-            contentView.leftAnchor.constraint(equalTo: leftAnchor, constant: 0.0),
-            contentView.rightAnchor.constraint(equalTo: rightAnchor, constant: 0.0),
-            contentView.bottomAnchor.constraint(equalTo: bottomAnchor, constant: 0.0),
-            ])
+        let backgroundLayer = CAShapeLayer()
+        layer.insertSublayer(backgroundLayer, at: 0)
+        self.backgroundLayer = backgroundLayer
 
         let grabberHandle = GrabberHandleView()
         addSubview(grabberHandle)
@@ -101,37 +98,64 @@ public class FloatingPanelSurfaceView: UIView {
 
     public override func layoutSubviews() {
         super.layoutSubviews()
-        updateShadowLayer()
-        // Don't use `contentView.layer.mask` because of UIVisualEffectView issue on ios10, https://forums.developer.apple.com/thread/50854
-        contentView.layer.cornerRadius = cornerRadius
-        contentView.clipsToBounds = true
-        contentView.layer.borderColor = borderColor?.cgColor
-        contentView.layer.borderWidth = borderWidth
+        log.debug("SurfaceView frame", frame)
+
+        updateLayers()
+        updateContentViewMask()
+
+        contentView?.layer.borderColor = borderColor?.cgColor
+        contentView?.layer.borderWidth = borderWidth
+        contentView?.frame = bounds
     }
 
-    private func updateShadowLayer() {
-        if shadowLayer != nil {
-            shadowLayer.removeFromSuperlayer()
-        }
-        shadowLayer = makeShadowLayer()
-        layer.insertSublayer(shadowLayer, at: 0)
-    }
-
-    private func makeShadowLayer() -> CAShapeLayer {
+    private func updateLayers() {
         log.debug("SurfaceView bounds", bounds)
-        let shadowLayer = CAShapeLayer()
-        let path = UIBezierPath(roundedRect: bounds,
+        
+        var rect = bounds
+        rect.size.height += bottomOverflow // Expand the height for overflow buffer
+        let path = UIBezierPath(roundedRect: rect,
                                 byRoundingCorners: [.topLeft, .topRight],
                                 cornerRadii: CGSize(width: cornerRadius, height: cornerRadius))
-        shadowLayer.path = path.cgPath
-        shadowLayer.fillColor = color?.cgColor
+        backgroundLayer.path = path.cgPath
+        backgroundLayer.fillColor = color?.cgColor
+		
         if shadowHidden == false {
-            shadowLayer.shadowPath = shadowLayer.path
-            shadowLayer.shadowColor = shadowColor.cgColor
-            shadowLayer.shadowOffset = shadowOffset
-            shadowLayer.shadowOpacity = shadowOpacity
-            shadowLayer.shadowRadius = shadowRadius
+            layer.shadowColor = shadowColor.cgColor
+            layer.shadowOffset = shadowOffset
+            layer.shadowOpacity = shadowOpacity
+            layer.shadowRadius = shadowRadius
         }
-        return shadowLayer
+    }
+
+    private func updateContentViewMask() {
+        if #available(iOS 11, *) {
+            // Don't use `contentView.clipToBounds` because it prevents content view from expanding the height of a subview of it
+            // for the bottom overflow like Auto Layout settings of UIVisualEffectView in Main.storyborad of Example/Maps.
+            // Because the bottom of contentView must be fit to the bottom of a screen to work the `safeLayoutGuide` of a content VC.
+            let maskLayer = CAShapeLayer()
+            var rect = bounds
+            rect.size.height += bottomOverflow
+            let path = UIBezierPath(roundedRect: rect,
+                                    byRoundingCorners: [.topLeft, .topRight],
+                                    cornerRadii: CGSize(width: cornerRadius, height: cornerRadius))
+            maskLayer.path = path.cgPath
+            contentView?.layer.mask = maskLayer
+        } else {
+            // Don't use `contentView.layer.mask` because of a UIVisualEffectView issue in iOS 10, https://forums.developer.apple.com/thread/50854
+            // Instead, a user can mask the content view manually in an application.
+        }
+    }
+
+    func add(contentView: UIView) {
+        insertSubview(contentView, belowSubview: grabberHandle)
+        self.contentView = contentView
+        /* contentView.frame = bounds */ // MUST NOT: Because the top safe area inset of a content VC will be incorrect.
+        contentView.translatesAutoresizingMaskIntoConstraints = false
+        NSLayoutConstraint.activate([
+            contentView.topAnchor.constraint(equalTo: topAnchor, constant: 0.0),
+            contentView.leftAnchor.constraint(equalTo: leftAnchor, constant: 0.0),
+            contentView.rightAnchor.constraint(equalTo: rightAnchor, constant: 0.0),
+            contentView.bottomAnchor.constraint(equalTo: bottomAnchor, constant: 0.0),
+            ])
     }
 }

Framework/Sources/FloatingPanelTransitioning.swift

@@ -0,0 +1,124 @@
+//
+//  Created by Shin Yamamoto on 2018/11/21.
+//  Copyright © 2018 Shin Yamamoto. All rights reserved.
+//
+
+import UIKit
+
+class FloatingPanelModalTransition: NSObject, UIViewControllerTransitioningDelegate {
+    func animationController(forPresented presented: UIViewController,
+                             presenting: UIViewController,
+                             source: UIViewController) -> UIViewControllerAnimatedTransitioning? {
+        return FloatingPanelModalPresentTransition()
+    }
+
+    func animationController(forDismissed dismissed: UIViewController) -> UIViewControllerAnimatedTransitioning? {
+        return FloatingPanelModalDismissTransition()
+    }
+
+    func presentationController(forPresented presented: UIViewController, presenting: UIViewController?, source: UIViewController) -> UIPresentationController? {
+        return FloatingPanelPresentationController(presentedViewController: presented, presenting: presenting)
+    }
+}
+
+class FloatingPanelPresentationController: UIPresentationController {
+    override func presentationTransitionWillBegin() {
+        // Must call here even if duplicating on in containerViewWillLayoutSubviews()
+        // Because it let the floating panel present correclty with the presentation animation
+        addFloatingPanel()
+    }
+
+    override func presentationTransitionDidEnd(_ completed: Bool) {
+        // For non-animated presentation
+        if let fpc = presentedViewController as? FloatingPanelController, fpc.position == .hidden {
+            fpc.show(animated: false, completion: nil)
+        }
+    }
+
+    override func dismissalTransitionDidEnd(_ completed: Bool) {
+        if let fpc = presentedViewController as? FloatingPanelController {
+            // For non-animated dismissal
+            if fpc.position != .hidden {
+                fpc.hide(animated: false, completion: nil)
+            }
+            fpc.view.removeFromSuperview()
+        }
+    }
+
+    override func containerViewWillLayoutSubviews() {
+        guard
+            let fpc = presentedViewController as? FloatingPanelController
+            else { fatalError() }
+
+        /*
+         * Layout the views managed by `FloatingPanelController` here for the
+         * sake of the presentation and disimissal modally from the controller.
+         */
+        addFloatingPanel()
+
+        // Forward touch events to the presenting view controller
+        (fpc.view as? FloatingPanelPassThroughView)?.eventForwardingView = presentingViewController.view
+
+        // Set tap-to-dimiss in the backdrop view
+        let tapGesture = UITapGestureRecognizer(target: self, action: #selector(handleBackdrop(tapGesture:)))
+        fpc.backdropView.addGestureRecognizer(tapGesture)
+    }
+
+    @objc func handleBackdrop(tapGesture: UITapGestureRecognizer) {
+        presentedViewController.dismiss(animated: true, completion: nil)
+    }
+
+    private func addFloatingPanel() {
+        guard
+            let containerView = self.containerView,
+            let fpc = presentedViewController as? FloatingPanelController
+            else { fatalError() }
+
+        containerView.addSubview(fpc.view)
+        fpc.view.frame = containerView.bounds
+        fpc.view.autoresizingMask = [.flexibleWidth, .flexibleHeight]
+    }
+}
+
+class FloatingPanelModalPresentTransition: NSObject, UIViewControllerAnimatedTransitioning {
+    func transitionDuration(using transitionContext: UIViewControllerContextTransitioning?) -> TimeInterval {
+        guard
+            let fpc = transitionContext?.viewController(forKey: .to) as? FloatingPanelController
+        else { fatalError()}
+
+        let animator = fpc.behavior.addAnimator(fpc, to: fpc.layout.initialPosition)
+        return TimeInterval(animator.duration)
+    }
+
+    func animateTransition(using transitionContext: UIViewControllerContextTransitioning) {
+        guard
+            let fpc = transitionContext.viewController(forKey: .to) as? FloatingPanelController
+        else { fatalError() }
+
+        fpc.show(animated: true) {
+            transitionContext.completeTransition(!transitionContext.transitionWasCancelled)
+        }
+    }
+}
+
+class FloatingPanelModalDismissTransition: NSObject, UIViewControllerAnimatedTransitioning {
+    func transitionDuration(using transitionContext: UIViewControllerContextTransitioning?) -> TimeInterval {
+        guard
+            let fpc = transitionContext?.viewController(forKey: .from) as? FloatingPanelController
+        else { fatalError()}
+
+        let animator = fpc.behavior.removeAnimator(fpc, from: fpc.position)
+        return TimeInterval(animator.duration)
+    }
+
+    func animateTransition(using transitionContext: UIViewControllerContextTransitioning) {
+        guard
+            let fpc = transitionContext.viewController(forKey: .from) as? FloatingPanelController
+        else { fatalError() }
+
+        fpc.hide(animated: true) {
+            transitionContext.completeTransition(!transitionContext.transitionWasCancelled)
+        }
+    }
+}
+

Framework/Sources/FloatingPanelView.swift

@@ -0,0 +1,19 @@
+//
+//  Created by Shin Yamamoto on 2018/11/21.
+//  Copyright © 2018 Shin Yamamoto. All rights reserved.
+//
+
+import UIKit
+
+class FloatingPanelPassThroughView: UIView {
+    public weak var eventForwardingView: UIView?
+    public override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
+        let hitView = super.hitTest(point, with: event)
+        switch hitView {
+        case self:
+            return eventForwardingView?.hitTest(self.convert(point, to: eventForwardingView), with: event)
+        default:
+            return hitView
+        }
+    }
+}

Framework/Sources/GrabberHandleView.swift

@@ -12,7 +12,7 @@ public class GrabberHandleView: UIView {
         public static let barColor = UIColor(displayP3Red: 0.76, green: 0.77, blue: 0.76, alpha: 1.0)
     }
 
-    required init?(coder aDecoder: NSCoder) {
+    required public init?(coder aDecoder: NSCoder) {
         super.init(coder: aDecoder)
         render()
     }
@@ -24,8 +24,14 @@ public class GrabberHandleView: UIView {
         self.backgroundColor = Default.barColor
         render()
     }
+
     private func render() {
         self.layer.masksToBounds = true
         self.layer.cornerRadius = frame.size.height * 0.5
     }
+
+    public override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
+        let view = super.hitTest(point, with: event)
+        return view == self ? nil : view
+    }
 }

Framework/Sources/Info.plist

@@ -15,7 +15,7 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>1.0</string>
+	<string>1.1.0</string>
 	<key>CFBundleVersion</key>
 	<string>$(CURRENT_PROJECT_VERSION)</string>
 </dict>

Framework/Sources/UIExtensions.swift

@@ -50,6 +50,8 @@ protocol SideLayoutGuideProvider {
 extension UIView: SideLayoutGuideProvider {}
 extension UILayoutGuide: SideLayoutGuideProvider {}
 
+// The reason why UIView has no extensions of safe area insets and top/bottom guides
+// is for iOS10 compat.
 extension UIView {
     var sideLayoutGuide: SideLayoutGuideProvider {
         if #available(iOS 11.0, *) {
@@ -60,7 +62,19 @@ extension UIView {
     }
 }
 
-extension UIGestureRecognizer.State: CustomDebugStringConvertible {
+extension UIView {
+    func disableAutoLayout() {
+        let frame = self.frame
+        translatesAutoresizingMaskIntoConstraints = true
+        self.frame = frame
+    }
+    func enableAutoLayout() {
+        translatesAutoresizingMaskIntoConstraints = false
+    }
+}
+
+
+extension UIGestureRecognizerState: CustomDebugStringConvertible {
     public var debugDescription: String {
         switch self {
         case .began: return "Began"

README.md

@@ -1,5 +1,13 @@
+[![Build Status](https://travis-ci.org/SCENEE/FloatingPanel.svg?branch=master)](https://travis-ci.org/SCENEE/FloatingPanel)
+[![Version](https://img.shields.io/cocoapods/v/FloatingPanel.svg)](https://cocoapods.org/pods/FloatingPanel)
+[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)
+[![Platform](https://img.shields.io/cocoapods/p/FloatingPanel.svg)](https://cocoapods.org/pods/FloatingPanel)
+[![Swift 4.1](https://img.shields.io/badge/Swift-4.1-orange.svg?style=flat)](https://swift.org/)
+[![Swift 4.2](https://img.shields.io/badge/Swift-4.2-orange.svg?style=flat)](https://swift.org/)
+
 #  FloatingPanel
 
+
 FloatingPanel is a simple and easy-to-use UI component for a new interface introduced in Apple Maps, Shortcuts and Stocks app.
 The new interface displays the related contents and utilities in parallel as a user wants.
 
@@ -8,16 +16,49 @@ The new interface displays the related contents and utilities in parallel as a u
 
 ![Maps(Landscape)](https://github.com/SCENEE/FloatingPanel/blob/master/assets/maps-landscape.gif)
 
+<!-- TOC -->
+
+- [Features](#features)
+- [Requirements](#requirements)
+- [Installation](#installation)
+  - [CocoaPods](#cocoapods)
+  - [Carthage](#carthage)
+- [Getting Started](#getting-started)
+  - [Add a floating panel as a child view controller](#add-a-floating-panel-as-a-child-view-controller)
+  - [Present a floating panel as a modality](#present-a-floating-panel-as-a-modality)
+- [View hierarchy](#view-hierarchy)
+- [Usage](#usage)
+  - [Show/Hide a floating panel in a view with your view hierarchy](#showhide-a-floating-panel-in-a-view-with-your-view-hierarchy)
+  - [Customize the layout with `FloatingPanelLayout` protocol](#customize-the-layout-with-floatingpanellayout-protocol)
+    - [Change the initial position and height](#change-the-initial-position-and-height)
+    - [Support your landscape layout](#support-your-landscape-layout)
+    - [Use Intrinsic height layout](#use-intrinsic-height-layout)
+  - [Customize the behavior with `FloatingPanelBehavior` protocol](#customize-the-behavior-with-floatingpanelbehavior-protocol)
+    - [Modify your floating panel's interaction](#modify-your-floating-panels-interaction)
+  - [Use a custom grabber handle](#use-a-custom-grabber-handle)
+  - [Add tap gestures to the surface or backdrop views](#add-tap-gestures-to-the-surface-or-backdrop-views)
+  - [Create an additional floating panel for a detail](#create-an-additional-floating-panel-for-a-detail)
+  - [Move a position with an animation](#move-a-position-with-an-animation)
+  - [Work your contents together with a floating panel behavior](#work-your-contents-together-with-a-floating-panel-behavior)
+- [Notes](#notes)
+  - ['Show' or 'Show Detail' Segues from `FloatingPanelController`'s content view controller](#show-or-show-detail-segues-from-floatingpanelcontrollers-content-view-controller)
+  - [FloatingPanelSurfaceView's issue on iOS 10](#floatingpanelsurfaceviews-issue-on-ios-10)
+- [Author](#author)
+- [License](#license)
+
+<!-- /TOC -->
+
 ## Features
 
 - [x] Simple container view controller
 - [x] Fluid animation and gesture handling
 - [x] Scroll view tracking
 - [x] Common UI elements: Grabber handle, Backdrop and Surface rounding corners
-- [x] 2 or 3 anchor positions(full, half, tip)
+- [x] 1~3 anchor positions(full, half, tip)
 - [x] Layout customization for all trait environments(i.e. Landscape orientation support)
 - [x] Behavior customization
 - [x] Free from common issues of Auto Layout and gesture handling
+- [x] Modal presentation
 
 Examples are here.
 
@@ -26,7 +67,7 @@ Examples are here.
 
 ## Requirements
 
-FloatingPanel is written in Swift 4.2. Compatible with iOS 10.0+
+FloatingPanel is written in Swift. It can be built by Xcode 9.4.1 or later. Compatible with iOS 10.0+.
 
 ## Installation
 
@@ -47,9 +88,10 @@ For [Carthage](https://github.com/Carthage/Carthage), add the following to your
 github "scenee/FloatingPanel"
 ```
 
-
 ## Getting Started
 
+### Add a floating panel as a child view controller
+
 ```swift
 import UIKit
 import FloatingPanel
@@ -65,81 +107,137 @@ class ViewController: UIViewController, FloatingPanelControllerDelegate {
         // Assign self as the delegate of the controller.
         fpc.delegate = self // Optional
 
-        // Add a content view controller.
+        // Set a content view controller.
         let contentVC = ContentViewController()
-        fpc.show(contentVC, sender: nil)
+        fpc.set(contentViewController: contentVC)
 
         // Track a scroll view(or the siblings) in the content view controller.
         fpc.track(scrollView: contentVC.tableView)
 
-        // Add the views managed by the `FloatingPanelController` object to self.view.
+        // Add and show the views managed by the `FloatingPanelController` object to self.view.
         fpc.addPanel(toParent: self)
     }
 
     override func viewWillDisappear(_ animated: Bool) {
         super.viewWillDisappear(animated)
+
         // Remove the views managed by the `FloatingPanelController` object from self.view.
         fpc.removePanelFromParent()
     }
-    ...
 }
 ```
 
+### Present a floating panel as a modality
+
+```swift
+let fpc = FloatingPanelController()
+let contentVC = ...
+fpc.set(contentViewController: contentVC)
+
+fpc.isRemovalInteractionEnabled = true // Optional: Let it removable by a swipe-down
+
+self.present(fpc, animated: true, completion: nil)
+```
+
+You can show a floating panel over UINavigationController from the containnee view controllers as a modality of `.overCurrentContext` style.
+
+NOTE: FloatingPanelController has the custom presentation controller. If you would like to customize the presentation/dismissal, please see [FloatingPanelTransitioning](https://github.com/SCENEE/FloatingPanel/blob/feat-modality/Framework/Sources/FloatingPanelTransitioning.swift).
+
+## View hierarchy
+
+`FloatingPanelController` manages the views as the following view hierarchy.
+
+```
+FloatingPanelController.view (FloatingPanelPassThroughView)
+ ├─ .backdropView (FloatingPanelBackdropView)
+ └─ .surfaceView (FloatingPanelSurfaceView)
+          ├─ .contentView  == FloatingPanelController.contentViewController.view
+          └─ .grabberHandle (GrabberHandleView)
+```
+
 ## Usage
 
-### Move a positon with an animation
-
-Move a floating panel to the top and middle of a view while opening and closeing a search bar like Apple Maps.
+### Show/Hide a floating panel in a view with your view hierarchy
 
 ```swift
-    func searchBarCancelButtonClicked(_ searchBar: UISearchBar) {
-        ...
-        fpc.move(to: .half, animated: true)
-    }
+// Add the controller and the managed views to a view controller.
+// From the second time, just call `show(animated:completion)`.
+view.addSubview(fpc.view)
 
-    func searchBarTextDidBeginEditing(_ searchBar: UISearchBar) {
-        ...
-        fpc.move(to: .full, animated: true)
-    }
-```
+fpc.view.frame = view.bounds // MUST
+// In addition, Auto Layout constraints are highly recommended.
+// Because it makes the layout more robust on trait collection change.
+//
+//     fpc.view.translatesAutoresizingMaskIntoConstraints = false
+//     NSLayoutConstraint.activate([...])
+// 
 
-### Make your contents correspond with FloatingPanel behavior
+parent.addChild(fpc)
 
-```swift
-class ViewController: UIViewController, FloatingPanelControllerDelegate {
-    ...
-    func floatingPanelWillBeginDragging(_ vc: FloatingPanelController) {
-        if vc.position == .full {
-            searchVC.searchBar.showsCancelButton = false
-            searchVC.searchBar.resignFirstResponder()
-        }
-    }
+// Show a floating panel to the initial position defined in your `FloatingPanelLayout` object.
+fpc.show(animated: true) {
 
-    func floatingPanelDidEndDragging(_ vc: FloatingPanelController, withVelocity velocity: CGPoint, targetPosition: FloatingPanelPosition) {
-        if targetPosition != .full {
-            searchVC.hideHeader()
-        }
-    }
-    ...
+    // Only for the first time
+    self.didMove(toParent: self)
+}
+
+...
+
+// Hide it
+fpc.hide(animated: true) {
+
+    // Remove it if needed
+    self.willMove(toParent: nil)
+    self.view.removeFromSuperview()
+    self.removeFromParent()
 }
 ```
 
-### Support your landscape layout with a `FloatingPanelLayout` object
+NOTE: `FloatingPanelController` wraps `show`/`hide` with `addPanel`/`removePanelFromParent` for easy-to-use. But `show`/`hide` are more convenience for your app.
+
+### Customize the layout with `FloatingPanelLayout` protocol
+
+#### Change the initial position and height
 
 ```swift
 class ViewController: UIViewController, FloatingPanelControllerDelegate {
     ...
     func floatingPanel(_ vc: FloatingPanelController, layoutFor newCollection: UITraitCollection) -> FloatingPanelLayout? {
-        return (newCollection.verticalSizeClass == .compact) ? FloatingPanelLandscapeLayout() : nil
+        return MyFloatingPanelLayout()
     }
+}
+
+class MyFloatingPanelLayout: FloatingPanelLayout {
+    public var initialPosition: FloatingPanelPosition {
+        return .tip
+    }
+
+    public func insetFor(position: FloatingPanelPosition) -> CGFloat? {
+        switch position {
+            case .full: return 16.0 // A top inset from safe area
+            case .half: return 216.0 // A bottom inset from the safe area
+            case .tip: return 44.0 // A bottom inset from the safe area
+            default: return nil // Or `case .hidden: return nil`
+        }
+    }
+}
+```
+
+#### Support your landscape layout
+
+```swift
+class ViewController: UIViewController, FloatingPanelControllerDelegate {
     ...
+    func floatingPanel(_ vc: FloatingPanelController, layoutFor newCollection: UITraitCollection) -> FloatingPanelLayout? {
+        return (newCollection.verticalSizeClass == .compact) ? FloatingPanelLandscapeLayout() : nil // Returning nil indicates to use the default layout
+    }
 }
 
 class FloatingPanelLandscapeLayout: FloatingPanelLayout {
     public var initialPosition: FloatingPanelPosition {
         return .tip
     }
-    public var supportedPositions: [FloatingPanelPosition] {
+    public var supportedPositions: Set<FloatingPanelPosition> {
         return [.full, .tip]
     }
 
@@ -160,7 +258,36 @@ class FloatingPanelLandscapeLayout: FloatingPanelLayout {
 }
 ```
 
-### Modify your floating panel's interaction with a `FloatingPanelBehavior` object
+#### Use Intrinsic height layout
+
+1. Lay out your content View with the intrinsic height size. For example, see "Detail View Controller scene"/"Intrinsic View Controller scene" of [Main.storyboard](https://github.com/SCENEE/FloatingPanel/blob/master/Examples/Samples/Sources/Base.lproj/Main.storyboard). The 'Stack View.bottom' constraint determines the intrinsic height.
+2. Create a layout that adopts and conforms to `FloatingPanelIntrinsicLayout` and use it.
+
+```swift
+class ViewController: UIViewController, FloatingPanelControllerDelegate {
+    ...
+    func floatingPanel(_ vc: FloatingPanelController, layoutFor newCollection: UITraitCollection) -> FloatingPanelLayout? {
+        return RemovablePanelLayout()
+    }
+}
+
+class RemovablePanelLayout: FloatingPanelIntrinsicLayout {
+    var supportedPositions: Set<FloatingPanelPosition> {
+        return [.full, .half]
+    }
+    func insetFor(position: FloatingPanelPosition) -> CGFloat? {
+        switch position {
+        case .half: return 130.0
+        default: return nil  // Must return nil for .full
+        }
+    }
+    ...
+}
+```
+
+### Customize the behavior with `FloatingPanelBehavior` protocol
+
+#### Modify your floating panel's interaction
 
 ```swift
 class ViewController: UIViewController, FloatingPanelControllerDelegate {
@@ -168,57 +295,158 @@ class ViewController: UIViewController, FloatingPanelControllerDelegate {
     func floatingPanel(_ vc: FloatingPanelController, behaviorFor newCollection: UITraitCollection) -> FloatingPanelBehavior? {
         return FloatingPanelStocksBehavior()
     }
-    ...
 }
-...
 
 class FloatingPanelStocksBehavior: FloatingPanelBehavior {
-    var velocityThreshold: CGFloat {
-        return 15.0
-    }
-
-    func interactionAnimator(to targetPosition: FloatingPanelPosition, with velocity: CGVector) -> UIViewPropertyAnimator {
+    ...
+    func interactionAnimator(_ fpc: FloatingPanelController, to targetPosition: FloatingPanelPosition, with velocity: CGVector) -> UIViewPropertyAnimator {
         let damping = self.damping(with: velocity)
         let springTiming = UISpringTimingParameters(dampingRatio: damping, initialVelocity: velocity)
         return UIViewPropertyAnimator(duration: 0.5, timingParameters: springTiming)
     }
+}
+```
+
+### Use a custom grabber handle
+
+```swift
+let myGrabberHandleView = MyGrabberHandleView()
+fpc.surfaceView.grabberHandle.isHidden = true
+fpc.surfaceView.addSubview(myGrabberHandleView)
+```
+
+### Add tap gestures to the surface or backdrop views
+
+```swift
+override func viewDidLoad() {
     ...
+    surfaceTapGesture = UITapGestureRecognizer(target: self, action: #selector(handleSurface(tapGesture:)))
+    fpc.surfaceView.addGestureRecognizer(surfaceTapGesture)
+
+    backdropTapGesture = UITapGestureRecognizer(target: self, action: #selector(handleBackdrop(tapGesture:)))
+    fpc.backdropView.addGestureRecognizer(backdropTapGesture)
+
+    surfaceTapGesture.isEnabled = (fpc.position == .tip)
+}
+
+// Enable `surfaceTapGesture` only at `tip` position
+func floatingPanelDidChangePosition(_ vc: FloatingPanelController) {
+    surfaceTapGesture.isEnabled = (vc.position == .tip)
 }
 ```
 
 ### Create an additional floating panel for a detail
 
 ```swift
-class ViewController: UIViewController, FloatingPanelControllerDelegate {
-    var searchPanelVC: FloatingPanelController!
-    var detailPanelVC: FloatingPanelController!
+override func viewDidLoad() {
+    // Setup Search panel
+    self.searchPanelVC = FloatingPanelController()
 
-    override func viewDidLoad() {
-        // Setup Search panel
-        self.searchPanelVC = FloatingPanelController()
+    let searchVC = SearchViewController()
+    self.searchPanelVC.set(contentViewController: searchVC)
+    self.searchPanelVC.track(scrollView: contentVC.tableView)
 
-        let searchVC = SearchViewController()
-        self.searchPanelVC.show(searchVC, sender: nil)
-        self.searchPanelVC.track(scrollView: contentVC.tableView)
+    self.searchPanelVC.addPanel(toParent: self)
 
-        self.searchPanelVC.addPanel(toParent: self)
+    // Setup Detail panel
+    self.detailPanelVC = FloatingPanelController()
 
-        // Setup Detail panel
-        self.detailPanelVC = FloatingPanelController()
+    let contentVC = ContentViewController()
+    self.detailPanelVC.set(contentViewController: contentVC)
+    self.detailPanelVC.track(scrollView: contentVC.scrollView)
 
-        let contentVC = ContentViewController()
-        self.detailPanelVC.show(contentVC, sender: nil)
-        self.detailPanelVC.track(scrollView: contentVC.scrollView)
-
-        self.detailPanelVC.addPanel(toParent: self)
-    }
-    ...
+    self.detailPanelVC.addPanel(toParent: self)
 }
 ```
 
+### Move a position with an animation
+
+In the following example, I move a floating panel to full or half position while opening or closing a search bar like Apple Maps.
+
+```swift
+func searchBarCancelButtonClicked(_ searchBar: UISearchBar) {
+    ...
+    fpc.move(to: .half, animated: true)
+}
+
+func searchBarTextDidBeginEditing(_ searchBar: UISearchBar) {
+    ...
+    fpc.move(to: .full, animated: true)
+}
+```
+
+### Work your contents together with a floating panel behavior
+
+```swift
+class ViewController: UIViewController, FloatingPanelControllerDelegate {
+    ...
+    func floatingPanelWillBeginDragging(_ vc: FloatingPanelController) {
+        if vc.position == .full {
+            searchVC.searchBar.showsCancelButton = false
+            searchVC.searchBar.resignFirstResponder()
+        }
+    }
+
+    func floatingPanelDidEndDragging(_ vc: FloatingPanelController, withVelocity velocity: CGPoint, targetPosition: FloatingPanelPosition) {
+        if targetPosition != .full {
+            searchVC.hideHeader()
+        }
+    }
+}
+```
+
+## Notes
+
+### 'Show' or 'Show Detail' Segues from `FloatingPanelController`'s content view controller
+
+'Show' or 'Show Detail' segues from a content view controller will be managed by a view controller(hereinafter called 'master VC') adding a floating panel. Because a floating panel is just a subview of the master VC(except for modality).
+
+`FloatingPanelController` has no way to manage a stack of view controllers like `UINavigationController`. If so, it would be so complicated and the interface will become `UINavigationController`. This component should not have the responsibility to manage the stack.
+
+By the way, a content view controller can present a view controller modally with `present(_:animated:completion:)` or 'Present Modally' segue.
+
+However, sometimes you want to show a destination view controller of 'Show' or 'Show Detail' segue with another floating panel. It's possible to override `show(_:sender)` of the master VC!
+
+Here is an example.
+
+```swift
+class ViewController: UIViewController {
+    var fpc: FloatingPanelController!
+    var secondFpc: FloatingPanelController!
+
+    ...
+    override func show(_ vc: UIViewController, sender: Any?) {
+        secondFpc = FloatingPanelController()
+
+        secondFpc.set(contentViewController: vc)
+
+        secondFpc.addPanel(toParent: self)
+    }
+}
+```
+
+A `FloatingPanelController` object proxies an action for `show(_:sender)` to the master VC. That's why the master VC can handle a destination view controller of a 'Show' or 'Show Detail' segue and you can hook `show(_:sender)` to show a secondary floating panel set the destination view controller to the content.
+
+It's a great way to decouple between a floating panel and the content VC.
+
+### FloatingPanelSurfaceView's issue on iOS 10
+
+* On iOS 10, `FloatingPanelSurfaceView.cornerRadius` isn't not automatically masked with the top rounded corners  because of `UIVisualEffectView` issue. See https://forums.developer.apple.com/thread/50854. 
+So you need to draw top rounding corners of your content.  Here is an example in Examples/Maps.
+```swift
+override func viewDidLayoutSubviews() {
+    super.viewDidLayoutSubviews()
+    if #available(iOS 10, *) {
+        visualEffectView.layer.cornerRadius = 9.0
+        visualEffectView.clipsToBounds = true
+    }
+}
+```
+* If you sets clear color to `FloatingPanelSurfaceView.backgroundColor`, please note the bottom overflow of your content on bouncing at full position. To prevent it, you need to expand your content. For example, See Example/Maps App's Auto Layout settings of `UIVisualEffectView` in Main.storyboard.
+
 ## Author
 
-Shin Yamamoto <shin@scenee.com>
+Shin Yamamoto <shin@scenee.com> | [@scenee](https://twitter.com/scenee)
 
 ## License