15项定制配置完整清单把EZLoadingActivity的配色、字体与成功图标改成你的App专属主题【免费下载链接】EZLoadingActivity:hatching_chick: Lightweight Swift loading activity for iOS7项目地址: https://gitcode.com/gh_mirrors/ez/EZLoadingActivityEZLoadingActivity是一款用 Swift 编写的轻量级 iOS 加载动画库只需一行代码就能在 App 中弹出加载对话框。它内置了15 项定制配置可以让你轻松完成 loading 动画配色修改、字体更换与成功图标自定义把默认的深色加载框变成完全贴合品牌视觉的专属主题。本文一次性讲全这 15 个配置项并附上最常见的避坑指南。快速上手一行代码显示加载动画先把代码下载到项目里最简单的安装方式把 EZLoadingActivity.swift 拖入 Xcode 工程即可支持 iOS 7然后调用EZLoadingActivity.show(Loading..., disableUI: true)disableUI: true会锁定用户交互防止加载过程中误触。任务完成后调用EZLoadingActivity.hide(success: true, animated: true)即可关闭——传success: true会显示成功图标false则显示失败图标不传参数则直接消失。 官方演示 App 中就是这样用的EZLoadingActivity/ViewController.swift 里的按钮点击后延迟 3 秒自动隐藏。定制配置在哪里改所有 15 项配置都集中在源文件 EZLoadingActivity.swift 的Settings结构体里。它们都是静态变量在调用 show 之前赋值一次即可全局生效无需创建任何实例EZLoadingActivity.Settings.SuccessColor .systemBlue EZLoadingActivity.show(Fetching..., disableUI: false)下面按用途分成 5 组逐项说明。一、配色组4 个颜色让加载框跟随品牌色 配置项默认值作用BackgroundColor深灰蓝50% 透明度加载框整体背景色ActivityColor暗金色旋转 spinner 的颜色TextColor米白色提示文字的颜色SuccessColor/FailColor绿色 / 橙红色成功与失败图标的颜色默认配色见 EZLoadingActivity.swift。想让 loading 动画配色与 App 品牌一致改这三行就够了EZLoadingActivity.Settings.BackgroundColor UIColor.black.withAlphaComponent(0.7) EZLoadingActivity.Settings.ActivityColor .systemBlue EZLoadingActivity.Settings.TextColor .whiteSuccessColor和FailColor的默认值定义在 EZLoadingActivity.swift。二、字体与图标组3 项决定长相 ✒️配置项默认值说明FontNameCochin-BoldItalic加载文字和图标的字体名SuccessIcon✔︎成功时显示的字符图标FailIcon✘失败时显示的字符图标源码位置见 EZLoadingActivity.swift。图标其实就是字符源码注释里列出了可选的变体✓ ✔︎ ✕ ✖︎ ✘。想更有辨识度也可以直接换成 emojiEZLoadingActivity.Settings.FontName PingFangSC-Semibold EZLoadingActivity.Settings.SuccessIcon ⚠️注意FontName必须是项目里已加载的字体名填错会回退到系统默认字体不报错但不生效——这是新手最常踩的坑。三、文字组提示文案本地化 配置项默认值说明SuccessTextSuccess成功时文字区域显示的内容FailTextFailure失败时文字区域显示的内容定义在 EZLoadingActivity.swift。中文 App 建议改成成功/加载失败配合上面的FontName设为中文字体显示效果最佳。四、尺寸组宽高的自动适配逻辑 配置项默认逻辑说明ActivityWidth屏幕宽度 ÷ 1.6iPhone加载框宽度ActivityHeight宽度的 1/3加载框高度源码见 EZLoadingActivity.swift。这里有个聪明的设计内部的WidthDivision属性会自动识别设备——iPhone 上宽度约为屏幕的 1/1.6iPad 上则约为 1/3.5避免加载框在平板上撑满全屏。一般无需手动改宽高若需要更紧凑的对话框在 show 之前重设ActivityWidth即可高度会联动调整。五、行为组3 个开关控制呈现方式 ⚙️配置项默认值说明ShadowEnabledtrue是否显示圆角阴影LoadOverApplicationWindowfalse是否挂在 App 窗口层级上DarkensBackgroundfalse是否压暗背景定义在 EZLoadingActivity.swift。典型用法DarkensBackground true加载时背景渐变为半透明黑视觉更聚焦适合表单提交、支付等关键操作。LoadOverApplicationWindow true分屏或复杂导航结构下让加载框浮在整个 App 窗口之上官方 README 专门提到了 Split View 场景参考 README.md。ShadowEnabled false关闭阴影适合扁平化设计风格。15 项配置速查表#配置项默认值分组1BackgroundColor深灰蓝 50% 透明配色2ActivityColor暗金色配色3TextColor米白色配色4SuccessColor绿色配色5FailColor橙红色配色6FontNameCochin-BoldItalic字体图标7SuccessIcon✔︎字体图标8FailIcon✘字体图标9SuccessTextSuccess文字10FailTextFailure文字11ActivityWidth屏宽 ÷ 1.6iPhone尺寸12ActivityHeight宽度 ÷ 3尺寸13ShadowEnabledtrue行为14LoadOverApplicationWindowfalse行为15DarkensBackgroundfalse行为完整清单也可对照 README.md 的官方设置表。实战三步打造 App 专属主题 假设你的 App 主色是蓝色、字体是苹方把下面片段放在AppDelegate或首个界面中执行一次EZLoadingActivity.Settings.BackgroundColor UIColor(red: 20/255, green: 24/255, blue: 39/255, alpha: 0.6) EZLoadingActivity.Settings.ActivityColor .systemBlue EZLoadingActivity.Settings.TextColor .white EZLoadingActivity.Settings.FontName PingFangSC-Medium EZLoadingActivity.Settings.SuccessIcon EZLoadingActivity.Settings.SuccessText 完成 EZLoadingActivity.Settings.FailText 加载失败 EZLoadingActivity.Settings.DarkensBackground true之后全 App 任何位置调用show/hide加载框都会呈现这套专属主题无需重复设置。新手避坑清单 ⚠️同时只能有一个加载框——重复调用show会打印警告并返回false先hide再重新显示。别在viewDidLoad里调用——此时视图层级尚未就绪源码会提示改用viewDidAppear见 EZLoadingActivity.swift。字体名要准确——用错字体名不会报错只是静默回退到默认字体。配置在 show 之前设置——Settings是读取型静态变量show 之后修改不会更新已显示的加载框。总结EZLoadingActivity 把加载动画的所有定制点都收敛在 EZLoadingActivity.swift 的Settings结构体中5 个颜色管色彩3 项管字体图标2 项管文案2 项管尺寸3 个开关管呈现行为。掌握这份 15 项完整清单你的 iOS 加载动画就能从千篇一律变成 App 的专属名片。项目采用 MIT 协议见 LICENSE可放心用于商业项目。【免费下载链接】EZLoadingActivity:hatching_chick: Lightweight Swift loading activity for iOS7项目地址: https://gitcode.com/gh_mirrors/ez/EZLoadingActivity创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考