hideLoading
接口说明
hideLoading:options: 用于隐藏当前正在展示的加载提示组件。
通常该接口与 showLoading:options: 配合使用,在异步任务完成、请求结束或发生错误后调用,用于关闭页面上的 loading 提示。
类型声明
objectivec
@interface SUDOPHideLoadingOptions : NSObject
@property(nonatomic, assign) BOOL noConflict;
@end方法声明
objectivec
/**
Hides the currently displayed loading indicator.
@param stateHandle The state handle object that manages the operation state and callbacks.
@param options The options configuration for hiding the loading indicator (e.g., animated or not).
*/
- (void)hideLoading:(id<SUDOPStateHandle>)stateHandle
options:(SUDOPHideLoadingOptions *)options;参数说明
SUDOPHideLoadingOptions
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
noConflict | BOOL | 否 | 是否启用非冲突隐藏策略。具体行为以 SDK 实现为准,通常用于避免隐藏其他业务或其他调用方正在展示的 loading。 |
方法参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
stateHandle | id<SUDOPStateHandle> | 是 | 状态句柄对象,用于管理当前操作状态及回调。 |
options | SUDOPHideLoadingOptions * | 是 | 隐藏 loading 的配置对象。 |
使用示例
objectivec
id<SUDOPStateHandle> stateHandle = self.stateHandle;
SUDOPHideLoadingOptions *options = [[SUDOPHideLoadingOptions alloc] init];
options.noConflict = YES;
[self hideLoading:stateHandle options:options];常见配合用法
objectivec
id<SUDOPStateHandle> stateHandle = self.stateHandle;
SUDOPShowLoadingOptions *showOptions = [[SUDOPShowLoadingOptions alloc] init];
showOptions.mask = YES;
showOptions.title = @"加载中...";
[self showLoading:stateHandle options:showOptions];
// 异步任务完成后隐藏 loading
SUDOPHideLoadingOptions *hideOptions = [[SUDOPHideLoadingOptions alloc] init];
hideOptions.noConflict = YES;
[self hideLoading:stateHandle options:hideOptions];处理流程
- 当前页面或全局环境中已存在通过
showLoading:options:展示的 loading。 - 业务侧创建
SUDOPHideLoadingOptions对象。 - 根据需要设置
noConflict。 - 调用
hideLoading:options:。 - SDK 隐藏当前正在展示的 loading 提示。
- 通过状态回调返回执行结果或异常信息。
注意事项
hideLoading:options:通常应在showLoading:options:之后调用。stateHandle不应为空,否则 SDK 可能无法正确管理当前操作状态或回调。options不应为空。- 如果当前没有正在展示的 loading,调用该方法可能不会产生可见效果。
noConflict的具体语义需要以 SDK 实际实现为准;如果 SDK 支持多 loading 场景,该字段可能用于避免误隐藏其他调用上下文中的 loading。- 建议在异步任务的成功、失败、取消等分支中都调用隐藏 loading,避免 loading 残留。
- 该方法无同步返回值,隐藏结果或异常信息应以 SDK 回调或状态回调为准。
