KivyMD中MDToolbar内文本输入框pos_hint位置调整失效问题

问题现象 #

在MDToolbar控件内部放置MDTextFieldRound圆角文本输入框时，运行后输入框始终紧贴窗口右侧边缘，通过pos_hint属性设置的所有x轴坐标参数都无法移动输入框位置。
原实现代码：

Screen:
canvas.before:
    Rectangle:
        pos: self.pos
        size: self.size
        source: 'assets/bg.png'

BoxLayout:
    orientation: 'vertical'
    MDToolbar:
        id: toolbar
        title: 'Placeholder'
        elevation: 10
        pos_hint: {"top": 1}

        left_action_items: [['menu', lambda x: app.menu.open()]]

        MDTextFieldRound:
            id: textinput
            icon_left: 'magnify'
            pos_hint: {'x': 0.1 ,'center_y': 0.5, 'right': 0.3}
            size_hint: {.6, .4}
            text_color: 'white'
            hint_text: 'Search'
        
    MDLabel:
        text: 'Placeholder'
        color: 'white'
        halign: 'center'

问题原因 #

• MDToolbar自带固定的内部布局规则，从左到右依次划分为左侧动作按钮区、标题区、自定义控件区三个独立区域
• 所有直接添加为MDToolbar子级的控件，会被自动放入最右侧的自定义控件区，这个区域默认右对齐、宽度随内容自适应
• 你在MDTextFieldRound上设置的x轴pos_hint参数，是相对于这个右侧小容器计算的，而非相对于整个Toolbar宽度，因此无法达到预期的位移效果
• 注意：原代码pos_hint同时设置了x:0.1和right:0.3，两个参数逻辑本身冲突，即便容器布局正常也会出现位置异常

修复方案 #

你可以直接通过相对坐标绑定的方式设置输入框位置，绕开右侧容器的布局限制，修正后的可运行代码如下：

Screen:
    canvas.before:
        Rectangle:
            pos: self.pos
            size: self.size
            source: 'assets/bg.png'

    BoxLayout:
        orientation: 'vertical'
        MDToolbar:
            id: toolbar
            title: 'Placeholder'
            elevation: 10
            pos_hint: {"top": 1}
            left_action_items: [['menu', lambda x: app.menu.open()]]

            MDTextFieldRound:
                id: textinput
                icon_left: 'magnify'
                pos_hint: {'center_y': 0.5}
                # 直接绑定Toolbar宽度计算x坐标和输入框宽度，不受内部容器限制
                x: toolbar.width * 0.2
                size_hint_y: 0.4
                width: toolbar.width * 0.55
                text_color: 'white'
                hint_text: 'Search'

        MDLabel:
            text: 'Placeholder'
            color: 'white'
            halign: 'center'

如果你使用2.0.0及以上版本KivyMD，MDToolbar已被标记为弃用，推荐替换为MDTopAppBar，可直接将输入框放入内置的自定义容器，布局逻辑更清晰。如果需要完全自定义工具栏样式，也可以直接用MDBoxLayout搭配MDIconButton、MDLabel手动拼接，不会被控件默认布局规则限制。

内容的提问来源于stack exchange，提问作者Mingchen Ma