183 lines
4.4 KiB
Objective-C
183 lines
4.4 KiB
Objective-C
//
|
|
// DCUniNativeComponent.h
|
|
//
|
|
// Created by DCloud on 2020/10/12.
|
|
// Copyright © 2020 DCloud. All rights reserved.
|
|
//
|
|
|
|
#import "DCUniBasePlugin.h"
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
@interface DCUniComponent : DCUniBaseCompenent
|
|
|
|
/**
|
|
*
|
|
*
|
|
* @param ref 组件的标识
|
|
* @param type 组件的类型
|
|
* @param styles 组件的样式
|
|
* @param attributes 组件的属性
|
|
* @param events 组件的事件
|
|
* @param uniInstance 与组件关联的uniInstance
|
|
*
|
|
*/
|
|
|
|
|
|
-(void)onCreateComponentWithRef:(NSString *)ref type:(NSString *)type
|
|
styles:(NSDictionary *)styles
|
|
attributes:(NSDictionary *)attributes
|
|
events:(NSArray *)events uniInstance:(DCUniSDKInstance *)uniInstance;
|
|
|
|
/**
|
|
* @abstract The component's supercomponent.
|
|
*/
|
|
@property (nonatomic, readonly, weak, nullable) DCUniSDKInstance * uniInstance;
|
|
|
|
|
|
/**
|
|
* @abstract 该组件的子组件
|
|
*/
|
|
@property (nonatomic, readonly, strong, nullable) NSArray<DCUniComponent *> * uniSubcomponents;
|
|
|
|
|
|
/**
|
|
* @abstract 该组件的父组件
|
|
*/
|
|
@property (nonatomic, readonly, weak, nullable) DCUniComponent * uniSupercomponent;
|
|
|
|
|
|
/**
|
|
* @abstract 组件的视图
|
|
*/
|
|
@property(nonatomic, readonly, strong) UIView *view;
|
|
|
|
|
|
//View 层级相关
|
|
/**
|
|
* @abstract 从父视图中删除该组件的视图。
|
|
*
|
|
* @discussion 该方法在主线程上调用。
|
|
*/
|
|
- (void)removeFromSuperview;
|
|
|
|
|
|
|
|
// 生命周期 相关函数
|
|
/**
|
|
* @abstract 创建组件管理的视图
|
|
*
|
|
* @return 返回创建的视图
|
|
*
|
|
* @discussion 此方法加载或创建视图，并将其分配给view属性。 子类应在此处创建其自定义视图层次结构。不要直接调用该方法。
|
|
*
|
|
* @warning 对此方法的自定义实现 不要调用super
|
|
*/
|
|
|
|
- (UIView *)loadView;
|
|
|
|
/**
|
|
* @abstract 返回一个布尔值，标识视图是否加载完毕。
|
|
*/
|
|
|
|
- (BOOL)isViewLoaded;
|
|
|
|
/**
|
|
* @abstract 在加载组件视图之前调用
|
|
*
|
|
* @discussion 这是在-loadView之前。 该方法在主线程上调用。
|
|
*/
|
|
- (void)viewWillLoad;
|
|
|
|
/**
|
|
* @abstract 在加载并设置组件的视图之后调用。
|
|
*
|
|
* @discussion 这是在-loadView之后。 这是执行额外初始化的最佳时间，例如向视图添加手势识别器。该方法在主线程上调用。
|
|
*/
|
|
|
|
- (void)viewDidLoad;
|
|
|
|
/**
|
|
* @abstract 在释放组件的视图之前调用。方法在主线程上调用。
|
|
*/
|
|
|
|
|
|
- (void)viewWillUnload;
|
|
|
|
/**
|
|
* @abstract 在释放组件的视图时调用。在主线程上调用该方法。
|
|
*/
|
|
- (void)viewDidUnload;
|
|
|
|
|
|
// 向JS发消息
|
|
|
|
/**
|
|
* @abstract 向JS 中的组件触发事件。
|
|
*
|
|
* @param eventName 要触发的事件的名称
|
|
* @param params 要触发的参数
|
|
**/
|
|
- (void)fireEvent:(NSString *)eventName params:(nullable NSDictionary *)params;
|
|
|
|
/**
|
|
* @abstract 向组件触发事件，并告诉JS哪个值已更改。
|
|
* 用于双向数据绑定。
|
|
*
|
|
* @param eventName 要触发的事件的名称
|
|
* @param params 要触发的参数
|
|
* @param domChanges 值已更改，用于双向数据绑定。
|
|
**/
|
|
|
|
- (void)fireEvent:(NSString *)eventName params:(nullable NSDictionary *)params domChanges:(nullable NSDictionary *)domChanges;
|
|
|
|
|
|
// 样式相关函数
|
|
/**
|
|
* @abstract 组件样式更新时调用
|
|
*
|
|
* @param styles 更新的样式字典
|
|
* @discussion 重写来处理特定的样式更新。 该方法在主线程上调用。
|
|
**/
|
|
- (void)updateStyles:(NSDictionary *)styles;
|
|
|
|
/**
|
|
* @abstract 重置组件样式时调用
|
|
*
|
|
* @param styles 重置样式的元素
|
|
* @discussion 可以重写它来处理特定的样式重置。 该方法在主线程上调用。
|
|
**/
|
|
- (void)resetStyles:(NSArray *)styles;
|
|
|
|
|
|
// 属性相关函数
|
|
|
|
/**
|
|
* @abstract 组件属性更新时调用
|
|
*
|
|
* @param attributes 更新的属性字典
|
|
* @discussion 可以覆盖它以处理特定的属性更新。 该方法在主线程上调用。
|
|
**/
|
|
- (void)updateAttributes:(NSDictionary *)attributes;
|
|
|
|
|
|
/**
|
|
* @abstract 在向组件添加事件时调用
|
|
*
|
|
* @param eventName 添加的事件的名称
|
|
* @discussion 可以覆盖它以处理特定事件的添加。 该方法在主线程上调用。
|
|
**/
|
|
- (void)addEvent:(NSString *)eventName;
|
|
|
|
/**
|
|
* @abstract 从组件中删除事件时调用
|
|
*
|
|
* @param eventName 删除的事件的名称
|
|
* @discussion 可以重写它来处理特定的事件删除。 该方法在主线程上调用。
|
|
**/
|
|
- (void)removeEvent:(NSString *)eventName;
|
|
|
|
|
|
@end
|
|
NS_ASSUME_NONNULL_END
|