Spec-Zone.ru › OpenJavaFX 24

Класс TextArea

java.lang.Object
javafx.scene.Node
javafx.scene.Parent
javafx.scene.layout.Region
javafx.scene.control.Control
javafx.scene.control.TextInputControl
javafx.scene.control.TextArea
Все реализованные интерфейсы:
Styleable, EventTarget, Skinnable 
public class TextArea extends TextInputControl
Компонент ввода текста, позволяющий пользователю вводить несколько строк простого текста. В отличие от предыдущих версий JavaFX, поддержка ввода одной строки недоступна в качестве части компонента TextArea, однако для этой цели предназначен компонент TextField. Кроме того, если вам требуется редактирование форматированного текста, существует компонент HTMLEditor.

TextArea поддерживает отображения подсказки prompt text пользователю, когда в TextArea нет text (либо от пользователя, либо заданного программно). Это полезный способ информирования пользователя о том, что ожидается в текстовом поле, без необходимости использовать tooltips или на экране labels.

Пример: 

 var textArea = new TextArea("Lorem ipsum dolor sit amet, consectetur adipiscing elit, "
        + "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim "
        + "ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip "
        + "ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate "
        + "velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat "
        + "cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.");
 textArea.setWrapText(true);
Image of the TextArea control
С момента:
JavaFX 2.0
См. также:
  • TextField

Краткое описание вложенных классов

Вложенные классы/интерфейсы, объявленные в классе javafx.scene.control.TextInputControl

TextInputControl.Content

Краткое описание свойств

Тип Свойство Описание
final IntegerProperty prefColumnCount
Предпочитаемое количество столбцов текста.
final IntegerProperty prefRowCount
Предпочитаемое количество строк текста.
final DoubleProperty scrollLeft
Количество пикселей горизонтального смещения содержимого.
final DoubleProperty scrollTop
Количество пикселей вертикального смещения содержимого.
final BooleanProperty wrapText
Если строка текста превышает ширину TextArea, то эта переменная указывает, нужно ли переносить текст на новую строку.

Свойства, объявленные в классе javafx.scene.control.TextInputControl

anchor, caretPosition, editable, font, length, promptText, redoable, selectedText, selection, textFormatter, text, undoable

Свойства, объявленные в классе javafx.scene.control.Control

contextMenu, skin, tooltip

Свойства, объявленные в классе javafx.scene.layout.Region

background, border, cacheShape, centerShape, height, insets, maxHeight, maxWidth, minHeight, minWidth, opaqueInsets, padding, prefHeight, prefWidth, scaleShape, shape, snapToPixel, width

Свойства, объявленные в классе javafx.scene.Parent

needsLayout

Свойства, объявленные в классе javafx.scene.Node

accessibleHelp, accessibleRoleDescription, accessibleRole, accessibleText, blendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effectiveNodeOrientation, effect, eventDispatcher, focused, focusTraversable, focusVisible, focusWithin, hover, id, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, nodeOrientation, onContextMenuRequested, onDragDetected, onDragDone, onDragDropped, onDragEntered, onDragExited, onDragOver, onInputMethodTextChanged, onKeyPressed, onKeyReleased, onKeyTyped, onMouseClicked, onMouseDragEntered, onMouseDragExited, onMouseDragged, onMouseDragOver, onMouseDragReleased, onMouseEntered, onMouseExited, onMouseMoved, onMousePressed, onMouseReleased, onRotate, onRotationFinished, onRotationStarted, onScrollFinished, onScroll, onScrollStarted, onSwipeDown, onSwipeLeft, onSwipeRight, onSwipeUp, onTouchMoved, onTouchPressed, onTouchReleased, onTouchStationary, onZoomFinished, onZoom, onZoomStarted, opacity, parent, pickOnBounds, pressed, rotate, rotationAxis, scaleX, scaleY, scaleZ, scene, style, translateX, translateY, translateZ, viewOrder, visible

Краткое описание полей

Модификатор и тип Поле Описание
static final int DEFAULT_PREF_COLUMN_COUNT
Значение по умолчанию для prefColumnCount.
static final int DEFAULT_PREF_ROW_COUNT
Значение по умолчанию для prefRowCount.

Поля, объявленные в классе javafx.scene.layout.Region

