DZNEmptyDataSet - GitLite

KO | EN

gitlite — search

#react #typescript #llm #go #docker #nodejs #java #windows #cli #kubernetes #vue #security #mcp #openai

DZNEmptyDataSet

(★ 12,014)

뷰에 표시할 콘텐츠가 없을 때 빈 데이터셋을 보여주기 위한 드롭인(drop-in) UITableView/UICollectionView 슈퍼클래스 카테고리

파일 탐색기

최종 버전 다운로드 (.zip)

- - AppDelegate.h
  - AppDelegate.m
  - Application.h
  - Application.m
  - applications.json
  - DetailViewController.h
  - DetailViewController.m
  - MainViewController.h
  - MainViewController.m
  - UIColor+Hexadecimal.h
  - UIColor+Hexadecimal.m
- - AppDelegate.h
  - AppDelegate.m
  - CollectionViewController.h
  - CollectionViewController.m
  - Info.plist
  - main.m
  - SearchViewController.h
  - SearchViewController.m
  - Storyboard.storyboard
  - TableViewController.h
  - TableViewController.m
- - DZNEmptyDataSet.h
  - Info.plist
- - project.pbxproj
- - contents.xcworkspacedata
- - ApplicationsSnapshotTests.m
  - Info.plist
- - DZNEmptyDataSetTests-Bridging-Header.h
- - Manifest.lock
- Podfile
- Podfile.lock
- UIScrollView+EmptyDataSet.h
- UIScrollView+EmptyDataSet.m
.codecov.yml
.gitignore
.travis.yml
Dangerfile
DZNEmptyDataSet.podspec
Gemfile
Gemfile.lock
LICENSE
Package.swift
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/dzenbot/DZNEmptyDataSet

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd DZNEmptyDataSet

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Ruby

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Ruby bundle 명령어를 쓰려면 Ruby가 필요합니다.

bundle install

Gemfile에 명시된 루비 라이브러리를 설치합니다.

✅ bundle install이 에러 없이 끝나면 README에 안내된 실행 명령어(예: rails server)로 마저 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

