certflow.views.bases.base_view module

视图基类(重构计划阶段 1)。

提供跨视图的统一契约与**真实可复用 helper**,避免各 view 手写重复:

  • init_ui():子类构造 UI 的唯一入口,基类 __init__ 末尾调用一次。

  • refresh():外部触发的数据刷新钩子(默认空实现)。

  • retranslate_ui():语言切换后的文本刷新钩子(默认空实现), MainWindow 未来可在语言变更时广播给所有已注册视图。

  • tr(text) / _tr(text):委托全局 i18n(QApplication.instance().i18n_manager, 与现有 query_view 读取 app.theme_manager 同约定),无则原样返回。

  • is_dark_theme():集中 query_view._is_dark_theme 的重复实现。

  • on_theme_changed(theme):主题切换钩子(默认空实现),供主题感知视图覆写。

非破坏性:仅定义契约与 helper,不改动任何现有视图。

class certflow.views.bases.base_view.BaseView(parent=None)[源代码]

基类:QWidget

所有业务视图的基类。

现有视图当前在 __init__ 内联构造 UI、各自实现 refresh / retranslate_ui (仅 settings_viewretranslate_ui、仅 query_view_is_dark_theme)。 本类把这些散落约定收敛为统一钩子 + helper,供后续灰度迁移继承。

参数:

parent (QWidget | None)

init_ui()[源代码]

构造 UI。子类必须实现;基类在 __init__ 末尾调用一次。

返回类型:

None

refresh()[源代码]

外部触发的数据刷新(如切换流水线阶段、数据变更后)。默认空实现。

返回类型:

None

retranslate_ui()[源代码]

语言切换后刷新 UI 文本。默认空实现,MainWindow 可在语言变更时广播。

返回类型:

None

on_theme_changed(theme)[源代码]

主题切换回调("light" / "dark")。默认空实现,主题感知视图覆写。

参数:

theme (str)

返回类型:

None

tr(text)[源代码]

翻译文本。

委托 QApplication.instance().i18n_manager.tr``(与现有视图读取 ``app.theme_manager 的同一种全局挂载约定);找不到则原样返回。

参数:

text (str)

返回类型:

str

is_dark_theme()[源代码]

当前是否为深色主题(集中 query_view._is_dark_theme 的重复实现)。

返回类型:

bool

staticMetaObject = PySide6.QtCore.QMetaObject("BaseView" inherits "QWidget": )