Files
OpenStats/Packages/OpenStatsKit/Sources/OpenStatsUI/Popover/PopoverRootView.swift
T
gentpan 51b954983b 菜单栏新增“电池”项目:电量、24 小时曲线、功耗、健康度与蓝牙设备电量
- 电池按九种风格画在菜单栏,充电中带闪电,电量低于 20% 按“高负载时着色”变红;点击弹出电池详情,主窗口同名页面复用同一视图,历史页多了电池电量曲线
- 历史库加 battery 列(旧库首次打开时 ALTER TABLE 迁移),HistoryRecorder 单独查最近 24 小时电量供弹窗使用
- BluetoothController 按需轮询蓝牙设备电量:弹窗 / 页面开着每分钟,菜单栏需要时每 5 分钟;本机信息页的蓝牙卡片改用它
- 没有电池的 Mac 上电池项目改为显示电量最低的蓝牙设备;「设置 · 菜单栏」新增“蓝牙设备电量低时提示”开关(同步文档一并带上)
- README、架构说明、更新日志与译文同步
2026-09-15 03:58:30 +05:00

286 lines
9.7 KiB
Swift

import AppKit
import Localization
import Metrics
import SwiftUI
/// 点击菜单栏单个指标弹出的窄详情。区块可在设置中逐个隐藏
struct PopoverRootView: View {
let item: MenuBarItem
@Environment(AppModel.self) private var model
@Environment(\.isSnapshot) private var isSnapshot
var body: some View {
VStack(spacing: 0) {
PopoverHeader(item: item)
.padding(.horizontal, DS.Space.s3)
.padding(.vertical, DS.Space.s2)
PageScroll {
switch item {
case .cpu: CPUPopover()
case .memory: MemoryPopover()
case .network: NetworkPopover()
case .gpu: GPUPopover()
case .disk: DiskPopover()
case .temperature, .fan: ThermalPopover(item: item)
case .battery: BatteryPopover()
}
}
.frame(maxWidth: .infinity, maxHeight: isSnapshot ? nil : .infinity, alignment: .top)
}
.frame(width: DS.Size.popoverWidth)
.frame(maxHeight: isSnapshot ? nil : .infinity, alignment: .top)
.fixedSize(horizontal: false, vertical: isSnapshot)
.background(DS.Palette.background, in: RoundedRectangle(cornerRadius: DS.Radius.xl))
.overlay {
RoundedRectangle(cornerRadius: DS.Radius.xl).strokeBorder(DS.Palette.border, lineWidth: DS.Size.stroke)
}
}
}
private struct PopoverHeader: View {
let item: MenuBarItem
@Environment(AppModel.self) private var model
var body: some View {
HStack(spacing: DS.Space.s2) {
Image(systemName: item.symbol)
.font(.system(size: DS.TextSize.sm.rawValue, weight: .semibold))
.foregroundStyle(DS.Palette.textSecondary)
.frame(width: DS.Size.iconStandalone)
Text(item.popoverTitle)
.dsFont(.base, weight: .semibold)
.foregroundStyle(DS.Palette.textPrimary)
Spacer(minLength: DS.Space.s2)
if item == .memory { PurgeMemoryButton() }
// 左边的按钮用该指标自己的图标,点进主窗口里它的页面;右边的齿轮进总设置
let page = PanelTab(item: item)
IconButton(systemName: page.symbol, help: tr("在主窗口打开“\(page.title)”")) { model.openMainWindow(page) }
IconButton(systemName: "gearshape", help: tr("设置")) { model.openSettings() }
}
}
}
// MARK: - 共用组件
/// 弹窗里的一个区块:小标题 + 内容。
/// 解释性文字不常驻界面:给 `hint` 后标题旁出现一个很淡的 ⓘ,鼠标悬停在 ⓘ 或卡片内容上才显示说明,看一遍就够的人不用一直看着它
struct SectionCard<Trailing: View, Content: View>: View {
let title: String
var hint: String?
/// 紧跟标题之后的小附件,例如数据来源的 logo
var titleAccessory: AnyView?
@ViewBuilder var trailing: Trailing
@ViewBuilder var content: Content
var body: some View {
Card(padding: DS.Space.s3, spacing: DS.Space.s2) {
HStack(spacing: DS.Space.s2) {
Text(title)
.dsFont(.xs, weight: .semibold)
.foregroundStyle(DS.Palette.textSecondary)
.lineLimit(1)
.fixedSize()
if let titleAccessory {
titleAccessory
}
if let hint {
Image(systemName: "info.circle")
.font(.system(size: DS.TextSize.xs.rawValue, weight: .medium))
.foregroundStyle(DS.Palette.textTertiary)
.help(hint)
.accessibilityLabel(hint)
}
Spacer(minLength: DS.Space.s2)
trailing
.dsFont(.xs)
.foregroundStyle(DS.Palette.textTertiary)
.lineLimit(1)
}
content
.help(optional: hint)
}
}
}
extension SectionCard where Trailing == EmptyView {
init(title: String, hint: String? = nil, @ViewBuilder content: () -> Content) {
self.init(title: title, hint: hint, trailing: { EmptyView() }, content: content)
}
}
extension View {
/// 有说明时才挂悬停提示
@ViewBuilder
func help(optional text: String?) -> some View {
if let text { help(text) } else { self }
}
}
/// 左侧标签、右侧数值的一行
struct InfoRow<Value: View>: View {
let label: String
@ViewBuilder var value: Value
var body: some View {
HStack(alignment: .firstTextBaseline, spacing: DS.Space.s3) {
Text(label)
.dsFont(.xs)
.foregroundStyle(DS.Palette.textSecondary)
.fixedSize()
Spacer(minLength: 0)
value
.dsFont(.xs, weight: .medium)
.foregroundStyle(DS.Palette.textPrimary)
.monospacedDigit()
.multilineTextAlignment(.trailing)
}
}
}
extension InfoRow where Value == Text {
init(label: String, text: String) {
self.label = label
self.value = Text(verbatim: text)
}
}
/// 点击拷贝的数值(IP、MAC 地址)
struct CopyableText: View {
let text: String
@State private var copied = false
@State private var hovering = false
var body: some View {
Button {
NSPasteboard.general.clearContents()
NSPasteboard.general.setString(text, forType: .string)
copied = true
Task {
try? await Task.sleep(for: .seconds(1.2))
copied = false
}
} label: {
Text(verbatim: copied ? tr("已拷贝") : text)
.foregroundStyle(copied ? DS.Palette.success : hovering ? DS.Palette.primary : DS.Palette.textPrimary)
.lineLimit(1)
.truncationMode(.middle)
.contentShape(Rectangle())
}
.buttonStyle(.plain)
.onHover { hovering = $0 }
.help(tr("点击拷贝"))
.disabled(text == "—")
}
}
/// 区块标题栏里的小图标按钮
struct MiniIconButton: View {
let systemName: String
let help: String
let action: () -> Void
@State private var hovering = false
var body: some View {
Button(action: action) {
Image(systemName: systemName)
.font(.system(size: DS.TextSize.xs.rawValue, weight: .semibold))
.foregroundStyle(hovering ? DS.Palette.textPrimary : DS.Palette.textSecondary)
.frame(width: DS.Size.segmentHeight, height: DS.Size.segmentHeight)
.background(hovering ? DS.Palette.surfaceHover : .clear, in: RoundedRectangle(cornerRadius: DS.Radius.sm))
.contentShape(Rectangle())
}
.buttonStyle(.plain)
.onHover { hovering = $0 }
.help(help)
.accessibilityLabel(help)
}
}
/// 区块标题栏里的刷新按钮:查询进行中换成系统的转圈,查完自动变回图标
struct RefreshButton: View {
var loading: Bool
let help: String
let action: () -> Void
var body: some View {
ZStack {
if loading {
ProgressView()
.controlSize(.small)
.accessibilityLabel(tr("正在查询…"))
} else {
MiniIconButton(systemName: "arrow.clockwise", help: help, action: action)
}
}
.frame(width: DS.Size.segmentHeight, height: DS.Size.segmentHeight)
.animation(DS.Motion.quick, value: loading)
}
}
/// 弹窗顶部的大号数值
struct HeroValue: View {
let value: String
var unit: String?
var size: DS.TextSize = .xl
var body: some View {
HStack(alignment: .firstTextBaseline, spacing: DS.Space.s1 / 2) {
Text(verbatim: value)
.dsFont(size, weight: .semibold)
.monospacedDigit()
.foregroundStyle(DS.Palette.textPrimary)
if let unit {
Text(verbatim: unit).dsFont(.xs, weight: .medium).foregroundStyle(DS.Palette.textSecondary)
}
}
.lineLimit(1)
}
}
/// 固定行数的进程列表,数据不足时用占位行,弹窗高度保持不变
struct ProcessList<Row: View>: View {
let count: Int
var rowCount = 5
var emptyText = tr("正在统计…")
@ViewBuilder var row: (Int) -> Row
var body: some View {
if count == 0 {
Text(emptyText)
.dsFont(.xs)
.foregroundStyle(DS.Palette.textTertiary)
.frame(maxWidth: .infinity, alignment: .leading)
.frame(height: Self.rowHeight)
ForEach(1..<rowCount, id: \.self) { _ in
Color.clear.frame(height: Self.rowHeight)
}
} else {
ForEach(0..<min(count, rowCount), id: \.self) { index in
row(index).frame(height: Self.rowHeight)
}
ForEach(0..<max(0, rowCount - count), id: \.self) { _ in
Color.clear.frame(height: Self.rowHeight)
}
}
}
static var rowHeight: CGFloat { DS.Size.iconInline + DS.Space.s1 }
}
struct ProcessNameLabel: View {
let icon: Image
let name: String
var body: some View {
HStack(spacing: DS.Space.s2) {
icon.resizable().frame(width: DS.Size.iconInline, height: DS.Size.iconInline)
Text(verbatim: name)
.dsFont(.xs, weight: .medium)
.foregroundStyle(DS.Palette.textPrimary)
.lineLimit(1)
Spacer(minLength: DS.Space.s2)
}
}
}