最近使用Kivy进行简单的图形用户界面开发。在使用BoxLayout时，发现size_hint的行为跟预期的不一致，特此记录分析一下。
当BoxLayout中所有的Widget都定义了size_hint时，所有Widget的尺寸符合预期
完整代码如下。
from kivy.app import App
from kivy.lang import Builder
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.scrollview import ScrollView
from kivy.uix.label import Label
from kivy.clock import Clock
kv = Builder.load_string(
"""
<ActionLabel1@Label>
bold: True
font_size: self.height / 2
text_size: self.size
valign: "middle"
halign: "center"
opacity: 1 if self.text else 0
canvas.before:
Color:
rgb: .6, .6, .6
Rectangle:
pos: self.pos
size: self.size
BoxLayout:
orientation: "vertical"
padding: 1
spacing: 1
ActionLabel1:
id: step1
size_hint: 1, 0.2
ActionLabel1:
id: step2
size_hint: 0.5, 0.8
"""
)
class MyLabel(Label):
pass
def gen():
while True:
yield ["123", "456"]
class MyApp(App):
def build(self):
self.gen = gen()
self.update()
self._timer = Clock.schedule_interval(self.update, 3.0)
return kv
def update(self, /, *args):
l = next(self.gen)
for i, text in enumerate(l, start=1):
l1 = kv.ids[f"step{i}"]
l1.text = text
MyApp().run()
运行结果：
Screen Shot 2021-10-08 at 11.14.26 pm.png
当BoxLayout中只有部分Widget定义size_hint时，Widget尺寸与预期不一致
比如，当把第一个ActionLabel的size_hint注释掉，此时运行结果如下。
Screen Shot 2021-10-08 at 11.20.52 pm.png
第二个ActionLabel的宽度符合预期，但高度并不是预期的总高度x0.8。这究竟是怎么回事呢？
看了一下BoxLayout的源码，才明白其中的原因。Widget默认的size_hint是(1,1)，所以第一个ActionLabel的size_hint是(1,1)，第二个是(0.5, 0.8)。因为BoxLayout的orientation为vertical，所以横向的长度没有问题，但纵向的高度会有问题。
BoxLayout在分配Widget的高度时，第一个ActionLabel是layout_height * 0.8 / (1+0.8)，第二个是layout_height * 1 / (1+0.8)，也就是上图的运行结果。
我自己潜意识认为第二个ActionLabel的size_hint_y是0.8，那么第一个的size_hint_y则应该是1-0.8=0.2。这一点与Widget默认的size_hint_y=1不符，造成了误解。
总结
遇到违反预期的现象时，需要仔细阅读文档和源码。源码面前无秘密，总会找到合理的解释的。