DZNEmptyDataSet
=================
[![Travis](https://travis-ci.org/dzenbot/DZNEmptyDataSet.svg?branch=master)](https://travis-ci.org/dzenbot/DZNEmptyDataSet.svg?branch=master)
[![codecov](https://codecov.io/gh/dzenbot/DZNEmptyDataSet/badge.svg)](https://codecov.io/gh/dzenbot/DZNEmptyDataSet)
[![Pod Version](http://img.shields.io/cocoapods/v/DZNEmptyDataSet.svg)](http://cocoadocs.org/docsets/DZNEmptyDataSet/)
[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)
[![License](http://img.shields.io/badge/license-MIT-blue.svg)](http://opensource.org/licenses/MIT)
### 이 라이브러리를 사용하는 프로젝트
[이곳 목록에 여러분의 프로젝트를 추가](https://github.com/dzenbot/DZNEmptyDataSet/wiki/Projects-using-DZNEmptyDataSet)하고 결과물 렌더링 화면(320px 너비)을 제공해 주세요.
### 빈 데이터 세트 패턴 (The Empty Data Set Pattern)
\*[Empty State](http://emptystat.es/)* 또는 \*[Blank Slate](http://patternry.com/p=blank-slate/)*로도 알려져 있습니다.
대부분의 애플리케이션은 콘텐츠(데이터 세트) 목록을 표시하지만, 특히 빈 계정을 가진 신규 유저의 경우 어떤 시점에는 이 목록이 비어있을 수 있습니다. 빈 화면은 현재 무슨 일이 일어나고 있는지, 오류나 버그가 발생한 것인지, 아니면 콘텐츠를 이용하기 위해 유저가 앱 내에서 무언가를 해야 하는지 명확히 알 수 없기 때문에 혼란을 줍니다.
[\*Designing For The Empty States\*](http://tympanus.net/codrops/2013/01/09/designing-for-the-empty-states/)에 관한 매우 흥미로운 아티클을 읽어보세요.
![Screenshots\_Row1](https://raw.githubusercontent.com/dzenbot/DZNEmptyDataSet/v2-swift/Examples/Applications/Screenshots/Screenshots\_row1.png)
![Screenshots\_Row2](https://raw.githubusercontent.com/dzenbot/DZNEmptyDataSet/v2-swift/Examples/Applications/Screenshots/Screenshots\_row2.png)
(\*이 스크린샷들은 v2-swift 브랜치의 'Applications' 샘플 프로젝트에서 확인할 수 있는 실제 예시입니다\*)
\*\*[Empty Data Sets](http://pttrns.com/?did=1&scid=30)\*\*은 다음과 같은 경우에 유용합니다:
\* 흰 화면을 방지하고 화면이 비어 있는 이유를 유저에게 전달합니다.
\* 행동 유도(Call to Action) (특히 온보딩 프로세스에서 유용합니다).
\* 오류 경고 창을 표시하는 것과 같은 다른 방해 요소를 방지합니다.
\* 일관성을 유지하고 사용자 경험을 개선합니다.
\* 브랜드 아이덴티티를 전달합니다.
### 기능
\* UITableView 및 UICollectionView와 호환됩니다. UISearchDisplayController 및 UIScrollView와도 호환됩니다.
\* 이미지, 타이틀 라벨, 설명 라벨, 버튼 등을 조합하여 다양한 레이아웃과 외형을 구현할 수 있습니다.
\* 더 쉬운 외형 커스텀을 위해 NSAttributedString을 사용합니다.
\* 자동 회전(auto-rotation)을 지원하며, 오토 레이아웃을 통해 테이블뷰에 콘텐츠를 자동으로 중앙 정렬합니다. 커스텀 수직 및 수평 정렬도 지원합니다.
\* 배경색 커스텀이 가능합니다.
\* 전체 테이블뷰 사각형 영역에서 탭 제스처를 허용합니다(퍼스트 리스폰더 해제나 유사한 동작에 유용합니다).
\* 더 고급 커스텀을 위해 커스텀 뷰를 허용합니다.
\* Storyboard와 호환됩니다.
\* iOS 6, tvOS 9 이상과 호환됩니다.
\* iPhone, iPad 및 Apple TV와 호환됩니다.
\* \*\*App Store 출시 준비 완료\*\*
이 라이브러리는 UITableView나 UICollectionView 클래스를 상속(extend)할 필요가 없도록 설계되었습니다. UITableViewController나 UICollectionViewController를 사용할 때도 정상적으로 작동합니다.
DZNEmptyDataSetSource와 DZNEmptyDataSetDelegate를 채택하기만 하면, 애플리케이션의 빈 상태에 대한 콘텐츠와 외형을 완벽하게 커스텀할 수 있습니다.
## 설치 (Installation)
[CocoaPods](http://cocoapods.org/?q=DZNEmptyDataSet)에서 사용할 수 있습니다.
```ruby
pod 'DZNEmptyDataSet'
```
Carthage를 사용하여 DZNEmptyDataSet을 Xcode 프로젝트에 통합하려면 `Cartfile`에 아래와 같이 명시하세요:
```ruby
github "dzenbot/DZNEmptyDataSet"
```
SPM을 사용하여 DZNEmptyDataSet을 Xcode 프로젝트에 통합하려면 `Package.swift`에 아래와 같이 명시하세요:
```ruby
.package(
url: "https://github.com/dzenbot/DZNEmptyDataSet",
.branch("master")
)
```
기존 프로젝트의 경우, "File Navigator" -> "Select Project" -> "Project Name"으로 이동하세요.

-> "Swift Packages" -> "+" -> "https://github.com/dzenbot/DZNEmptyDataSet"를 붙여넣고 타겟을 선택하여 진행합니다.
## 사용 방법
전체 문서는 [CocoaPods의 자동 생성 문서](http://cocoadocs.org/docsets/DZNEmptyDataSet/)를 방문하세요.
### 임포트 (Import)
```objc
#import "UIScrollView+EmptyDataSet.h"
```
프레임워크로 임포트하는 경우가 아니라면 다음과 같이 하세요:
```objc
#import 
```
### 프로토콜 준수 (Protocol Conformance)
datasource 및/또는 delegate를 준수합니다.
```objc
@interface MainViewController : UITableViewController 
- (void)viewDidLoad
{
[super viewDidLoad];
self.tableView.emptyDataSetSource = self;
self.tableView.emptyDataSetDelegate = self;
// 셀 구분선을 제거하기 위한 작은 팁
self.tableView.tableFooterView = [UIView new];
}
```
### 데이터 소스 구현 (Data Source Implementation)
빈 상태(empty state)에 표시할 콘텐츠를 반환하고, NSAttributedString 기능을 활용하여 텍스트 외관을 커스터마이즈하세요.
빈 상태의 이미지:
```objc
- (UIImage \*)imageForEmptyDataSet:(UIScrollView \*)scrollView
{
return [UIImage imageNamed:@"empty\_placeholder"];
}
```
빈 상태 제목의 속성 문자열:
```objc
- (NSAttributedString \*)titleForEmptyDataSet:(UIScrollView \*)scrollView
{
NSString \*text = @"Please Allow Photo Access";
NSDictionary \*attributes = @{NSFontAttributeName: [UIFont boldSystemFontOfSize:18.0f],
NSForegroundColorAttributeName: [UIColor darkGrayColor]};
return [[NSAttributedString alloc] initWithString:text attributes:attributes];
}
```
빈 상태 설명의 속성 문자열:
```objc
- (NSAttributedString \*)descriptionForEmptyDataSet:(UIScrollView \*)scrollView
{
NSString \*text = @"This allows you to share photos from your library and save photos to your camera roll.";
NSMutableParagraphStyle \*paragraph = [NSMutableParagraphStyle new];
paragraph.lineBreakMode = NSLineBreakByWordWrapping;
paragraph.alignment = NSTextAlignmentCenter;
NSDictionary \*attributes = @{NSFontAttributeName: [UIFont systemFontOfSize:14.0f],
NSForegroundColorAttributeName: [UIColor lightGrayColor],
NSParagraphStyleAttributeName: paragraph};
return [[NSAttributedString alloc] initWithString:text attributes:attributes];
}
```
지정된 버튼 상태에 사용할 속성 문자열:
```objc
- (NSAttributedString \*)buttonTitleForEmptyDataSet:(UIScrollView \*)scrollView forState:(UIControlState)state
{
NSDictionary \*attributes = @{NSFontAttributeName: [UIFont boldSystemFontOfSize:17.0f]};
return [[NSAttributedString alloc] initWithString:@"Continue" attributes:attributes];
}
```
또는 지정된 버튼 상태에 사용할 이미지:
```objc
- (UIImage \*)buttonImageForEmptyDataSet:(UIScrollView \*)scrollView forState:(UIControlState)state
{
return [UIImage imageNamed:@"button\_image"];
}
```
빈 상태의 배경 색상:
```objc
- (UIColor \*)backgroundColorForEmptyDataSet:(UIScrollView \*)scrollView
{
return [UIColor whiteColor];
}
```
더 복잡한 레이아웃이 필요한 경우, 대신 커스텀 뷰를 반환할 수 있습니다:
```objc
- (UIView \*)customViewForEmptyDataSet:(UIScrollView \*)scrollView
{
UIActivityIndicatorView \*activityView = [[UIActivityIndicatorView alloc] initWithActivityIndicatorStyle:UIActivityIndicatorViewStyleGray];
[activityView startAnimating];
return activityView;
}
```
이미지 뷰 애니메이션
```objc
- (CAAnimation \*)imageAnimationForEmptyDataSet:(UIScrollView \*)scrollView
{
CABasicAnimation \*animation = [CABasicAnimation animationWithKeyPath: @"transform"];
animation.fromValue = [NSValue valueWithCATransform3D:CATransform3DIdentity];
animation.toValue = [NSValue valueWithCATransform3D:CATransform3DMakeRotation(M\_PI\_2, 0.0, 0.0, 1.0)];
animation.duration = 0.25;
animation.cumulative = YES;
animation.repeatCount = MAXFLOAT;
return animation;
}
```
추가로, 콘텐츠 뷰의 수직 정렬을 조정할 수도 있습니다 (예: tableHeaderView가 표시되어 있을 때 유용함):
```objc
- (CGFloat)verticalOffsetForEmptyDataSet:(UIScrollView \*)scrollView
{
return -self.tableVie

w.tableHeaderView.frame.size.height/2.0f;
}
```
마지막으로, 컴포넌트 간의 간격을 분리할 수 있습니다 (기본 간격은 11 pt입니다):
```objc
- (CGFloat)spaceHeightForEmptyDataSet:(UIScrollView \*)scrollView
{
return 20.0f;
}
```
### 델리게이트 구현 (Delegate Implementation)
빈 상태(empty state)에서 기대하는 동작을 반환하고 사용자 이벤트를 수신합니다.
빈 상태를 렌더링하고 표시해야 하는지 묻습니다 (기본값은 YES):
```objc
- (BOOL)emptyDataSetShouldDisplay:(UIScrollView \*)scrollView
{
return YES;
}
```
상호작용 권한을 묻습니다 (기본값은 YES):
```objc
- (BOOL)emptyDataSetShouldAllowTouch:(UIScrollView \*)scrollView
{
return YES;
}
```
스크롤 권한을 묻습니다 (기본값은 NO):
```objc
- (BOOL)emptyDataSetShouldAllowScroll:(UIScrollView \*)scrollView
{
return YES;
}
```
이미지 뷰 애니메이션 권한을 묻습니다 (기본값은 NO):
```objc
- (BOOL) emptyDataSetShouldAllowImageViewAnimate:(UIScrollView \*)scrollView
{
return YES;
}
```
데이터셋 뷰를 탭했을 때 알려줍니다:
```objc
- (void)emptyDataSet:(UIScrollView \*)scrollView didTapView:(UIView \*)view
// 무언가 수행
}
```
데이터셋 액션 호출 버튼을 탭했을 때 알려줍니다:
```objc
- (void)emptyDataSet:(UIScrollView \*)scrollView didTapButton:(UIButton \*)button
{
// 무언가 수행
}
```
### 레이아웃 새로고침 (Refresh layout)
빈 상태 레이아웃을 새로고침해야 하는 경우, 단순히 다음을 호출하세요:
```objc
[self.tableView reloadData];
```
또는
```objc
[self.collectionView reloadData];
```
사용 중인 항목에 따라 다릅니다.
### 레이아웃 강제 업데이트 (Force layout update)
`-reloadData`를 우회하여 현재 빈 상태 레이아웃을 무효화하고 레이아웃 업데이트를 트리거하기 위해 `[self.tableView reloadEmptyDataSet]`을 호출할 수도 있습니다. 이는 불필요할 때 호출되는 것을 방지하고자 하는 데이터 소스의 로직이 많을 때 유용할 수 있습니다. `[self.scrollView reloadEmptyDataSet]`은 UIScrollView와 함께 사용할 때 콘텐츠를 새로고침할 수 있는 유일한 방법입니다.
## 예제 프로젝트 (Sample projects)
#### 애플리케이션 (Applications)
이 프로젝트는 Airbnb, Dropbox, Facebook, Foursquare 등 여러 인기 애플리케이션의 빈 상태를 정확한 콘텐츠와 외형(~20개)으로 재현합니다. 빈 상태의 외형을 커스터마이징하는 것이 얼마나 쉽고 유연한지 확인해 보세요. 이 프로젝트를 테스트를 위한 플레이그라운드로 사용할 수도 있습니다.
#### 국가 (Countries)
이 프로젝트는 CoreData에서 로드한 전 세계 국가 목록을 보여줍니다. 검색 필터링을 위해 NSFecthedResultController를 사용합니다. 검색 시 일치하는 콘텐츠가 없으면 간단한 빈 상태가 표시됩니다. 일반적인 CoreData 스택을 사용하면서 UITableViewDataSource와 DZNEmptyDataSetSource 프로토콜 간에 상호작용하는 방법을 확인해 보세요.
#### 색상 (Colors)
이 프로젝트는 스토리보드(Storyboards)를 사용하면서 이 라이브러리가 UICollectionView 및 UISearchDisplayController와 어떻게 작동하는지 보여주는 간단한 예제입니다.
## 기여 (Collaboration)
아이디어, 이슈 및/또는 풀 리퀘스트(pull requests)를 통한 기여를 언제나 환영합니다.
## 라이선스 (License)
(The MIT License)
Copyright (c) 2016 Ignacio Romero Zurbuchen iromero@dzen.cl
본 소프트웨어와 관련 문서 파일('Software')의 사본을 얻는 모든 사람에게 무료로 허가되며, 본 소프트웨어를 제한 없이 사용할 수 있는 권리, 사용, 복사, 수정, 병합, 배포, 서브라이선스 및/또는 판매할 수 있는 권리를 포함하여 소프트웨어 사본을 제공받는 사람에게도 다음 조건에 따라 제공됩니다:
위의 저작권 고지 및 이 허가 고지는 소프트웨어의 모든 사본 또는 상당 부분에 포함되어야 합니다.
본 소프트웨어는 상품성, 특정 목적에의 적합성, 비침해에 대한 보증을 포함하여 명시적이거나 묵시적인 어떠한 보증도 없이 '있는 그대로' 제공됩니다. 어떠한 경우에도 저작자나 저작권자는 계약, 불법행위 또는 기타 사유로 인해 소프트웨어와 관련하여 또는 그 사용, 거래와 관련하여 발생하는 어떠한 청구, 손해 또는 기타 책임에 대해서도 책임을 지지 않습니다.