企业官网建设流程全解析

15项定制配置完整清单：把EZLoadingActivity的配色、字体与成功图标改成你的App专属主题

【免费下载链接】EZLoadingActivity:hatching_chick: Lightweight Swift loading activity for iOS7+项目地址: https://gitcode.com/gh_mirrors/ez/EZLoadingActivity

🎯EZLoadingActivity是一款用 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 个颜色让加载框跟随品牌色 🎨

默认配色见 EZLoadingActivity.swift。想让 loading 动画配色与 App 品牌一致，改这三行就够了：

EZLoadingActivity.Settings.BackgroundColor = UIColor.black.withAlphaComponent(0.7) EZLoadingActivity.Settings.ActivityColor = .systemBlue EZLoadingActivity.Settings.TextColor = .white

SuccessColor和FailColor的默认值定义在 EZLoadingActivity.swift。

二、字体与图标组：3 项决定"长相" ✒️

源码位置见 EZLoadingActivity.swift。图标其实就是"字符"，源码注释里列出了可选的变体：✓ ✔︎ ✕ ✖︎ ✘。想更有辨识度，也可以直接换成 emoji：

EZLoadingActivity.Settings.FontName = "PingFangSC-Semibold" EZLoadingActivity.Settings.SuccessIcon = "🏆"

⚠️注意：FontName必须是项目里已加载的字体名，填错会回退到系统默认字体，不报错但不生效——这是新手最常踩的坑。

三、文字组：提示文案本地化 📝

定义在 EZLoadingActivity.swift。中文 App 建议改成"成功"/"加载失败"，配合上面的FontName设为中文字体，显示效果最佳。

四、尺寸组：宽高的自动适配逻辑 📐

源码见 EZLoadingActivity.swift。这里有个聪明的设计：内部的WidthDivision属性会自动识别设备——iPhone 上宽度约为屏幕的 1/1.6，iPad 上则约为 1/3.5，避免加载框在平板上撑满全屏。一般无需手动改宽高；若需要更紧凑的对话框，在 show 之前重设ActivityWidth即可，高度会联动调整。

五、行为组：3 个开关控制呈现方式 ⚙️

定义在 EZLoadingActivity.swift。典型用法：

• DarkensBackground = true：加载时背景渐变为半透明黑，视觉更聚焦，适合表单提交、支付等关键操作。
• LoadOverApplicationWindow = true：分屏或复杂导航结构下，让加载框浮在整个 App 窗口之上，官方 README 专门提到了 Split View 场景，参考 README.md。
• ShadowEnabled = false：关闭阴影，适合扁平化设计风格。

15 项配置速查表

完整清单也可对照 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，加载框都会呈现这套专属主题，无需重复设置。

新手避坑清单 ⚠️

1. 同时只能有一个加载框——重复调用show会打印警告并返回false，先hide再重新显示。
2. 别在viewDidLoad里调用——此时视图层级尚未就绪，源码会提示改用viewDidAppear（见 EZLoadingActivity.swift）。
3. 字体名要准确——用错字体名不会报错，只是静默回退到默认字体。
4. 配置在 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