如何让JavaFX ScrollPane占用剩余空间且不挤压上方Label

核心调整思路 #

• 保证labelInfoBox完整显示：将其VBox.vgrow设为NEVER，让该Label仅占用自身内容所需的高度，不参与剩余空间分配。
• 让ScrollPane占用剩余空间：将messageScrollBox的VBox.vgrow设为ALWAYS，强制它填充VBox中所有剩余区域，不会被内部文本撑大挤压上方Label。
• 约束内部Label的尺寸：绑定messageBox的宽度到ScrollPane的视口宽度，确保文本自动换行且不撑大ScrollPane。

修改后的完整代码 #

FXML文件（hello-view.fxml）

<?import javafx.scene.control.Label?>
<?import javafx.scene.layout.VBox?>
<?import javafx.scene.control.ScrollPane?>
<?import javafx.geometry.Insets?>

<VBox alignment="CENTER" spacing="20.0" xmlns:fx="http://javafx.com/fxml"
      fx:controller="com.example.testscrollpane.HelloController">
    <padding>
        <Insets bottom="20.0" left="20.0" right="20.0" top="20.0"/>
    </padding>

    <!-- 仅占用自身所需高度，确保完整显示 -->
    <Label fx:id="labelInfoBox" text="InfoBox" wrapText="true" VBox.vgrow="NEVER"/>
    
    <!-- 占用所有剩余空间 -->
    <ScrollPane fx:id="messageScrollBox" hbarPolicy="NEVER"
                fitToWidth="true" VBox.vgrow="ALWAYS"
                styleClass="edge-to-edge">
        <!-- 绑定Label宽度到ScrollPane视口宽度，避免文本撑大容器 -->
        <Label fx:id="messageBox" text="messageBox" wrapText="true" 
               maxWidth="${messageScrollBox.viewportBounds.width - 10}" />
    </ScrollPane>
</VBox>

Kotlin代码部分（仅保留核心逻辑）

class HelloController {
    @FXML
    lateinit var labelInfoBox: Label

    @FXML
    private lateinit var messageScrollBox: ScrollPane

    @FXML
    lateinit var messageBox: Label
}

class HelloApplication : Application() {
    val messageBoxTexts = mutableListOf<String>()

    override fun start(stage: Stage) {
        val fxmlLoader = FXMLLoader(HelloApplication::class.java.getResource("hello-view.fxml"))
        val scene = Scene(fxmlLoader.load(), 320.0, 500.0)
        stage.title = "Hello!"
        stage.scene = scene
        stage.show()

        val helloController = fxmlLoader.getController<Any>() as HelloController
        val texts = mutableListOf<String>()
        for (i in 0..10) {
            texts.add("some text which should always be shown, line $i")
        }
        helloController.labelInfoBox.text = texts.joinToString("\n")

        for (i in 0..50) {
            messageBoxTexts.add("some text which should be scrolled, line $i")
        }
        helloController.messageBox.text = messageBoxTexts.joinToString("\n")
    }
}

fun main() {
    Application.launch(HelloApplication::class.java)
}

关键细节说明 #

• VBox.vgrow的取值逻辑：NEVER表示组件不扩展，仅使用自身最小/首选尺寸；ALWAYS表示优先占用所有剩余空间。
• 绑定messageBox的maxWidth时减去10，是为了避免Label边缘贴紧ScrollPane边框，防止文本被视口裁剪。
• fitToWidth="true"配合hbarPolicy="NEVER"，确保ScrollPane视口宽度匹配父容器，完全屏蔽水平滚动条。

内容的提问来源于stack exchange，提问作者Gunnar Bernstein