0

0

Kivy ScrollView 子组件不显示的常见原因与修复方法

霞舞

霞舞

发布时间:2026-01-22 21:04:02

|

251人浏览过

|

来源于php中文网

原创

Kivy ScrollView 子组件不显示的常见原因与修复方法

kivy 中 scrollview 子组件不显示,通常是因为误创建了新 app 实例而非调用当前运行实例的方法,导致 ui 更新作用于无效对象。本文详解该典型错误及正确实践。

在 Kivy 应用中,ScrollView 本身不会“隐藏”子控件,但若其内部布局(如 GridLayout)未被正确添加到当前活动的 UI 树,或内容更新逻辑作用于错误的对象实例,则视觉上会表现为完全空白——即使日志输出、数据获取均正常。

你代码中的核心问题出现在 SelectableLabel.apply_selection() 方法内:

def apply_selection(self, rv, index, is_selected):
    self.selected = is_selected
    if is_selected:
        MyApp().display_info(self.data)  # ❌ 错误:新建无关 App 实例

MyApp() 每次调用都会创建一个全新的、未启动、未挂载到窗口的 App 对象。因此 display_info() 虽然执行了,但它操作的是这个“幽灵实例”的 self.info_layout,而真正显示在屏幕上的 MainLayout 和 ScrollView 属于正在运行的唯一 App 实例,两者内存隔离、互不影响。

✅ 正确做法是通过 Kivy 提供的全局访问机制获取当前运行的 App 实例:

from kivy.app import App  # 确保已导入

def apply_selection(self, rv, index, is_selected):
    self.selected = is_selected
    if is_selected:
        App.get_running_app().display_info(self.data)  # ✅ 正确:获取真实运行实例

App.get_running_app() 是 Kivy 官方推荐的标准方式,它返回当前正在 run() 的 App 子类唯一实例(即你调用 MyApp().run() 启动的那个),确保所有 UI 操作(如 clear_widgets()、add_widget())都作用于真实渲染树。

此外,还需注意两个关键细节以保障 ScrollView 正常工作:

Memories.ai
Memories.ai

专注于视频解析的AI视觉记忆模型

下载
  1. 动态高度管理:GridLayout 作为 ScrollView 的子控件时,必须显式设置 size_hint_y=None 并绑定 height 到 minimum_height,否则 ScrollView 无法计算可滚动区域:

    self.info_layout = GridLayout(
        size_hint=(1, None),  # 关键:禁用 y 方向自适应
        cols=1,
        height=0  # 初始高度可设为 0,后续由 add_widget 触发 minimum_height 更新
    )
    self.info_layout.bind(minimum_height=self.info_layout.setter('height'))
  2. 避免重复构建布局:build() 中手动添加 ScrollView 与 KV 文件定义存在冲突。建议统一使用 KV 构建 UI 结构,更清晰可控。例如,在 KV 中补全右侧 ScrollView 部分:

    :
        orientation: 'horizontal'
        BoxLayout:  # 左侧词表区
            orientation: 'vertical'
            size_hint_x: 0.35
            TextInput:
                hint_text: 'Search'
                size_hint_y: 0.05
                multiline: False
                padding_y: 10
            RV:
                size_hint_y: 0.95
                viewclass: 'SelectableLabel'
                SelectableRecycleBoxLayout:
                    default_size: None, dp(56)
                    default_size_hint: 1, None
                    size_hint_y: None
                    height: self.minimum_height
                    orientation: 'vertical'
                    multiselect: False
                    touch_multiselect: False
        ScrollView:  # 右侧信息区(直接定义在 KV 中)
            size_hint_x: 0.65
            GridLayout:
                id: info_grid
                size_hint_y: None
                cols: 1
                height: self.minimum_height
                padding: 10
                spacing: 8

    然后在 Python 中通过 self.root.ids.info_grid 访问并更新内容,避免手动 add_widget 引发的层级混乱。

总结:Kivy UI 更新失效的首要排查点是 App 实例一致性 —— 始终使用 App.get_running_app() 替代 MyApp() 构造新实例;其次确保 ScrollView 内部容器具备明确的高度约束(size_hint_y=None + minimum_height 绑定)。遵循这两条原则,即可稳定驱动动态内容在滚动视图中正确呈现。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

772

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

661

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

764

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

679

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1345

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

549

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

579

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

730

2023.08.11

菜鸟裹裹入口以及教程汇总
菜鸟裹裹入口以及教程汇总

本专题整合了菜鸟裹裹入口地址及教程分享,阅读专题下面的文章了解更多详细内容。

0

2026.01.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 12.9万人学习

Django 教程
Django 教程

共28课时 | 3.4万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号