feat(smc): 新增文档链接 (#643)

Author: unknowIfGuestInDream

core/src/main/java/com/tlcsdm/core/javafx/controlsfx/FxAction.java

@@ -42,6 +42,8 @@
 import com.tlcsdm.core.javafx.util.Config;
 import com.tlcsdm.core.javafx.util.ConfigureUtil;
 import com.tlcsdm.core.javafx.util.JavaFxSystemUtil;
+import com.tlcsdm.core.util.CoreConstant;
+import com.tlcsdm.core.util.CoreUtil;
 import com.tlcsdm.core.util.I18nUtils;
 import javafx.event.ActionEvent;
 import javafx.scene.Node;
@@ -219,6 +221,24 @@ public static Action openSysConfig(Consumer<ActionEvent> eventHandler) {
         return openSysConfig(I18nUtils.get("core.menubar.help.openSysConfigDir"), eventHandler);
     }
 
+    public static Action api() {
+        return create("JavaFX", actionEvent -> {
+            CoreUtil.openWeb(CoreConstant.JAVAFX_API_URL);
+        }, "/com/tlcsdm/core/static/menubar/jfx.png");
+    }
+
+    public static Action cssApi() {
+        return create("CSS", actionEvent -> {
+            CoreUtil.openWeb(CoreConstant.JAVAFX_API_CSS_URL);
+        }, "/com/tlcsdm/core/static/menubar/css.png");
+    }
+
+    public static Action fxmlApi() {
+        return create("FXML", actionEvent -> {
+            CoreUtil.openWeb(CoreConstant.JAVAFX_API_FXML_URL);
+        }, "/com/tlcsdm/core/static/menubar/fxml.png");
+    }
+
     public static Action openSysConfig() {
         return openSysConfig(actionEvent -> {
             VBox vbox = new VBox();

core/src/main/java/com/tlcsdm/core/util/CoreConstant.java

@@ -0,0 +1,50 @@
+/*
+ * Copyright (c) 2023 unknowIfGuestInDream
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *     * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ *     * Neither the name of unknowIfGuestInDream, any associated website, nor the
+ * names of its contributors may be used to endorse or promote products
+ * derived from this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL UNKNOWIFGUESTINDREAM BE LIABLE FOR ANY
+ * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+package com.tlcsdm.core.util;
+
+/**
+ * @author: unknowIfGuestInDream
+ * @date: 2023/8/6 15:45
+ */
+public class CoreConstant {
+
+    /**
+     * JavaFX API
+     */
+    public static final String JAVAFX_API_URL = "https://openjfx.io/javadoc/17";
+
+    /**
+     * JavaFX CSS API
+     */
+    public static final String JAVAFX_API_CSS_URL = "https://openjfx.io/javadoc/17/javafx.graphics/javafx/scene/doc-files/cssref.html";
+
+    /**
+     * JavaFX FXML API
+     */
+    public static final String JAVAFX_API_FXML_URL = "https://openjfx.io/javadoc/17/javafx.fxml/javafx/fxml/doc-files/introduction_to_fxml.html";
+}

core/src/main/resources/com/tlcsdm/core/static/menubar/css.png

@@ -65,7 +65,6 @@
 import javafx.scene.Node;
 import javafx.scene.Scene;
 import javafx.scene.control.Label;
-import javafx.scene.control.MenuBar;
 import javafx.scene.control.TextField;
 import javafx.scene.control.TreeCell;
 import javafx.scene.control.TreeItem;
@@ -75,6 +74,7 @@
 import javafx.scene.layout.AnchorPane;
 import javafx.scene.layout.BorderPane;
 import javafx.scene.layout.GridPane;
+import javafx.scene.layout.HBox;
 import javafx.scene.layout.Priority;
 import javafx.scene.layout.VBox;
 import javafx.scene.paint.Color;
@@ -216,8 +216,8 @@ public void initializeUI() {
 
         // menubar
         if (menubarConfigration != null) {
-            MenuBar menuBar = menubarConfigration.getMenuBar();
-            bp.setTop(menuBar);
+            HBox menuBox = menubarConfigration.getMenuBox();
+            bp.setTop(menuBox);
         }
 
         // --- left hand side

core/src/main/resources/com/tlcsdm/core/static/menubar/fxml.png

@@ -27,9 +27,11 @@
 
 package com.tlcsdm.frame.service;
 
-import com.tlcsdm.frame.FXSampler;
+import javafx.scene.control.Menu;
 import javafx.scene.control.MenuBar;
-import javafx.stage.Stage;
+import javafx.scene.layout.HBox;
+import javafx.scene.layout.Priority;
+import javafx.scene.layout.Region;
 
 /**
  * 菜单栏配置(应用模块实现)
@@ -41,14 +43,18 @@ public interface MenubarConfigration {
     MenuBar setMenuBar(MenuBar menuBar);
 
     default MenuBar getMenuBar() {
-        Stage primaryStage = FXSampler.getStage();
         setMenuBar(menuBar);
-        // 设置菜单条长度
-        menuBar.setPrefWidth(primaryStage.getWidth());
-        // 宽度监听设置菜单条长度
-        menuBar.widthProperty()
-            .addListener((observable, oldValue, newValue) -> menuBar.setPrefWidth(newValue.doubleValue()));
         return menuBar;
     }
 
+    default HBox getMenuBox() {
+        MenuBar leftBar = getMenuBar();
+        MenuBar rightBar = new MenuBar();
+        rightBar.getMenus().addAll(new Menu("Help"));
+        Region spacer = new Region();
+        spacer.getStyleClass().add("menu-bar");
+        HBox.setHgrow(spacer, Priority.SOMETIMES);
+        return new HBox(leftBar, spacer);
+    }
+
 }

core/src/main/resources/com/tlcsdm/core/static/menubar/jfx.png

@@ -101,6 +101,10 @@ public class QeMenubarConfigrationProvider implements MenubarConfigration {
 
     private final Action openUserData = FxAction.openUserData();
 
+    private final Action api = FxAction.api();
+    private final Action css = FxAction.cssApi();
+    private final Action fxml = FxAction.fxmlApi();
+
     private final Action about = FxAction.about(actionEvent -> {
         Consumer<String> showLink = (string) -> {
             if ("openSourceSoftware".equals(string)) {
@@ -167,7 +171,7 @@ public class QeMenubarConfigrationProvider implements MenubarConfigration {
         FxActionGroup.file(export, induct, ACTION_SEPARATOR, restart, exit),
         FxActionGroup.setting(systemSetting, FxActionGroup.language(chinese, english, japanese)),
         FxActionGroup.tool(logConsole, pathWatch, colorPicker, screenshot), FxActionGroup.help(openSysConfig, openLogDir, openUserData, ACTION_SEPARATOR,
-            contactSupport, submitFeedback, ACTION_SEPARATOR, release, about));
+            contactSupport, submitFeedback, ACTION_SEPARATOR, api, css, fxml, ACTION_SEPARATOR, release, about));
 
     /**
      * 初始化action

frame/src/main/java/com/tlcsdm/frame/FXSampler.java

@@ -101,6 +101,10 @@ public class SmcMenubarConfigrationProvider implements MenubarConfigration {
 
     private final Action openUserData = FxAction.openUserData();
 
+    private final Action api = FxAction.api();
+    private final Action css = FxAction.cssApi();
+    private final Action fxml = FxAction.fxmlApi();
+
     private final Action about = FxAction.about(actionEvent -> {
         Consumer<String> showLink = (string) -> {
             if ("openSourceSoftware".equals(string)) {
@@ -167,7 +171,7 @@ public class SmcMenubarConfigrationProvider implements MenubarConfigration {
         FxActionGroup.file(export, induct, ACTION_SEPARATOR, restart, exit),
         FxActionGroup.setting(systemSetting, FxActionGroup.language(chinese, english, japanese)),
         FxActionGroup.tool(logConsole, pathWatch, colorPicker, screenshot), FxActionGroup.help(openSysConfig, openLogDir, openUserData,
-            ACTION_SEPARATOR, contactSupport, submitFeedback, ACTION_SEPARATOR, release, about));
+            ACTION_SEPARATOR, contactSupport, submitFeedback, ACTION_SEPARATOR, api, css, fxml, ACTION_SEPARATOR, release, about));
 
     /**
      * 初始化action