/**
|
* Tencent is pleased to support the open source community by making QMUI_iOS available.
|
* Copyright (C) 2016-2021 THL A29 Limited, a Tencent company. All rights reserved.
|
* Licensed under the MIT License (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
|
* http://opensource.org/licenses/MIT
|
* Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
|
*/
|
|
//
|
// QMUIStaticTableViewCellData.h
|
// qmui
|
//
|
// Created by QMUI Team on 15/5/3.
|
//
|
|
#import <Foundation/Foundation.h>
|
#import <UIKit/UIKit.h>
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
@class QMUITableViewCell;
|
|
typedef NS_ENUM(NSInteger, QMUIStaticTableViewCellAccessoryType) {
|
QMUIStaticTableViewCellAccessoryTypeNone,
|
QMUIStaticTableViewCellAccessoryTypeDisclosureIndicator,
|
QMUIStaticTableViewCellAccessoryTypeDetailDisclosureButton,
|
QMUIStaticTableViewCellAccessoryTypeCheckmark,
|
QMUIStaticTableViewCellAccessoryTypeDetailButton,
|
QMUIStaticTableViewCellAccessoryTypeSwitch,
|
};
|
|
/**
|
* 一个 cellData 对象用于存储 static tableView（例如设置界面那种列表） 列表里的一行 cell 的基本信息，包括这个 cell 的 class、text、detailText、accessoryView 等。
|
* @see QMUIStaticTableViewCellDataSource
|
*/
|
@interface QMUIStaticTableViewCellData : NSObject
|
|
/// 当前 cellData 的标志，一般同个 tableView 里的每个 cellData 都会拥有不相同的 identifier
|
@property(nonatomic, assign) NSInteger identifier;
|
|
/// 当前 cellData 所对应的 indexPath
|
@property(nonatomic, strong, readonly, nullable) NSIndexPath *indexPath;
|
|
/// cell 要使用的 class，默认为 QMUITableViewCell，若要改为自定义 class，必须是 QMUITableViewCell 的子类
|
@property(nonatomic, assign) Class cellClass;
|
|
/// init cell 时要使用的 style
|
@property(nonatomic, assign) UITableViewCellStyle style;
|
|
/// cell 的高度，默认为 TableViewCellNormalHeight
|
@property(nonatomic, assign) CGFloat height;
|
|
/// cell 左边要显示的图片，将会被设置到 cell.imageView.image
|
@property(nonatomic, strong, nullable) UIImage *image;
|
|
/// cell 的文字，将会被设置到 cell.textLabel.text
|
@property(nonatomic, copy, nullable) NSString *text;
|
|
/// cell 的详细文字，将会被设置到 cell.detailTextLabel.text，所以要求 cellData.style 的值必须是带 detailTextLabel 类型的 style
|
@property(nonatomic, copy, nullable) NSString *detailText;
|
|
/// 会自动在 tableView:cellForRowAtIndexPath: 里调用，这样就不需要实现 cellForRow
|
@property(nonatomic, copy, nullable) void (^cellForRowBlock)(UITableView *tableView, __kindof QMUITableViewCell *cell, QMUIStaticTableViewCellData *cellData);
|
|
/// 会自动在 tableView:didSelectRowAtIndexPath: 里调用，当实现了这个属性时，didSelectTarget/didSelectAction 会失效
|
@property(nonatomic, copy, nullable) void (^didSelectBlock)(UITableView *tableView, QMUIStaticTableViewCellData *cellData);
|
|
/// 当 cell 的点击事件被触发时，要由哪个对象来接收，当实现了 didSelectBlock 时本属性无效
|
@property(nonatomic, assign, nullable) id didSelectTarget;
|
|
/// 当 cell 的点击事件被触发时，要向 didSelectTarget 指针发送什么消息以响应事件，当实现了 didSelectBlock 时本属性无效
|
/// @warning 这个 selector 接收一个参数，这个参数也即当前的 QMUIStaticTableViewCellData 对象
|
@property(nonatomic, assign, nullable) SEL didSelectAction;
|
|
/// cell 右边的 accessoryView 的类型
|
@property(nonatomic, assign) QMUIStaticTableViewCellAccessoryType accessoryType;
|
|
/// 配合 accessoryType 使用，不同的 accessoryType 需要配合不同 class 的 accessoryValueObject 使用。例如 QMUIStaticTableViewCellAccessoryTypeSwitch 要求传 @YES 或 @NO 用于控制 UISwitch.on 属性。
|
/// @warning 目前也仅支持与 QMUIStaticTableViewCellAccessoryTypeSwitch 搭配使用。
|
@property(nonatomic, strong, nullable) NSObject *accessoryValueObject;
|
|
/// 当 accessoryType 是 QMUIStaticTableViewCellAccessoryTypeDetailDisclosureButton、QMUIStaticTableViewCellAccessoryTypeDetailButton 时，点击按钮会触发这个 block，当实现了这个属性时，accessoryTarget/accessoryAction 会失效。
|
@property(nonatomic, copy, nullable) void (^accessoryBlock)(UITableView *tableView, QMUIStaticTableViewCellData *cellData);
|
|
/// 当 accessoryType 是 QMUIStaticTableViewCellAccessoryTypeSwitch 时，切换 UISwitch 开关会触发这个 block，当实现了这个属性时，accessoryTarget/accessoryAction 会失效。
|
@property(nonatomic, copy, nullable) void (^accessorySwitchBlock)(UITableView *tableView, QMUIStaticTableViewCellData *cellData, UISwitch *switcher);
|
|
/// 当 accessoryType 是 QMUIStaticTableViewCellAccessoryTypeDetailDisclosureButton、QMUIStaticTableViewCellAccessoryTypeDetailButton、QMUIStaticTableViewCellAccessoryTypeSwitch 时，可通过这两个属性来为 accessoryView 添加操作事件。
|
/// @warning 这个 selector 接收一个参数，与 didSelectAction 一样，这个参数一般情况下也是当前的 QMUIStaticTableViewCellData 对象，仅在 Switch 时会传 UISwitch 控件的实例
|
@property(nonatomic, assign, nullable) id accessoryTarget;
|
@property(nonatomic, assign, nullable) SEL accessoryAction;
|
|
|
|
+ (instancetype)staticTableViewCellDataWithIdentifier:(NSInteger)identifier
|
image:(nullable UIImage *)image
|
text:(nullable NSString *)text
|
detailText:(nullable NSString *)detailText
|
didSelectTarget:(nullable id)didSelectTarget
|
didSelectAction:(nullable SEL)didSelectAction
|
accessoryType:(QMUIStaticTableViewCellAccessoryType)accessoryType;
|
|
+ (instancetype)staticTableViewCellDataWithIdentifier:(NSInteger)identifier
|
cellClass:(Class)cellClass
|
style:(UITableViewCellStyle)style
|
height:(CGFloat)height
|
image:(nullable UIImage *)image
|
text:(nullable NSString *)text
|
detailText:(nullable NSString *)detailText
|
didSelectTarget:(nullable id)didSelectTarget
|
didSelectAction:(nullable SEL)didSelectAction
|
accessoryType:(QMUIStaticTableViewCellAccessoryType)accessoryType
|
accessoryValueObject:(nullable NSObject *)accessoryValueObject
|
accessoryTarget:(nullable id)accessoryTarget
|
accessoryAction:(nullable SEL)accessoryAction;
|
|
+ (UITableViewCellAccessoryType)tableViewCellAccessoryTypeWithStaticAccessoryType:(QMUIStaticTableViewCellAccessoryType)type;
|
@end
|
|
NS_ASSUME_NONNULL_END
|
