CryptoBar 原生 UI 技巧:NSVisualEffectView 毛玻璃背景、自定义表格行与实时搜索过滤
CryptoBar 原生 UI 技巧:NSVisualEffectView 毛玻璃背景、自定义表格行与实时搜索过滤
CryptoBar 是一款轻量级的 macOS 菜单栏加密货币行情应用,基于 CoinGecko API 实时展示比特币、以太坊等币种的现价与 24 小时涨跌。本文拆解它的三套原生 UI 技巧:NSVisualEffectView 毛玻璃背景、自定义表格行和实时搜索过滤,全部基于 Objective-C + AppKit 实现,思路可直接复用到你自己的 Mac 小工具中。
一、NSVisualEffectView 毛玻璃背景:打造系统原生菜单面板
点开 CryptoBar 面板时,那种和 macOS 原生下拉菜单一致的半透明模糊效果,靠的就是 NSVisualEffectView 这个系统组件。它在 CoinViewController.m 的 buildUI 方法中配置,关键只有三行属性:
blur.material = NSVisualEffectMaterialHUDWindow; // HUD 材质,最接近系统菜单质感
blur.blendingMode = NSVisualEffectBlendingModeBehindWindow; // 对窗口"背后"内容做模糊
blur.state = NSVisualEffectStateActive; // 始终保持激活,避免变灰
三个配置各有讲究:
| 属性 | 取值 | 作用 |
|---|---|---|
material |
NSVisualEffectMaterialHUDWindow |
HUD 材质,是系统通知/快捷操作窗口的同款质感 |
blendingMode |
BehindWindow |
模糊窗口后方的桌面内容,面板看起来像"长在桌面上" |
state |
Active |
防止失焦时材质变淡,视觉一致性更好 |
再配合 autoresizingMask 让毛玻璃层随面板 420×650 的窗口尺寸(见 loadView)自动拉伸,搜索框、滚动列表全部作为子视图加在模糊层之上,就得到了与系统浑然一体的面板。🪟
💡 提示:菜单栏应用的"下拉面板"几乎都是 NSPopover + NSVisualEffectView 的组合,这套配置是最常用的一套。
二、自定义表格行:74 像素高的行情卡片
CryptoBar 的币种列表不是简单的"名称 + 价格"两列表格,而是用 NSTableView 的自定义单元格视图把每行做成一张信息卡片。核心设置见 buildUI 中的表格部分:
self.tableView.headerView = nil; // 去掉表头
self.tableView.rowHeight = 74; // 加高行,给图标和走势图留空间
self.tableView.backgroundColor = [NSColor clearColor]; // 透出毛玻璃背景
真正的重头戏在 viewForTableColumn: 的行实现。每行从左到右依次拼装:
- 收藏星标:一个无边框
NSButton,用 SF Symbols 的star.fill/star切换实心空心,点亮的星星为系统黄色(toggleFavorite:); - 币种图标:从 App 包内
icons目录按币种符号读取 PNG,找不到就画一个橙色圆角方块兜底; - 名称与符号:币种全名用 14pt 加粗字体,符号用次要文字色弱化;
- 24 小时走势图:一个 80×34 的自绘
SparklineView; - 价格与涨跌幅:价格右对齐加粗;涨跌幅按正负值着色,涨绿跌红并加
▲/▼前缀。
其中走势图是自绘视图 SparklineView.m:先取点位的最小/最大值做归一化,把每个价格映射成 y 坐标,再用 NSBezierPath 连成折线;收尾时比较首尾价格,上涨描绿、下跌描红,一行代码都不用额外状态。⭐
数据侧由 CryptoAPI.m 单例负责:面板每 60 秒拉一次最新价格(定时刷新),图表数据每 180 秒更新一次(图表定时器),且刷新时会保留用户已有的收藏状态。
三、实时搜索过滤:NSSearchField 即时筛选币种
面板左上角内置了一个 NSSearchField(搜索框创建)。它没有数据库、没有模糊查询库,靠最朴素的方式实现"边打字边过滤":
- (void)controlTextDidChange:(NSNotification *)obj {
NSString *text = [self.searchField.stringValue lowercaseString];
for (NSDictionary *coin in self.coins) {
if ([name containsString:text] || [symbol containsString:text]) {
[self.filteredCoins addObject:coin];
}
}
[self.tableView reloadData];
}
技巧拆解(完整逻辑见 controlTextDidChange:):
- 双字段匹配:同时匹配币种
name和symbol,输入TRX或Tron都能命中; - 统一小写:用户输入与匹配字段都转小写,避免大小写漏匹配;
- 双数据源:原始数据存
coins,过滤结果存filteredCoins,表格数据源只读后者,互不干扰; - 收藏置顶:每次过滤后按
favorite字段排序(refreshFilteredCoins),点亮的币种永远排在最上面。
下图是在搜索框输入 TRX 后的过滤效果,Tron 被即时筛出:
四、关键源码路径速览
| 模块 | 路径 | 说明 |
|---|---|---|
| 面板控制器 | CoinViewController.m | 毛玻璃背景、表格行、搜索过滤、收藏 |
| 走势图视图 | SparklineView.m | 24h 迷你折线图自绘 |
| 行情数据 | CryptoAPI.m | CoinGecko 拉取、定时刷新、图表缓存 |
| 应用入口 | AppDelegate.m | NSStatusItem 菜单栏图标 |
| 中文说明 | README.zh-CN.md | 功能介绍与安装方式 |
小结
CryptoBar 用不到 700 行 Objective-C,演示了一个 macOS 原生小工具的完整 UI 套路:NSVisualEffectView 负责"像系统",NSTableView 自定义单元格负责"信息密度",NSSearchField + 双数据源负责"即用即查"。三招都不依赖第三方库,照着 CoinViewController.m 的结构抄改,就能做出属于你自己的菜单栏工具。

