de.jensd.fx.glyphs.GlyphIcon Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of fontawesomefx Show documentation
Show all versions of fontawesomefx Show documentation
Use WebFonts as icon source for JavaFX applications.
/**
* Copyright (c) 2016 Jens Deters http://www.jensd.de
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations under
* the License.
*
*/
package de.jensd.fx.glyphs;
import com.sun.javafx.css.ParsedValueImpl;
import com.sun.javafx.css.parser.CSSParser;
import java.lang.reflect.ParameterizedType;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import java.util.logging.Level;
import java.util.logging.Logger;
import javafx.beans.property.ObjectProperty;
import javafx.beans.property.SimpleStringProperty;
import javafx.beans.property.StringProperty;
import javafx.css.CssMetaData;
import javafx.css.SimpleStyleableObjectProperty;
import javafx.css.StyleConverter;
import javafx.css.Styleable;
import javafx.css.StyleableProperty;
import javafx.fxml.FXML;
import javafx.scene.text.Font;
import javafx.scene.text.Text;
/**
* A GlyphIcon represents an Icon Node.
*
* @author Jens Deters
* @param The type of GlyphIcons enum.
*/
public abstract class GlyphIcon & GlyphIcons> extends Text {
public final static Double DEFAULT_ICON_SIZE = 12.0;
public final static String DEFAULT_FONT_SIZE = "1em";
private final static CSSParser CSS_PARSER = new CSSParser();
private StringProperty glyphStyle; // needed as setStyle() is final in javafx.scene.text.Text
private ObjectProperty glyphName;
private ObjectProperty glyphSize;
public final Class typeOfT;
@FXML
public void init() {
}
public GlyphIcon(Class iconType) {
this.typeOfT = iconType;
initProperties();
}
private void initProperties() {
getStyleClass().addAll("root", "glyph-icon");
glyphSizeProperty().addListener(observable -> {
updateSize();
});
glyphStyleProperty().addListener(observable -> {
updateStyle();
});
glyphNameProperty().addListener(observable -> {
updateIcon();
});
setIcon(getDefaultGlyph());
}
// convenience method
public final GlyphIcon setStyleClass(String styleClass) {
getStyleClass().add(styleClass);
return this;
}
public final StringProperty glyphStyleProperty() {
if (glyphStyle == null) {
glyphStyle = new SimpleStringProperty("");
}
return glyphStyle;
}
public final String getGlyphStyle() {
return glyphStyleProperty().getValue();
}
public final void setGlyphStyle(String style) {
glyphStyleProperty().setValue(style);
}
public final ObjectProperty glyphNameProperty() {
if (glyphName == null) {
glyphName = new SimpleStyleableObjectProperty<>(StyleableProperties.GLYPH_NAME, GlyphIcon.this, "glyphName");
}
return glyphName;
}
public final String getGlyphName() {
return glyphNameProperty().getValue();
}
public final void setGlyphName(String glyphName) {
glyphNameProperty().setValue(glyphName);
}
public final ObjectProperty glyphSizeProperty() {
if (glyphSize == null) {
glyphSize = new SimpleStyleableObjectProperty<>(StyleableProperties.GLYPH_SIZE, GlyphIcon.this, "glyphSize");
glyphSize.setValue(DEFAULT_ICON_SIZE);
}
return glyphSize;
}
public final Number getGlyphSize() {
return glyphSizeProperty().getValue();
}
public final void setGlyphSize(Number size) {
size = (size == null) ? DEFAULT_ICON_SIZE : size;
glyphSizeProperty().setValue(size);
}
// kept for compability reasons and for SceneBuilder/FXML support
public final String getSize() {
return getGlyphSize().toString();
}
// kept for compability reasons and for SceneBuilder/FXML support
public final void setSize(String sizeExpr) {
Number s = convert(sizeExpr);
setGlyphSize(s);
}
public final void setIcon(T glyph) {
setGlyphName(glyph.name());
}
abstract public T getDefaultGlyph();
private void updateSize() {
Font f = new Font(getFont().getFamily(), getGlyphSize().doubleValue());
setFont(f);
}
private void updateIcon() {
GlyphIcons icon = getDefaultGlyph();
try {
icon = Enum.valueOf(typeOfT, getGlyphName());
} catch (Exception e) {
String msg = String.format("Icon '%s' not found. Using '%s' (default) instead", getGlyphName(), getDefaultGlyph());
Logger.getLogger(GlyphIcon.class.getName()).log(Level.SEVERE, msg);
}
setText(icon.characterToString());
}
private void updateStyle() {
setStyle(getGlyphStyle());
}
// CSS
private static class StyleableProperties {
private static final CssMetaData GLYPH_NAME
= new CssMetaData("-glyph-name", StyleConverter.getStringConverter(), "BLANK") {
@Override
public boolean isSettable(GlyphIcon styleable) {
return styleable.glyphName == null || !styleable.glyphName.isBound();
}
@Override
public StyleableProperty getStyleableProperty(GlyphIcon styleable) {
return (StyleableProperty) styleable.glyphNameProperty();
}
@Override
public String getInitialValue(GlyphIcon styleable) {
return "BLANK";
}
};
private static final CssMetaData GLYPH_SIZE
= new CssMetaData("-glyph-size", StyleConverter.getSizeConverter(), DEFAULT_ICON_SIZE) {
@Override
public boolean isSettable(GlyphIcon styleable) {
return styleable.glyphSize == null || !styleable.glyphSize.isBound();
}
@Override
public StyleableProperty getStyleableProperty(GlyphIcon styleable) {
return (StyleableProperty) styleable.glyphSizeProperty();
}
@Override
public Number getInitialValue(GlyphIcon styleable) {
return DEFAULT_ICON_SIZE;
}
};
private static final List> STYLEABLES;
static {
final List> styleables = new ArrayList<>(Text.getClassCssMetaData());
Collections.addAll(styleables, GLYPH_NAME, GLYPH_SIZE);
STYLEABLES = Collections.unmodifiableList(styleables);
}
}
public static List> getClassCssMetaData() {
return StyleableProperties.STYLEABLES;
}
@Override
public List> getCssMetaData() {
return getClassCssMetaData();
}
public Number convert(String sizeString) {
ParsedValueImpl parsedValueImpl = CSS_PARSER.parseExpr("", sizeString);
return (Number) parsedValueImpl.convert(getFont());
}
}