GMGridView 开源项目教程

GMGridView 开源项目教程

GMGridViewA performant Grid-View for iOS (iPhone/iPad) that allows sorting of views with gestures (the user can move the items with his finger to sort them) and pinching/rotating/panning gestures allow the user to play with the view and toggle from the cellview to a fullsize display.项目地址:https://gitcode.com/gh_mirrors/gm/GMGridView

1. 项目的目录结构及介绍

GMGridView 项目的目录结构如下：

GMGridView/
├── Example/
│   ├── GMGridView/
│   │   ├── GMGridView.xcodeproj
│   │   ├── GMGridView/
│   │   │   ├── MainViewController.m
│   │   │   ├── MainViewController.h
│   │   │   ├── ...
│   ├── ...
├── GMGridView/
│   ├── GMGridView/
│   │   ├── GMGridView.h
│   │   ├── GMGridView.m
│   │   ├── ...
│   ├── ...
├── .gitignore
├── LICENSE
├── README.md

目录结构介绍

• Example/: 包含项目的示例代码，展示了如何使用 GMGridView。
  • GMGridView/: 示例项目的主要目录，包含 Xcode 项目文件和示例代码。
• GMGridView/: 包含 GMGridView 的核心代码。
  • GMGridView/: 核心代码的主要目录，包含 GMGridView 的头文件和实现文件。
• .gitignore: Git 忽略文件，指定哪些文件不需要被版本控制。
• LICENSE: 项目的许可证文件，采用 MIT 许可证。
• README.md: 项目的说明文档，包含项目的基本信息和使用说明。

2. 项目的启动文件介绍

项目的启动文件位于 Example/GMGridView/GMGridView/MainViewController.m 和 MainViewController.h。

MainViewController.h

#import <UIKit/UIKit.h>

@interface MainViewController : UIViewController

@end

MainViewController.m

#import "MainViewController.h"
#import "GMGridView.h"

@interface MainViewController () <GMGridViewDataSource, GMGridViewDelegate>
{
    GMGridView *_gmGridView;
}

@end

@implementation MainViewController

- (void)viewDidLoad
{
    [super viewDidLoad];
    
    _gmGridView = [[GMGridView alloc] initWithFrame:self.view.bounds];
    _gmGridView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
    _gmGridView.backgroundColor = [UIColor whiteColor];
    [self.view addSubview:_gmGridView];
    [self.view sendSubviewToBack:_gmGridView];
    
    _gmGridView.scrollEnabled = YES;
    [_gmGridView setAlwaysBounceVertical:YES];
    _gmGridView.clipsToBounds = YES;
    
    _gmGridView.dataSource = self;
    _gmGridView.delegate = self;
}

#pragma mark - GMGridViewDataSource

- (NSInteger)numberOfItemsInGMGridView:(GMGridView *)gridView
{
    return 20;
}

- (CGSize)GMGridView:(GMGridView *)gridView sizeForItemsInInterfaceOrientation:(UIInterfaceOrientation)orientation
{
    return CGSizeMake(100, 100);
}

- (GMGridViewCell *)GMGridView:(GMGridView *)gridView cellForItemAtIndex:(NSInteger)index
{
    GMGridViewCell *cell = [gridView dequeueReusableCell];
    
    if (!cell)
    {
        cell = [[GMGridViewCell alloc] init];
        UILabel *label = [[UILabel alloc] initWithFrame:CGRectMake(0, 0, 100, 100)];
        label.text = [NSString stringWithFormat:@"%ld", (long)index];
        label.textAlignment = NSTextAlignmentCenter;
        [cell addSubview:label];
    }
    
    return cell;
}

#pragma mark - GMGridViewDelegate

- (void)GMGridView:(GMGridView *)gridView didSelectItemAtIndex:(NSInteger)index
{
    NSLog(@"Selected item at index %ld", (long)index);
}

@end

启动文件介绍

• MainViewController.h: 定义了 MainViewController 类，继承自 UIViewController。
• MainViewController.m: 实现了 MainViewController 类，初始化并配置了 GMGridView，并实现了 GMGridViewDataSource 和 GMGridViewDelegate 协议。

3. 项目的配置文件介绍

项目的配置文件主要包括

GMGridViewA performant Grid-View for iOS (iPhone/iPad) that allows sorting of views with gestures (the user can move the items with his finger to sort them) and pinching/rotating/panning gestures allow the user to play with the view and toggle from the cellview to a fullsize display.项目地址:https://gitcode.com/gh_mirrors/gm/GMGridView