翻译自 使用FXML创建用户界面
本教程展示了使用JavaFX FXML的好处,JavaFX FXML是一种基于XML的语言,它提供了构建与代码的应用程序逻辑分开的用户界面的结构。
如果您从一开始就开始使用本文档,那么您已经了解了如何使用JavaFX创建登录应用程序。在这里,您使用FXML创建相同的登录用户界面,将应用程序设计与应用程序逻辑分离,从而使代码更易于维护。您在本教程中构建的登录用户界面如图6-1所示。
图6-1登录用户界面
本教程使用NetBeans IDE。确保您使用的NetBeans IDE版本支持JavaFX 8.有关详细信息,请参阅Java SE下载页面的“认证系统配置”部分。
1、设置项目
您的第一个任务是在NetBeans IDE中设置JavaFX FXML项目:
-
从“ 文件”菜单中,选择“ 新建项目”。
-
在JavaFX应用程序类别中,选择JavaFX FXML Application。单击下一步。
-
将项目命名为FXMLExample,然后单击Finish。
NetBeans IDE打开一个FXML项目,其中包含基本Hello World应用程序的代码。该应用程序包括三个文件:
-
FXMLExample.java.
该文件负责FXML应用程序所需的标准Java代码。 -
FXMLDocument.fxml.
这是您在其中定义用户界面的FXML源文件。 -
FXMLDocumentController.java.
这是用于处理鼠标和键盘输入的控制器文件。
-
-
重命名
FXMLDocumentController.java
为F,XMLExampleController.java
以使该名称对此应用程序更有意义。-
在“项目”窗口中,右键单击“ FXMLDocumentController.java”,然后选择“ 重构”,然后选择“ 重命名”。
-
输入FXMLExampleController,然后单击“ 重构”。
-
-
重命名
FXMLDocument.fxml
为fxml_example.fxml.
-
右键单击FXMLDocument.fxml并选择“ 重命名”。
-
输入fxml_example并单击“ 确定”。
-
2、加载FXML源文件
您编辑的第一个文件是FXMLExample.java
文件。此文件包含用于设置应用程序主类和定义舞台和场景的代码。更具体的FXML,该文件使用FXMLLoader
该类,该类负责加载FXML源文件并返回结果对象图。
在例6-1中进行粗体显示的更改。
例6-1 FXMLExample.java
@Overridepublic void start(Stage stage) throws Exception {Parent root = FXMLLoader.load(getClass().getResource("fxml_example.fxml"));Scene scene = new Scene(root, 300, 275);stage.setTitle("FXML Welcome");stage.setScene(scene);stage.show();}
一个好的做法是在创建场景时设置场景的高度和宽度,在本例中为300乘275; 否则场景默认为显示其内容所需的最小尺寸。
3、修改导入语句
接下来,编辑该fxml_example.fxml
文件。此文件指定应用程序启动时显示的用户界面。第一项任务是修改import语句,使代码如例6-2所示。
示例6-2 XML声明和导入语句
<?xml version="1.0" encoding="UTF-8"?><?import java.net.*?>
<?import javafx.geometry.*?>
<?import javafx.scene.control.*?>
<?import javafx.scene.layout.*?>
<?import javafx.scene.text.*?>
与在Java中一样,类名可以是完全限定的(包括包名),也可以使用import语句导入它们,如例6-2所示。如果您愿意,可以使用引用类的特定import语句。
4、创建GridPane布局
NetBeans生成的Hello World应用程序使用AnchorPane
布局。对于登录表单,您将使用GridPane
布局,因为它使您能够创建灵活的行和列网格,以在其中布置控件。
删除AnchorPane
布局及其子项,并将其替换GridPane
为示例6-3中的布局。
示例6-3 GridPane布局
<GridPane fx:controller="fxmlexample.FXMLExampleController" xmlns:fx="http://javafx.com/fxml" alignment="center" hgap="10" vgap="10">
<padding><Insets top="25" right="25" bottom="10" left="25"/></padding></GridPane>
在此应用程序中,GridPane
布局是FXML文档的根元素,因此具有两个属性。fx:controller
在标记中指定基于控制器的事件处理程序时,该属性是必需的。该xmlns:fx
属性始终是必需的,并指定fx
命名空间。
代码的其余部分控制网格窗格的对齐和间距。alignment属性将网格的默认位置从场景的左上角更改为中心。在gap
性能管理行和列之间的间距,而padding
物业管理围绕网格窗格边缘的空间。
在调整窗口大小时,网格窗格中的节点将根据其布局约束进行调整大小。在此示例中,当您增大或缩小窗口时,网格将保留在中心。填充属性确保在使窗口变小时网格周围有填充。
5、添加文本和密码字段
回顾图6-1,您可以看到登录表单需要标题“欢迎”以及用于从用户收集信息的文本和密码字段。例6-4中的代码是GridPane
布局的一部分,必须放在</GridPane>
语句的上方。
示例6-4文本,标签,TextField和密码字段控件
<Text text="Welcome" GridPane.columnIndex="0" GridPane.rowIndex="0"GridPane.columnSpan="2"/><Label text="User Name:"GridPane.columnIndex="0" GridPane.rowIndex="1"/><TextField GridPane.columnIndex="1" GridPane.rowIndex="1"/><Label text="Password:"GridPane.columnIndex="0" GridPane.rowIndex="2"/><PasswordField fx:id="passwordField" GridPane.columnIndex="1" GridPane.rowIndex="2"/>
第一行创建一个Text
对象并将其文本值设置为Welcome
。的GridPane.columnIndex
和GridPane.rowIndex
属性对应的放置Text
在网格控制。网格中行和列的编号从零开始,Text
控件的位置设置为(0,0),这意味着它位于第一行的第一列中。该GridPane.columnSpan
属性设置为2,使欢迎标题跨越网格中的两列。当您添加样式表以将文本的字体大小增加到32磅时,您将在本教程后面需要这个额外的宽度。
下一行创建一个Label
对象,其中第User Name
0列,第1行为文本,第1列为第1行TextField
,右侧为对象。另一行Label
和PasswordField
对象以类似方式创建并添加到网格中。
使用网格布局时,可以显示网格线,这对于调试非常有用。在这种情况下,通过在语句后添加语句gridLinesVisible
来将属性设置为。然后,当您运行应用程序时,您会看到网格列和行的行以及间隙属性,如图6-2所示。true
<gridLinesVisible>true</gridLinesVisible>
<padding></padding>
图6-2带网格线的登录表单
6、添加按钮和文本
应用程序所需的最后两个控件是Button
用于提交数据的Text
控件和用于在用户按下按钮时显示消息的控件。代码在例6-5中。之前添加此代码</GridPane>
。
例6-5 HBox,Button和Text
<HBox spacing="10" alignment="bottom_right" GridPane.columnIndex="1" GridPane.rowIndex="4"><Button text="Sign In" onAction="#handleSubmitButtonAction"/>
</HBox><Text fx:id="actiontarget"GridPane.columnIndex="0" GridPane.columnSpan="2"GridPane.halignment="RIGHT" GridPane.rowIndex="6"/>
HBox
需要一个窗格来设置按钮的对齐方式,该方框与应用于GridPane
布局中其他控件的默认对齐方式不同。该alignment
属性设置为bottom_right
,将空间底部的节点垂直放置,并在空间的右边缘水平放置。该HBox
窗格将添加到第1列第4行的网格中。
该HBox
窗格有一个孩子,一个Button
与text
属性设置为Sign in
和onAction
设置属性handleSubmitButtonAction()
。虽然FXML是定义应用程序用户界面结构的便捷方式,但它并未提供实现应用程序行为的方法。您可以handleSubmitButtonAction()
在本教程的下一部分“ 添加代码来处理事件”中实现Java代码中的方法行为。
分配一个fx:id
值到一个元素,如在对所述代码中所示Text
的控制,创建在文档的命名空间的变量,该变量可以参考从代码的其他地方。虽然不是必需的,但定义控制器字段有助于阐明控制器和标记的关联方式。
7、添加代码来处理事件
现在,Text
当用户按下按钮时,控件会显示一条消息。你在FXMLExampleController.java
文件中这样做。删除NetBeans IDE生成的代码,并将其替换为例6-6中的代码。
例6-6 FXMLExampleController.java
package fxmlexample;import javafx.event.ActionEvent;
import javafx.fxml.FXML;
import javafx.scene.text.Text;public class FXMLExampleController {@FXML private Text actiontarget;@FXML protected void handleSubmitButtonAction(ActionEvent event) {actiontarget.setText("Sign in button pressed");}}
该@FXML
注释被用于标记非公共控制器成员字段和处理程序方法用于通过FXML标记使用。该handleSubmtButtonAction
方法将actiontarget
变量设置为Sign in button pressed
用户按下按钮时。
您现在可以运行该应用程序以查看完整的用户界面。图6-3显示了在两个字段中键入文本并单击“登录”按钮时的结果。如果您有任何问题,那么您可以将您的代码与FXMLLogin示例进行比较。
图6-3 FXML登录窗口
8、使用脚本语言处理事件
作为使用Java代码创建事件处理程序的替代方法,您可以使用提供与JSR 223兼容的脚本引擎的任何语言来创建处理程序。这些语言包括JavaScript,Groovy,Jython和Clojure。
您可以选择立即尝试使用JavaScript。
-
在文件中
fxml_example.fxml
,在XML doctype声明之后添加JavaScript声明。<?language javascript?>
-
在
Button
标记中,更改函数的名称,以使调用如下所示:onAction="handleSubmitButtonAction(event);"
-
fx:controller
从GridPane
标记中删除属性,并将JavaScript函数<script>
直接添加到其下的标记中,如例6-7所示。例6-7 FXML中的JavaScript
<GridPane xmlns:fx="http://javafx.com/fxml" alignment="center" hgap="10" vgap="10"><fx:script>function handleSubmitButtonAction() {actiontarget.setText("Calling the JavaScript");}</fx:script>
或者,您可以将JavaScript函数放在外部文件(例如
fxml_example.js
)中,并包含如下脚本:<fx:script source="fxml_example.js"/>
结果如图6-4所示。
图6-4使用JavaScript登录应用程序
如果您正在考虑使用FXML脚本语言,请注意IDE可能不支持在调试期间单步执行脚本代码。
9、使用CSS设置应用程序样式
最后的任务是通过添加层叠样式表(CSS)使登录应用程序看起来很有吸引力。
-
创建样式表。
-
在“项目”窗口中,右键单击“源包”下的fxmlexample文件夹,然后选择“ 新建”,再选择“ 其他”。
-
在“新建文件”对话框中,选择“ 其他”,然后选择“ 层叠样式表”,并单击“ 下一步”。
-
输入Login并单击Finish。
-
将
Login.css
文件的内容复制到CSS文件中。该Login.css
文件包含在可下载的LoginCSS.zip文件中。有关CSS文件中的类的说明,请参阅使用JavaFX CSS的花式表单。
-
-
通过右键单击background.jpg文件并将其保存到
fxmlexample
文件夹,下载背景的灰色亚麻图像。 -
打开
fxml_example.fxml
文件并在GridPane
布局标记结束之前添加样式表元素,如例6-8所示。例6-8样式表
<stylesheets><URL value="@Login.css" /></stylesheets></GridPane>
URL中样式表名称前面的@符号表示样式表与FXML文件位于同一目录中。
-
要使用网格窗格的根样式,请将样式类添加到
GridPane
布局的标记中,如例6-9所示。示例6-9设置GridPane的样式
<GridPane fx:controller="fxmlexample.FXMLExampleController" xmlns:fx="http://javafx.com/fxml" alignment="center" hgap="10" vgap="10" styleClass="root">
-
welcome-text
为WelcomeText
对象创建一个ID,使其使用#welcome-text
CSS文件中定义的样式,如例6-10所示。示例6-10文本ID
<Text id="welcome-text" text="Welcome" GridPane.columnIndex="0" GridPane.rowIndex="0" GridPane.columnSpan="2"/>
-
运行该应用程序。图6-5显示了程式化的应用程序。如果遇到问题,请查看可下载的FXMLExample.zip文件中包含的代码
图6-5样式化登录应用程序
10、从这往哪儿走
既然您熟悉FXML,请查看FXML 简介,它提供了有关构成FXML语言的元素的更多信息。该文档包含在API文档的javafx.fxml
包中。
您还可以通过fxml_example.fxml
在Scene Builder中打开文件并进行修改来试用JavaFX Scene Builder工具。此工具为JavaFX应用程序的UI设计提供了可视化布局环境,并自动为布局生成FXML代码。请注意,保存时可能会重新格式化FXML文件。有关此工具的更多信息,请参阅JavaFX Scene Builder入门。使用CSS进行Skinning和JavaFX Scene Builder用户指南的CSS Analyzer部分,还可以为您提供有关如何为FXML布局设置外观的信息。