ElongationPreview 2.1.0

ElongationPreview 2.1.0

测试已测试
语言语言 SwiftSwift
许可证 MIT
发布上次发布2019年4月
SPM支持 SPM

Abdurahim JauzeeAdaptive ControllerAlex Kalinkin 维护。



  • 作者
  • Abdurahim Jauzee

ELONGATION PREVIEW

Elongation Preview 是一款优雅的 iOS 推出弹出样式视图控制器。


我们专注于为移动应用程序和网站设计和编写自定义 UI。

关注最新更新

为您的项目获取免费原型 →

Twitter PodPlatform PodVersion Documentation Donate Carthage Codebeat


要求

  • iOS 9.0+
  • Xcode 8
  • Swift 3 (<= 1.0.5)
  • Swift 4 (>= 1.1)

安装

您可以通过几种方式安装 ElongationPreview

  • 将源文件添加到您的项目中。

pod 'ElongationPreview'

github "Ramotion/elongation-preview"

如何使用

首先,将模块导入到源文件中。

import ElongationPreview

ElongationViewController

然后继承 ElongationViewController 并按您希望的方式配置它。

class RootViewController: ElongationViewController { }

现在您必须在 tableView 中注册可重用单元格。如果您喜欢使用 Storyboards,您可以从底部的右侧菜单拖动 UITableViewCell布局它并将其类更改为 ElongationCell。当然,对单元格子视图的配置有一些特定要求。

ElongationCell

  • 简单方法:从示例项目中复制DemoElongationCell,按需进行修改。将您自己的视图添加到topbottomscalable容器中。

  • 如果您要从头创建单元格,这是您的单元格层次结构应如下所示:

    hierarchy

    所需属性

    bottomView —— 当您点击单元格时,位于单元格后面的视图。

    scalableView —— 当您点击单元格时,将被缩放的视图。

    topView —— 静态顶部视图,在这里添加所有不会缩放且必须保持其位置的视图。

    还必须连接这些约束:topViewHeightConstrainttopViewTopConstraintbottomViewHeightConstraintbottomViewTopConstraint


📌如果您需要覆盖

func scrollViewDidScroll(_ scrollView: UIScrollView)

func tableView(_ tableView: UITableView, willDisplay cell: UITableViewCell, forRowAt indexPath: IndexPath)

您必须调用 super,因为在超类(ElongationViewController)的这些方法中已进行了重要的配置。


ElongationDetailViewController

class DetailViewController: ElongationDetailViewController { }

如果您想为来自root视图的对象显示某些详细信息,最好是创建ElongationDetailViewController的子类,并为其配置显示您的数据。

此类包含headerView属性,它实际上代表展开状态下的ElongationCell,并默认用作tableView的标题。

📌重写openDetailView(for: IndexPath)方法,创建您的ElongationDetailViewController实例,并使用此实例调用expand(viewController: ElongationDetailViewController, animated: Bool)方法。

这是您需要配置ElongationDetailViewController子类的地方。


外观和功能

您可以通过调整ElongationConfig的某些参数并覆盖shared实例来自定义ElongationPreview控件的外观和功能。

// Create new config.
var config = ElongationConfig()

// Change desired properties.
config.scaleViewScaleFactor = 0.9
config.topViewHeight = 190
config.bottomViewHeight = 170
config.bottomViewOffset = 20
config.parallaxFactor = 100
config.separatorHeight = 0.5
config.separatorColor = .white

// Save created config as `shared` instance.
ElongationConfig.shared = config

🗒所有参数及其说明都列在ElongationConfig文件中。

📄许可证

Elongation Preview是在MIT许可证下发布的。有关详细信息,请参阅LICENSE

此库是我们最好的UI开源项目之一的一部分选择。

如果您在项目中使用开源库,请确保链接到www.ramotion.com并进行信用。

📱获取尝试Showroom App的iOS版本

在我们的iOS应用中尝试这个UI组件和其他类似组件。如有兴趣,请联系我们。