Latest 0.1.2
Homepage https://github.com/fengshanjian/FlexBoxKit
License MIT
Platforms ios 8.0
Dependencies Yoga

Version
License
Platform

特点(Feature)

  • Flexbox Layout;
  • 虚拟视图 (Virtual Div)
  • TableView 支持自动高度、布局缓存,contentView 缓存,和自动 cache 失效机制;( It support auto cell height of FBLayout and easy use)
  • ScrollView 支持自适应 contentSize;(contentSize auto contentSize)
  • 依赖yoga最新版本 (base on the newest version of yoga)

预览(Preview)

FlexBoxKit

示例 (example)

  1. 利用 git clone 命令下载本仓库, Examples 目录包含了示例程序;
  2. 用 XCode 打开对应项目编译即可。

或执行以下命令:

git clone [email protected]:fengshanjian/FlexBoxKit.git
cd FlexBoxKit/Example
open 'FlexBoxLayout.xcworkspace'

安装 (Install)

pod "FlexBoxKit"

使用

These are some flexbox introduce FlexBox(Chinese), A Complete Guide to Flexbox and A Visual Guide to CSS3 Flexbox Properties

1. UIView + FBKit && FBKDiv Usage

FBKDiv是一个虚拟的view,用于分割不同的区域,避免使用太多view以至层级太多

(FBKDiv is virtual view, split view to a different area, avoid too much view.)

Here are some simple uses

    UIScrollView *contentView = [UIScrollView new];
    contentView.frame = CGRectMake(0, 0, [UIScreen mainScreen].bounds.size.width, [UIScreen mainScreen].bounds.size.height-(iPhoneX?83:49));
    [self.view addSubview:contentView];

    UIView *child1 = [UIView new];
    child1.backgroundColor = [UIColor blueColor];
    [child1 configureLayout:^(FBKLayout * _Nonnull layout) {
        layout.kWidth = 100;
        layout.kHeight = 100;
    }];

    UIView *child2 = [UIView new];
    child2.backgroundColor = [UIColor greenColor];
    [child2 configureLayout:^(FBKLayout * _Nonnull layout) {
        layout.kWidth = 100;
        layout.kHeight = 100;
    }];

    UILabel *child3 = [UILabel new];
    child3.numberOfLines = 0;
    child3.backgroundColor = [UIColor yellowColor];
    [child3 setAttributedText:[[NSAttributedString alloc] initWithString:@"testfdsfdsfdsfdsfdsfdsafdsafdsafasdkkk" attributes:@{NSFontAttributeName :[UIFont systemFontOfSize:18]}]];
    child3.layout.isEnabled = YES;
    FBKDiv *div1 = [FBKDiv new];
    [div1 configureLayout:^(FBKLayout * _Nonnull layout) {
        layout.justifyContent = YGJustifySpaceBetween;
        layout.alignItems = YGAlignCenter;
        layout.kMarginTop = 20;
        layout.kWidth = 150;
    }];
    [div1 setChildren:@[child1,child2,child3]];

    UIView *child5 = [UIView new];
    child5.backgroundColor = [UIColor blueColor];
    [child5 configureLayout:^(FBKLayout * _Nonnull layout) {
        layout.kWidth = 50;
        layout.kMarginBottom = 10;
        layout.flexGrow = 1.0;
    }];

    UIView *child6 = [UIView new];
    child6.backgroundColor = [UIColor greenColor];
    [child6 configureLayout:^(FBKLayout * _Nonnull layout) {
        layout.kMargin = 10;
        layout.kWidth = 50;
        layout.flexGrow = 2.0;
    }];

    UIView *child7 = [UIView new];
    child7.backgroundColor = [UIColor yellowColor];
    [child7 configureLayout:^(FBKLayout * _Nonnull layout) {
        layout.kMarginBottom = 10;
        layout.kWidth = 50;
        layout.flexGrow = 1.0;
    }];

    UIView *child8 = [UIView new];
    child8.backgroundColor = [UIColor blackColor];

    [child8 configureLayout:^(FBKLayout * _Nonnull layout) {
        layout.kMarginBottom = 10;
        layout.kWidth = 50;
        layout.flexGrow = 1.0;
    }];

    FBKDiv *div2 = [FBKDiv new];
    [div2 configureLayout:^(FBKLayout * _Nonnull layout) {
        layout.justifyContent = YGJustifySpaceAround;
        layout.alignItems = YGAlignCenter;
        layout.kMarginTop = 20;
        layout.kWidth = 50;
        layout.kHeight = 800;
    }];
    [div2 setChildren:@[child5,child6,child7,child8]];

    FBKDiv *root = [FBKDiv new];
    [root configureLayout:^(FBKLayout * _Nonnull layout) {
        layout.flexDirection = YGFlexDirectionRow;
        layout.justifyContent = YGJustifySpaceAround;
        layout.alignItems = YGAlignCenter;
    }];
    [root setChildren:@[div1,div2]];
    contentView.contentDiv = root;
    [contentView.layout applyLayoutPreservingOrigin:NO];

备注 (remark)

  • 请使用addChild取代addSubview
    Please Use addChild to replace addSubview
  • kWidth kMargin … layout.kWidth = 10 等同于(equals) layout.width = YGPointValue(10)

2. 绝对布局(absolute layout)

FlexBox中position=absolute的使用

