Skip to content

faimin/ZDFlexLayoutKit

Repository files navigation

ZDFlexLayoutKit

Intro

基于 Yoga 引擎二次开发的给 iOS 用的盒子布局~

Feature

  • 虚拟视图

  • 链式调用

  • 异步计算

  • 自动更新布局

  • 支持UIScrollView布局

  • UITableViewCellUICollectionViewCell 高度自动计算

PS:开启自动更新布局后,在布局发生改变需要更新时需要手动调用 markDirtygone 不需要调用 markDirty ,它内部会自己处理

Install

pod 'ZDFlexLayoutKit'

0.1.2 开始支持 Swift

支持编译为静态库,但如果想使用Literal字面量特性,需要把这个repo编译为framework的形式,比如在podfile中开启use_framework!或者其他方式让它以framework的形式存在

如果它被编译为了动态库,其依赖的 yoga 也需要以动态库的形式集成,即动态库不能依赖静态库

默认使用的是ZDYoga,如果想使用官方Yoga,可以在Podfile中添加设置:

ENV['Yoga'] = 'true'

pod 'Yoga', :podspec => './Yoga.podspec'

Usage

Swift

avatarImgView.zd.makeFlexLayout {
    $0.position(.absolute)
    $0.width(100%).height(100%)
}
gradientView.zd.makeFlexLayout {
    $0.position(.relative).flexDirection(.column)
    $0.paddingHorizontal(8)
    $0.width(100%)
}
titleLabel.zd.makeFlexLayout { (make) in
    make.marginTop(3.5)
    make.width(100%)
    make.flexShrink(1)
}
// 虚拟视图
let userInfoDiv = ZDFlexLayoutDiv.zd.makeFlexLayout { (make) in
    make.flexDirection(.row)
    make.alignItems(.center)
    make.marginTop(2.5)
    make.marginBottom(6)
}

// 这里需要调用 `addChildren` 函数,因为我们重新构建了视图树
gradientView.addChildren([titleLabel, avatarImgView])
userInfoDiv.addChildren([gradientView])

// 计算布局,以下2种方式皆可,第二种会当你标记为mark之后会在runloop空闲时自动计算布局
//userInfoDiv.calculateLayoutPreservingOrigin(true, dimensionFlexibility: .flexibleHeight)
userInfoDiv.calculateLayout(withAutoRefresh: true, preservingOrigin: false, dimensionFlexibility: .flexibleHeight)

Objective-C

[self zd_makeFlexLayout:^(ZDFlexLayoutMaker * _Nonnull make) {
    make.flexDirection(YGFlexDirectionColumn).flexWrap(YGWrapWrap).alignContent(YGAlignCenter);
}];
[self.iconimageV zd_makeFlexLayout:^(ZDFlexLayoutMaker * _Nonnull make) {
    // 属性设置支持链式调用
    make.marginLeft(YGPointValue(10)).marginTop(YGPointValue(6)).marginBottom(YGPointValue(6)).width(YGPointValue(20)).height(YGPointValue(20));
}];
[self.contentLabel zd_makeFlexLayout:^(ZDFlexLayoutMaker * _Nonnull make) {
    make.marginLeft(YGPointValue(5)).marginRight(YGPointValue(10));
}];
[self calculateLayoutWithAutoRefresh:YES preservingOrigin:YES dimensionFlexibility:ZDDimensionFlexibilityFlexibleHeight];

dynamic_framework_setting

pre_install do |installer|
    dynamic_framework = ['ZDFlexLayoutKit','Yoga']
    Pod::Installer::Xcode::TargetValidator.send(:define_method, :verify_no_static_framework_transitive_dependencies) {}
    installer.pod_targets.each do |pod|
      if dynamic_framework.include?(pod.name)
        def pod.build_type;
          Pod::BuildType.dynamic_framework
        end
      end
    end
end

Learning materials