USE_COMPUTED_SIZE, USE_PREF_SIZE

Поля, объявленные в классе javafx.scene.Node

BASELINE_OFFSET_SAME_AS_HEIGHT

Краткое описание конструкторов

Конструктор Описание
TextArea()
Создает TextArea с пустым текстовым содержимым.
TextArea(String text)
Создает TextArea с начальным текстовым содержимым.

Краткое описание методов

Модификатор и тип Метод Описание
static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
Получает CssMetaData, ассоциированное с этим классом, что может включать CssMetaData его суперклассов.
List<CssMetaData<? extends Styleable,?>> getControlCssMetaData()
Получает неизменяемый список стилизуемых CSS-свойств элемента управления.
ObservableList<CharSequence> getParagraphs()
Возвращает неизменяемый список последовательностей символов, которые хранят содержимое текстовой области.
final int getPrefColumnCount()
Получает значение свойства prefColumnCount.
final int getPrefRowCount()
Получает значение свойства prefRowCount.
final double getScrollLeft()
Получает значение свойства scrollLeft.
final double getScrollTop()
Получает значение свойства scrollTop.
final boolean isWrapText()
Получает значение свойства wrapText.
final IntegerProperty prefColumnCountProperty()
Предпочитаемое количество столбцов текста.
final IntegerProperty prefRowCountProperty()
Предпочитаемое количество строк текста.
final DoubleProperty scrollLeftProperty()
Количество пикселей горизонтального смещения содержимого.
final DoubleProperty scrollTopProperty()
Количество пикселей вертикального смещения содержимого.
final void setPrefColumnCount(int value)
Устанавливает значение свойства prefColumnCount.
final void setPrefRowCount(int value)
Устанавливает значение свойства prefRowCount.
final void setScrollLeft(double value)
Устанавливает значение свойства scrollLeft.
final void setScrollTop(double value)
Устанавливает значение свойства scrollTop.
final void setWrapText(boolean value)
Устанавливает значение свойства wrapText.
final BooleanProperty wrapTextProperty()
Если строка текста превышает ширину TextArea, то эта переменная указывает, нужно ли переносить текст на новую строку.

Методы, объявленные в классе javafx.scene.control.TextInputControl

anchorProperty, appendText, backward, cancelEdit, caretPositionProperty, clear, commitValue, copy, cut, deleteNextChar, deletePreviousChar, deleteText, deleteText, deselect, editableProperty, end, endOfNextWord, extendSelection, fontProperty, forward, getAnchor, getCaretPosition, getContent, getFont, getLength, getPromptText, getSelectedText, getSelection, getText, getText, getTextFormatter, home, insertText, isEditable, isRedoable, isUndoable, lengthProperty, nextWord, paste, positionCaret, previousWord, promptTextProperty, redo, redoableProperty, replaceSelection, replaceText, replaceText, selectAll, selectBackward, selectedTextProperty, selectEnd, selectEndOfNextWord, selectForward, selectHome, selectionProperty, selectNextWord, selectPositionCaret, selectPreviousWord, selectRange, setEditable, setFont, setPromptText, setText, setTextFormatter, textFormatterProperty, textProperty, undo, undoableProperty

Методы, объявленные в классе javafx.scene.control.Control

computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, contextMenuProperty, createDefaultSkin, getContextMenu, getCssMetaData, getInitialFocusTraversable, getSkin, getTooltip, isResizable, setContextMenu, setSkin, setTooltip, skinProperty, tooltipProperty

Методы, объявленные в классе javafx.scene.layout.Region

backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, computePrefHeight, computePrefWidth, getBackground, getBorder, getHeight, getInsets, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getOpaqueInsets, getPadding, getPrefHeight, getPrefWidth, getShape, getUserAgentStylesheet, getWidth, heightProperty, insetsProperty, isCacheShape, isCenterShape, isScaleShape, isSnapToPixel, layoutInArea, layoutInArea, layoutInArea, layoutInArea, maxHeight, maxHeightProperty, maxWidth, maxWidthProperty, minHeight, minHeightProperty, minWidth, minWidthProperty, opaqueInsetsProperty, paddingProperty, positionInArea, positionInArea, prefHeight, prefHeightProperty, prefWidth, prefWidthProperty, resize, scaleShapeProperty, setBackground, setBorder, setCacheShape, setCenterShape, setHeight, setMaxHeight, setMaxSize, setMaxWidth, setMinHeight, setMinSize, setMinWidth, setOpaqueInsets, setPadding, setPrefHeight, setPrefSize, setPrefWidth, setScaleShape, setShape, setSnapToPixel, setWidth, shapeProperty, snappedBottomInset, snappedLeftInset, snappedRightInset, snappedTopInset, snapPosition, snapPositionX, snapPositionY, snapSize, snapSizeX, snapSizeY, snapSpace, snapSpaceX, snapSpaceY, snapToPixelProperty, widthProperty

