Files
douyi_guaji_main/gui/components/mapping_table_helpers.py
T
CodexandClaude Opus 4.7 053ffa3469 refactor(gui): 拆出 mapping_table.py 5 个 UI 辅助子函数(659→482,-177 行)
mapping_table.create_mapping_tab 是单个 632 行的 tkinter 闭包巨型函数,
把其中相对独立的 5 个块抽到 mapping_table_helpers:
- open_entry_detail_window:弹出条目详情(原代码出现 2 次)
- compute_card_layout:根据画布宽度计算列数和卡片宽度
- set_card_bg:批量切换 widget + 子 widget 背景色
- make_card_event_handlers:单卡片的 click/dbl/enter/leave 处理器工厂
- render_card_labels:渲染单卡片内的 title + meta + body label

逻辑保持等价,只是提取闭包消除重复嵌套。新增 8 个单元测试覆盖
compute_card_layout / API 表面,1026 → 1034 用例全过。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-22 01:51:52 +08:00

183 lines
5.4 KiB
Python

"""mapping_table 内部辅助函数。
把 mapping_table.create_mapping_tab 中重复或自包含的子块抽出来:
- 弹出条目详情窗口(在两处出现,逻辑完全一致)
- 计算自适应列数与卡片宽度
- 卡片背景色批量切换
- card hover/click/dbl 事件处理器工厂
- 渲染单张卡片内的标题 + 多行 label
"""
from __future__ import annotations
import tkinter as tk
from tkinter import ttk
from typing import Any, Callable, List, Optional
def open_entry_detail_window(
root: tk.Tk,
content: str,
scrolled_text_cls: Optional[type] = None,
) -> None:
"""打开"条目详情"弹窗。如果 ScrolledText 不可用则退化成 Label。"""
if not content:
return
win = tk.Toplevel(root)
win.title("条目详情")
try:
if scrolled_text_cls is not None:
st = scrolled_text_cls(win, width=100, height=20)
st.pack(fill=tk.BOTH, expand=True, padx=6, pady=6)
st.insert("1.0", content)
st.configure(state="disabled")
return
lbl = ttk.Label(win, text=content, justify="left")
lbl.pack(fill=tk.BOTH, expand=True, padx=6, pady=6)
except Exception:
lbl = ttk.Label(win, text=content, justify="left")
lbl.pack(fill=tk.BOTH, expand=True, padx=6, pady=6)
def compute_card_layout(canvas_width: int, min_card_w: int = 300, h_gap: int = 12,
max_columns: int = 3) -> tuple[int, int]:
"""根据画布宽度计算列数与单卡片可用宽度。
返回 (columns, card_width)。
"""
try:
columns = max(1, int((canvas_width + h_gap) / (min_card_w + h_gap)))
except Exception:
columns = 1
columns = min(columns, max_columns)
try:
col_total_gap = columns * h_gap
col_width = max(220, int((canvas_width - col_total_gap) / columns))
except Exception:
col_width = 800
return columns, col_width
def set_card_bg(widget: tk.Widget, bg: str) -> None:
"""把 widget 自身和所有直接子 widget 的背景色改为 bg。"""
try:
try:
widget.configure(**{"bg": bg})
except Exception:
widget.configure(**{"background": bg})
except Exception:
pass
for ch in widget.winfo_children():
try:
try:
ch.configure(**{"bg": bg})
except Exception:
ch.configure(**{"background": bg})
except Exception:
pass
def make_card_event_handlers(
card_index: int,
card: tk.Widget,
cards: List[tk.Widget],
last_selected: dict,
entries_text: List[str],
root: tk.Tk,
normal_bg: str,
hover_bg: str,
selected_bg: str,
scrolled_text_cls: Optional[type] = None,
) -> tuple[Callable, Callable, Callable, Callable]:
"""生成单张卡片的 click / dblclick / enter / leave 事件处理器。"""
def on_click(_e: object | None = None) -> None:
try:
for i, w in enumerate(cards):
bg = normal_bg if i != card_index else selected_bg
set_card_bg(w, bg)
last_selected["idx"] = card_index
except Exception:
pass
def on_dbl(_e: object | None = None) -> None:
try:
content = entries_text[card_index]
except Exception:
content = ""
open_entry_detail_window(root, content, scrolled_text_cls)
def on_enter(_e: object | None = None) -> None:
try:
bg = (
selected_bg if last_selected.get("idx") == card_index else hover_bg
)
set_card_bg(card, bg)
except Exception:
pass
def on_leave(_e: object | None = None) -> None:
try:
bg = (
selected_bg if last_selected.get("idx") == card_index else normal_bg
)
set_card_bg(card, bg)
except Exception:
pass
return on_click, on_dbl, on_enter, on_leave
def render_card_labels(
card: tk.Widget,
lines: List[str],
title_font: Any,
meta_font: Any,
body_font: Any,
bg: str,
wraplength: int,
show_title_raw: bool,
) -> None:
"""在单张 card 内逐行渲染 title + meta + body label。"""
if not lines:
return
# 标题行
try:
tk.Label(
card,
text=lines[0],
font=title_font,
bg=bg,
fg="#0b3d91",
anchor="w",
justify="left",
wraplength=wraplength,
).pack(fill="x", padx=10, pady=(6, 1))
except Exception:
try:
tk.Label(card, text=lines[0], bg=bg).pack(fill="x", padx=10, pady=(6, 1))
except Exception:
pass
meta_line_count = 3 if show_title_raw else 2
for li, ln in enumerate(lines[1:], start=1):
try:
is_meta = li in tuple(range(1, meta_line_count + 1))
font = meta_font if is_meta else body_font
fg = "#555555" if is_meta else "#222222"
tk.Label(
card,
text=ln,
font=font,
fg=fg,
bg=bg,
anchor="w",
justify="left",
wraplength=wraplength,
).pack(fill="x", padx=10, pady=(0, 1))
except Exception:
try:
tk.Label(card, text=ln, bg=bg).pack(fill="x", padx=10, pady=(0, 1))
except Exception:
pass