《ECSlidingViewController》是一个视图控制器容器,用于管理分层界面。顶层锚定在容器的左侧或右侧,同时显示其下的层。这通常被称为“侧边菜单”、“滑动弹出”、“汉堡菜单/抽屉/侧边栏”等...
支持所有屏幕尺寸和方向。
ECSlidingViewController
的设计理念是提供简单默认的设置,同时允许用户自定义。它可能不会立即满足您的需求或期望的效果,但在自定义时不会造成阻碍。
您的视图控制器将在正确的时间收到适当的视图生命周期和旋转方法。它们在旋转或边界变化时将适当地更新布局,同时尊重它们的 edgesForExtendedLayout
属性。这意味着您可以对您的视图控制器在状态栏、导航栏或其他配置了 topLayoutGuide
的容器下方或其下的位置进行控制。
ECSlidingViewController
努力感觉像是 UIKit
视图控制器容器家族的一部分,并且当将任何组合嵌套在一起时可以正常工作。
可以使用 用户自定义运行时属性 来完成基本的配置。`.ECSlidingViewController` 带有一个自定义的转换操作,并支持在视图控制器之间进行逆向转换。
此功能是可选的,如果您愿意,可以通过代码程序来完成所有设置。就像其他任何视图控制器容器一样,您很可能会在 Storyboards 上进行一些程序化的自定义设置。
如果默认的滑动动画或滑动交互无法满足您的需求,则可以通过提供自己的来定制它们。
自定义转换使用 iOS 7 中引入的新协议,同时提供了一个类似于 UIKit 容器用于自定义转换的 API。如果您熟悉 iOS 7 中的自定义转换 API,将会感到非常熟悉。
注意:为了支持iOS 5-7,ECSlidingViewController
的1.x版本可在这个分支找到。
使用CocoaPods安装,在你的Podfile中添加以下命令
platform :ios, '7.0'
pod 'ECSlidingViewController', '~> 2.0.3'
注意:我们遵循http://semver.org对公共API进行版本控制。
或者,将此仓库中的ECSlidingViewController/
目录复制到你的项目中。
公共API的头文件中有文档。它将自动显示在Xcode 5的快速帮助中,或者你可以在网上查看它。
cocoadocs.org上的ECSlidingViewController参考
学习如何使用ECSlidingViewController
的一个好方法是浏览Examples.xcworkspace
中的示例应用程序。每个示例都有一个README文件,解释了如何实现。
注意:在模拟器中取消交互式转换时,出现动画闪烁的问题。在设备上不会发生这种情况。
Wiki包含了更详细的关于如何使用ECSlidingViewController
中特定功能的指南。
ECSlidingViewController Wiki首页
如果你需要使用ECSlidingViewController
的帮助,请在带有“ECSlidingViewController”标签的StackOverflow上发布一个问题。此外,你提供的上下文越多(例如示例项目),你获得帮助的机会就越大。
如果你认为找到了ECSlidingViewController
的问题,请提交问题。示例项目或任何示例示例的分支演示问题将帮助我们更快地解决问题。
由Mike Enriquez创建和维护。
Neo Innovation(之前称为EdgeCase)允许Mike在成立期间,在公司时间内工作在ECSlidingViewController
。他不再与该公司一起工作,但继续维护该项目。
版权所有(C) 2013 Michael Enriquez (http://enriquez.me)
在此特此授予任何获得此软件及其相关文档文件(以下简称“软件”)副本的任何人不受限制地处理软件的权利,包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或转让软件副本的权利,并允许向用户提供软件,以便他们可以这样做,前提是遵守以下条件
上述版权声明和本许可说明应包含在软件的所有副本或实质部分中。
软件按照“现状”提供,不提供任何明示或暗示的保证,包括但不限于适销性、特定目的适用性和非侵权性。在任何情况下,作者或版权持有人不对任何主张、损害或其他责任承担责任,无论产生于合同、侵权或其他方面,以及与软件或软件的使用或其他操作有关的情况。