Miles-Matheson / TABAnimated

A skeleton screen loading framework based on native for iOS. (一个由iOS原生组件映射出骨架屏的框架，包含快速植入，低耦合，兼容复杂视图等特点，提供国内主流骨架屏动画的加载方案，同时支持上拉加载更多、自定制动画。)

• English Documents

骨架屏

骨架屏(Skeleton Screen)是一种优化用户弱网体验的方案。在弱网情况下，客户端获取到服务器数据的时间会比较长，通过骨架屏来减缓用户等待的焦躁情绪。 TABAnimated是提供给iOS开发者自动生成骨架屏的一种解决方案。开发者可以将已经开发好的视图，通过配置一些全局/局部的参数，自动生成与其结构一致的骨架屏。开发者用较少的开发成本，就可以获得和需求一致的骨架屏。

优势

• 自动化、低耦合
• 列表视图、嵌套视图
• 支持上拉加载
• 支持暗黑模式
• 自定制动画及其序列化
• 实时预览

效果展示

闪光动画	经典动画	下坠动画

呼吸动画	上拉加载	复杂场景

暗黑模式：

工具箱切换	setting页面切换

实时预览：

Usages

流程图

一、导入

• CocoaPods

pod 'TABAnimated', '2.6.3'

• Carthage

github "tigerAndBull/TABAnimated"

• 手动将TABAnimated文件夹拖入工程

二、设置全局参数(可选)

在 didFinishLaunchingWithOptions 中设置全局参数

[TABAnimated sharedAnimated].openLog = YES;
[TABAnimated sharedAnimated].openAnimationTag = YES;
...

三、初始化

NewsCollectionViewCell就是业务方自己的cell，也可以绑定其他任意类型cell！

_collectionView.tabAnimated = 
[TABCollectionAnimated animatedWithCellClass:[NewsCollectionViewCell class] 
cellSize:[NewsCollectionViewCell cellSize]];

• 有其他初始化方法，针对不同结构的列表视图，在框架中都有注释
• 有针对这个控制视图的局部属性，在框架中都有注释

四、控制骨架屏开关

1. 开启动画

[self.collectionView tab_startAnimation];  

2. 关闭动画

[self.collectionView tab_endAnimation];

五、预处理回调+链式语法用于修改骨架元素的属性

使用变量名修改

_tableView.tabAnimated.adjustBlock = ^(TABComponentManager * _Nonnull manager) {
    manager.animationN(@"titleImageView").down(3).radius(12);
    manager.animationN(@"nameLabel").height(12).width(110);
    manager.animationN(@"timeButton").down(-5).height(12);
};

使用index修改

_tableView.tabAnimated.adjustBlock = ^(TABComponentManager * _Nonnull manager) {
    manager.animation(1).down(3).radius(12);
    manager.animation(2).height(12).width(110);
    manager.animation(3).down(-5).height(12);
};

Swift

tableView.tabAnimated?.adjustBlock = { manager in
   manager.animation()?(1)?.down()(3)?.radius()(12)
   manager.animation()?(2)?.height()(12)?.width()(110)
   manager.animation()?(3)?.down()(-5)?.height()(12)
}

FAQ

1. manager.animation(x)和 manager.animationN(@"x")，x是几？

manager.animation(x)其实是视图addSubView尾递归排序。 在appDelegate设置TABAnimated的openAnimationTag属性为YES，框架就会自动为你指示，究竟x是几。

[TABAnimated sharedAnimated].openAnimationTag = YES;

animationN(@"x")的x是变量名，不支持局部变量。

2. 通过几个示例，了解预处理回调和链式语法

• 假如第0个元素的高度和宽度不合适

manager.animation(0).height(12).width(110);

• 假如第1个元素需要使用占位图

manager.animation(1).placeholder(@"占位图名称.png");

• 假如第1，2，3个元素宽度都为50

manager.animations(1,3).width(50);

• 假如第1，5，7个元素需要下移5px

manager.animationWithIndexs(1,5,7).down(5);

3. 列表集成问题

在你集成列表视图之前，一定要理清列表视图结构。分为以下三种：

• 以section为单元，section和cell样式一一对应
• 视图只有1个section, 但是对应多个cell
• 动态section：section数量是网络获取的

明确自身需求

• 设置多个section/row，一起开启动画
• 设置多个section/row，部分开启动画

最后到框架内找到对应的初始化方法、启动动画方法即可！

4. 详细说明文档列表

• 缓存策略和线程处理
• 架构设计和性能测试
• 预处理回调动画元素下标问题
• 问题答疑文档、版本信息记录文档
• 全局:局部属性、链式语法api
• 豆瓣动画详解
• 不再hook setDelegate和setDataSource
• 上拉加载更多

Tips

• 有问题优先查看issues和documents
• demo提供的只是不同结构视图的集成方案，开发者可以自己定制出更精美的效果
• 如有使用问题、优化建议等，可以关注公众号：tigerAndBull技术分享，加群解决

Stargazers over time

License

All source code is licensed under the License