CryptoBar 原生 UI 技巧:NSVisualEffectView 毛玻璃背景、自定义表格行与实时搜索过滤

原创2026-10-11 17:28:461,638 阅读

CryptoBar 原生 UI 技巧:NSVisualEffectView 毛玻璃背景、自定义表格行与实时搜索过滤

CryptoBar 是一款轻量级的 macOS 菜单栏加密货币行情应用,基于 CoinGecko API 实时展示比特币、以太坊等币种的现价与 24 小时涨跌。本文拆解它的三套原生 UI 技巧:NSVisualEffectView 毛玻璃背景、自定义表格行和实时搜索过滤,全部基于 Objective-C + AppKit 实现,思路可直接复用到你自己的 Mac 小工具中。

CryptoBar macOS 菜单栏加密货币价格面板毛玻璃界面


一、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: 的行实现。每行从左到右依次拼装:

  1. 收藏星标:一个无边框 NSButton,用 SF Symbols 的 star.fill / star 切换实心空心,点亮的星星为系统黄色(toggleFavorite:);
  2. 币种图标:从 App 包内 icons 目录按币种符号读取 PNG,找不到就画一个橙色圆角方块兜底;
  3. 名称与符号:币种全名用 14pt 加粗字体,符号用次要文字色弱化;
  4. 24 小时走势图:一个 80×34 的自绘 SparklineView;
  5. 价格与涨跌幅:价格右对齐加粗;涨跌幅按正负值着色,涨绿跌红并加 ▲/▼ 前缀。

其中走势图是自绘视图 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 被即时筛出:

CryptoBar 搜索过滤加密货币币种 TRX 行情面板

四、关键源码路径速览

模块 路径 说明
面板控制器 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 的结构抄改,就能做出属于你自己的菜单栏工具。

登录后查看全文
crypto-bar-mac