• UIKit
  • SDK
  • サーバー API
Chat/
UIKit/
iOS and macOS/
Build Basic Interfaces/
UIKit
  • Overview
  • Run Demo
  • 開始
  • インストール
    • TUIKit
    • TUIChat のみ
  • Build Basic Interfaces
    • Chat
    • Conversation List
    • Contact List
    • Add Contact
    • Create Group Chat
    • Video and Audio Call
  • Features
    • 反応
    • Quote
    • 既読レシート
    • ユーザーのオンライン状態
    • Translation
    • Voice to Text
    • メッセージ検索
  • カスタマイズ
    • メッセージのカスタマイズ
    • 絵文字とステッカーのカスタマイズ
  • ローカライズ
  • Changelog
  • Guideline for Beginners
  • コンソールガイド
    • アプリケーションの作成とアップグレード
    • 基本設定
    • 機能設定
    • アカウント管理
    • グループ管理
    • コールバック設定
  • 製品紹介
    • メッセージ管理
      • シングルチャットメッセージ
      • メッセージの保存
      • オフラインプッシュ
      • グループメッセージ
      • メッセージフォーマット
    • アカウントシステム
      • ログイン認証
      • オンライン状態管理
    • グループ関連
      • グループシステム
      • グループ管理
    • ユーザープロファイルとリレーションシップチェーン
      • 資料管理
      • リレーションシップチェーン管理
  • 購入ガイド
    • 課金の概要
    • 価格
  • エラーコード
このページは現在英語版のみで提供されており、日本語版も近日中に提供される予定です。ご利用いただきありがとうございます。

Contact List

This article will guide you in building a contact interface.

Display Effect

If you haven't added any contacts beforehand, the loaded contact interface will be empty. After adding contacts, the contacts will be displayed in the interface list, as shown below:
Contact list is empty
Contact list is not empty



Environment Requirements

Xcode 10 or later
iOS 9.0 or later

Preconditions

Before building the interface, please ensure that you have completed the following 4 things:
1. Created an application in the console.
2. Created some user accounts in the console.
3. Integrated TUIKit or TUIContact.
4. Called the TUILogin login API to log in to the component.
Note:
1. All components use this log in to API. Just log in once every time the application is launched.
2. Please ensure a successful log in to proceed, we recommend performing the following actions in the callback for a successful log in to.
If you haven't completed the above 4 steps, please refer to the corresponding steps in Getting Started first, otherwise you may encounter obstacles when implementing the following features.
If you have already completed them, please continue reading below.

Step Instructions

To display the contacts interface, simply create a TUIContactController object and display it.
Sample code:
Minimalist version
Classic version
#import "TUIContactController_Minimalist.h"

// ContactController is your own ViewController
@implementation ContactController
- (void)viewDidLoad {
// Create TUIContactController_Minimalist
TUIContactController_Minimalist *vc = [[TUIContactController_Minimalist alloc] init];
// Option 1: push vc.
[self.navigationController pushViewController:vc animated:YES];
// Option 2: add vc to your own ViewController.
// [self addChildViewController:vc];
// [self.view addSubview:vc.view];
}
@end
#import "TUIContactController.h"

// ContactController is your own ViewController
@implementation ContactController
- (void)viewDidLoad {
// Create TUIContactController
TUIContactController *vc = [[TUIContactController alloc] init];
// Option 1: push vc.
[self.navigationController pushViewController:vc animated:YES];
// Option 2: add vc to your own ViewController.
// [self addChildViewController:vc];
// [self.view addSubview:vc.view];
}
@end
The features of the contacts interface are divided as shown below:

TUIContact handles click actions in this interface by default, as follows:
Action
Effect
Click on New Contacts
Display pending friend requests
Click on Group Chats
Display all group chats for the currently logged-in account
Click on Blocked List
Display the blocklist for the currently logged-in account
Click on the contact's avatar
Enter the Contact Management interface
Click on the + sign at the top right of the interface
A pop-up menu with Add to Contacts and Add Group
In it, by clicking on the contact's avatar, clicking Add to Contacts, and clicking on Group Chats, you can customize the behavior by implementing the methods in TUIContactControllerListener
Minimalist version
Classic version
@protocol TUIContactControllerListener_Minimalist <NSObject>
@optional
- (void)onSelectFriend:(TUICommonContactCell *)cell;
- (void)onAddNewFriend:(TUICommonTableViewCell *)cell;
- (void)onGroupConversation:(TUICommonTableViewCell *)cell;
@end
@protocol TUIContactControllerListener <NSObject>
@optional
- (void)onSelectFriend:(TUICommonContactCell *)cell;
- (void)onAddNewFriend:(TUICommonTableViewCell *)cell;
- (void)onGroupConversation:(TUICommonTableViewCell *)cell;
@end

More practices

You can locally run the TUIKitDemo source code to explore more interface implementations.

Contact Us

If you have any questions about this article, feel free to join the Telegram Technical Group, where you will receive reliable technical support.