Browse Source
Merge in DESIGN/design from ~ZHANYING/design:feature/x to feature/x * commit '7818b5a4d4bc0dda4928d9062617dd12c753f2c2': feat: FRM引导提示使用FVS #REPORT-136793feature/x
2 changed files with 310 additions and 0 deletions
@ -0,0 +1,260 @@ |
|||||||
|
package com.fr.design.mainframe.guide; |
||||||
|
|
||||||
|
import com.fr.base.svg.IconUtils; |
||||||
|
import com.fr.design.gui.ilable.UILabel; |
||||||
|
import com.fr.design.i18n.Toolkit; |
||||||
|
import com.fr.design.layout.FRGUIPaneFactory; |
||||||
|
import com.fr.design.ui.util.UIUtil; |
||||||
|
import com.fr.log.FineLoggerFactory; |
||||||
|
import com.fr.stable.StringUtils; |
||||||
|
|
||||||
|
import javax.swing.BorderFactory; |
||||||
|
import javax.swing.Icon; |
||||||
|
import javax.swing.JButton; |
||||||
|
import javax.swing.JComponent; |
||||||
|
import javax.swing.JPanel; |
||||||
|
import javax.swing.JTextPane; |
||||||
|
import javax.swing.UIManager; |
||||||
|
import javax.swing.border.LineBorder; |
||||||
|
import javax.swing.event.AncestorEvent; |
||||||
|
import javax.swing.event.AncestorListener; |
||||||
|
import javax.swing.event.HyperlinkEvent; |
||||||
|
import java.awt.BorderLayout; |
||||||
|
import java.awt.Color; |
||||||
|
import java.awt.Desktop; |
||||||
|
import java.awt.Dimension; |
||||||
|
import java.awt.Font; |
||||||
|
import java.awt.FontMetrics; |
||||||
|
import java.awt.Insets; |
||||||
|
import java.awt.event.ActionEvent; |
||||||
|
import java.awt.event.ComponentAdapter; |
||||||
|
import java.awt.event.ComponentEvent; |
||||||
|
|
||||||
|
/** |
||||||
|
* FRM引导提示使用FVS |
||||||
|
* |
||||||
|
* @author Zhanying |
||||||
|
* @since 11.0 |
||||||
|
* Created on 2024/12/20 |
||||||
|
*/ |
||||||
|
public class FvsGuidePane extends JPanel { |
||||||
|
private static final String OMIT_TEXT = "..."; |
||||||
|
private static final Color BACKGROUND_COLOR = new Color(255, 251, 230); |
||||||
|
private static final Color BORDER_COLOR = new Color(255, 229, 143); |
||||||
|
private static final Icon TIP_ICON = UIManager.getIcon("OptionPane.circularWarningIcon"); |
||||||
|
private static final Icon CLOSE_ICON = IconUtils.readIcon("/com/fr/design/standard/close/close"); |
||||||
|
// 引导URL
|
||||||
|
private static final String GUIDE_URL = "https://help.fanruan.com/finereport/doc-view-4222.html?source=3"; |
||||||
|
private static final int MAX_PANE_HEIGHT = 80; |
||||||
|
private static final int MAX_CONTENT_HEIGHT = 60; |
||||||
|
private static final int LINE_HEIGHT = 20; |
||||||
|
// 计算文本框最多能容纳的行数 = 最大高度 / 行高，向下取整
|
||||||
|
private static final int MAX_LINES = (int) Math.floor((double) MAX_CONTENT_HEIGHT / LINE_HEIGHT); |
||||||
|
private static final String CONTENT_FORMAT = "<html>\n<body style=\"font-family: %s; font-size: %spt;\">\n %s\n</body>\n</html>"; |
||||||
|
private final JComponent parent; |
||||||
|
private JTextPane textPane; |
||||||
|
|
||||||
|
public FvsGuidePane(JComponent parent) { |
||||||
|
super(); |
||||||
|
this.parent = parent; |
||||||
|
initUI(); |
||||||
|
} |
||||||
|
|
||||||
|
private void initUI() { |
||||||
|
this.setLayout(FRGUIPaneFactory.createBorderLayout()); |
||||||
|
this.setLayout(new BorderLayout()); |
||||||
|
this.setBorder(new LineBorder(BORDER_COLOR)); |
||||||
|
this.setBackground(BACKGROUND_COLOR); |
||||||
|
this.setMaximumSize(new Dimension(Integer.MAX_VALUE, MAX_PANE_HEIGHT)); |
||||||
|
JPanel wrapPane = new JPanel(new BorderLayout(10, 0)); |
||||||
|
wrapPane.setBorder(BorderFactory.createEmptyBorder(8, 13, 8, 13)); |
||||||
|
wrapPane.setBackground(BACKGROUND_COLOR); |
||||||
|
wrapPane.add(this.createIconPane(), BorderLayout.WEST); |
||||||
|
wrapPane.add(this.createContentPane(), BorderLayout.CENTER); |
||||||
|
wrapPane.add(this.createCloseBtnPane(), BorderLayout.EAST); |
||||||
|
this.add(wrapPane, BorderLayout.CENTER); |
||||||
|
addListener(); |
||||||
|
} |
||||||
|
|
||||||
|
private void addListener() { |
||||||
|
this.textPane.addComponentListener(new ComponentAdapter() { |
||||||
|
@Override |
||||||
|
public void componentResized(ComponentEvent e) { |
||||||
|
refreshText(); |
||||||
|
} |
||||||
|
}); |
||||||
|
this.textPane.addAncestorListener(new AncestorListener() { |
||||||
|
@Override |
||||||
|
public void ancestorAdded(AncestorEvent event) { |
||||||
|
UIUtil.invokeLaterIfNeeded(FvsGuidePane.this::refreshText); |
||||||
|
} |
||||||
|
|
||||||
|
@Override |
||||||
|
public void ancestorRemoved(AncestorEvent event) { |
||||||
|
|
||||||
|
} |
||||||
|
|
||||||
|
@Override |
||||||
|
public void ancestorMoved(AncestorEvent event) { |
||||||
|
|
||||||
|
} |
||||||
|
}); |
||||||
|
} |
||||||
|
|
||||||
|
private JPanel createIconPane() { |
||||||
|
// 图标
|
||||||
|
JPanel panel = new JPanel(new BorderLayout()); |
||||||
|
panel.setBorder(BorderFactory.createEmptyBorder(6, 0, 0, 0)); |
||||||
|
panel.setBackground(BACKGROUND_COLOR); |
||||||
|
UILabel iconLabel = new UILabel(TIP_ICON); |
||||||
|
panel.add(iconLabel, BorderLayout.NORTH); |
||||||
|
return panel; |
||||||
|
} |
||||||
|
|
||||||
|
private JPanel createCloseBtnPane() { |
||||||
|
JPanel panel = new JPanel(new BorderLayout()); |
||||||
|
panel.setBackground(BACKGROUND_COLOR); |
||||||
|
JButton closeButton = new JButton(this.closeBtnText(), CLOSE_ICON); |
||||||
|
closeButton.setOpaque(false); |
||||||
|
closeButton.setBorderPainted(false); |
||||||
|
closeButton.setContentAreaFilled(false); |
||||||
|
closeButton.addActionListener(this::close); |
||||||
|
panel.add(closeButton, BorderLayout.NORTH); |
||||||
|
return panel; |
||||||
|
} |
||||||
|
|
||||||
|
private JPanel createContentPane() { |
||||||
|
JPanel contentPane = new JPanel(new BorderLayout()); |
||||||
|
contentPane.setBackground(BACKGROUND_COLOR); |
||||||
|
textPane = new JTextPane(); |
||||||
|
// 设置文本格式为 HTML
|
||||||
|
textPane.setContentType("text/html"); |
||||||
|
textPane.setEditable(false); |
||||||
|
textPane.setBackground(BACKGROUND_COLOR); |
||||||
|
|
||||||
|
// 添加超链接监听器
|
||||||
|
textPane.addHyperlinkListener(e -> { |
||||||
|
if (HyperlinkEvent.EventType.ACTIVATED.equals(e.getEventType())) { |
||||||
|
// 用户点击了超链接，处理跳转
|
||||||
|
try { |
||||||
|
Desktop.getDesktop().browse(e.getURL().toURI()); |
||||||
|
} catch (Exception ex) { |
||||||
|
FineLoggerFactory.getLogger().error(ex.getMessage(), ex); |
||||||
|
} |
||||||
|
} |
||||||
|
}); |
||||||
|
contentPane.add(textPane, BorderLayout.CENTER); |
||||||
|
return contentPane; |
||||||
|
} |
||||||
|
|
||||||
|
private void refreshText() { |
||||||
|
int textPaneWidth = textPane.getWidth(); |
||||||
|
if (textPaneWidth <= 0) { |
||||||
|
return; |
||||||
|
} |
||||||
|
// 获取可用宽度：减去可能的左右边距
|
||||||
|
Insets insets = textPane.getInsets(); |
||||||
|
int availableWidth = textPaneWidth - insets.left - insets.right - 15;// 留点冗余
|
||||||
|
// 组装html
|
||||||
|
String buildHtml = buildHtml(textPane.getFont(), autoChangeLineAndOmit(availableWidth)); |
||||||
|
textPane.setText(buildHtml); |
||||||
|
} |
||||||
|
|
||||||
|
private String tipContent() { |
||||||
|
return Toolkit.i18nText("Fine-Design_Form_Guide_Use_Fvs_Tips"); |
||||||
|
} |
||||||
|
|
||||||
|
private String linkContent() { |
||||||
|
return Toolkit.i18nText("Fine-Design_Form_Guide_Use_Fvs_Link_Tips"); |
||||||
|
} |
||||||
|
|
||||||
|
private void close(ActionEvent e) { |
||||||
|
parent.remove(this); |
||||||
|
parent.revalidate(); |
||||||
|
parent.repaint(); |
||||||
|
} |
||||||
|
|
||||||
|
private String closeBtnText() { |
||||||
|
return Toolkit.i18nText("Fine-Design_Form_Guide_Use_Fvs_Close_Tips"); |
||||||
|
} |
||||||
|
|
||||||
|
private String buildHtml(Font font, String text) { |
||||||
|
return String.format(CONTENT_FORMAT, font.getFamily(), font.getSize(), text); |
||||||
|
} |
||||||
|
|
||||||
|
private String autoChangeLineAndOmit(double width) { |
||||||
|
StringBuilder htmlBuilder = new StringBuilder(); |
||||||
|
// 获取字体的大小
|
||||||
|
FontMetrics fontMetrics = textPane.getFontMetrics(textPane.getFont()); |
||||||
|
// 计算行间距
|
||||||
|
int lineSpace = LINE_HEIGHT - fontMetrics.getHeight(); |
||||||
|
String divStart = String.format("<div style=\"margin-bottom: %spt; margin-top: %spt;\">", lineSpace / 2, lineSpace / 2); |
||||||
|
htmlBuilder.append(divStart); |
||||||
|
|
||||||
|
// 计算省略号的长度
|
||||||
|
int omitLength = getStringWidth(OMIT_TEXT, fontMetrics); |
||||||
|
|
||||||
|
String linkContent = linkContent(); |
||||||
|
// 计算超链的长度
|
||||||
|
int linkLength = getStringWidth(linkContent, fontMetrics); |
||||||
|
|
||||||
|
String tipContent = tipContent(); |
||||||
|
|
||||||
|
// 宽度已经小于省略号+超链的宽度
|
||||||
|
boolean widthTooSmall = width < omitLength + linkLength; |
||||||
|
if (StringUtils.isNotEmpty(tipContent)) { |
||||||
|
char[] chars = tipContent.toCharArray(); |
||||||
|
|
||||||
|
int row = 1; |
||||||
|
int off = 0; |
||||||
|
for (int i = 0; i < chars.length; i++) { |
||||||
|
// 当前行占的宽度
|
||||||
|
int currRowWidth = fontMetrics.charsWidth(chars, off, i - off); |
||||||
|
// 到最后一行
|
||||||
|
if (row == MAX_LINES) { |
||||||
|
// 计算省略号的位置
|
||||||
|
if (currRowWidth + omitLength + linkLength > width) { |
||||||
|
//拼上省略号
|
||||||
|
htmlBuilder.append(OMIT_TEXT); |
||||||
|
break; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
if (currRowWidth > width) { |
||||||
|
// 换行
|
||||||
|
htmlBuilder.append("</div>").append(divStart); |
||||||
|
off = i; |
||||||
|
row++; |
||||||
|
} else if (widthTooSmall && simulateIfLastLineOverflows(fontMetrics, currRowWidth, row, (OMIT_TEXT + linkContent).toCharArray(), width)) { |
||||||
|
//模拟到最后一行是否溢出；其实这么窄展示也没什么意义了
|
||||||
|
//拼上省略号
|
||||||
|
htmlBuilder.append(OMIT_TEXT); |
||||||
|
break; |
||||||
|
} |
||||||
|
htmlBuilder.append(chars[i]); |
||||||
|
} |
||||||
|
} |
||||||
|
htmlBuilder.append("<a href=\"").append(GUIDE_URL).append("\">").append(linkContent).append("</a></div>"); |
||||||
|
return htmlBuilder.toString(); |
||||||
|
} |
||||||
|
|
||||||
|
private boolean simulateIfLastLineOverflows(FontMetrics fontMetrics, int currRowWidth, int row, char[] omitAndLink, double width) { |
||||||
|
int off = 0; |
||||||
|
for (int i = 0; i < omitAndLink.length; i++) { |
||||||
|
boolean lastRow = row == MAX_LINES; |
||||||
|
if (currRowWidth + fontMetrics.charsWidth(omitAndLink, off, i - off) > (lastRow ? width - 30 : width)) { // 最后一行留点冗余
|
||||||
|
if (lastRow) { |
||||||
|
return true; |
||||||
|
} |
||||||
|
off = i; |
||||||
|
currRowWidth = 0; |
||||||
|
row++; |
||||||
|
} |
||||||
|
} |
||||||
|
return false; |
||||||
|
} |
||||||
|
|
||||||
|
private int getStringWidth(String str, FontMetrics fontMetrics) { |
||||||
|
return fontMetrics.charsWidth(str.toCharArray(), 0, str.length()); |
||||||
|
} |
||||||
|
} |
||||||
Loading…
Reference in new issue