Files
main/Tweaks/FLEX/ObjectExplorers/Sections/Shortcuts/FLEXShortcut.h
2023-06-27 09:54:41 +02:00

72 lines
2.7 KiB
Objective-C

//
// FLEXShortcut.h
// FLEX
//
// Created by Tanner Bennett on 12/10/19.
// Copyright © 2020 FLEX Team. All rights reserved.
//
#import "FLEXObjectExplorer.h"
NS_ASSUME_NONNULL_BEGIN
/// Represents a row in a shortcut section.
///
/// The purpsoe of this protocol is to allow delegating a small
/// subset of the responsibilities of a \c FLEXShortcutsSection
/// to another object, for a single arbitrary row.
///
/// It is useful to make your own shortcuts to append/prepend
/// them to the existing list of shortcuts for a class.
@protocol FLEXShortcut <FLEXObjectExplorerItem>
- (nonnull NSString *)titleWith:(id)object;
- (nullable NSString *)subtitleWith:(id)object;
- (nullable void (^)(UIViewController *host))didSelectActionWith:(id)object;
/// Called when the row is selected
- (nullable UIViewController *)viewerWith:(id)object;
/// Basically, whether or not to show a detail disclosure indicator
- (UITableViewCellAccessoryType)accessoryTypeWith:(id)object;
/// If nil is returned, the default reuse identifier is used
- (nullable NSString *)customReuseIdentifierWith:(id)object;
@optional
/// Called when the (i) button is pressed if the accessory type includes it
- (UIViewController *)editorWith:(id)object forSection:(FLEXTableViewSection *)section;
@end
/// Provides default behavior for FLEX metadata objects. Also works in a limited way with strings.
/// Used internally. If you wish to use this object, only pass in \c FLEX* metadata objects.
@interface FLEXShortcut : NSObject <FLEXShortcut>
/// @param item An \c NSString or \c FLEX* metadata object.
/// @note You may also pass a \c FLEXShortcut conforming object,
/// and that object will be returned instead.
+ (id<FLEXShortcut>)shortcutFor:(id)item;
@end
/// Provides a quick and dirty implementation of the \c FLEXShortcut protocol,
/// allowing you to specify a static title and dynamic atttributes for everything else.
/// The object passed into each block is the object passed to each \c FLEXShortcut method.
///
/// Does not support the \c -editorWith: method.
@interface FLEXActionShortcut : NSObject <FLEXShortcut>
+ (instancetype)title:(NSString *)title
subtitle:(nullable NSString *(^)(id object))subtitleFuture
viewer:(nullable UIViewController *(^)(id object))viewerFuture
accessoryType:(nullable UITableViewCellAccessoryType(^)(id object))accessoryTypeFuture;
+ (instancetype)title:(NSString *)title
subtitle:(nullable NSString *(^)(id object))subtitleFuture
selectionHandler:(nullable void (^)(UIViewController *host, id object))tapAction
accessoryType:(nullable UITableViewCellAccessoryType(^)(id object))accessoryTypeFuture;
@end
NS_ASSUME_NONNULL_END