javafx.scene.control.TextField Maven / Gradle / Ivy
/*
* Copyright (c) 2011, 2023, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package javafx.scene.control;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import javafx.beans.property.IntegerProperty;
import javafx.beans.property.ObjectProperty;
import javafx.beans.property.ObjectPropertyBase;
import javafx.beans.value.WritableValue;
import javafx.css.CssMetaData;
import javafx.css.StyleableIntegerProperty;
import javafx.css.StyleableObjectProperty;
import javafx.css.StyleableProperty;
import javafx.event.ActionEvent;
import javafx.event.EventHandler;
import javafx.geometry.Pos;
import javafx.scene.AccessibleRole;
import javafx.css.converter.EnumConverter;
import javafx.css.converter.SizeConverter;
import javafx.scene.control.skin.TextFieldSkin;
import javafx.css.Styleable;
/**
* Text input component that allows a user to enter a single line of
* unformatted text. Unlike in previous releases of JavaFX, support for multi-line
* input is not available as part of the TextField control, however this is
* the sole-purpose of the {@link TextArea} control. Additionally, if you want
* a form of rich-text editing, there is also the
* {@link javafx.scene.web.HTMLEditor HTMLEditor} control.
*
* TextField supports the notion of showing {@link #promptTextProperty() prompt text}
* to the user when there is no {@link #textProperty() text} already in the
* TextField (either via the user, or set programmatically). This is a useful
* way of informing the user as to what is expected in the text field, without
* having to resort to {@link Tooltip tooltips} or on-screen {@link Label labels}.
*
*
Example:
*
var textField = new TextField("Hello World!");
*
* 
*
* @see TextArea
* @since JavaFX 2.0
*/
public class TextField extends TextInputControl {
// Text field content
private static final class TextFieldContent extends ContentBase {
private StringBuilder characters = new StringBuilder();
@Override public String get(int start, int end) {
return characters.substring(start, end);
}
@Override public void insert(int index, String text, boolean notifyListeners) {
text = TextInputControl.filterInput(text, true, true);
if (!text.isEmpty()) {
characters.insert(index, text);
if (notifyListeners) {
fireValueChangedEvent();
}
}
}
@Override public void delete(int start, int end, boolean notifyListeners) {
if (end > start) {
characters.delete(start, end);
if (notifyListeners) {
fireValueChangedEvent();
}
}
}
@Override public int length() {
return characters.length();
}
@Override public String get() {
return characters.toString();
}
@Override public String getValue() {
return get();
}
}
/**
* The default value for {@link #prefColumnCountProperty() prefColumnCount}.
*/
public static final int DEFAULT_PREF_COLUMN_COUNT = 12;
/**
* Creates a {@code TextField} with empty text content.
*/
public TextField() {
this("");
}
/**
* Creates a {@code TextField} with initial text content.
*
* @param text A string for text content.
*/
public TextField(String text) {
super(new TextFieldContent());
getStyleClass().add("text-field");
setAccessibleRole(AccessibleRole.TEXT_FIELD);
setText(text);
}
/**
* Returns the character sequence backing the text field's content.
* @return the character sequence backing the text field's content
*/
public CharSequence getCharacters() {
return ((TextFieldContent)getContent()).characters;
}
/* *************************************************************************
* *
* Properties *
* *
**************************************************************************/
/**
* The preferred number of text columns. This is used for
* calculating the {@code TextField}'s preferred width.
*/
private IntegerProperty prefColumnCount = new StyleableIntegerProperty(DEFAULT_PREF_COLUMN_COUNT) {
private int oldValue = get();
@Override
protected void invalidated() {
int value = get();
if (value < 0) {
if (isBound()) {
unbind();
}
set(oldValue);
throw new IllegalArgumentException("value cannot be negative.");
}
oldValue = value;
}
@Override public CssMetaData getCssMetaData() {
return StyleableProperties.PREF_COLUMN_COUNT;
}
@Override
public Object getBean() {
return TextField.this;
}
@Override
public String getName() {
return "prefColumnCount";
}
};
public final IntegerProperty prefColumnCountProperty() { return prefColumnCount; }
public final int getPrefColumnCount() { return prefColumnCount.getValue(); }
public final void setPrefColumnCount(int value) { prefColumnCount.setValue(value); }
/**
* The action handler associated with this text field, or
* {@code null} if no action handler is assigned.
*
* The action handler is normally called when the user types the ENTER key.
*/
private ObjectProperty> onAction = new ObjectPropertyBase<>() {
@Override
protected void invalidated() {
setEventHandler(ActionEvent.ACTION, get());
}
@Override
public Object getBean() {
return TextField.this;
}
@Override
public String getName() {
return "onAction";
}
};
public final ObjectProperty> onActionProperty() { return onAction; }
public final EventHandler getOnAction() { return onActionProperty().get(); }
public final void setOnAction(EventHandler value) { onActionProperty().set(value); }
/**
* Specifies how the text should be aligned when there is empty
* space within the TextField.
* @return the alignment property
* @since JavaFX 2.1
*/
public final ObjectProperty alignmentProperty() {
if (alignment == null) {
alignment = new StyleableObjectProperty(Pos.CENTER_LEFT) {
@Override public CssMetaData getCssMetaData() {
return StyleableProperties.ALIGNMENT;
}
@Override public Object getBean() {
return TextField.this;
}
@Override public String getName() {
return "alignment";
}
};
}
return alignment;
}
private ObjectProperty alignment;
public final void setAlignment(Pos value) { alignmentProperty().set(value); }
public final Pos getAlignment() { return alignment == null ? Pos.CENTER_LEFT : alignment.get(); }
/* *************************************************************************
* *
* Methods *
* *
**************************************************************************/
/** {@inheritDoc} */
@Override protected Skin createDefaultSkin() {
return new TextFieldSkin(this);
}
@Override
String filterInput(String text) {
return TextInputControl.filterInput(text, true, true);
}
/* *************************************************************************
* *
* Stylesheet Handling *
* *
**************************************************************************/
private static class StyleableProperties {
private static final CssMetaData ALIGNMENT =
new CssMetaData<>("-fx-alignment",
new EnumConverter<>(Pos.class), Pos.CENTER_LEFT ) {
@Override public boolean isSettable(TextField n) {
return (n.alignment == null || !n.alignment.isBound());
}
@Override public StyleableProperty getStyleableProperty(TextField n) {
return (StyleableProperty)(WritableValue)n.alignmentProperty();
}
};
private static final CssMetaData PREF_COLUMN_COUNT =
new CssMetaData<>("-fx-pref-column-count",
SizeConverter.getInstance(), DEFAULT_PREF_COLUMN_COUNT) {
@Override
public boolean isSettable(TextField n) {
return n.prefColumnCount == null || !n.prefColumnCount.isBound();
}
@Override
public StyleableProperty getStyleableProperty(TextField n) {
return (StyleableProperty)n.prefColumnCountProperty();
}
};
private static final List> STYLEABLES;
static {
final List> styleables =
new ArrayList<>(TextInputControl.getClassCssMetaData());
styleables.add(ALIGNMENT);
styleables.add(PREF_COLUMN_COUNT);
STYLEABLES = Collections.unmodifiableList(styleables);
}
}
/**
* Gets the {@code CssMetaData} associated with this class, which may include the
* {@code CssMetaData} of its superclasses.
* @return the {@code CssMetaData}
* @since JavaFX 8.0
*/
public static List> getClassCssMetaData() {
return StyleableProperties.STYLEABLES;
}
/**
* {@inheritDoc}
* @since JavaFX 8.0
*/
@Override
public List> getControlCssMetaData() {
return getClassCssMetaData();
}
}