JavaFX入门参考,高优质资料:http://www.javafxchina.net/blog/docs/tutorial1/
版权所有,转载注明。
零、 最终目标
通过两种方式(纯代码控制、FXML),实现一个简单的登录界面:
涉及到的控件:
文本(Text,动态显示内容)、标签(Label,显示文本)、文本域(TextField,用户交互输入)、按钮(Button,登录点击)
一、 控件通过Code动态添加实现方法
1、 新建项目
新建JavaFXLoginDemo项目,具体新建方法参见前篇:
JavaFX开发环境:NetBeans开发环境搭建
完成项目新建后,进入开发正题。
入口参数:
public class JavaFXLoginDemo extends Application {
@Override
public void start(Stage primaryStage) {
}
/**
* @param args the command line arguments
*/
public static void main(String[] args) {
launch(args);
}
}
2、 布局方式
JavaFX的UI控件均摆放在Scene上,一般通过增加控制布局的Panel,并将实际的UI摆放在布局Panel上,有点类似于Android的布局方式。Panel有多种样式,包括了行、列、栈等等,如BorderPane、GridPane、Hbox、VBox等等。
本文将使用GridPane进行布局。
GridPane grid = new GridPane();//网格式布局,由行列网格控制
grid.setAlignment(Pos.CENTER);//对齐方式,默认靠左对齐,当前设置居中对齐
grid.setHgap(10);//设置水平间隔
grid.setVgap(10);//设置垂直间隔
grid.setPadding(new Insets(25, 25, 25, 25));//设置Padding,顺序是:上、右、下、左
Scene scene = new Scene(grid, 300, 275);//新建Scene,并将网格式Panel置于其中
primaryStage.setScene(scene);//设置场景
primaryStage.show();
3、 添加控件
Text scenetitle = new Text("欢迎标题");
//scenetitle.setFont(Font.font("Times New Roman", FontWeight.NORMAL, 20));
grid.add(scenetitle, 0, 0, 2, 1);
//创建Label对象,放到第0列,第1行
Label userName = new Label("用户名:");
grid.add(userName, 0, 1);
//创建文本输入框,放到第1列,第1行
TextField userTextField = new TextField();
grid.add(userTextField, 1, 1);
Label pw = new Label("密 码:");
grid.add(pw, 0, 2);
PasswordField pwBox = new PasswordField();
grid.add(pwBox, 1, 2);
Button btn = new Button("登录");
HBox hbBtn = new HBox(10);
hbBtn.setAlignment(Pos.BOTTOM_RIGHT);
hbBtn.getChildren().add(btn);//将按钮控件作为子节点
grid.add(hbBtn, 1, 4);//将HBox pane放到grid中的第1列,第4行
final Text actiontarget = new Text();//增加用于显示信息的文本
grid.add(actiontarget, 1, 6);
4、 添加处理事件
只有一个按钮需要事件处理:
btn.setOnAction(new EventHandler() {//注册事件handler
@Override
public void handle(ActionEvent e) {
actiontarget.setFill(Color.FIREBRICK);//将文字颜色变成 firebrick red
actiontarget.setText("登录中...");
}
});
5、 添加样式CSS
步骤一:新建CSS文件:
在包上右击:
输入文件名Login.css,完成样式表文件的创建:
样式表中定义的内容,主要用在控件的样式控制上,需要在UI中应用。样式表需要应用到Root容器中:
scene.getStylesheets().add(JavaFXLoginDemo.class.getResource("Login.css").toExternalForm());
设置后,将会在JavaFXLoginDemo.class相对路径下寻找给出的样式表Login.css,并应用到scene中。
步骤二:添加一张背景图,到当前包路径下:
步骤三:添加CSS样式控制
//根元素样式布局,设置背景图
.root {
-fx-background-image: url("background.jpg");
}
//标签控件样式
.label {
-fx-font-size: 12px;
-fx-font-weight: bold;
-fx-text-fill: #333333;
-fx-effect: dropshadow( gaussian , rgba(255,255,255,0.5) , 0,0,0,1 );
}
//给Button增加样式
.button {
-fx-text-fill: white;
-fx-font-family: "Arial Narrow";
-fx-font-weight: bold;
-fx-background-color: linear-gradient(#61a2b1, #2A5058);
-fx-effect: dropshadow( three-pass-box , rgba(0,0,0,0.6) , 5, 0.0 , 0 , 1 );
}
.button:hover {
-fx-background-color: linear-gradient(#2A5058, #61a2b1);
}
//增加文本效果
#welcome-text {
-fx-font-size: 32px;
-fx-fill: #818181;
-fx-effect: innershadow( three-pass-box , rgba(0,0,0,0.7) , 6, 0.0 , 0 , 2 );
}
//登录点击事件显示效果
#actiontarget {
-fx-fill: FIREBRICK;
-fx-font-weight: bold;
-fx-effect: dropshadow( gaussian , rgba(255,255,255,0.5) , 0,0,0,1 );
}
注意,最后两个是采用了CSS中的ID控制样式,而非Label、Button中针对类型设置的样式,因此需要给目标控件增加ID规则:
scenetitle.setId("welcome-text");
actiontarget.setId("actiontarget");
☆☆☆ 中文字体库应用
任何事情,涉及到了中文之后,字体库使用有点麻烦。
(1)新建文件夹,在当前包下建立resources/fonts,如图所示:
将字体库粘贴进去,一般是ttf文件,Windows常用,Mac可以用,Linux也是兼容的。我粘贴的是微软雅黑和粗体版,在Windows操作系统的系统盘下Windows/Fonts目录下。
(2)增加fonts.mf文件
使用“文件”选项卡查看工程:
fonts.mf内容:
msyh=/javafxlogindemo/resources/fonts/msyh.ttf
msyhbd=/javafxlogindemo/resources/fonts/msyhbd.ttf
hwxk=/javafxlogindemo/resources/fonts/STXINGKA.TTF
hwcy=/javafxlogindemo/resources/fonts/STCAIYUN.TTF
hwcy:
hwxk:
"="前面,是项目使用时的字体名称,即font-family,后面是字体库文件的路径。
(3)fonts.mf需要在打包时放到jar包的META-INF目录下,因此需要配置NetBeans工程的build.xml文件内容:
NetBeans工程使用Ant管理项目,配置的build.xml文件,根文件在工程根目录下,具体配置文件在nbproject目录下的build-impl.xml文件中。
在build.xml中增加如下内容:
完成之后,运行一下项目,在项目目录的dist目录下,可以看到打包的jar包,用压缩文件查看器打开(WinRAR):
包含了配置文件和字体库文件。
(4)code中使用:
import javafx.scene.text.Font;
Font font = Font.font("hwcy", 32);//字体,尺寸,注意不能使用加粗,即FontWeight
(5)在CSS样式文件中使用:
//增加文本效果
#welcome-text {
-fx-font-size: 32px;
-fx-font-family: "hwcy";
-fx-fill: #818181;
-fx-effect: innershadow( three-pass-box , rgba(0,0,0,0.7) , 6, 0.0 , 0 , 2 );
}
注意,-fx-font-weight: bold;
加粗不能一起使用,会使字体失效。
经过上述的配置,中文字体也能够轻松走起啦。
6、 完成编码,启动项目,运行测试。
二、 FXML实现界面
NetBeans实现方法
1、 新建工程JavaFXLoginFXMLDemo:
与前一种方法新的工程种类稍有区别,这里选择JavaFX FXML应用程序
对比一下工程结构,FXML工程多了一些FXML文件和控制器文件:
新建工程后,立刻运行:
代码也稍有区别,FXML文件中定义了控件和控制器映射关系等等:
默认生成的FXML样例界面文件中,根容器是一个AnchorPane:
AnchorPane布局面板可锚定节点于面板的顶、底、左边、右边或中间。当窗口尺寸调整时,相应节点维护它们相对于锚点的位置。节点可被锚定于多个位置,多个节点也可锚定于同一个位置。
在后面,将要修改实际的布局容器。
控制器Controller定义了事件处理方法:
/*
* To change this license header, choose License Headers in Project Properties.
* To change this template file, choose Tools | Templates
* and open the template in the editor.
*/
package javafxloginfxmldemo;
import java.net.URL;
import java.util.ResourceBundle;
import javafx.event.ActionEvent;
import javafx.fxml.FXML;
import javafx.fxml.Initializable;
import javafx.scene.control.Label;
/**
*
* @author guorui.he
*/
public class FXMLDocumentController implements Initializable {
@FXML
private Label label;
@FXML
private void handleButtonAction(ActionEvent event) {
System.out.println("You clicked me!");
label.setText("Hello World!");
}
@Override
public void initialize(URL url, ResourceBundle rb) {
// TODO
}
}
主文件内,与之前的纯代码实现基本类似,但是加载页面的机制稍有不同,这时通过FXML文件加载,搞过Android的人很熟悉:
/*
* To change this license header, choose License Headers in Project Properties.
* To change this template file, choose Tools | Templates
* and open the template in the editor.
*/
package javafxloginfxmldemo;
import javafx.application.Application;
import javafx.fxml.FXMLLoader;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.stage.Stage;
/**
*
* @author guorui.he
*/
public class JavaFXLoginFXMLDemo extends Application {
@Override
public void start(Stage stage) throws Exception {
//通过fxml的UI布局文件加载实际的界面内容
Parent root = FXMLLoader.load(getClass().getResource("FXMLDocument.fxml"));
Scene scene = new Scene(root);
stage.setScene(scene);
stage.show();
}
/**
* @param args the command line arguments
*/
public static void main(String[] args) {
launch(args);
}
}
由于默认文件名定义的比较弱,我们要自己改一下文件名,这样才能更清晰的展示:
注意不要忘记修改控制器和FXML的映射,以及主类加载的FXML界面名称。
2、在FXML文件中,编写界面内容:
//整理引入包
//编写界面
此时,没有添加事件处理,可以试运行:
大致内容都在了,但是没有样式,没有登录按钮点击处理事件。
3、 添加处理事件:
方法一:使用Java处理
//给Button增加一个事件处理
添加之后,会报错:
需要在控制器中为其添加事件处理:
会自动的在控制器内添加处理程序:
package javafxloginfxmldemo;
import java.net.URL;
import java.util.ResourceBundle;
import javafx.event.ActionEvent;
import javafx.fxml.FXML;
import javafx.fxml.Initializable;
import javafx.scene.control.Label;
import javafx.scene.control.PasswordField;
import javafx.scene.text.Text;
/**
*
* @author guorui.he
*/
public class FXMLLoginDemoDocumentController implements Initializable {
private Label label;
@FXML
private PasswordField passwordField;
@FXML
private Text actiontarget;
@Override
public void initialize(URL url, ResourceBundle rb) {
// TODO
}
@FXML
private void handleSubmitButtonAction(ActionEvent event) {
actiontarget.setText("登录中...");
}
}
@FXML注解,可以删除,最好保留,阅读方便。
添加好处理事件后,点击登录按钮,就会有反应了:
方法二.1:使用内置JS脚本处理
添加脚本声明。
修改Button的事件处理方法(局部代码):
function handleSubmitButtonAction() {
actiontarget.setText("Calling the JavaScript");
}
点击之后,调用脚本:
脚本语言提供与JSR 223规范兼容的引擎即可。例如JavaScript、Groovy、Jython、Clojure。
方法二.2:使用外置JS脚本处理
脚本可以放在外部,正确引用即可:
function handleSubmitButtonAction() {
actiontarget.setText("Calling the Outline JavaScript");
}
同时,在FXML中引入脚本:
试运行,得到结果:
4、 添加样式控制:
添加样式表文件、字体库文件、背景图片,增加fonts.mf配置文件,修改build.xml等等,与前面纯代码开发基本一致,注意路径名(包名有变化)。
在FXML中引入样式表,并给特定的控件增加id,以便于CSS样式筛选器能够正确筛选适配:
5、 最终运行结果:
FXML方式开发界面完成。
JavaFX Scene Builder 2.0协助开发
JavaFX Scene Builder 2.0下载位置
下载完成,一路安装,开始运行:
非常简单的一个界面,就是做做界面……
配置一下:
选择JavaFX Scene Builder安装主目录,即可。
然后,双击或者右击打开FXML,则会自动使用SB编辑器打开。
尾
NetBeans是JavaFX的一个开发工具,比较好用。
除此之外,e(fx)clipse也是一个不错的JavaFX开发工具,有时间可以适当查下资料,看看如何使用。