Методы, объявленные в классе javafx.scene.Parent

getBaselineOffset, getChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, layoutChildren, needsLayoutProperty, requestLayout, requestParentLayout, setNeedsLayout, updateBounds

Методы, объявленные в классе javafx.scene.Node

accessibleHelpProperty, accessibleRoleDescriptionProperty, accessibleRoleProperty, accessibleTextProperty, addEventFilter, addEventHandler, applyCss, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, computeAreaInScreen, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, executeAccessibleAction, fireEvent, focusedProperty, focusTraversableProperty, focusVisibleProperty, focusWithinProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getContentBias, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, getInitialCursor, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getLocalToParentTransform, getLocalToSceneTransform, getNodeOrientation, getOnContextMenuRequested, getOnDragDetected, getOnDragDone, getOnDragDropped, getOnDragEntered, getOnDragExited, getOnDragOver, getOnInputMethodTextChanged, getOnKeyPressed, getOnKeyReleased, getOnKeyTyped, getOnMouseClicked, getOnMouseDragEntered, getOnMouseDragExited, getOnMouseDragged, getOnMouseDragOver, getOnMouseDragReleased, getOnMouseEntered, getOnMouseExited, getOnMouseMoved, getOnMousePressed, getOnMouseReleased, getOnRotate, getOnRotationFinished, getOnRotationStarted, getOnScroll, getOnScrollFinished, getOnScrollStarted, getOnSwipeDown, getOnSwipeLeft, getOnSwipeRight, getOnSwipeUp, getOnTouchMoved, getOnTouchPressed, getOnTouchReleased, getOnTouchStationary, getOnZoom, getOnZoomFinished, getOnZoomStarted, getOpacity, getParent, getProperties, getPseudoClassStates, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleableParent, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, getViewOrder, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isFocusVisible, isFocusWithin, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToSceneTransformProperty, localToScreen, localToScreen, localToScreen, localToScreen, localToScreen, lookup, lookupAll, managedProperty, mouseTransparentProperty, nodeOrientationProperty, notifyAccessibleAttributeChanged, onContextMenuRequestedProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDragEnteredProperty, onMouseDragExitedProperty, onMouseDraggedProperty, onMouseDragOverProperty, onMouseDragReleasedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onRotateProperty, onRotationFinishedProperty, onRotationStartedProperty, onScrollFinishedProperty, onScrollProperty, onScrollStartedProperty, onSwipeDownProperty, onSwipeLeftProperty, onSwipeRightProperty, onSwipeUpProperty, onTouchMovedProperty, onTouchPressedProperty, onTouchReleasedProperty, onTouchStationaryProperty, onZoomFinishedProperty, onZoomProperty, onZoomStartedProperty, opacityProperty, parentProperty, parentToLocal, parentToLocal, parentToLocal, parentToLocal, parentToLocal, pickOnBoundsProperty, pressedProperty, pseudoClassStateChanged, queryAccessibleAttribute, relocate, removeEventFilter, removeEventHandler, requestFocus, requestFocusTraversal, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, screenToLocal, screenToLocal, screenToLocal, setAccessibleHelp, setAccessibleRole, setAccessibleRoleDescription, setAccessibleText, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setNodeOrientation, setOnContextMenuRequested, setOnDragDetected, setOnDragDone, setOnDragDropped, setOnDragEntered, setOnDragExited, setOnDragOver, setOnInputMethodTextChanged, setOnKeyPressed, setOnKeyReleased, setOnKeyTyped, setOnMouseClicked, setOnMouseDragEntered, setOnMouseDragExited, setOnMouseDragged, setOnMouseDragOver, setOnMouseDragReleased, setOnMouseEntered, setOnMouseExited, setOnMouseMoved, setOnMousePressed, setOnMouseReleased, setOnRotate, setOnRotationFinished, setOnRotationStarted, setOnScroll, setOnScrollFinished, setOnScrollStarted, setOnSwipeDown, setOnSwipeLeft, setOnSwipeRight, setOnSwipeUp, setOnTouchMoved, setOnTouchPressed, setOnTouchReleased, setOnTouchStationary, setOnZoom, setOnZoomFinished, setOnZoomStarted, setOpacity, setPickOnBounds, setPressed, setRotate, setRotationAxis, setScaleX, setScaleY, setScaleZ, setStyle, setTranslateX, setTranslateY, setTranslateZ, setUserData, setViewOrder, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, viewOrderProperty, visibleProperty

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе javafx.css.Styleable

