Skip to content

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 ​

参数类型是否必填说明
noConflictBOOL否是否启用非冲突隐藏策略。具体行为以 SDK 实现为准,通常用于避免隐藏其他业务或其他调用方正在展示的 loading。

方法参数 ​

参数类型是否必填说明
stateHandleid<SUDOPStateHandle>是状态句柄对象,用于管理当前操作状态及回调。
optionsSUDOPHideLoadingOptions *是隐藏 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];

处理流程 ​

  1. 当前页面或全局环境中已存在通过 showLoading:options: 展示的 loading。
  2. 业务侧创建 SUDOPHideLoadingOptions 对象。
  3. 根据需要设置 noConflict。
  4. 调用 hideLoading:options:。
  5. SDK 隐藏当前正在展示的 loading 提示。
  6. 通过状态回调返回执行结果或异常信息。

注意事项 ​

  • hideLoading:options: 通常应在 showLoading:options: 之后调用。
  • stateHandle 不应为空,否则 SDK 可能无法正确管理当前操作状态或回调。
  • options 不应为空。
  • 如果当前没有正在展示的 loading,调用该方法可能不会产生可见效果。
  • noConflict 的具体语义需要以 SDK 实际实现为准;如果 SDK 支持多 loading 场景,该字段可能用于避免误隐藏其他调用上下文中的 loading。
  • 建议在异步任务的成功、失败、取消等分支中都调用隐藏 loading,避免 loading 残留。
  • 该方法无同步返回值,隐藏结果或异常信息应以 SDK 回调或状态回调为准。