(Absolute layout of FlexBox)

    UIView *view5 = [UIView new];
    view5.backgroundColor = [UIColor orangeColor];
    //绝对布局 absolute layout
    [view5 configureLayout:^(FBKLayout * _Nonnull layout) {
        layout.position = YGPositionTypeAbsolute;
        layout.kLeft = 10;
        layout.kTop = 64;
        layout.kWidth = 100;
        layout.kHeight = 100;
    }];
    [root addChild:view5];
    [root.layout applyLayoutPreservingOrigin:NO];

3. UITableView+FBLayout

自动cell高度计算

(UITableView+FBLayout is category of UITableView. It support auto cell height of FBLayout and easy use.)

 [self.tableView fb_setCellContnetViewBlockForIndexPath:^UIView *(NSIndexPath *indexPath) {
    return [[FBKFeedView alloc]initWithModel:weakSelf.sections[indexPath.section][indexPath.row]];
  }];

....

- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {
  return [self.tableView fb_heightForIndexPath:indexPath];
}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
  return [self.tableView fb_cellForIndexPath:indexPath];
}

4. UIScrollView+FBKit

自动contentSize计算

(It support auto content size)

    FBKDiv *root = [FBKDiv new];
    [root configureLayout:^(FBKLayout * _Nonnull layout) {
        layout.flexDirection = YGFlexDirectionRow;
        layout.justifyContent = YGJustifySpaceAround;
        layout.alignItems = YGAlignCenter;
    }];
    [root setChildren:@[div1,div2]];
    contentView.contentDiv = root;

5. Flexbox container properties

5.1 flex-direction

This property specifies how flex items are laid out in the flex container, by setting the direction of the flex container’s main axis. They can be laid out in two main directions, like rows horizontally or like columns vertically.

YGFlexDirectionRow;

ROW

YGFlexDirectionRowReverse;

RowReverse

YGFlexDirectionColumn;

Colum

YGFlexDirectionColumnReverse;

ColumReverse

5.2 flex-wrap

The initial flexbox concept is the container to set its items in one single line. The flex-wrap property controls if the flex container lay out its items in single or multiple lines, and the direction the new lines are stacked in.Supports only ‘nowrap’ (which is the default) or ‘wrap’

YGWrapNoWrap;

noWrap

YGWrapWrap;

noWrap

5.3 justify-content

The justify-content property aligns flex items along the main axis of the current line of the flex container. It helps distribute left free space when either all the flex items on a line are inflexible, or are flexible but have reached their maximum size.

YGJustifyFlexStart;

JustifyFlexStart

YGJustifyCenter;

JustifyFlexStart

YGJustifyFlexEnd

JustifyFlexStart

YGJustifySpaceBetween;

JustifyFlexStart

YGJustifySpaceAround;

JustifyFlexStart

5.4 align-items

Flex items can be aligned in the cross axis of the current line of the flex container, similar to justify-content but in the perpendicular direction. This property sets the default alignment for all flex items, including the anonymous ones.

YGAlignFlexStart;

CSSAlignFlexStart

YGAlignCenter;

CSSAlignCenter

YGAlignFlexEnd;

CSSAlignFlexEnd

YGAlignStretch;

CSSAlignStretch

5.5 align-content

The align-content property aligns a flex container’s lines within the flex container when there is extra space in the cross-axis, similar to how justify-content aligns individual items within the main-axis.

YGAlignFlexStart;

CSSAlignFlexStart

YGAlignCenter;

CSSAlignFlexStart

YGAlignFlexEnd;

CSSAlignFlexStart

YGAlignStretch;

CSSAlignFlexStart

6. Flexbox item properties

6.1 flex-grow

This property specifies the flex grow factor, which determines how much the flex item will grow relative to the rest of the flex items in the flex container when positive free space is distributed.

FlexGrow;

FlexGrow-1.0

FlexGrow-3.0

6.2 flex-shrink

The flex-shrink specifies the flex shrink factor, which determines how much the flex item will shrink relative to the rest of the flex items in the flex container when negative free space is distributed.

By default all flex items can be shrunk, but if we set it to 0 (don’t shrink) they will maintain the original size

FlexShrink;

flex-shrink

6.3 flex-basis

This property takes the same values as the width and height properties, and specifies the initial main size of the flex item, before free space is distributed according to the flex factors.

FlexBasis:350;

flex-basis

6.4 align-self

This align-self property allows the default alignment (or the one specified by align-items) to be overridden for individual flex items. Refer to align-items explanation for flex container to understand the available values.

YGAlignFlexStart;

align-self

作者

will

感谢

该项目是基于YogaKit 的二次封装,基本保留了YogaKit的所有特点,同时参照FlexBoxLayout,将virtual Div以及TableView的cache机制引入,所以项目中很多FlexBoxLayout项目的影子在,甚至很多都未做修改(拿来主义),在此感谢@carlSQ,同时感谢Facebook对yoga的开源。

协议

FlexBoxKit

FlexBoxKit 基于 MIT 协议进行分发和使用,更多信息参见协议文件。
MIT License

Copyright (c) 2018 will

Latest podspec

{
    "name": "FlexBoxKit",
    "version": "0.1.2",
    "summary": "iOS Flexbox layout Kit",
    "description": "iOS Flexbox layout Kit.",
    "homepage": "https://github.com/fengshanjian/FlexBoxKit",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": "will",
    "source": {
        "git": "https://github.com/fengshanjian/FlexBoxKit.git",
        "tag": "0.1.2"
    },
    "platforms": {
        "ios": "8.0"
    },
    "ios": {
        "frameworks": "UIKit"
    },
    "source_files": "FlexBoxKit/Source/*.{h,m,swift}",
    "dependencies": {
        "Yoga": [
            "~> 1.8"
        ]
    }
}

Pin It on Pinterest

Share This