getStyleableNode

Свойства

wrapText

public final BooleanProperty wrapTextProperty
Если строка текста превышает ширину TextArea, то эта переменная указывает, нужно ли переносить текст на другую строку.
См. также:
  • isWrapText()
  • setWrapText(boolean)
  • wrapTextProperty()

prefColumnCount

public final IntegerProperty prefColumnCountProperty
Предпочтительное количество столбцов текста. Используется для вычисления предпочтительной ширины TextArea.
См. также:
  • getPrefColumnCount()
  • setPrefColumnCount(int)
  • prefColumnCountProperty()

prefRowCount

public final IntegerProperty prefRowCountProperty
Предпочтительное количество строк текста. Используется для вычисления предпочтительной высоты TextArea.
См. также:
  • getPrefRowCount()
  • setPrefRowCount(int)
  • prefRowCountProperty()

scrollTop

public final DoubleProperty scrollTopProperty
Количество пикселей, на которое содержимое прокручено вертикально.
См. также:
  • getScrollTop()
  • setScrollTop(double)
  • scrollTopProperty()

scrollLeft

public final DoubleProperty scrollLeftProperty
Количество пикселей, на которое содержимое прокручено горизонтально.
См. также:
  • getScrollLeft()
  • setScrollLeft(double)
  • scrollLeftProperty()

Подробное описание полей

DEFAULT_PREF_COLUMN_COUNT

public static final int DEFAULT_PREF_COLUMN_COUNT
Значение по умолчанию для prefColumnCount.
См. также:
  • Значения константных полей

DEFAULT_PREF_ROW_COUNT

public static final int DEFAULT_PREF_ROW_COUNT
Значение по умолчанию для prefRowCount.
См. также:
  • Значения константных полей

Подробное описание конструкторов

TextArea

public TextArea()
Создает TextArea с пустым текстовым содержимым.

TextArea

public TextArea(String text)
Создает TextArea с начальным текстовым содержимым.
Параметры:
text - Строка для текстового содержимого.

Подробное описание методов

getParagraphs

public ObservableList<CharSequence> getParagraphs()
Возвращает список неизменяемых последовательностей символов, которые являются основой содержимого текстовой области.
Возвращает:
Список неизменяемых последовательностей символов, которые являются основой содержимого текстовой области

wrapTextProperty

public final BooleanProperty wrapTextProperty()
Если строка текста превышает ширину TextArea, то эта переменная указывает, нужно ли переносить текст на другую строку.
Возвращает:
свойство wrapText
См. также:
  • isWrapText()
  • setWrapText(boolean)

isWrapText

public final boolean isWrapText()
Получает значение свойства wrapText.
Описание свойства:
Если строка текста превышает ширину TextArea, то эта переменная указывает, нужно ли переносить текст на другую строку.
Возвращает:
значение свойства wrapText
См. также:
  • setWrapText(boolean)
  • wrapTextProperty()

setWrapText

public final void setWrapText(boolean value)
Устанавливает значение свойства wrapText.
Описание свойства:
Если строка текста превышает ширину TextArea, то эта переменная указывает, нужно ли переносить текст на другую строку.
Параметры:
value - значение для свойства wrapText
См. также:
  • isWrapText()
  • wrapTextProperty()

prefColumnCountProperty

public final IntegerProperty prefColumnCountProperty()
Предпочтительное количество столбцов текста. Используется для вычисления предпочтительной ширины TextArea.
Возвращает:
свойство prefColumnCount
См. также:
  • getPrefColumnCount()
  • setPrefColumnCount(int)

getPrefColumnCount

public final int getPrefColumnCount()
Получает значение свойства prefColumnCount.
Описание свойства:
Предпочтительное количество столбцов текста. Используется для вычисления предпочтительной ширины TextArea.
Возвращает:
значение свойства prefColumnCount
См. также:
  • setPrefColumnCount(int)
  • prefColumnCountProperty()

setPrefColumnCount

public final void setPrefColumnCount(int value)
Устанавливает значение свойства prefColumnCount.
Описание свойства:
Предпочтительное количество столбцов текста. Используется для вычисления предпочтительной ширины TextArea.
Параметры:
value - значение для свойства prefColumnCount
См. также:
  • getPrefColumnCount()
  • prefColumnCountProperty()

prefRowCountProperty

public final IntegerProperty prefRowCountProperty()
Предпочтительное количество строк текста. Используется для вычисления предпочтительной высоты TextArea.
Возвращает:
свойство prefRowCount
См. также:
  • getPrefRowCount()
  • setPrefRowCount(int)

getPrefRowCount

public final int getPrefRowCount()
Получает значение свойства prefRowCount.
Описание свойства:
Предпочтительное количество строк текста. Используется для вычисления предпочтительной высоты TextArea.
Возвращает:
значение свойства prefRowCount
См. также:
  • setPrefRowCount(int)
  • prefRowCountProperty()

setPrefRowCount

public final void setPrefRowCount(int value)
Устанавливает значение свойства prefRowCount.
Описание свойства:
Предпочтительное количество строк текста. Используется для вычисления предпочтительной высоты TextArea.
Параметры:
value - значение для свойства prefRowCount
См. также:
  • getPrefRowCount()
  • prefRowCountProperty()

scrollTopProperty

public final DoubleProperty scrollTopProperty()
Количество пикселей, на которое содержимое прокручено вертикально.
Возвращает:
свойство scrollTop
См. также:
  • getScrollTop()
  • setScrollTop(double)

getScrollTop

public final double getScrollTop()
Получает значение свойства scrollTop.
Описание свойства:
Количество пикселей, на которое содержимое прокручено вертикально.
Возвращает:
значение свойства scrollTop
См. также:
  • setScrollTop(double)
  • scrollTopProperty()

setScrollTop

public final void setScrollTop(double value)
Устанавливает значение свойства scrollTop.
Описание свойства:
Количество пикселей, на которое содержимое прокручено вертикально.
Параметры:
value - значение для свойства scrollTop
См. также:
  • getScrollTop()
  • scrollTopProperty()

scrollLeftProperty

public final DoubleProperty scrollLeftProperty()
Количество пикселей, на которое содержимое прокручено горизонтально.
Возвращает:
свойство scrollLeft
См. также:
  • getScrollLeft()
  • setScrollLeft(double)

getScrollLeft

public final double getScrollLeft()
Получает значение свойства scrollLeft.
Описание свойства:
Количество пикселей, на которое содержимое прокручено горизонтально.
Возвращает:
значение свойства scrollLeft
См. также:
  • setScrollLeft(double)
  • scrollLeftProperty()

setScrollLeft

public final void setScrollLeft(double value)
Устанавливает значение свойства scrollLeft.
Описание свойства:
Количество пикселей, на которое содержимое прокручено горизонтально.
Параметры:
value - значение для свойства scrollLeft
См. также:
  • getScrollLeft()
  • scrollLeftProperty()

getClassCssMetaData

public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
Получает CssMetaData, связанное с этим классом, который может включать в себя CssMetaData его суперклассов.
Возвращает:
CssMetaData
С тех пор как:
JavaFX 8.0

getControlCssMetaData

public List<CssMetaData<? extends Styleable,?>> getControlCssMetaData()
Получает неизменяемый список стилизуемых CSS свойств элемента управления.
Переопределяет:
getControlCssMetaData в классе TextInputControl
Возвращает:
неизменяемый список стилизуемых CSS свойств элемента управления
С тех пор как:
JavaFX 8.0

Отправить отчет об ошибке или предложить улучшение
Авторское право © 2008, 2025, Oracle и/или его дочерние компании. Все права защищены.

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API