From ee850d4dad9c0f13c1ce17bbd91b4159a8a8b8ae Mon Sep 17 00:00:00 2001 From: Artur Signell Date: Fri, 26 Jun 2026 12:08:13 +0300 Subject: [PATCH 1/2] docs: reconcile @since tags with published release history (25.2) Derive every public/protected @since from the versions each API element actually appears in across the published -sources.jar artifacts on Maven Central, indexed per component artifact (their version timelines differ). Relative to the 25.2 line: new API on this branch gets @since 25.2. - add 2581 missing tags, correct 50 wrong ones, remove 12 redundant - tag 97 elements introduced in 25.2 - create 115 minimal javadoc blocks on undocumented public types charts/spreadsheet legacy framework-era tags (6.x/7.x/8.x) are rewritten to the Flow artifact timeline (e.g. spreadsheet classes -> 23.1). vaadin-spreadsheet-flow-client publishes no sources and is left untouched. --- .../flow/component/accordion/Accordion.java | 3 + .../component/accordion/AccordionPanel.java | 7 + ...omponentsExperimentalFeatureException.java | 1 + .../ai/AIComponentsFeatureFlagProvider.java | 1 + .../component/ai/chart/ChartAIController.java | 1 + .../flow/component/ai/chart/ChartAITools.java | 1 + .../ai/chart/ChartConfigurationParser.java | 1 + .../component/ai/chart/ChartRenderer.java | 1 + .../flow/component/ai/chart/ChartState.java | 1 + .../flow/component/ai/chart/ColumnNames.java | 1 + .../component/ai/chart/ConfigurationKeys.java | 1 + .../component/ai/chart/DataConverter.java | 1 + .../ai/chart/DefaultDataConverter.java | 1 + .../ai/chart/PlotOptionsSchemaGenerator.java | 2 + .../component/ai/common/AIAttachment.java | 1 + .../ai/common/AttachmentContentType.java | 2 + .../flow/component/ai/common/ChatMessage.java | 1 + .../component/ai/form/FieldValueChange.java | 1 + .../component/ai/form/FormAIController.java | 1 + .../flow/component/ai/form/ValueOptions.java | 1 + .../flow/component/ai/grid/AIDataRow.java | 1 + .../component/ai/grid/GridAIController.java | 1 + .../flow/component/ai/grid/GridAITools.java | 1 + .../flow/component/ai/grid/GridRenderer.java | 1 + .../flow/component/ai/grid/GridState.java | 1 + .../ai/orchestrator/AIController.java | 1 + .../ai/orchestrator/AIOrchestrator.java | 7 + .../orchestrator/AttachmentClickListener.java | 2 + .../ai/orchestrator/RequestListener.java | 2 + .../ai/orchestrator/ResponseListener.java | 2 + .../ai/provider/DatabaseProvider.java | 1 + .../ai/provider/DatabaseProviderAITools.java | 1 + .../component/ai/provider/LLMProvider.java | 1 + .../ai/provider/LangChain4JLLMProvider.java | 1 + .../ai/provider/SpringAILLMProvider.java | 1 + .../flow/component/ai/ui/AIFileReceiver.java | 1 + .../vaadin/flow/component/ai/ui/AIInput.java | 1 + .../flow/component/ai/ui/AIMessage.java | 1 + .../flow/component/ai/ui/AIMessageList.java | 1 + .../flow/component/applayout/AppLayout.java | 16 +++ .../component/applayout/DrawerToggle.java | 2 + .../java/com/vaadin/flow/theme/aura/Aura.java | 2 + .../vaadin/flow/component/avatar/Avatar.java | 4 + .../flow/component/avatar/AvatarGroup.java | 5 + .../component/avatar/AvatarGroupVariant.java | 2 + .../flow/component/avatar/AvatarVariant.java | 2 + .../vaadin/flow/component/badge/Badge.java | 1 + .../flow/component/badge/BadgeVariant.java | 2 + .../vaadin/flow/component/board/Board.java | 1 + .../com/vaadin/flow/component/board/Row.java | 1 + .../board/internal/FunctionCaller.java | 3 + .../component/breadcrumbs/Breadcrumbs.java | 1 + .../BreadcrumbsFeatureFlagProvider.java | 1 + .../breadcrumbs/BreadcrumbsItem.java | 1 + .../breadcrumbs/BreadcrumbsVariant.java | 2 + .../ExperimentalFeatureException.java | 1 + .../vaadin/flow/component/button/Button.java | 19 +++ .../flow/component/button/ButtonVariant.java | 2 + .../com/vaadin/flow/component/card/Card.java | 22 +++ .../flow/component/card/CardVariant.java | 2 + .../vaadin/flow/component/charts/Chart.java | 7 + .../flow/component/charts/ChartOptions.java | 2 + .../flow/component/charts/ChartVariant.java | 2 + .../charts/events/ChartAddSeriesEvent.java | 3 + .../charts/events/ChartAfterPrintEvent.java | 2 + .../charts/events/ChartBeforePrintEvent.java | 2 + .../charts/events/ChartClickEvent.java | 2 + .../charts/events/ChartDrillupAllEvent.java | 2 + .../charts/events/ChartDrillupEvent.java | 2 + .../charts/events/ChartLoadEvent.java | 2 + .../charts/events/ChartRedrawEvent.java | 2 + .../charts/events/ChartSelectionEvent.java | 2 + .../component/charts/events/ClickEvent.java | 3 + .../charts/events/DrilldownEvent.java | 3 + .../flow/component/charts/events/HasAxis.java | 3 + .../flow/component/charts/events/HasItem.java | 3 + .../component/charts/events/HasSeries.java | 2 + .../charts/events/MouseEventDetails.java | 2 + .../charts/events/PointClickEvent.java | 3 + .../charts/events/PointDragEvent.java | 2 + .../charts/events/PointDragStartEvent.java | 2 + .../charts/events/PointDropEvent.java | 2 + .../events/PointLegendItemClickEvent.java | 3 + .../charts/events/PointMouseOutEvent.java | 2 + .../charts/events/PointMouseOverEvent.java | 2 + .../charts/events/PointRemoveEvent.java | 2 + .../charts/events/PointSelectEvent.java | 2 + .../charts/events/PointUnselectEvent.java | 2 + .../charts/events/PointUpdateEvent.java | 2 + .../events/SeriesAfterAnimateEvent.java | 2 + .../events/SeriesCheckboxClickEvent.java | 2 + .../charts/events/SeriesClickEvent.java | 2 + .../charts/events/SeriesHideEvent.java | 2 + .../events/SeriesLegendItemClickEvent.java | 3 + .../charts/events/SeriesMouseOutEvent.java | 2 + .../charts/events/SeriesMouseOverEvent.java | 2 + .../charts/events/SeriesShowEvent.java | 2 + .../charts/events/XAxesExtremesSetEvent.java | 2 + .../charts/events/YAxesExtremesSetEvent.java | 2 + .../events/internal/AbstractSeriesEvent.java | 2 +- .../internal/AbstractSeriesItemEvent.java | 2 +- .../events/internal/AxisRescaledEvent.java | 2 +- .../internal/ConfigurationChangeListener.java | 2 +- .../events/internal/DataAddedEvent.java | 2 +- .../events/internal/DataRemovedEvent.java | 2 +- .../events/internal/DataUpdatedEvent.java | 2 +- .../events/internal/ItemSlicedEvent.java | 2 +- .../events/internal/SeriesAddedEvent.java | 2 +- .../events/internal/SeriesChangedEvent.java | 2 +- .../events/internal/SeriesStateEvent.java | 2 +- .../model/AbstractConfigurationObject.java | 2 + .../charts/model/AbstractDataLabels.java | 21 +++ .../charts/model/AbstractPlotOptions.java | 3 + .../charts/model/AbstractSeries.java | 4 + .../charts/model/AbstractSeriesItem.java | 3 + .../component/charts/model/Accessibility.java | 2 + .../charts/model/AnnotationItem.java | 2 + .../charts/model/AnnotationItemLabel.java | 2 + .../model/AnnotationItemLabelPoint.java | 2 + .../component/charts/model/AreaOptions.java | 36 +++++ .../component/charts/model/Attributes.java | 2 + .../flow/component/charts/model/Axis.java | 19 +++ .../component/charts/model/AxisDimension.java | 2 + .../flow/component/charts/model/AxisGrid.java | 3 + .../flow/component/charts/model/AxisList.java | 2 + .../component/charts/model/AxisTitle.java | 5 + .../flow/component/charts/model/AxisType.java | 2 + .../flow/component/charts/model/Back.java | 2 + .../component/charts/model/Background.java | 12 ++ .../charts/model/BackgroundShape.java | 2 + .../flow/component/charts/model/Bottom.java | 2 + .../component/charts/model/BoxPlotItem.java | 1 + .../component/charts/model/Breadcrumbs.java | 2 + .../charts/model/BreadcrumbsPosition.java | 2 + .../flow/component/charts/model/Breaks.java | 2 + .../component/charts/model/ButtonOptions.java | 8 ++ .../charts/model/ButtonPosition.java | 2 + .../charts/model/ButtonRelativeTo.java | 2 + .../flow/component/charts/model/Buttons.java | 2 + .../charts/model/ChartConfiguration.java | 3 + .../charts/model/ChartConnectors.java | 2 + .../component/charts/model/ChartEnum.java | 2 + .../component/charts/model/ChartModel.java | 39 ++++++ .../component/charts/model/ChartType.java | 7 + .../component/charts/model/ColorAxis.java | 3 + .../component/charts/model/ColumnOptions.java | 30 +++++ .../flow/component/charts/model/Compare.java | 2 + .../component/charts/model/Completed.java | 2 + .../component/charts/model/Condition.java | 2 + .../component/charts/model/Configuration.java | 10 ++ .../charts/model/ConnectorStyle.java | 2 + .../component/charts/model/ContextButton.java | 16 +++ .../charts/model/ContextButtonMenuItem.java | 3 + .../flow/component/charts/model/Credits.java | 6 + .../component/charts/model/Crosshair.java | 11 ++ .../charts/model/CrosshairLabel.java | 11 ++ .../flow/component/charts/model/Cursor.java | 2 + .../component/charts/model/DashStyle.java | 1 + .../component/charts/model/DataGrouping.java | 2 + .../component/charts/model/DataLabels.java | 28 ++++ .../charts/model/DataLabelsFunnel.java | 25 ++++ .../charts/model/DataLabelsRange.java | 20 +++ .../charts/model/DataProviderSeries.java | 2 + .../component/charts/model/DataSeries.java | 2 + .../charts/model/DataSeriesItem.java | 9 ++ .../charts/model/DataSeriesItem3d.java | 2 + .../charts/model/DataSeriesItemBullet.java | 2 + .../charts/model/DataSeriesItemSankey.java | 2 + .../charts/model/DataSeriesItemTimeline.java | 2 + .../charts/model/DataSeriesItemXrange.java | 2 + .../charts/model/DateTimeLabelFormats.java | 2 + .../flow/component/charts/model/Dial.java | 11 ++ .../component/charts/model/Dimension.java | 2 + .../flow/component/charts/model/DragDrop.java | 3 + .../component/charts/model/DragHandle.java | 3 + .../component/charts/model/Drilldown.java | 8 ++ .../charts/model/DrilldownCallback.java | 2 + .../charts/model/ExportFileType.java | 2 + .../component/charts/model/Exporting.java | 4 + .../model/ExportingMenuItemDefinition.java | 3 + .../flow/component/charts/model/FlagItem.java | 2 + .../component/charts/model/FlagShape.java | 2 + .../flow/component/charts/model/Frame.java | 2 + .../component/charts/model/GanttSeries.java | 2 + .../charts/model/GanttSeriesItem.java | 2 + .../model/GanttSeriesItemDependency.java | 2 + .../component/charts/model/GaugeOptions.java | 12 ++ .../flow/component/charts/model/Global.java | 2 + .../flow/component/charts/model/GuideBox.java | 2 + .../charts/model/GuideBoxDefaultState.java | 3 + .../flow/component/charts/model/Halo.java | 8 ++ .../flow/component/charts/model/Handles.java | 2 + .../component/charts/model/HeatSeries.java | 2 + .../charts/model/HorizontalAlign.java | 2 + .../flow/component/charts/model/Hover.java | 26 ++++ .../flow/component/charts/model/Inactive.java | 5 + .../component/charts/model/IntervalUnit.java | 2 + .../charts/model/ItemPartialFill.java | 2 + .../flow/component/charts/model/Items.java | 2 + .../charts/model/KeyboardNavigation.java | 2 + .../flow/component/charts/model/Label.java | 5 + .../flow/component/charts/model/Labels.java | 6 + .../flow/component/charts/model/Lang.java | 2 + .../charts/model/LayoutDirection.java | 2 + .../flow/component/charts/model/Legend.java | 20 +++ .../charts/model/LegendNavigation.java | 11 ++ .../component/charts/model/LegendTitle.java | 5 + .../flow/component/charts/model/Level.java | 14 ++ .../flow/component/charts/model/Link.java | 2 + .../flow/component/charts/model/LinkType.java | 2 + .../component/charts/model/ListSeries.java | 2 + .../flow/component/charts/model/Loading.java | 8 ++ .../flow/component/charts/model/Marker.java | 20 +++ .../component/charts/model/MarkerSymbol.java | 2 + .../charts/model/MarkerSymbolEnum.java | 1 + .../charts/model/MarkerSymbolUrl.java | 2 + .../component/charts/model/Navigation.java | 11 ++ .../component/charts/model/Navigator.java | 16 +++ .../flow/component/charts/model/NoData.java | 5 + .../flow/component/charts/model/Node.java | 2 + .../component/charts/model/NodeLayout.java | 1 + .../component/charts/model/NodeSeries.java | 2 + .../charts/model/NodeSeriesItem.java | 2 + .../flow/component/charts/model/OhlcItem.java | 1 + .../component/charts/model/OhlcOptions.java | 26 ++++ .../component/charts/model/Options3d.java | 2 + .../flow/component/charts/model/PanKey.java | 2 + .../flow/component/charts/model/Pane.java | 2 + .../flow/component/charts/model/PaneList.java | 2 + .../component/charts/model/PartialFill.java | 2 + .../charts/model/PathfinderType.java | 2 + .../flow/component/charts/model/Pivot.java | 11 ++ .../flow/component/charts/model/PlotBand.java | 11 ++ .../flow/component/charts/model/PlotLine.java | 11 ++ .../charts/model/PlotOptionsArea.java | 38 ++++++ .../charts/model/PlotOptionsArearange.java | 38 ++++++ .../charts/model/PlotOptionsAreaspline.java | 39 ++++++ .../model/PlotOptionsAreasplinerange.java | 38 ++++++ .../charts/model/PlotOptionsBar.java | 32 +++++ .../charts/model/PlotOptionsBoxplot.java | 49 +++++++ .../charts/model/PlotOptionsBubble.java | 26 ++++ .../charts/model/PlotOptionsBullet.java | 2 + .../charts/model/PlotOptionsCandlestick.java | 36 +++++ .../charts/model/PlotOptionsColumn.java | 31 +++++ .../charts/model/PlotOptionsColumnrange.java | 28 ++++ .../charts/model/PlotOptionsErrorbar.java | 34 +++++ .../charts/model/PlotOptionsFlags.java | 33 +++++ .../charts/model/PlotOptionsFunnel.java | 23 ++++ .../charts/model/PlotOptionsGantt.java | 2 + .../charts/model/PlotOptionsGauge.java | 17 +++ .../charts/model/PlotOptionsHeatmap.java | 25 ++++ .../charts/model/PlotOptionsLine.java | 27 ++++ .../charts/model/PlotOptionsOhlc.java | 24 ++++ .../charts/model/PlotOptionsOrganization.java | 5 + .../charts/model/PlotOptionsPie.java | 23 ++++ .../charts/model/PlotOptionsPolygon.java | 26 ++++ .../charts/model/PlotOptionsPyramid.java | 28 ++++ .../charts/model/PlotOptionsSankey.java | 2 + .../charts/model/PlotOptionsScatter.java | 26 ++++ .../charts/model/PlotOptionsSeries.java | 25 ++++ .../charts/model/PlotOptionsSolidgauge.java | 16 +++ .../charts/model/PlotOptionsSpline.java | 27 ++++ .../charts/model/PlotOptionsTimeline.java | 2 + .../charts/model/PlotOptionsTreemap.java | 23 ++++ .../charts/model/PlotOptionsWaterfall.java | 40 ++++++ .../charts/model/PlotOptionsXrange.java | 2 + .../component/charts/model/PointOptions.java | 26 ++++ .../charts/model/PointPlacement.java | 2 + .../flow/component/charts/model/Position.java | 2 + .../charts/model/PyramidOptions.java | 23 ++++ .../component/charts/model/RangeSelector.java | 14 ++ .../charts/model/RangeSelectorButton.java | 2 + .../charts/model/RangeSelectorTimespan.java | 2 + .../component/charts/model/RangeSeries.java | 2 + .../charts/model/ResetZoomButton.java | 2 + .../model/ResetZoomButtonRelativeTo.java | 2 + .../component/charts/model/Responsive.java | 2 + .../flow/component/charts/model/Rules.java | 2 + .../component/charts/model/Scrollbar.java | 20 +++ .../flow/component/charts/model/Select.java | 11 ++ .../component/charts/model/Separator.java | 3 + .../flow/component/charts/model/Series.java | 2 + .../model/SeriesConnectorAnimation.java | 2 + .../charts/model/SeriesConnectors.java | 2 + .../component/charts/model/SeriesTooltip.java | 2 + .../flow/component/charts/model/Shape.java | 2 + .../flow/component/charts/model/Side.java | 2 + .../component/charts/model/StackLabels.java | 5 + .../flow/component/charts/model/Stacking.java | 2 + .../flow/component/charts/model/States.java | 5 + .../flow/component/charts/model/StepType.java | 2 + .../flow/component/charts/model/Stop.java | 3 + .../flow/component/charts/model/Subtitle.java | 5 + .../component/charts/model/TargetOptions.java | 2 + .../component/charts/model/TextAlign.java | 2 + .../component/charts/model/TickPosition.java | 2 + .../charts/model/TickmarkPlacement.java | 2 + .../flow/component/charts/model/Time.java | 4 + .../flow/component/charts/model/TimeUnit.java | 3 + .../charts/model/TimeUnitMultiples.java | 2 + .../flow/component/charts/model/Title.java | 5 + .../flow/component/charts/model/Tooltip.java | 14 ++ .../flow/component/charts/model/Top.java | 2 + .../charts/model/TreeMapLayoutAlgorithm.java | 2 + .../model/TreeMapLayoutStartingDirection.java | 2 + .../component/charts/model/TreeSeries.java | 2 + .../charts/model/TreeSeriesItem.java | 2 + .../component/charts/model/VerticalAlign.java | 2 + .../component/charts/model/WaterFallSum.java | 2 + .../flow/component/charts/model/XAxis.java | 56 ++++++++ .../flow/component/charts/model/YAxis.java | 59 ++++++++ .../flow/component/charts/model/ZAxis.java | 40 ++++++ .../flow/component/charts/model/ZoneAxis.java | 2 + .../flow/component/charts/model/Zones.java | 11 ++ .../flow/component/charts/model/Zooming.java | 2 + .../charts/model/ZoomingMouseWheel.java | 2 + .../charts/model/ZoomingResetButton.java | 1 + .../AbstractSeriesBeanSerializer.java | 1 + .../model/serializers/AxisListSerializer.java | 1 + .../serializers/AxisTitleBeanSerializer.java | 1 + .../BeanSerializationDelegate.java | 1 + .../serializers/BeanSerializerDelegator.java | 1 + .../serializers/ChartEnumSerializer.java | 1 + .../DataProviderSeriesBeanSerializer.java | 2 + .../DataSeriesItemBeanSerializer.java | 1 + .../model/serializers/DateSerializer.java | 2 + .../DefaultBeanSerializerModifier.java | 2 + .../GradientColorStopsSerializer.java | 3 + .../model/serializers/InstantSerializer.java | 1 + .../serializers/LabelsRotationSerializer.java | 2 + .../LegendTitleBeanSerializer.java | 1 + .../model/serializers/PaneListSerializer.java | 1 + .../serializers/SolidColorSerializer.java | 1 + .../model/serializers/StopSerializer.java | 1 + .../TimeUnitMultiplesSerializer.java | 1 + .../serializers/TitleBeanSerializer.java | 2 + .../charts/model/style/AxisStyle.java | 2 + .../charts/model/style/ButtonTheme.java | 3 + .../charts/model/style/ChartStyle.java | 2 + .../component/charts/model/style/Color.java | 1 + .../charts/model/style/FontWeight.java | 2 + .../charts/model/style/GradientColor.java | 2 + .../charts/model/style/LegendStyle.java | 2 + .../charts/model/style/MarkerStyle.java | 2 + .../charts/model/style/PlotOptionsStyle.java | 4 + .../charts/model/style/SolidColor.java | 2 + .../component/charts/model/style/Style.java | 2 + .../charts/model/style/StylePosition.java | 2 + .../charts/model/style/StyleWrapper.java | 2 + .../component/charts/model/style/Theme.java | 1 + .../charts/model/style/TickIntervalStyle.java | 3 + .../charts/model/style/TooltipStyle.java | 2 + .../charts/themes/LumoDarkTheme.java | 2 + .../charts/themes/LumoLightTheme.java | 2 + .../charts/util/ChartSerialization.java | 2 + .../flow/component/charts/util/Util.java | 3 + .../flow/component/checkbox/Checkbox.java | 11 ++ .../component/checkbox/CheckboxGroup.java | 24 ++++ .../checkbox/CheckboxGroupVariant.java | 2 + .../component/checkbox/CheckboxVariant.java | 2 + .../dataview/CheckboxGroupDataView.java | 2 +- .../dataview/CheckboxGroupListDataView.java | 2 +- .../flow/component/combobox/ComboBox.java | 17 +++ .../flow/component/combobox/ComboBoxBase.java | 19 +++ .../component/combobox/ComboBoxBaseI18n.java | 2 + .../combobox/ComboBoxDataCommunicator.java | 1 + .../component/combobox/ComboBoxVariant.java | 2 + .../combobox/MultiSelectComboBox.java | 8 ++ .../combobox/MultiSelectComboBoxI18n.java | 4 + .../combobox/MultiSelectComboBoxVariant.java | 2 + .../combobox/dataview/ComboBoxDataView.java | 2 + .../dataview/ComboBoxLazyDataView.java | 1 + .../dataview/ComboBoxListDataView.java | 2 + .../confirmdialog/ConfirmDialog.java | 21 +++ ...eDisabledMenuItemsFeatureFlagProvider.java | 3 + .../component/contextmenu/ContextMenu.java | 3 + .../contextmenu/ContextMenuBase.java | 14 ++ .../contextmenu/ContextMenuPosition.java | 2 + .../component/contextmenu/HasMenuItems.java | 1 + .../flow/component/contextmenu/MenuItem.java | 3 + .../component/contextmenu/MenuItemBase.java | 12 ++ .../contextmenu/MenuItemsArrayGenerator.java | 1 + .../component/contextmenu/MenuManager.java | 8 ++ .../flow/component/contextmenu/SubMenu.java | 5 + .../component/contextmenu/SubMenuBase.java | 4 + .../flow/component/crud/BinderCrudEditor.java | 1 + .../com/vaadin/flow/component/crud/Crud.java | 17 +++ .../flow/component/crud/CrudEditor.java | 2 + .../component/crud/CrudEditorPosition.java | 2 + .../flow/component/crud/CrudFilter.java | 2 + .../vaadin/flow/component/crud/CrudGrid.java | 1 + .../vaadin/flow/component/crud/CrudI18n.java | 1 + .../component/crud/CrudI18nUpdatedEvent.java | 2 + .../flow/component/crud/CrudVariant.java | 2 + .../component/customfield/CustomField.java | 6 + .../customfield/CustomFieldVariant.java | 2 + .../flow/component/dashboard/Dashboard.java | 7 + .../DashboardChildDetachHandler.java | 3 + .../DashboardItemMoveModeChangedEvent.java | 1 + .../dashboard/DashboardItemMovedEvent.java | 1 + .../dashboard/DashboardItemRemoveEvent.java | 1 + .../dashboard/DashboardItemRemoveHandler.java | 1 + .../dashboard/DashboardItemRemovedEvent.java | 1 + .../DashboardItemResizeModeChangedEvent.java | 1 + .../dashboard/DashboardItemResizedEvent.java | 1 + .../DashboardItemSelectedChangedEvent.java | 1 + .../component/dashboard/DashboardSection.java | 2 + .../component/dashboard/DashboardVariant.java | 2 + .../component/dashboard/DashboardWidget.java | 2 + .../flow/component/dashboard/HasWidgets.java | 2 + .../flow/component/datepicker/DatePicker.java | 28 ++++ .../datepicker/DatePickerVariant.java | 2 + .../datetimepicker/DateTimePicker.java | 22 +++ .../datetimepicker/DateTimePickerVariant.java | 2 + .../flow/component/details/Details.java | 12 ++ .../component/details/DetailsVariant.java | 2 + .../vaadin/flow/component/dialog/Dialog.java | 53 ++++++++ .../flow/component/dialog/DialogVariant.java | 2 + .../FieldHighlighterInitializer.java | 3 + .../shared/HasAllowedCharPattern.java | 1 + .../flow/component/shared/HasAutoOpen.java | 1 + .../flow/component/shared/HasClearButton.java | 1 + .../flow/component/shared/HasPrefix.java | 1 + .../flow/component/shared/HasSuffix.java | 1 + .../component/shared/HasThemeVariant.java | 6 + .../flow/component/shared/HasTooltip.java | 2 + .../shared/HasValidationProperties.java | 1 + .../flow/component/shared/InputField.java | 2 +- .../shared/SelectionPreservationHandler.java | 1 + .../shared/SelectionPreservationMode.java | 1 + .../flow/component/shared/SlotUtils.java | 5 + .../flow/component/shared/ThemeVariant.java | 2 + .../vaadin/flow/component/shared/Tooltip.java | 9 ++ .../shared/TooltipConfiguration.java | 1 + .../flow/component/shared/ValidationUtil.java | 8 ++ .../internal/DisableOnClickController.java | 1 + .../component/shared/internal/ModalRoot.java | 2 + .../internal/OverlayAutoAddController.java | 6 + .../internal/OverlayClassListProxy.java | 2 + .../shared/internal/SignalBindingUtil.java | 2 + .../shared/internal/ValidationController.java | 1 + .../flow/component/formlayout/FormLayout.java | 36 +++++ .../grid/AbstractGridMultiSelectionModel.java | 2 + .../AbstractGridSingleSelectionModel.java | 1 + .../flow/component/grid/CellFocusEvent.java | 1 + .../component/grid/ClientItemToggleEvent.java | 1 + .../component/grid/ColumnPathRenderer.java | 1 + .../flow/component/grid/ColumnRendering.java | 1 + .../component/grid/ColumnReorderEvent.java | 2 + .../component/grid/ColumnResizeEvent.java | 1 + .../flow/component/grid/ColumnTextAlign.java | 1 + .../vaadin/flow/component/grid/FooterRow.java | 1 + .../com/vaadin/flow/component/grid/Grid.java | 126 ++++++++++++++++++ .../flow/component/grid/GridArrayUpdater.java | 1 + .../grid/GridMultiSelectionModel.java | 4 + .../grid/GridNoneSelectionModel.java | 1 + .../component/grid/GridSelectionColumn.java | 4 + .../component/grid/GridSelectionModel.java | 1 + .../grid/GridSingleSelectionModel.java | 1 + .../flow/component/grid/GridSortOrder.java | 1 + .../component/grid/GridSortOrderBuilder.java | 1 + .../flow/component/grid/GridVariant.java | 2 + .../vaadin/flow/component/grid/HeaderRow.java | 1 + .../flow/component/grid/ItemClickEvent.java | 3 + .../component/grid/ItemDoubleClickEvent.java | 2 + .../component/grid/SortOrderProvider.java | 1 + .../grid/contextmenu/GridContextMenu.java | 9 ++ .../grid/contextmenu/GridMenuItem.java | 1 + .../grid/contextmenu/GridSubMenu.java | 1 + .../component/grid/dataview/GridDataView.java | 2 +- .../grid/dataview/GridLazyDataView.java | 1 + .../grid/dataview/GridListDataView.java | 2 +- .../component/grid/dnd/GridDragEndEvent.java | 1 + .../grid/dnd/GridDragStartEvent.java | 2 + .../component/grid/dnd/GridDropEvent.java | 2 + .../component/grid/dnd/GridDropLocation.java | 1 + .../flow/component/grid/dnd/GridDropMode.java | 1 + .../flow/component/grid/editor/Editor.java | 2 + .../grid/editor/EditorCancelEvent.java | 1 + .../grid/editor/EditorCancelListener.java | 1 + .../grid/editor/EditorCloseEvent.java | 1 + .../grid/editor/EditorCloseListener.java | 1 + .../component/grid/editor/EditorEvent.java | 1 + .../component/grid/editor/EditorImpl.java | 1 + .../grid/editor/EditorOpenEvent.java | 1 + .../grid/editor/EditorOpenListener.java | 1 + .../component/grid/editor/EditorRenderer.java | 1 + .../grid/editor/EditorSaveEvent.java | 1 + .../grid/editor/EditorSaveListener.java | 1 + .../component/treegrid/CollapseEvent.java | 3 + .../flow/component/treegrid/ExpandEvent.java | 3 + .../HierarchyColumnComponentRenderer.java | 1 + .../flow/component/treegrid/TreeGrid.java | 20 ++- .../gridpro/EditColumnConfigurator.java | 5 + .../flow/component/gridpro/EditorType.java | 2 + .../flow/component/gridpro/GridPro.java | 15 +++ .../component/gridpro/GridProVariant.java | 2 + .../flow/component/gridpro/ItemUpdater.java | 1 + .../flow/component/icon/AbstractIcon.java | 1 + .../vaadin/flow/component/icon/FontIcon.java | 1 + .../com/vaadin/flow/component/icon/Icon.java | 7 + .../flow/component/icon/IconFactory.java | 2 + .../vaadin/flow/component/icon/SvgIcon.java | 5 + .../flow/component/icon/VaadinIcon.java | 1 + .../flow/component/listbox/ListBox.java | 2 + .../flow/component/listbox/ListBoxBase.java | 11 ++ .../component/listbox/MultiSelectListBox.java | 4 + .../listbox/dataview/ListBoxDataView.java | 2 +- .../listbox/dataview/ListBoxListDataView.java | 2 +- .../flow/component/login/AbstractLogin.java | 4 + .../flow/component/login/LoginForm.java | 1 + .../flow/component/login/LoginI18n.java | 5 + .../flow/component/login/LoginOverlay.java | 6 + .../java/com/vaadin/flow/theme/lumo/Lumo.java | 8 ++ .../com/vaadin/flow/theme/lumo/LumoIcon.java | 1 + .../vaadin/flow/theme/lumo/LumoUtility.java | 28 ++++ .../com/vaadin/flow/component/map/Assets.java | 2 + .../com/vaadin/flow/component/map/Map.java | 10 ++ .../vaadin/flow/component/map/MapBase.java | 6 + .../vaadin/flow/component/map/MapVariant.java | 2 + .../AbstractConfigurationObject.java | 4 + .../map/configuration/Configuration.java | 6 + .../map/configuration/Constants.java | 2 + .../map/configuration/Coordinate.java | 2 + .../component/map/configuration/Extent.java | 2 + .../component/map/configuration/Feature.java | 9 ++ .../map/configuration/Projection.java | 2 + .../SerializablePropertyChangeListener.java | 2 + .../component/map/configuration/View.java | 5 + .../controls/AttributionControl.java | 2 + .../map/configuration/controls/Control.java | 2 + .../configuration/controls/ScaleControl.java | 1 + .../configuration/controls/ZoomControl.java | 2 + .../feature/LineStringFeature.java | 2 + .../configuration/feature/MarkerFeature.java | 2 + .../feature/PointBasedFeature.java | 2 + .../configuration/feature/PolygonFeature.java | 2 + .../configuration/geometry/LineString.java | 2 + .../map/configuration/geometry/Point.java | 2 + .../map/configuration/geometry/Polygon.java | 1 + .../geometry/SimpleGeometry.java | 3 + .../map/configuration/layer/FeatureLayer.java | 12 ++ .../map/configuration/layer/ImageLayer.java | 2 + .../map/configuration/layer/Layer.java | 5 + .../map/configuration/layer/TileLayer.java | 2 + .../map/configuration/layer/VectorLayer.java | 2 + .../configuration/source/ClusterSource.java | 2 + .../map/configuration/source/ImageSource.java | 5 + .../configuration/source/ImageWMSSource.java | 3 + .../map/configuration/source/OSMSource.java | 2 + .../map/configuration/source/Source.java | 5 + .../configuration/source/TileImageSource.java | 5 + .../map/configuration/source/TileSource.java | 5 + .../configuration/source/TileWMSSource.java | 2 + .../configuration/source/UrlTileSource.java | 5 + .../configuration/source/VectorSource.java | 3 + .../map/configuration/source/XYZSource.java | 3 + .../map/configuration/style/Fill.java | 3 + .../map/configuration/style/Icon.java | 4 + .../map/configuration/style/ImageStyle.java | 11 ++ .../map/configuration/style/Stroke.java | 3 + .../map/configuration/style/Style.java | 4 + .../map/configuration/style/TextStyle.java | 2 + .../map/events/FeatureEventDetails.java | 2 + .../component/map/events/MapClickEvent.java | 2 + .../map/events/MapClusterClickEvent.java | 2 + .../map/events/MapFeatureClickEvent.java | 2 + .../map/events/MapFeatureDropEvent.java | 2 + .../map/events/MapViewMoveEndEvent.java | 2 + .../map/events/MouseEventDetails.java | 2 + .../map/serialization/MapSerializer.java | 2 + .../flow/component/markdown/Markdown.java | 1 + .../MasterDetailLayout.java | 24 ++++ .../flow/component/menubar/MenuBar.java | 16 +++ .../component/menubar/MenuBarVariant.java | 2 + .../flow/component/messages/MessageInput.java | 1 + .../component/messages/MessageInputI18n.java | 1 + .../messages/MessageInputVariant.java | 2 + .../flow/component/messages/MessageList.java | 13 +- .../component/messages/MessageListItem.java | 14 ++ .../component/notification/Notification.java | 12 ++ .../notification/NotificationVariant.java | 2 + .../component/orderedlayout/BoxSizing.java | 1 + .../orderedlayout/FlexComponent.java | 4 + .../component/orderedlayout/FlexLayout.java | 17 +++ .../orderedlayout/HorizontalLayout.java | 15 +++ .../HorizontalLayoutVariant.java | 2 + .../component/orderedlayout/Scroller.java | 6 + .../orderedlayout/ScrollerVariant.java | 2 + .../orderedlayout/ThemableLayout.java | 6 + .../orderedlayout/VerticalLayout.java | 5 + .../orderedlayout/VerticalLayoutVariant.java | 2 + .../flow/component/popover/Popover.java | 5 + .../component/popover/PopoverPosition.java | 2 + .../component/popover/PopoverVariant.java | 2 + .../component/progressbar/ProgressBar.java | 1 + .../progressbar/ProgressBarVariant.java | 2 + .../radiobutton/RadioButtonGroup.java | 28 ++++ .../radiobutton/RadioGroupVariant.java | 2 + .../dataview/RadioButtonGroupDataView.java | 2 +- .../RadioButtonGroupListDataView.java | 2 +- .../flow/data/renderer/BasicRenderer.java | 1 + .../flow/data/renderer/ClickableRenderer.java | 1 + .../data/renderer/ComponentDataGenerator.java | 1 + .../flow/data/renderer/ComponentRenderer.java | 1 + .../flow/data/renderer/IconRenderer.java | 1 + .../flow/data/renderer/LitRenderer.java | 2 + .../flow/data/renderer/LocalDateRenderer.java | 3 + .../data/renderer/LocalDateTimeRenderer.java | 3 + .../data/renderer/NativeButtonRenderer.java | 1 + .../flow/data/renderer/NumberRenderer.java | 1 + .../vaadin/flow/data/renderer/Renderer.java | 2 + .../vaadin/flow/data/renderer/Rendering.java | 1 + .../flow/data/renderer/TextRenderer.java | 1 + .../richtexteditor/RichTextEditor.java | 12 ++ .../richtexteditor/RichTextEditorVariant.java | 2 + .../vaadin/flow/component/select/Select.java | 29 ++++ .../flow/component/select/SelectVariant.java | 2 + .../component/select/data/SelectDataView.java | 2 +- .../select/data/SelectListDataView.java | 1 + .../component/sidenav/HasSideNavItems.java | 1 + .../flow/component/sidenav/SideNav.java | 7 + .../flow/component/sidenav/SideNavItem.java | 18 +++ .../component/sidenav/SideNavVariant.java | 2 + .../component/slider/DecimalRangeSlider.java | 1 + .../slider/DecimalRangeSliderValue.java | 1 + .../flow/component/slider/DecimalSlider.java | 1 + .../component/slider/IntegerRangeSlider.java | 1 + .../slider/IntegerRangeSliderValue.java | 1 + .../flow/component/slider/IntegerSlider.java | 1 + .../component/splitlayout/SplitLayout.java | 8 ++ .../splitlayout/SplitLayoutVariant.java | 2 + .../spreadsheet/CellSelectionManager.java | 1 + .../spreadsheet/CellSelectionShifter.java | 1 + .../flow/component/spreadsheet/CellSet.java | 2 + .../spreadsheet/CellValueFormatter.java | 2 + .../spreadsheet/CellValueManager.java | 1 + .../component/spreadsheet/ChartCreator.java | 3 + .../component/spreadsheet/ColorConverter.java | 2 + .../spreadsheet/ColorConverterUtil.java | 3 + .../spreadsheet/ConditionalFormatter.java | 1 + .../spreadsheet/ContextMenuManager.java | 1 + .../DefaultHyperlinkCellClickHandler.java | 2 +- .../spreadsheet/FormulaFormatter.java | 2 + .../spreadsheet/HSSFColorConverter.java | 2 +- .../component/spreadsheet/ItemFilter.java | 2 + .../component/spreadsheet/PopupButton.java | 1 + .../spreadsheet/SheetChartWrapper.java | 1 + .../spreadsheet/SheetImageWrapper.java | 2 + .../spreadsheet/SheetOverlayWrapper.java | 4 + .../component/spreadsheet/Spreadsheet.java | 12 ++ .../SpreadsheetComponentFactory.java | 1 + .../spreadsheet/SpreadsheetEventListener.java | 3 + .../spreadsheet/SpreadsheetFactory.java | 1 + .../spreadsheet/SpreadsheetFilter.java | 1 + .../spreadsheet/SpreadsheetFilterTable.java | 1 + .../spreadsheet/SpreadsheetHandlerImpl.java | 2 + .../SpreadsheetHistoryManager.java | 1 + .../spreadsheet/SpreadsheetStyleFactory.java | 1 + .../spreadsheet/SpreadsheetTable.java | 6 + .../spreadsheet/SpreadsheetUtil.java | 2 +- .../spreadsheet/XSSFColorConverter.java | 2 +- .../spreadsheet/action/DeleteRowAction.java | 2 +- .../spreadsheet/action/DeleteTableAction.java | 2 +- .../action/EditCellCommentAction.java | 2 +- .../spreadsheet/action/HideHeaderAction.java | 2 +- .../action/InsertDeleteCellCommentAction.java | 2 +- .../action/InsertNewRowAction.java | 2 +- .../spreadsheet/action/InsertTableAction.java | 2 +- .../spreadsheet/action/MergeCellsAction.java | 2 +- .../action/ShowHideCellCommentAction.java | 2 +- .../spreadsheet/action/SpreadsheetAction.java | 2 +- .../SpreadsheetDefaultActionHandler.java | 2 +- .../action/UnHideHeadersAction.java | 2 +- .../action/UnMergeCellsAction.java | 2 +- .../charts/converter/DefaultChartCreator.java | 3 + .../spreadsheet/charts/converter/Utils.java | 3 + .../chartdata/AbstractSeriesData.java | 3 + .../converter/chartdata/AreaSeriesData.java | 3 + .../converter/chartdata/BarSeriesData.java | 3 + .../converter/chartdata/BubbleSeriesData.java | 3 + .../charts/converter/chartdata/ChartData.java | 3 + .../converter/chartdata/ColumnSeriesData.java | 3 + .../converter/chartdata/LineSeriesData.java | 3 + .../converter/chartdata/PieSeriesData.java | 3 + .../converter/chartdata/RadarSeriesData.java | 3 + .../chartdata/ScatterSeriesData.java | 3 + .../converter/chartdata/SplineSeriesData.java | 3 + .../charts/converter/chartdata/Stacking.java | 3 + .../confwriter/AbstractSeriesDataWriter.java | 3 + .../confwriter/AreaSeriesDataWriter.java | 3 + .../confwriter/BarSeriesDataWriter.java | 3 + .../confwriter/BubbleSeriesDataWriter.java | 3 + .../ChartDataToVaadinConfigWriter.java | 3 + .../confwriter/ColumnSeriesDataWriter.java | 3 + .../confwriter/LineSeriesDataWriter.java | 3 + .../confwriter/LineSeriesWriterUtils.java | 3 + .../confwriter/PieSeriesDataWriter.java | 3 + .../confwriter/PieToDonutConverter.java | 3 + .../confwriter/RadarSeriesWriter.java | 3 + .../confwriter/ScatterSeriesDataWriter.java | 3 + .../confwriter/SelectListeningDataSeries.java | 3 + .../confwriter/SplineSeriesDataWriter.java | 3 + .../xssfreader/AbstractSeriesReader.java | 3 + .../xssfreader/AreaSeriesReader.java | 3 + .../converter/xssfreader/BarSeriesReader.java | 3 + .../xssfreader/BubbleSeriesReader.java | 3 + .../converter/xssfreader/CTSerAdapter.java | 2 + .../xssfreader/GenericSeriesReader.java | 2 + .../xssfreader/LineSeriesReader.java | 3 + .../xssfreader/LineSeriesReaderUtils.java | 3 + .../converter/xssfreader/PieSeriesReader.java | 3 + .../xssfreader/RadarSeriesReader.java | 3 + .../xssfreader/ScatterSeriesReader.java | 3 + .../converter/xssfreader/XSSFChartReader.java | 3 + .../spreadsheet/client/CellData.java | 3 + .../spreadsheet/client/GroupingHandler.java | 3 + .../spreadsheet/client/MergedRegion.java | 3 + .../spreadsheet/client/MergedRegionUtil.java | 3 + .../spreadsheet/client/OverlayInfo.java | 3 + .../client/SpreadsheetActionDetails.java | 3 + .../client/SpreadsheetHandler.java | 3 + .../command/CellShiftValuesCommand.java | 2 +- .../spreadsheet/command/CellValueCommand.java | 2 +- .../spreadsheet/command/Command.java | 2 +- .../command/RowInsertOrDeleteCommand.java | 2 + .../command/SizeChangeCommand.java | 2 +- .../command/SpreadsheetCommand.java | 2 +- .../command/ValueChangeCommand.java | 2 +- .../spreadsheet/framework/Action.java | 6 +- .../spreadsheet/framework/ReflectTools.java | 7 +- .../spreadsheet/rpc/PopupButtonClientRpc.java | 3 + .../spreadsheet/rpc/PopupButtonServerRpc.java | 3 + .../spreadsheet/rpc/SpreadsheetClientRpc.java | 3 + .../spreadsheet/rpc/SpreadsheetServerRpc.java | 5 + .../spreadsheet/shared/ContentMode.java | 2 +- .../spreadsheet/shared/ErrorLevel.java | 2 +- .../spreadsheet/shared/GroupingData.java | 2 + .../spreadsheet/shared/PopupButtonState.java | 3 + .../spreadsheet/shared/SpreadsheetState.java | 5 +- .../spreadsheet/shared/URLReference.java | 3 + .../poi/ss/formula/WorkbookEvaluatorUtil.java | 2 + .../com/vaadin/flow/component/tabs/Tab.java | 1 + .../vaadin/flow/component/tabs/TabSheet.java | 4 + .../flow/component/tabs/TabSheetVariant.java | 2 + .../flow/component/tabs/TabVariant.java | 2 + .../com/vaadin/flow/component/tabs/Tabs.java | 25 ++++ .../flow/component/tabs/TabsVariant.java | 2 + .../textfield/AbstractNumberField.java | 7 + .../textfield/AbstractNumberFieldI18n.java | 2 + .../component/textfield/Autocapitalize.java | 2 + .../component/textfield/Autocomplete.java | 2 + .../component/textfield/BigDecimalField.java | 8 ++ .../flow/component/textfield/EmailField.java | 9 ++ .../textfield/HasAutocapitalize.java | 2 + .../component/textfield/HasAutocomplete.java | 2 + .../component/textfield/HasAutocorrect.java | 2 + .../component/textfield/IntegerField.java | 8 ++ .../flow/component/textfield/NumberField.java | 8 ++ .../component/textfield/PasswordField.java | 11 ++ .../flow/component/textfield/TextArea.java | 21 +++ .../component/textfield/TextAreaVariant.java | 2 + .../flow/component/textfield/TextField.java | 11 ++ .../component/textfield/TextFieldBase.java | 3 + .../component/textfield/TextFieldVariant.java | 2 + .../flow/component/timepicker/StepsUtil.java | 2 + .../flow/component/timepicker/TimePicker.java | 22 +++ .../timepicker/TimePickerVariant.java | 2 + .../component/upload/AllFinishedEvent.java | 1 + .../flow/component/upload/FailedEvent.java | 1 + .../component/upload/FileRejectedEvent.java | 3 + .../component/upload/FileRemovedEvent.java | 1 + .../flow/component/upload/FinishedEvent.java | 1 + .../component/upload/MultiFileReceiver.java | 1 + .../component/upload/NoInputStreamEvent.java | 2 + .../component/upload/NoOutputStreamEvent.java | 2 + .../component/upload/ProgressListener.java | 2 + .../component/upload/ProgressUpdateEvent.java | 3 + .../flow/component/upload/Receiver.java | 1 + .../flow/component/upload/StartedEvent.java | 1 + .../flow/component/upload/SucceededEvent.java | 1 + .../vaadin/flow/component/upload/Upload.java | 16 +++ .../flow/component/upload/UploadButton.java | 1 + .../flow/component/upload/UploadDropZone.java | 1 + .../flow/component/upload/UploadFileList.java | 1 + .../component/upload/UploadFileListI18N.java | 2 + .../upload/UploadFileListVariant.java | 2 + .../flow/component/upload/UploadFormat.java | 2 + .../flow/component/upload/UploadHelper.java | 2 + .../flow/component/upload/UploadI18N.java | 15 +++ .../flow/component/upload/UploadManager.java | 1 + .../flow/component/upload/UploadVariant.java | 2 + .../upload/receivers/AbstractFileBuffer.java | 1 + .../upload/receivers/FileBuffer.java | 4 + .../component/upload/receivers/FileData.java | 3 + .../upload/receivers/FileFactory.java | 1 + .../upload/receivers/MemoryBuffer.java | 1 + .../upload/receivers/MultiFileBuffer.java | 4 + .../receivers/MultiFileMemoryBuffer.java | 1 + .../upload/receivers/TempDirectory.java | 3 + .../receivers/TemporaryFileFactory.java | 3 + .../upload/receivers/UploadOutputStream.java | 2 + .../component/virtuallist/VirtualList.java | 8 ++ .../virtuallist/VirtualListVariant.java | 2 + .../paging/PagelessDataCommunicator.java | 1 + 805 files changed, 4014 insertions(+), 64 deletions(-) diff --git a/vaadin-accordion-flow-parent/vaadin-accordion-flow/src/main/java/com/vaadin/flow/component/accordion/Accordion.java b/vaadin-accordion-flow-parent/vaadin-accordion-flow/src/main/java/com/vaadin/flow/component/accordion/Accordion.java index 818355aa378..6958ab89a8e 100644 --- a/vaadin-accordion-flow-parent/vaadin-accordion-flow/src/main/java/com/vaadin/flow/component/accordion/Accordion.java +++ b/vaadin-accordion-flow-parent/vaadin-accordion-flow/src/main/java/com/vaadin/flow/component/accordion/Accordion.java @@ -47,6 +47,7 @@ * inaccessible by keyboard or screen reader. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-accordion") @NpmPackage(value = "@vaadin/accordion", version = "25.2.0") @@ -58,6 +59,8 @@ public class Accordion extends Component implements HasSize, HasStyle { /** * Initializes a new Accordion component. + * + * @since 25.1.7 */ public Accordion() { if (getElement().getPropertyRaw(OPENED_PROPERTY) == null) { diff --git a/vaadin-accordion-flow-parent/vaadin-accordion-flow/src/main/java/com/vaadin/flow/component/accordion/AccordionPanel.java b/vaadin-accordion-flow-parent/vaadin-accordion-flow/src/main/java/com/vaadin/flow/component/accordion/AccordionPanel.java index 97013d14d68..fbd75b94cf8 100644 --- a/vaadin-accordion-flow-parent/vaadin-accordion-flow/src/main/java/com/vaadin/flow/component/accordion/AccordionPanel.java +++ b/vaadin-accordion-flow-parent/vaadin-accordion-flow/src/main/java/com/vaadin/flow/component/accordion/AccordionPanel.java @@ -23,6 +23,8 @@ /** * An accordion panel which could be opened or closed. + * + * @since 1.0 */ @Tag("vaadin-accordion-panel") @NpmPackage(value = "@vaadin/accordion", version = "25.2.0") @@ -51,6 +53,7 @@ public AccordionPanel() { * @param summary * the summary component to set. * @see #setSummaryText(String) + * @since 23.1 */ public AccordionPanel(String summary) { this(); @@ -63,6 +66,7 @@ public AccordionPanel(String summary) { * @param summary * the summary component to set. * @see #setSummary(Component) + * @since 23.1 */ public AccordionPanel(Component summary) { this(); @@ -104,6 +108,7 @@ public AccordionPanel(Component summary, Component content) { * * @see #setSummaryText(String) * @see #add(Component...) + * @since 23.1 */ public AccordionPanel(String summary, Component... components) { this(summary); @@ -121,6 +126,7 @@ public AccordionPanel(String summary, Component... components) { * * @see #setSummary(Component) * @see #add(Component...) + * @since 23.1 */ public AccordionPanel(Component summary, Component... components) { this(summary); @@ -131,6 +137,7 @@ public AccordionPanel(Component summary, Component... components) { * Creates the summary container component. * * @return the summary container + * @since 24.0 */ protected Component createSummaryContainer() { return new AccordionHeading(); diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/AIComponentsExperimentalFeatureException.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/AIComponentsExperimentalFeatureException.java index 69aca26cfea..fa6942d7ddd 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/AIComponentsExperimentalFeatureException.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/AIComponentsExperimentalFeatureException.java @@ -20,6 +20,7 @@ * features without activating the associated feature flag first. * * @author Vaadin Ltd + * @since 25.1 */ public class AIComponentsExperimentalFeatureException extends RuntimeException { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/AIComponentsFeatureFlagProvider.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/AIComponentsFeatureFlagProvider.java index 2bc44e35190..c2956f84b18 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/AIComponentsFeatureFlagProvider.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/AIComponentsFeatureFlagProvider.java @@ -25,6 +25,7 @@ * AIOrchestrator, modular upload components, and MessageListItem attachments. * * @author Vaadin Ltd + * @since 25.1 */ public class AIComponentsFeatureFlagProvider implements FeatureFlagProvider { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartAIController.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartAIController.java index f8826a8533d..d821551e5ae 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartAIController.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartAIController.java @@ -108,6 +108,7 @@ * @see ChartState * @see DataConverter * @see DatabaseProviderAITools + * @since 25.2 */ public class ChartAIController implements AIController { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartAITools.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartAITools.java index 3ec00db6959..b8f30efc97d 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartAITools.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartAITools.java @@ -45,6 +45,7 @@ *

* * @author Vaadin Ltd + * @since 25.2 */ public final class ChartAITools { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartConfigurationParser.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartConfigurationParser.java index 37e4bb21076..1b84dce0c8f 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartConfigurationParser.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartConfigurationParser.java @@ -56,6 +56,7 @@ * {@link Configuration} object. * * @author Vaadin Ltd + * @since 25.2 */ public final class ChartConfigurationParser implements Serializable { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartRenderer.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartRenderer.java index e8ea13e20d1..6fba26798cc 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartRenderer.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartRenderer.java @@ -43,6 +43,7 @@ * (standalone chart, dashboard) share the same rendering logic. * * @author Vaadin Ltd + * @since 25.2 */ public final class ChartRenderer implements Serializable { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartState.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartState.java index 34fc4ac53f2..af8407d2293 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartState.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ChartState.java @@ -31,6 +31,7 @@ * @param configuration * the chart configuration * @author Vaadin Ltd + * @since 25.2 */ public record ChartState(List queries, Configuration configuration) implements Serializable { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ColumnNames.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ColumnNames.java index 9fca8b192c4..e4ea737d731 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ColumnNames.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ColumnNames.java @@ -27,6 +27,7 @@ *

* * @author Vaadin Ltd + * @since 25.2 */ public final class ColumnNames implements Serializable { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ConfigurationKeys.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ConfigurationKeys.java index 54aab35000c..6f2a2cf857d 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ConfigurationKeys.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/ConfigurationKeys.java @@ -26,6 +26,7 @@ *

* * @author Vaadin Ltd + * @since 25.2 */ public final class ConfigurationKeys implements Serializable { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/DataConverter.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/DataConverter.java index a4211e239de..bd08f0caaaa 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/DataConverter.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/DataConverter.java @@ -34,6 +34,7 @@ * * @author Vaadin Ltd * @see DefaultDataConverter + * @since 25.2 */ public interface DataConverter extends Serializable { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/DefaultDataConverter.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/DefaultDataConverter.java index 44dd5d1bef8..136040414c3 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/DefaultDataConverter.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/DefaultDataConverter.java @@ -118,6 +118,7 @@ * * @author Vaadin Ltd * @see ColumnNames + * @since 25.2 */ public class DefaultDataConverter implements DataConverter { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/PlotOptionsSchemaGenerator.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/PlotOptionsSchemaGenerator.java index 7893338b4fa..6d1956872de 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/PlotOptionsSchemaGenerator.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/chart/PlotOptionsSchemaGenerator.java @@ -80,6 +80,8 @@ *

* Invoked automatically during the Maven build via {@code exec-maven-plugin}. * The output is consumed by {@link PlotOptionsSchema} at runtime. + * + * @since 25.2 */ public final class PlotOptionsSchemaGenerator { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/common/AIAttachment.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/common/AIAttachment.java index 130cd19223d..1f4a5accd45 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/common/AIAttachment.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/common/AIAttachment.java @@ -33,6 +33,7 @@ * @param data * the raw file data, not {@code null} * @author Vaadin Ltd + * @since 25.1 */ public record AIAttachment(String name, String mimeType, byte[] data) implements Serializable { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/common/AttachmentContentType.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/common/AttachmentContentType.java index 8f5809dcd23..823ac1b7be9 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/common/AttachmentContentType.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/common/AttachmentContentType.java @@ -19,6 +19,8 @@ * Supported content type categories for attachments. *

* Intended only for internal use and can be removed in the future. + * + * @since 25.1 */ public enum AttachmentContentType { /** Image content types (image/*). */ diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/common/ChatMessage.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/common/ChatMessage.java index 8cf242f7485..f9a6b965e65 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/common/ChatMessage.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/common/ChatMessage.java @@ -45,6 +45,7 @@ * @param time * the timestamp when the message was created; may be {@code null} * @author Vaadin Ltd + * @since 25.1 */ public record ChatMessage(Role role, String content, String messageId, Instant time) implements Serializable { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/form/FieldValueChange.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/form/FieldValueChange.java index 5538baa0902..b9ff62761ae 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/form/FieldValueChange.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/form/FieldValueChange.java @@ -33,6 +33,7 @@ * the field's value at the end of the turn, possibly {@code null} * * @author Vaadin Ltd + * @since 25.2 */ public record FieldValueChange(HasValue field, Object oldValue, Object newValue) implements Serializable { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/form/FormAIController.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/form/FormAIController.java index 338f78a1866..27ce34812d8 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/form/FormAIController.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/form/FormAIController.java @@ -167,6 +167,7 @@ *

* * @author Vaadin Ltd + * @since 25.2 */ public class FormAIController implements AIController { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/form/ValueOptions.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/form/ValueOptions.java index ebae7d1f3de..75abc840e97 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/form/ValueOptions.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/form/ValueOptions.java @@ -47,6 +47,7 @@ * multi-select fields * * @author Vaadin Ltd + * @since 25.2 */ public final class ValueOptions { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/AIDataRow.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/AIDataRow.java index da4b5616998..6c3003ec85b 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/AIDataRow.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/AIDataRow.java @@ -31,6 +31,7 @@ * @author Vaadin Ltd * @see GridAIController * @see GridRenderer + * @since 25.2 */ public final class AIDataRow implements Serializable { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridAIController.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridAIController.java index d9bb7225280..0af6a846393 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridAIController.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridAIController.java @@ -103,6 +103,7 @@ * @see GridRenderer * @see GridState * @see DatabaseProviderAITools + * @since 25.2 */ public class GridAIController implements AIController { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridAITools.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridAITools.java index 5116ccd5c41..0f1cde2dfa7 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridAITools.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridAITools.java @@ -40,6 +40,7 @@ *

* * @author Vaadin Ltd + * @since 25.2 */ public final class GridAITools { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridRenderer.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridRenderer.java index a2c68677200..9f6b093091a 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridRenderer.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridRenderer.java @@ -45,6 +45,7 @@ * * @author Vaadin Ltd * @see GridAIController + * @since 25.2 */ public final class GridRenderer implements Serializable { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridState.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridState.java index 1556ec49f14..914ee88d261 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridState.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/grid/GridState.java @@ -25,6 +25,7 @@ * @param query * the SQL query that populates the grid * @author Vaadin Ltd + * @since 25.2 */ public record GridState(String query) implements Serializable { } diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/AIController.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/AIController.java index 3351194de4a..993138347b8 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/AIController.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/AIController.java @@ -31,6 +31,7 @@ *

* * @author Vaadin Ltd + * @since 25.2 */ public interface AIController { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/AIOrchestrator.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/AIOrchestrator.java index b1e71b99dc7..1cf31302eeb 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/AIOrchestrator.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/AIOrchestrator.java @@ -125,6 +125,7 @@ *

* * @author Vaadin Ltd + * @since 25.1 */ public class AIOrchestrator implements Serializable { @@ -293,6 +294,7 @@ public void prompt(String userMessage) { * if no UI context is available, or if the orchestrator needs * to be reconnected after deserialization (see * {@link #reconnect(LLMProvider)}) + * @since 25.2 */ public void prompt(String userMessage, List attachments) { Objects.requireNonNull(attachments, "attachments cannot be null"); @@ -805,6 +807,7 @@ public Reconnector withTools(Object... tools) { * @return this reconnector * @throws IllegalArgumentException * if any tool name is invalid + * @since 25.2 */ public Reconnector withController(AIController controller) { Objects.requireNonNull(controller, "Controller cannot be null"); @@ -1102,6 +1105,7 @@ public Builder withTools(Object... tools) { * if controller is {@code null} * @throws IllegalArgumentException * if any tool name is invalid + * @since 25.2 */ public Builder withController(AIController controller) { Objects.requireNonNull(controller, "Controller cannot be null"); @@ -1167,6 +1171,7 @@ public Builder withAssistantName(String assistantName) { * @param listener * the listener to call on each prompt * @return this builder + * @since 25.2 */ public Builder withRequestListener(RequestListener listener) { warnIfAlreadySet(this.requestListener, "Request listener"); @@ -1227,6 +1232,7 @@ public Builder withAttachmentClickListener( * @param listener * the listener to call after each exchange * @return this builder + * @since 25.2 */ public Builder withResponseListener(ResponseListener listener) { warnIfAlreadySet(this.responseListener, "Response listener"); @@ -1265,6 +1271,7 @@ public Builder withResponseListener(ResponseListener listener) { * supplier of the per-turn context string, or {@code null} * to disable session context entirely * @return this builder + * @since 25.2 */ public Builder withMetadata( SerializableSupplier contextSupplier) { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/AttachmentClickListener.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/AttachmentClickListener.java index 2136ec4e5e7..2c8d198ae23 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/AttachmentClickListener.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/AttachmentClickListener.java @@ -19,6 +19,8 @@ /** * Listener for attachment click events. + * + * @since 25.1 */ @FunctionalInterface public interface AttachmentClickListener extends Serializable { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/RequestListener.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/RequestListener.java index 29f9fdbefe7..3cc455caf21 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/RequestListener.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/RequestListener.java @@ -33,6 +33,8 @@ * Threading: the listener is called on the UI thread under the session * lock. Long-running work should be offloaded to a worker; UI updates do not * need an extra {@code ui.access(...)} hop. + * + * @since 25.2 */ @FunctionalInterface public interface RequestListener extends Serializable { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/ResponseListener.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/ResponseListener.java index bd70977fce5..d4b9ffba60e 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/ResponseListener.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/orchestrator/ResponseListener.java @@ -44,6 +44,8 @@ * Threading: the listener is called from a background thread (Reactor * scheduler). Blocking I/O (e.g. database writes) is safe directly. To update * Vaadin UI components from this listener, use {@code ui.access()}. + * + * @since 25.2 */ @FunctionalInterface public interface ResponseListener extends Serializable { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/DatabaseProvider.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/DatabaseProvider.java index 64539bda12a..55851d6230d 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/DatabaseProvider.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/DatabaseProvider.java @@ -97,6 +97,7 @@ * * * @author Vaadin Ltd + * @since 25.2 */ public interface DatabaseProvider extends Serializable { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/DatabaseProviderAITools.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/DatabaseProviderAITools.java index 459d3cc2c38..e98bd7e561d 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/DatabaseProviderAITools.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/DatabaseProviderAITools.java @@ -26,6 +26,7 @@ * {@link DatabaseProvider}. * * @author Vaadin Ltd + * @since 25.2 */ public final class DatabaseProviderAITools { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/LLMProvider.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/LLMProvider.java index 72557d73ca7..c02179fc620 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/LLMProvider.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/LLMProvider.java @@ -43,6 +43,7 @@ * * * @author Vaadin Ltd. + * @since 25.1 */ public interface LLMProvider { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/LangChain4JLLMProvider.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/LangChain4JLLMProvider.java index d0eb2098444..c822f75bda2 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/LangChain4JLLMProvider.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/LangChain4JLLMProvider.java @@ -92,6 +92,7 @@ *

* * @author Vaadin Ltd + * @since 25.1 */ public class LangChain4JLLMProvider implements LLMProvider { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/SpringAILLMProvider.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/SpringAILLMProvider.java index 177fbd0524f..90a2e998d51 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/SpringAILLMProvider.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/provider/SpringAILLMProvider.java @@ -79,6 +79,7 @@ *

* * @author Vaadin Ltd + * @since 25.1 */ public class SpringAILLMProvider implements LLMProvider { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIFileReceiver.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIFileReceiver.java index 2de9150ee1d..3794a961bab 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIFileReceiver.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIFileReceiver.java @@ -24,6 +24,7 @@ * Interface for file upload components that are used in an AI conversation. * * @author Vaadin Ltd + * @since 25.1 */ public interface AIFileReceiver extends Serializable { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIInput.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIInput.java index 0fbb9b3c33b..2e921e35c2a 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIInput.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIInput.java @@ -23,6 +23,7 @@ * Interface for input components that are used in an AI conversation. * * @author Vaadin Ltd + * @since 25.1 */ public interface AIInput extends Serializable { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIMessage.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIMessage.java index 7ee7a0cf507..68d7d69b663 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIMessage.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIMessage.java @@ -23,6 +23,7 @@ * * @author Vaadin Ltd * @see AIMessageList + * @since 25.1 */ public interface AIMessage extends Serializable { diff --git a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIMessageList.java b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIMessageList.java index c0632d832cb..9461ae68a2e 100644 --- a/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIMessageList.java +++ b/vaadin-ai-components-flow-parent/vaadin-ai-components-flow/src/main/java/com/vaadin/flow/component/ai/ui/AIMessageList.java @@ -26,6 +26,7 @@ * * @author Vaadin Ltd * @see AIMessage + * @since 25.1 */ public interface AIMessageList extends Serializable { diff --git a/vaadin-app-layout-flow-parent/vaadin-app-layout-flow/src/main/java/com/vaadin/flow/component/applayout/AppLayout.java b/vaadin-app-layout-flow-parent/vaadin-app-layout-flow/src/main/java/com/vaadin/flow/component/applayout/AppLayout.java index 53d937f8098..0d470a12fbb 100644 --- a/vaadin-app-layout-flow-parent/vaadin-app-layout-flow/src/main/java/com/vaadin/flow/component/applayout/AppLayout.java +++ b/vaadin-app-layout-flow-parent/vaadin-app-layout-flow/src/main/java/com/vaadin/flow/component/applayout/AppLayout.java @@ -48,6 +48,7 @@ * and mobile screen sizes. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-app-layout") @NpmPackage(value = "@vaadin/app-layout", version = "25.2.0") @@ -71,6 +72,7 @@ public class AppLayout extends Component implements RouterLayout, HasStyle { * {@link #setI18n(AppLayoutI18n)} * * @return the i18n object or {@code null} if no i18n object has been set + * @since 23.0 */ public AppLayoutI18n getI18n() { return i18n; @@ -81,6 +83,7 @@ public AppLayoutI18n getI18n() { * * @param i18n * the i18n object, not {@code null} + * @since 23.0 */ public void setI18n(AppLayoutI18n i18n) { this.i18n = Objects.requireNonNull(i18n, @@ -92,6 +95,7 @@ public void setI18n(AppLayoutI18n i18n) { * @see #setPrimarySection(Section) * @return value for the primarySection property. Default is * {@link Section#NAVBAR}. + * @since 2.0 */ @Synchronize("primary-section-changed") public Section getPrimarySection() { @@ -112,6 +116,7 @@ public Section getPrimarySection() { * new value for the primarySection property. Not {@code null}. * @throws NullPointerException * if primarySection is {@code null}. + * @since 2.0 */ public void setPrimarySection(Section primarySection) { Objects.requireNonNull(primarySection, @@ -129,6 +134,7 @@ public void setPrimarySection(Section primarySection) { * * @return {@code true} if the drawer is opened (visible). {@code false} * otherwise. + * @since 2.0 */ @Synchronize("drawer-opened-changed") public boolean isDrawerOpened() { @@ -143,6 +149,7 @@ public boolean isDrawerOpened() { * @see #isDrawerOpened * @see DrawerToggle for a component that allows the user to open and close * the drawer. + * @since 2.0 */ public void setDrawerOpened(boolean drawerOpened) { getElement().setProperty("drawerOpened", drawerOpened); @@ -176,6 +183,7 @@ public SignalBinding bindDrawerOpened(Signal signal, * * @return {@code true} if drawer is an overlay on top of the content. * {@code false} otherwise. + * @since 2.0 */ @Synchronize("overlay-changed") public boolean isOverlay() { @@ -214,6 +222,7 @@ public void setContent(Component content) { * @throws NullPointerException * if any of the components is null or if the components array * is null. + * @since 2.0 */ public void addToDrawer(Component... components) { SlotUtils.addToSlot(this, "drawer", components); @@ -227,6 +236,7 @@ public void addToDrawer(Component... components) { * @throws NullPointerException * if any of the components is null or if the components array * is null. + * @since 2.0 */ public void addToNavbar(Component... components) { final boolean touchOptimized = false; @@ -244,6 +254,7 @@ public void addToNavbar(Component... components) { * @throws NullPointerException * if any of the components is null or if the components array * is null. + * @since 2.0 */ public void addToNavbar(boolean touchOptimized, Component... components) { final String slot = "navbar" @@ -257,6 +268,7 @@ public void addToNavbar(boolean touchOptimized, Component... components) { * * @param components * Components to remove. + * @since 2.0 */ public void remove(Component... components) { for (Component component : components) { @@ -272,6 +284,7 @@ public void remove(Component... components) { * * @throws IllegalArgumentException * if content is not a {@link Component} + * @since 2.0 */ @Override public void showRouterLayoutContent(HasElement content) { @@ -318,6 +331,7 @@ private void remove(Component component) { * Sections in the component that can be used as primary. * * @see #setPrimarySection(Section) + * @since 2.0 */ public enum Section { NAVBAR, DRAWER; @@ -335,6 +349,8 @@ public static Section fromWebcomponentValue(String webcomponentValue) { /** * The internationalization properties for {@link AppLayout} + * + * @since 23.0 */ @JsonInclude(JsonInclude.Include.NON_NULL) public static class AppLayoutI18n implements Serializable { diff --git a/vaadin-app-layout-flow-parent/vaadin-app-layout-flow/src/main/java/com/vaadin/flow/component/applayout/DrawerToggle.java b/vaadin-app-layout-flow-parent/vaadin-app-layout-flow/src/main/java/com/vaadin/flow/component/applayout/DrawerToggle.java index eff0a8b0d4b..13971d7db88 100644 --- a/vaadin-app-layout-flow-parent/vaadin-app-layout-flow/src/main/java/com/vaadin/flow/component/applayout/DrawerToggle.java +++ b/vaadin-app-layout-flow-parent/vaadin-app-layout-flow/src/main/java/com/vaadin/flow/component/applayout/DrawerToggle.java @@ -28,6 +28,8 @@ * AppLayout layout = new AppLayout(); * layout.addToNavbar(new DrawerToggle()); * + * + * @since 2.0 */ @Tag("vaadin-drawer-toggle") @NpmPackage(value = "@vaadin/app-layout", version = "25.2.0") diff --git a/vaadin-aura-theme-flow-parent/vaadin-aura-theme-flow/src/main/java/com/vaadin/flow/theme/aura/Aura.java b/vaadin-aura-theme-flow-parent/vaadin-aura-theme-flow/src/main/java/com/vaadin/flow/theme/aura/Aura.java index d63e575bb89..79a3ba9dc91 100644 --- a/vaadin-aura-theme-flow-parent/vaadin-aura-theme-flow/src/main/java/com/vaadin/flow/theme/aura/Aura.java +++ b/vaadin-aura-theme-flow-parent/vaadin-aura-theme-flow/src/main/java/com/vaadin/flow/theme/aura/Aura.java @@ -21,6 +21,8 @@ /** * Aura theme base class. + * + * @since 25.0 */ @NpmPackage(value = "@vaadin/aura", version = "25.2.0") public class Aura { diff --git a/vaadin-avatar-flow-parent/vaadin-avatar-flow/src/main/java/com/vaadin/flow/component/avatar/Avatar.java b/vaadin-avatar-flow-parent/vaadin-avatar-flow/src/main/java/com/vaadin/flow/component/avatar/Avatar.java index 6d541a6b77c..9380381c629 100644 --- a/vaadin-avatar-flow-parent/vaadin-avatar-flow/src/main/java/com/vaadin/flow/component/avatar/Avatar.java +++ b/vaadin-avatar-flow-parent/vaadin-avatar-flow/src/main/java/com/vaadin/flow/component/avatar/Avatar.java @@ -53,6 +53,7 @@ * used standalone as a regular component. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-avatar") @JsModule("@vaadin/avatar/src/vaadin-avatar.js") @@ -279,6 +280,7 @@ public void setImageResource(AbstractStreamResource resource) { * @see Avatar#setImage(String) * @param downloadHandler * the download resource or {@code null} to remove the resource + * @since 24.8 */ public void setImageHandler(DownloadHandler downloadHandler) { if (downloadHandler == null) { @@ -331,6 +333,7 @@ public void setColorIndex(Integer colorIndex) { * * @return true if the tooltip is shown on hover or focus, * false otherwise + * @since 23.3 */ public boolean isTooltipEnabled() { return getElement().getProperty("withTooltip", false); @@ -342,6 +345,7 @@ public boolean isTooltipEnabled() { * @param tooltipEnabled * true to show the tooltip on hover or focus, * false to not show it + * @since 23.3 */ public void setTooltipEnabled(boolean tooltipEnabled) { getElement().setProperty("withTooltip", tooltipEnabled); diff --git a/vaadin-avatar-flow-parent/vaadin-avatar-flow/src/main/java/com/vaadin/flow/component/avatar/AvatarGroup.java b/vaadin-avatar-flow-parent/vaadin-avatar-flow/src/main/java/com/vaadin/flow/component/avatar/AvatarGroup.java index 2fbafbd50f2..818050bbcc7 100644 --- a/vaadin-avatar-flow-parent/vaadin-avatar-flow/src/main/java/com/vaadin/flow/component/avatar/AvatarGroup.java +++ b/vaadin-avatar-flow-parent/vaadin-avatar-flow/src/main/java/com/vaadin/flow/component/avatar/AvatarGroup.java @@ -70,6 +70,7 @@ * the overflow item displays the overflowing avatars and names in a list. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-avatar-group") @JsModule("@vaadin/avatar-group/src/vaadin-avatar-group.js") @@ -244,6 +245,7 @@ public void setImage(String url) { * @param downloadHandler * the download resource or {@code null} to remove the * resource + * @since 24.8 */ public void setImageHandler(DownloadHandler downloadHandler) { if (downloadHandler == null) { @@ -415,6 +417,7 @@ public void setColorIndex(Integer colorIndex) { * * @param classNames * the class name or class names to be added to the item + * @since 24.3 */ public void addClassNames(String... classNames) { this.classNames.addAll(Arrays.asList(classNames)); @@ -429,6 +432,7 @@ public void addClassNames(String... classNames) { * * @param classNames * the class name or class names to be removed from the item + * @since 24.3 */ public void removeClassNames(String... classNames) { this.classNames.removeAll(Arrays.asList(classNames)); @@ -441,6 +445,7 @@ public void removeClassNames(String... classNames) { * Gets the CSS class name set on this item. * * @return a space-delimited list of CSS class names + * @since 24.3 */ public String getClassName() { if (classNames.isEmpty()) { diff --git a/vaadin-avatar-flow-parent/vaadin-avatar-flow/src/main/java/com/vaadin/flow/component/avatar/AvatarGroupVariant.java b/vaadin-avatar-flow-parent/vaadin-avatar-flow/src/main/java/com/vaadin/flow/component/avatar/AvatarGroupVariant.java index 17294fcd1f8..2491c91053f 100644 --- a/vaadin-avatar-flow-parent/vaadin-avatar-flow/src/main/java/com/vaadin/flow/component/avatar/AvatarGroupVariant.java +++ b/vaadin-avatar-flow-parent/vaadin-avatar-flow/src/main/java/com/vaadin/flow/component/avatar/AvatarGroupVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-avatar-group} component. + * + * @since 1.0 */ public enum AvatarGroupVariant implements ThemeVariant { LUMO_XLARGE("xlarge"), diff --git a/vaadin-avatar-flow-parent/vaadin-avatar-flow/src/main/java/com/vaadin/flow/component/avatar/AvatarVariant.java b/vaadin-avatar-flow-parent/vaadin-avatar-flow/src/main/java/com/vaadin/flow/component/avatar/AvatarVariant.java index 434f466006c..812dcd91189 100644 --- a/vaadin-avatar-flow-parent/vaadin-avatar-flow/src/main/java/com/vaadin/flow/component/avatar/AvatarVariant.java +++ b/vaadin-avatar-flow-parent/vaadin-avatar-flow/src/main/java/com/vaadin/flow/component/avatar/AvatarVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-avatar} component. + * + * @since 1.0 */ public enum AvatarVariant implements ThemeVariant { LUMO_XLARGE("xlarge"), diff --git a/vaadin-badge-flow-parent/vaadin-badge-flow/src/main/java/com/vaadin/flow/component/badge/Badge.java b/vaadin-badge-flow-parent/vaadin-badge-flow/src/main/java/com/vaadin/flow/component/badge/Badge.java index d2c7380a69c..e861d1fbe2c 100644 --- a/vaadin-badge-flow-parent/vaadin-badge-flow/src/main/java/com/vaadin/flow/component/badge/Badge.java +++ b/vaadin-badge-flow-parent/vaadin-badge-flow/src/main/java/com/vaadin/flow/component/badge/Badge.java @@ -63,6 +63,7 @@ * * * @author Vaadin Ltd + * @since 25.1 */ @Tag("vaadin-badge") @NpmPackage(value = "@vaadin/badge", version = "25.2.0") diff --git a/vaadin-badge-flow-parent/vaadin-badge-flow/src/main/java/com/vaadin/flow/component/badge/BadgeVariant.java b/vaadin-badge-flow-parent/vaadin-badge-flow/src/main/java/com/vaadin/flow/component/badge/BadgeVariant.java index 09f5d5aa4ed..59a83d97153 100644 --- a/vaadin-badge-flow-parent/vaadin-badge-flow/src/main/java/com/vaadin/flow/component/badge/BadgeVariant.java +++ b/vaadin-badge-flow-parent/vaadin-badge-flow/src/main/java/com/vaadin/flow/component/badge/BadgeVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-badge} component. + * + * @since 25.1 */ public enum BadgeVariant implements ThemeVariant { CONTRAST("contrast"), diff --git a/vaadin-board-flow-parent/vaadin-board-flow/src/main/java/com/vaadin/flow/component/board/Board.java b/vaadin-board-flow-parent/vaadin-board-flow/src/main/java/com/vaadin/flow/component/board/Board.java index 0062e4c95de..0fa3f91c833 100644 --- a/vaadin-board-flow-parent/vaadin-board-flow/src/main/java/com/vaadin/flow/component/board/Board.java +++ b/vaadin-board-flow-parent/vaadin-board-flow/src/main/java/com/vaadin/flow/component/board/Board.java @@ -27,6 +27,7 @@ * * @deprecated Board is deprecated and will be removed in Vaadin 26. Consider * using Dashboard as an alternative. + * @since 2.0.1 */ @Tag("vaadin-board") @NpmPackage(value = "@vaadin/board", version = "25.2.0") diff --git a/vaadin-board-flow-parent/vaadin-board-flow/src/main/java/com/vaadin/flow/component/board/Row.java b/vaadin-board-flow-parent/vaadin-board-flow/src/main/java/com/vaadin/flow/component/board/Row.java index bc07f3ac95b..670fbf780a3 100644 --- a/vaadin-board-flow-parent/vaadin-board-flow/src/main/java/com/vaadin/flow/component/board/Row.java +++ b/vaadin-board-flow-parent/vaadin-board-flow/src/main/java/com/vaadin/flow/component/board/Row.java @@ -28,6 +28,7 @@ * * @deprecated Board Row is deprecated and will be removed in Vaadin 26. * Consider using Dashboard as an alternative. + * @since 2.0.1 */ @Tag("vaadin-board-row") @NpmPackage(value = "@vaadin/board", version = "25.2.0") diff --git a/vaadin-board-flow-parent/vaadin-board-flow/src/main/java/com/vaadin/flow/component/board/internal/FunctionCaller.java b/vaadin-board-flow-parent/vaadin-board-flow/src/main/java/com/vaadin/flow/component/board/internal/FunctionCaller.java index e5ca2dffacb..154cd94c9fd 100644 --- a/vaadin-board-flow-parent/vaadin-board-flow/src/main/java/com/vaadin/flow/component/board/internal/FunctionCaller.java +++ b/vaadin-board-flow-parent/vaadin-board-flow/src/main/java/com/vaadin/flow/component/board/internal/FunctionCaller.java @@ -11,6 +11,9 @@ import com.vaadin.flow.component.Component; import com.vaadin.flow.dom.Element; +/** + * @since 2.0.1 + */ public class FunctionCaller { /** diff --git a/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/Breadcrumbs.java b/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/Breadcrumbs.java index 57d8451b49b..0422a7c6542 100644 --- a/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/Breadcrumbs.java +++ b/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/Breadcrumbs.java @@ -60,6 +60,7 @@ * {@code com.vaadin.experimental.breadcrumbsComponent} feature flag. * * @author Vaadin Ltd + * @since 25.2 */ @Tag("vaadin-breadcrumbs") @NpmPackage(value = "@vaadin/breadcrumbs", version = "25.2.0") diff --git a/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/BreadcrumbsFeatureFlagProvider.java b/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/BreadcrumbsFeatureFlagProvider.java index df6af19ce87..0b3ac73b4aa 100644 --- a/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/BreadcrumbsFeatureFlagProvider.java +++ b/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/BreadcrumbsFeatureFlagProvider.java @@ -25,6 +25,7 @@ * {@link Breadcrumbs} component. * * @author Vaadin Ltd + * @since 25.2 */ public class BreadcrumbsFeatureFlagProvider implements FeatureFlagProvider { diff --git a/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/BreadcrumbsItem.java b/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/BreadcrumbsItem.java index ca55be689d8..35d5e89f6f7 100644 --- a/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/BreadcrumbsItem.java +++ b/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/BreadcrumbsItem.java @@ -44,6 +44,7 @@ * optional prefix component (typically an icon) can be shown before the text. * * @author Vaadin Ltd + * @since 25.2 */ @Tag("vaadin-breadcrumbs-item") @NpmPackage(value = "@vaadin/breadcrumbs", version = "25.2.0") diff --git a/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/BreadcrumbsVariant.java b/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/BreadcrumbsVariant.java index 0336e238584..d863408e4e0 100644 --- a/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/BreadcrumbsVariant.java +++ b/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/BreadcrumbsVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-breadcrumbs} component. + * + * @since 25.2 */ public enum BreadcrumbsVariant implements ThemeVariant { SLASH("slash"), LUMO_PRIMARY("primary"), AURA_ACCENT("accent"); diff --git a/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/ExperimentalFeatureException.java b/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/ExperimentalFeatureException.java index 23dad6d8b6a..e135dba05e1 100644 --- a/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/ExperimentalFeatureException.java +++ b/vaadin-breadcrumbs-flow-parent/vaadin-breadcrumbs-flow/src/main/java/com/vaadin/flow/component/breadcrumbs/ExperimentalFeatureException.java @@ -21,6 +21,7 @@ * first. * * @author Vaadin Ltd + * @since 25.2 */ public class ExperimentalFeatureException extends RuntimeException { /** diff --git a/vaadin-button-flow-parent/vaadin-button-flow/src/main/java/com/vaadin/flow/component/button/Button.java b/vaadin-button-flow-parent/vaadin-button-flow/src/main/java/com/vaadin/flow/component/button/Button.java index 9092b33c5c5..4910e936e77 100644 --- a/vaadin-button-flow-parent/vaadin-button-flow/src/main/java/com/vaadin/flow/component/button/Button.java +++ b/vaadin-button-flow-parent/vaadin-button-flow/src/main/java/com/vaadin/flow/component/button/Button.java @@ -54,6 +54,7 @@ * different style variants, and supports icons in addition to text labels. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-button") @NpmPackage(value = "@vaadin/button", version = "25.2.0") @@ -95,6 +96,7 @@ public Button(String text) { * * @param textSignal * the signal of text value + * @since 25.1 */ public Button(Signal textSignal) { this(); @@ -139,6 +141,7 @@ public Button(String text, Component icon) { * the signal of text value * @param icon * the icon inside the button + * @since 25.1 */ public Button(Signal textSignal, Component icon) { this(); @@ -171,6 +174,7 @@ public Button(String text, * the signal of text value * @param clickListener * the event listener for click events + * @since 25.1 */ public Button(Signal textSignal, ComponentEventListener> clickListener) { @@ -227,6 +231,7 @@ public Button(String text, Component icon, * the icon inside the button * @param clickListener * the event listener for click events + * @since 25.1 */ public Button(Signal textSignal, Component icon, ComponentEventListener> clickListener) { @@ -355,6 +360,8 @@ public void click() { /** * Executes a click on this button at the client-side. Calling this method * behaves the same as if the user would have clicked on the button. + * + * @since 1.3 */ public void clickInClient() { getElement().callJsFunction("click"); @@ -418,6 +425,7 @@ public boolean isAutofocus() { * whether the button should be disabled when clicked * @throws IllegalStateException * if the enabled state is already bound to a signal + * @since 1.2 */ public void setDisableOnClick(boolean disableOnClick) { boolean hasEnabledBinding = getElement().getNode() @@ -436,6 +444,7 @@ public void setDisableOnClick(boolean disableOnClick) { * Gets whether the button is set to be disabled when clicked. * * @return whether button is set to be disabled on click + * @since 1.2 */ public boolean isDisableOnClick() { return disableOnClickController.isDisableOnClick(); @@ -460,6 +469,8 @@ public boolean isDisableOnClick() { * * This feature flag will also enable focus events and focus shortcuts for * disabled buttons. + * + * @since 24.3.8 */ @Override public void setEnabled(boolean enabled) { @@ -481,6 +492,7 @@ public void setEnabled(boolean enabled) { * onChange} callbacks * @throws IllegalStateException * if disable-on-click is active + * @since 25.1 */ @Override public SignalBinding bindEnabled(Signal enabledSignal) { @@ -504,6 +516,8 @@ public SignalBinding bindEnabled(Signal enabledSignal) { * * This feature flag will enable focus events and focus shortcuts for * disabled buttons. + * + * @since 24.7 */ @Override public ShortcutRegistration addFocusShortcut(Key key, @@ -529,6 +543,8 @@ public ShortcutRegistration addFocusShortcut(Key key, * * This feature flag will enable focus events and focus shortcuts for * disabled buttons. + * + * @since 24.7 */ @SuppressWarnings({ "unchecked", "rawtypes" }) @Override @@ -554,6 +570,8 @@ public Registration addFocusListener( * 
      * com.vaadin.experimental.accessibleDisabledButtons = true
      *
+ * + * @since 24.7 */ @SuppressWarnings({ "unchecked", "rawtypes" }) @Override @@ -588,6 +606,7 @@ private void updateIconSlot() { * The components to remove. * @throws IllegalArgumentException * if any of the components is not a child of this component. + * @since 24.0 */ protected void remove(Component... components) { for (Component component : components) { diff --git a/vaadin-button-flow-parent/vaadin-button-flow/src/main/java/com/vaadin/flow/component/button/ButtonVariant.java b/vaadin-button-flow-parent/vaadin-button-flow/src/main/java/com/vaadin/flow/component/button/ButtonVariant.java index c8fcce7d6b8..8463490a6e3 100644 --- a/vaadin-button-flow-parent/vaadin-button-flow/src/main/java/com/vaadin/flow/component/button/ButtonVariant.java +++ b/vaadin-button-flow-parent/vaadin-button-flow/src/main/java/com/vaadin/flow/component/button/ButtonVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-button} component. + * + * @since 1.1 */ public enum ButtonVariant implements ThemeVariant { LUMO_SMALL("small"), diff --git a/vaadin-card-flow-parent/vaadin-card-flow/src/main/java/com/vaadin/flow/component/card/Card.java b/vaadin-card-flow-parent/vaadin-card-flow/src/main/java/com/vaadin/flow/component/card/Card.java index 16bd5ed610b..918d1331ece 100644 --- a/vaadin-card-flow-parent/vaadin-card-flow/src/main/java/com/vaadin/flow/component/card/Card.java +++ b/vaadin-card-flow-parent/vaadin-card-flow/src/main/java/com/vaadin/flow/component/card/Card.java @@ -36,6 +36,7 @@ * Card is a visual content container for creating a card-based layout. * * @author Vaadin Ltd + * @since 24.7 */ @Tag("vaadin-card") @NpmPackage(value = "@vaadin/card", version = "25.2.0") @@ -62,6 +63,7 @@ public class Card extends Component implements HasSize, * * @param media * the media component, or {@code null} to remove + * @since 24.7.2 */ public void setMedia(Component media) { SlotUtils.setSlot(this, MEDIA_SLOT_NAME, media); @@ -71,6 +73,7 @@ public void setMedia(Component media) { * Gets the current media component. * * @return the media component, or {@code null} if none is set + * @since 24.7.2 */ public Component getMedia() { return SlotUtils.getChildInSlot(this, MEDIA_SLOT_NAME); @@ -88,6 +91,7 @@ public Component getMedia() { * @see #setTitle(String, Integer) * @see #setTitleHeadingLevel(Integer) * @see #getTitleAsText() + * @since 24.7.2 */ public void setTitle(String title) { doSetTitle((Component) null); @@ -108,6 +112,7 @@ public void setTitle(String title) { * @see #setTitle(String) * @see #setTitleHeadingLevel(Integer) * @see #getTitleAsText() + * @since 24.7.2 */ public void setTitle(String title, Integer titleHeadingLevel) { setTitleHeadingLevel(titleHeadingLevel); @@ -122,6 +127,7 @@ public void setTitle(String title, Integer titleHeadingLevel) { * * @param titleHeadingLevel * the title heading level property, {@code null} to remove + * @since 24.7.2 */ public void setTitleHeadingLevel(Integer titleHeadingLevel) { if (titleHeadingLevel == null) { @@ -141,6 +147,7 @@ public void setTitleHeadingLevel(Integer titleHeadingLevel) { * * @param title * the title component, or {@code null} to remove + * @since 24.7.2 */ public void setTitle(Component title) { doSetTitle((String) null); @@ -152,6 +159,7 @@ public void setTitle(Component title) { * title is set. * * @return the value of the title property + * @since 24.7.2 */ public String getTitleAsText() { return getElement().getProperty(CARD_TITLE_PROPERTY, ""); @@ -161,6 +169,7 @@ public String getTitleAsText() { * Gets the current title component set using {@link #setTitle(Component)}. * * @return the title component, or {@code null} if none is set + * @since 24.7.2 */ public Component getTitle() { return SlotUtils.getChildInSlot(this, TITLE_SLOT_NAME); @@ -175,6 +184,7 @@ public Component getTitle() { * * @param subtitle * the subtitle component, or {@code null} to remove + * @since 24.7.2 */ public void setSubtitle(Component subtitle) { SlotUtils.setSlot(this, SUBTITLE_SLOT_NAME, subtitle); @@ -188,6 +198,7 @@ public void setSubtitle(Component subtitle) { * * @param subtitle * the subtitle, or {@code null} to remove + * @since 25.0 */ public void setSubtitle(String subtitle) { if (subtitle == null) { @@ -201,6 +212,7 @@ public void setSubtitle(String subtitle) { * Gets the current subtitle component. * * @return the subtitle component, or {@code null} if none is set + * @since 24.7.2 */ public Component getSubtitle() { return SlotUtils.getChildInSlot(this, SUBTITLE_SLOT_NAME); @@ -216,6 +228,7 @@ public Component getSubtitle() { * * @param header * the header component, or {@code null} to remove + * @since 24.7.2 */ public void setHeader(Component header) { SlotUtils.setSlot(this, HEADER_SLOT_NAME, header); @@ -225,6 +238,7 @@ public void setHeader(Component header) { * Gets the current header component. * * @return the header component, or {@code null} if none is set + * @since 24.7.2 */ public Component getHeader() { return SlotUtils.getChildInSlot(this, HEADER_SLOT_NAME); @@ -238,6 +252,7 @@ public Component getHeader() { * * @param headerPrefix * the header prefix component, or {@code null} to remove + * @since 24.7.2 */ public void setHeaderPrefix(Component headerPrefix) { SlotUtils.setSlot(this, HEADER_PREFIX_SLOT_NAME, headerPrefix); @@ -247,6 +262,7 @@ public void setHeaderPrefix(Component headerPrefix) { * Gets the current header prefix component. * * @return the header prefix component, or {@code null} if none is set + * @since 24.7.2 */ public Component getHeaderPrefix() { return SlotUtils.getChildInSlot(this, HEADER_PREFIX_SLOT_NAME); @@ -260,6 +276,7 @@ public Component getHeaderPrefix() { * * @param headerSuffix * the header suffix component, or {@code null} to remove + * @since 24.7.2 */ public void setHeaderSuffix(Component headerSuffix) { SlotUtils.setSlot(this, HEADER_SUFFIX_SLOT_NAME, headerSuffix); @@ -269,6 +286,7 @@ public void setHeaderSuffix(Component headerSuffix) { * Gets the current header suffix component. * * @return the header suffix component, or {@code null} if none is set + * @since 24.7.2 */ public Component getHeaderSuffix() { return SlotUtils.getChildInSlot(this, HEADER_SUFFIX_SLOT_NAME); @@ -279,6 +297,7 @@ public Component getHeaderSuffix() { * * @param footerComponent * the components to add into the footer + * @since 24.7.2 */ public void addToFooter(Component... footerComponent) { Objects.requireNonNull(footerComponent, @@ -295,6 +314,7 @@ public void addToFooter(Component... footerComponent) { * Gets all components added to the card's footer. * * @return an array of footer components + * @since 24.7.2 */ public Component[] getFooterComponents() { return SlotUtils.getElementsInSlot(this, FOOTER_SLOT_NAME) @@ -345,6 +365,7 @@ public void addComponentAtIndex(int index, Component component) { * * @param role * the ARIA role, or {@code null} to clear + * @since 24.7.2 */ public void setAriaRole(String role) { if (role == null) { @@ -358,6 +379,7 @@ public void setAriaRole(String role) { * Gets the ARIA role attribute of the card. * * @return an optional ARIA role of the card if no ARIA role has been set + * @since 24.7.2 */ public Optional getAriaRole() { return Optional.ofNullable(getElement().getAttribute("role")); diff --git a/vaadin-card-flow-parent/vaadin-card-flow/src/main/java/com/vaadin/flow/component/card/CardVariant.java b/vaadin-card-flow-parent/vaadin-card-flow/src/main/java/com/vaadin/flow/component/card/CardVariant.java index aa1ad0d3fef..e0fa60ed835 100644 --- a/vaadin-card-flow-parent/vaadin-card-flow/src/main/java/com/vaadin/flow/component/card/CardVariant.java +++ b/vaadin-card-flow-parent/vaadin-card-flow/src/main/java/com/vaadin/flow/component/card/CardVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-card} component. + * + * @since 24.7 */ public enum CardVariant implements ThemeVariant { LUMO_ELEVATED("elevated"), diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/Chart.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/Chart.java index 1cfb4760608..3f7d46eeff1 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/Chart.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/Chart.java @@ -87,6 +87,7 @@ * layout. * * @author Vaadin Ltd + * @since 6.0.1 */ @Tag("vaadin-chart") @NpmPackage(value = "@vaadin/charts", version = "25.2.0") @@ -258,6 +259,7 @@ public Configuration getConfiguration() { /** * @param configuration * new configuration for this chart. + * @since 18.0 */ public void setConfiguration(Configuration configuration) { if (this.configuration != null) { @@ -599,6 +601,7 @@ public Registration addPointUpdateListener( * drag a point. * * @param listener + * @since 24.7 */ public Registration addPointDragStartListener( ComponentEventListener listener) { @@ -609,6 +612,7 @@ public Registration addPointDragStartListener( * Adds a point drop listener, which will be notified point is dropped. * * @param listener + * @since 24.7 */ public Registration addPointDropListener( ComponentEventListener listener) { @@ -620,6 +624,7 @@ public Registration addPointDropListener( * dragged. * * @param listener + * @since 24.7 */ public Registration addPointDragListener( ComponentEventListener listener) { @@ -656,6 +661,7 @@ public Registration addYAxesExtremesSetListener( * * @param variants * theme variants to add + * @since 23.1 */ public void addThemeVariants(ChartVariant... variants) { getThemeNames() @@ -668,6 +674,7 @@ public void addThemeVariants(ChartVariant... variants) { * * @param variants * theme variants to remove + * @since 23.1 */ public void removeThemeVariants(ChartVariant... variants) { getThemeNames() diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/ChartOptions.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/ChartOptions.java index 421cda2bef6..a21fca82543 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/ChartOptions.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/ChartOptions.java @@ -27,6 +27,8 @@ *

* Use {@link ChartOptions#get()} or {@link ChartOptions#get(UI)} to get an * instance for the current or specified {@link UI}. + * + * @since 18.0 */ public class ChartOptions extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/ChartVariant.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/ChartVariant.java index 863411e795a..acb7e2892a7 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/ChartVariant.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/ChartVariant.java @@ -10,6 +10,8 @@ /** * Set of theme variants applicable for {@code vaadin-chart} component. + * + * @since 23.1 */ public enum ChartVariant { LUMO_GRADIENT("gradient"), diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartAddSeriesEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartAddSeriesEvent.java index 06fa7d3b4c2..b435c5ab078 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartAddSeriesEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartAddSeriesEvent.java @@ -18,6 +18,8 @@ /** * The ChartAddSeriesEvent class stores data about new series added to an * existing chart. + * + * @since 6.0.1 */ @DomEvent("chart-add-series") public class ChartAddSeriesEvent extends ComponentEvent { @@ -32,6 +34,7 @@ public class ChartAddSeriesEvent extends ComponentEvent { * @param fromClient * @param name * @param data + * @since 25.0 */ public ChartAddSeriesEvent(Chart source, boolean fromClient, @EventData("event.detail.originalEvent.options.name") String name, diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartAfterPrintEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartAfterPrintEvent.java index 4bd49a1e8f1..a8de4ee9742 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartAfterPrintEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartAfterPrintEvent.java @@ -14,6 +14,8 @@ /** * Fired after a chart is printed using the print menu + * + * @since 6.0.1 */ @DomEvent("chart-after-print") public class ChartAfterPrintEvent extends ComponentEvent { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartBeforePrintEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartBeforePrintEvent.java index 1ada74c40b0..343b34621fb 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartBeforePrintEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartBeforePrintEvent.java @@ -14,6 +14,8 @@ /** * Fired before a chart is printed using the print menu + * + * @since 6.0.1 */ @DomEvent("chart-before-print") public class ChartBeforePrintEvent extends ComponentEvent { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartClickEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartClickEvent.java index ab5334a0e30..4358e57121d 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartClickEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartClickEvent.java @@ -16,6 +16,8 @@ /** * The ChartClickEvent class stores information on click events anywhere on the * area of the chart. + * + * @since 6.0.1 */ @DomEvent("chart-click") public class ChartClickEvent extends ComponentEvent diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartDrillupAllEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartDrillupAllEvent.java index 82d44b93b7a..28ec131ccef 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartDrillupAllEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartDrillupAllEvent.java @@ -15,6 +15,8 @@ /** * ChartDrillupEvent triggered after all the series has been drilled up if chart * has multiple drilldown series + * + * @since 6.0.1 */ @DomEvent("chart-drillupall") public class ChartDrillupAllEvent extends ComponentEvent { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartDrillupEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartDrillupEvent.java index 0853b0fe1e3..a06e89715db 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartDrillupEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartDrillupEvent.java @@ -15,6 +15,8 @@ /** * ChartDrillupEvent triggered when the 'Back to previous series' button is * clicked + * + * @since 6.0.1 */ @DomEvent("chart-drillup") public class ChartDrillupEvent extends ComponentEvent { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartLoadEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartLoadEvent.java index 927f3a9c166..3d0efcfbacf 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartLoadEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartLoadEvent.java @@ -14,6 +14,8 @@ /** * Fired after a chart is loaded + * + * @since 6.0.1 */ @DomEvent("chart-load") public class ChartLoadEvent extends ComponentEvent { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartRedrawEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartRedrawEvent.java index 6fca353d328..484b170ae0a 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartRedrawEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartRedrawEvent.java @@ -14,6 +14,8 @@ /** * Fired after a chart is redrawn + * + * @since 6.0.1 */ @DomEvent("chart-redraw") public class ChartRedrawEvent extends ComponentEvent { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartSelectionEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartSelectionEvent.java index c139e77c9f2..dadb3e037eb 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartSelectionEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ChartSelectionEvent.java @@ -18,6 +18,8 @@ /** * The ChartSelectionEvent class stores information on selection events on the * chart's area. + * + * @since 6.0.1 */ @DomEvent("chart-selection") public class ChartSelectionEvent extends ComponentEvent { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ClickEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ClickEvent.java index 518f28d1423..c462b31c519 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ClickEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/ClickEvent.java @@ -12,6 +12,9 @@ import com.vaadin.flow.component.charts.util.Util; +/** + * @since 6.0.1 + */ public interface ClickEvent extends Serializable { /** diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/DrilldownEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/DrilldownEvent.java index 5cff35faafb..578155ff806 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/DrilldownEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/DrilldownEvent.java @@ -16,6 +16,8 @@ /** * The DrilldownEvent class stores information on click events in drilldown * points + * + * @since 6.0.1 */ @DomEvent("chart-drilldown") public class DrilldownEvent extends ComponentEvent implements HasItem { @@ -32,6 +34,7 @@ public class DrilldownEvent extends ComponentEvent implements HasItem { * Construct a ChartDrilldownEvent * * @param source + * @since 22.0.1 */ public DrilldownEvent(Chart source, boolean fromClient, @EventData("event.detail.originalEvent.point.drilldown") String drilldown, diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/HasAxis.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/HasAxis.java index ea272d64584..64d3a1e718c 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/HasAxis.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/HasAxis.java @@ -12,6 +12,9 @@ import com.vaadin.flow.component.charts.Chart; +/** + * @since 6.0.1 + */ public interface HasAxis extends Serializable { Chart getSource(); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/HasItem.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/HasItem.java index 6fcf27f5c59..b8ea55829e9 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/HasItem.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/HasItem.java @@ -19,6 +19,8 @@ /** * Indicates that an event has an associated item + * + * @since 6.0.1 */ public interface HasItem extends HasSeries { @@ -70,6 +72,7 @@ public interface HasItem extends HasSeries { * * @see #getItem() * @see #getItemIndex() + * @since 22.0.1 */ String getItemId(); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/HasSeries.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/HasSeries.java index f159b4f8e9a..50cddd8e98f 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/HasSeries.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/HasSeries.java @@ -15,6 +15,8 @@ /** * Indicates that an event has an associated series + * + * @since 6.0.1 */ public interface HasSeries extends Serializable { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/MouseEventDetails.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/MouseEventDetails.java index ab71b0bd3a8..29f77d49fcc 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/MouseEventDetails.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/MouseEventDetails.java @@ -12,6 +12,8 @@ /** * Helper class to store and transfer mouse event details. + * + * @since 6.0.1 */ public class MouseEventDetails implements Serializable { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointClickEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointClickEvent.java index d25fbed4f5b..4472c5a887e 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointClickEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointClickEvent.java @@ -16,6 +16,8 @@ /** * The PointClickEvent class stores data for click events on the points of the * chart. + * + * @since 6.0.1 */ @DomEvent("point-click") public class PointClickEvent extends ComponentEvent @@ -43,6 +45,7 @@ public class PointClickEvent extends ComponentEvent * @param category * @param pointIndex * @param pointId + * @since 22.0.1 */ public PointClickEvent(Chart source, boolean fromClient, @EventData("event.detail.originalEvent.pageX") int pageX, diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointDragEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointDragEvent.java index f67c01000ec..f24d3a7fdba 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointDragEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointDragEvent.java @@ -18,6 +18,8 @@ /** * Fired while dragging a point. + * + * @since 24.7 */ @DomEvent("point-drag") public class PointDragEvent extends ComponentEvent implements HasItem { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointDragStartEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointDragStartEvent.java index 4f265d46549..9c27ed0e3ff 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointDragStartEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointDragStartEvent.java @@ -18,6 +18,8 @@ /** * Fired when starting to drag a point. + * + * @since 24.7 */ @DomEvent("point-drag-start") public class PointDragStartEvent extends ComponentEvent diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointDropEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointDropEvent.java index 4302dd7aeb3..9aeb13ffc8e 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointDropEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointDropEvent.java @@ -18,6 +18,8 @@ /** * Fired when the point is dropped. + * + * @since 24.7 */ @DomEvent("point-drop") public class PointDropEvent extends ComponentEvent implements HasItem { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointLegendItemClickEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointLegendItemClickEvent.java index 36021acb219..8bf032f44f8 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointLegendItemClickEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointLegendItemClickEvent.java @@ -16,6 +16,8 @@ /** * The PointLegendItemClickEvent class stores information on click events on the * charts's legend items that correspond to a chart point. + * + * @since 6.0.1 */ @DomEvent("point-legend-item-click") public class PointLegendItemClickEvent extends ComponentEvent @@ -32,6 +34,7 @@ public class PointLegendItemClickEvent extends ComponentEvent * * @param source * @param fromClient + * @since 22.0.1 */ public PointLegendItemClickEvent(Chart source, boolean fromClient, @EventData("event.detail.originalEvent.browserEvent.pageX") int pageX, diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointMouseOutEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointMouseOutEvent.java index 7617f984a72..fa801da8bb2 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointMouseOutEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointMouseOutEvent.java @@ -15,6 +15,8 @@ /** * Fired when the mouse exits the neighborhood of a point + * + * @since 6.0.1 */ @DomEvent("point-mouse-out") public class PointMouseOutEvent extends ComponentEvent diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointMouseOverEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointMouseOverEvent.java index 2c1ab9238fe..228db14b398 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointMouseOverEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointMouseOverEvent.java @@ -15,6 +15,8 @@ /** * Fired when the mouse pointer moves within the neighborhood of a point + * + * @since 6.0.1 */ @DomEvent("point-mouse-over") public class PointMouseOverEvent extends ComponentEvent diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointRemoveEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointRemoveEvent.java index 8d16a9b0c9c..91c9f62b8c4 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointRemoveEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointRemoveEvent.java @@ -16,6 +16,8 @@ /** * The PointRemoveEvent class stores data for remove events on the points of the * chart + * + * @since 6.0.1 */ @DomEvent("point-remove") public class PointRemoveEvent extends ComponentEvent implements HasItem { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointSelectEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointSelectEvent.java index 59ed8820365..9e490019bb7 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointSelectEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointSelectEvent.java @@ -16,6 +16,8 @@ /** * The PointSelectEvent class stores data for select events on the points of the * chart. + * + * @since 6.0.1 */ @DomEvent("point-select") public class PointSelectEvent extends ComponentEvent implements HasItem { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointUnselectEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointUnselectEvent.java index 8e666b25f31..683871cc346 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointUnselectEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointUnselectEvent.java @@ -16,6 +16,8 @@ /** * The PointUnselectEvent class stores data for unselect events on the points of * the chart. + * + * @since 6.0.1 */ @DomEvent("point-unselect") public class PointUnselectEvent extends ComponentEvent diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointUpdateEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointUpdateEvent.java index 82d7b62ad85..50fa66f9453 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointUpdateEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/PointUpdateEvent.java @@ -16,6 +16,8 @@ /** * The PointUpdateEvent class stores data for update events on the points of the * chart + * + * @since 6.0.1 */ @DomEvent("point-update") public class PointUpdateEvent extends ComponentEvent implements HasItem { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesAfterAnimateEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesAfterAnimateEvent.java index ea381a3a2b7..86d7771d8ac 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesAfterAnimateEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesAfterAnimateEvent.java @@ -15,6 +15,8 @@ /** * Fired after a chart series is animated + * + * @since 6.0.1 */ @DomEvent("series-after-animate") public class SeriesAfterAnimateEvent extends ComponentEvent diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesCheckboxClickEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesCheckboxClickEvent.java index 5e722ac38b3..c2a601f3c59 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesCheckboxClickEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesCheckboxClickEvent.java @@ -15,6 +15,8 @@ /** * SeriesCheckboxClickEvent triggered when a checkbox in a legend is clicked + * + * @since 6.0.1 */ @DomEvent("series-checkbox-click") public class SeriesCheckboxClickEvent extends ComponentEvent diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesClickEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesClickEvent.java index 18ab4abf8e1..065e271e0d4 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesClickEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesClickEvent.java @@ -16,6 +16,8 @@ /** * The SeriesClickEvent class stores data for click events on the series of the * chart. + * + * @since 6.0.1 */ @DomEvent("series-click") public class SeriesClickEvent extends ComponentEvent diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesHideEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesHideEvent.java index 66b4b8dd5de..a68722887b2 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesHideEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesHideEvent.java @@ -15,6 +15,8 @@ /** * Fired when a series is hidden + * + * @since 6.0.1 */ @DomEvent("series-hide") public class SeriesHideEvent extends ComponentEvent diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesLegendItemClickEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesLegendItemClickEvent.java index 0854b4f55fc..a9591a15ce1 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesLegendItemClickEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesLegendItemClickEvent.java @@ -16,6 +16,8 @@ /** * The SeriesLegendItemClickEvent class stores information on click events on * the charts's legend items that correspond to a chart series. + * + * @since 6.0.1 */ @DomEvent("series-legend-item-click") public class SeriesLegendItemClickEvent extends ComponentEvent @@ -29,6 +31,7 @@ public class SeriesLegendItemClickEvent extends ComponentEvent * * @param source * @param fromClient + * @since 22.0 */ public SeriesLegendItemClickEvent(Chart source, boolean fromClient, @EventData("event.detail.originalEvent.browserEvent.pageX") int pageX, diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesMouseOutEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesMouseOutEvent.java index b560c1359e6..d20840e0d8d 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesMouseOutEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesMouseOutEvent.java @@ -15,6 +15,8 @@ /** * Fired when the mouse exits the neighborhood of a series + * + * @since 6.0.1 */ @DomEvent("series-mouse-out") public class SeriesMouseOutEvent extends ComponentEvent diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesMouseOverEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesMouseOverEvent.java index c09a2a1cc7f..b148cccdc43 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesMouseOverEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesMouseOverEvent.java @@ -15,6 +15,8 @@ /** * Fired when the mouse moves within the neighborhood of a series + * + * @since 6.0.1 */ @DomEvent("series-mouse-over") public class SeriesMouseOverEvent extends ComponentEvent diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesShowEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesShowEvent.java index b2ef50238bb..ec30c404656 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesShowEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/SeriesShowEvent.java @@ -15,6 +15,8 @@ /** * Fired when a series is shown + * + * @since 6.0.1 */ @DomEvent("series-show") public class SeriesShowEvent extends ComponentEvent diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/XAxesExtremesSetEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/XAxesExtremesSetEvent.java index c4a2fbf78d8..c6e22870b87 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/XAxesExtremesSetEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/XAxesExtremesSetEvent.java @@ -17,6 +17,8 @@ /** * The XAxesExtremesSetEvent class stores data for set extremes events on the x * axes of the chart. + * + * @since 6.0.1 */ @DomEvent("xaxes-extremes-set") public class XAxesExtremesSetEvent extends ComponentEvent diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/YAxesExtremesSetEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/YAxesExtremesSetEvent.java index d18588f900e..af3a6f35eda 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/YAxesExtremesSetEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/YAxesExtremesSetEvent.java @@ -17,6 +17,8 @@ /** * The YAxesExtremesSetEvent class stores data for set extremes events on the y * axes of the chart. + * + * @since 6.0.1 */ @DomEvent("yaxes-extremes-set") public class YAxesExtremesSetEvent extends ComponentEvent diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/AbstractSeriesEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/AbstractSeriesEvent.java index d8b941c5070..299a33103a6 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/AbstractSeriesEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/AbstractSeriesEvent.java @@ -15,7 +15,7 @@ /** * Base class for series events. * - * @since 2.0 + * @since 6.0.1 * */ public abstract class AbstractSeriesEvent implements Serializable { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/AbstractSeriesItemEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/AbstractSeriesItemEvent.java index 127d0151bb3..17139480a48 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/AbstractSeriesItemEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/AbstractSeriesItemEvent.java @@ -15,7 +15,7 @@ * Base class for series item events. Contains the information about series and * exactly one of item or value. * - * @since 2.0 + * @since 6.0.1 * */ public abstract class AbstractSeriesItemEvent extends AbstractSeriesEvent { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/AxisRescaledEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/AxisRescaledEvent.java index 1473fceab17..98c20f00dee 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/AxisRescaledEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/AxisRescaledEvent.java @@ -14,7 +14,7 @@ * Event for information about rescaling the axis. Wraps * Axis.setExtremes(). * - * @since 2.0 + * @since 6.0.1 */ public class AxisRescaledEvent implements Serializable { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/ConfigurationChangeListener.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/ConfigurationChangeListener.java index 8e4ec97f8f0..cc635194ed2 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/ConfigurationChangeListener.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/ConfigurationChangeListener.java @@ -14,7 +14,7 @@ * Listener interface for events triggered in Configuration. E.g. in DataSeries, * events like data add/remove/update. * - * @since 2.0 + * @since 6.0.1 * */ public interface ConfigurationChangeListener extends Serializable { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/DataAddedEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/DataAddedEvent.java index bbce2ea7889..20aab1f4df9 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/DataAddedEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/DataAddedEvent.java @@ -14,7 +14,7 @@ /** * Event triggered when data was added to the series. * - * @since 2.0 + * @since 6.0.1 * */ public class DataAddedEvent extends AbstractSeriesItemEvent { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/DataRemovedEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/DataRemovedEvent.java index dbcf442b55e..a108e7e5a4c 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/DataRemovedEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/DataRemovedEvent.java @@ -13,7 +13,7 @@ /** * Event when the data was removed. * - * @since 2.0 + * @since 6.0.1 * */ public class DataRemovedEvent extends AbstractSeriesEvent { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/DataUpdatedEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/DataUpdatedEvent.java index 3b9bd74b9b4..03903a3d6f5 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/DataUpdatedEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/DataUpdatedEvent.java @@ -14,7 +14,7 @@ /** * Event for updating existing data series. * - * @since 2.0 + * @since 6.0.1 * */ public class DataUpdatedEvent extends AbstractSeriesItemEvent { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/ItemSlicedEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/ItemSlicedEvent.java index 96f21af0751..72711f304a5 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/ItemSlicedEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/ItemSlicedEvent.java @@ -13,7 +13,7 @@ /** * Event for information about slicing a pie point * - * @since 2.0 + * @since 6.0.1 */ public class ItemSlicedEvent extends AbstractSeriesEvent { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/SeriesAddedEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/SeriesAddedEvent.java index 70ffdf63e15..f8b87c3e683 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/SeriesAddedEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/SeriesAddedEvent.java @@ -13,7 +13,7 @@ /** * Event for information about a new series to be added * - * @since 4.0 + * @since 6.0.1 * */ public class SeriesAddedEvent extends AbstractSeriesEvent { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/SeriesChangedEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/SeriesChangedEvent.java index 2d7625c98ad..7dad1356674 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/SeriesChangedEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/SeriesChangedEvent.java @@ -13,7 +13,7 @@ /** * Event for information about changes in data of series * - * @since 4.0 + * @since 6.0.1 * */ public class SeriesChangedEvent extends AbstractSeriesEvent { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/SeriesStateEvent.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/SeriesStateEvent.java index f48f672b8ca..07c1c4bfebc 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/SeriesStateEvent.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/events/internal/SeriesStateEvent.java @@ -13,7 +13,7 @@ /** * Listener class for Series enabling and disabling events. * - * @since 2.0 + * @since 6.0.1 */ public class SeriesStateEvent extends AbstractSeriesEvent { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractConfigurationObject.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractConfigurationObject.java index ec78cd34f87..7d9377dc8f4 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractConfigurationObject.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractConfigurationObject.java @@ -13,6 +13,8 @@ /** * Abstract base class for model classes to be serialized to JSON. Mainly * com.vaadin.flow.component.charts.model.Configuration and the stuff it uses. + * + * @since 6.0.1 */ public abstract class AbstractConfigurationObject implements Serializable { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractDataLabels.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractDataLabels.java index 8e04cd90f33..870feb40416 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractDataLabels.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractDataLabels.java @@ -11,6 +11,9 @@ import com.vaadin.flow.component.charts.model.style.Color; import com.vaadin.flow.component.charts.model.style.Style; +/** + * @since 6.0.1 + */ public abstract class AbstractDataLabels extends AbstractConfigurationObject { public static final String OVERFLOW_JUSTIFY = "justify"; @@ -28,51 +31,66 @@ public abstract class AbstractDataLabels extends AbstractConfigurationObject { /** * @see #setBackgroundColor(Color) + * @since 18.0 */ public abstract Color getBackgroundColor(); /** * The background color or gradient for the data label. + * + * @since 18.0 */ public abstract void setBackgroundColor(Color backgroundColor); /** * @see #setBorderColor(Color) + * @since 18.0 */ public abstract Color getBorderColor(); /** * The border color for the data label. + * + * @since 18.0 */ public abstract void setBorderColor(Color borderColor); /** * @see #setBorderRadius(Number) + * @since 18.0 */ public abstract Number getBorderRadius(); /** * The border radius in pixels for the data label. + * + * @since 18.0 */ public abstract void setBorderRadius(Number borderRadius); /** * @see #setColor(Color) + * @since 18.0 */ public abstract Color getColor(); /** * The text color for the data labels. + * + * @since 18.0 */ public abstract void setColor(Color color); /** * @see #setBorderWidth(Number) + * @since 18.0 */ public abstract Number getBorderWidth(); /** * The border width in pixels for the data label. + * + * @since 18.0 */ public abstract void setBorderWidth(Number borderWidth); @@ -202,11 +220,14 @@ public abstract class AbstractDataLabels extends AbstractConfigurationObject { /** * @see #setStyle(Style) + * @since 18.0 */ public abstract Style getStyle(); /** * Styles for the label. + * + * @since 18.0 */ public abstract void setStyle(Style style); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractPlotOptions.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractPlotOptions.java index 927f6918a6b..eb5ce91b8a2 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractPlotOptions.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractPlotOptions.java @@ -8,6 +8,9 @@ */ package com.vaadin.flow.component.charts.model; +/** + * @since 6.0.1 + */ public abstract class AbstractPlotOptions extends AbstractConfigurationObject { public ChartType getChartType() { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractSeries.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractSeries.java index 1d3003b2539..9c96e326dfc 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractSeries.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractSeries.java @@ -15,6 +15,8 @@ /** * Abstract base class for series + * + * @since 6.0.1 */ public abstract class AbstractSeries extends AbstractConfigurationObject implements Series { @@ -214,6 +216,7 @@ public void setyAxis(Integer yAxis) { * @see #setColorAxis(Integer) * @return The index of the color-axis that this data series is bound to. * Returns null if undefined. + * @since 18.0 */ public Integer getColorAxis() { return colorAxis; @@ -227,6 +230,7 @@ public Integer getColorAxis() { * * @param colorAxis * The index of the color-axis to bind this data series to. + * @since 18.0 */ public void setColorAxis(Integer colorAxis) { this.colorAxis = colorAxis; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractSeriesItem.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractSeriesItem.java index f06bfe79731..d16523f1577 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractSeriesItem.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AbstractSeriesItem.java @@ -16,6 +16,7 @@ /** * Abstract superclass for chart series items * + * @since 6.0.1 */ public class AbstractSeriesItem extends AbstractConfigurationObject { @@ -132,6 +133,7 @@ public void setSliced(boolean sliced) { * * @see #setColor(Color) * @return The color of the item. + * @since 18.0 */ public Color getColor() { return color; @@ -143,6 +145,7 @@ public Color getColor() { * * @param color * Color of the item. + * @since 18.0 */ public void setColor(Color color) { this.color = color; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Accessibility.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Accessibility.java index 24c9971adf1..6b586638d83 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Accessibility.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Accessibility.java @@ -17,6 +17,8 @@ * "http://www.highcharts.com/docs/chart-concepts/accessibility">Highcharts * Accessibility. *

+ * + * @since 6.0.1 */ public class Accessibility extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AnnotationItem.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AnnotationItem.java index 7c8bec819b7..72c5b2708d8 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AnnotationItem.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AnnotationItem.java @@ -13,6 +13,8 @@ /** * Container for labels on the chart + * + * @since 24.0 */ public class AnnotationItem extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AnnotationItemLabel.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AnnotationItemLabel.java index a9a80c67f37..1af63af6636 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AnnotationItemLabel.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AnnotationItemLabel.java @@ -12,6 +12,8 @@ /** * Label that can be positioned anywhere in the chart area + * + * @since 24.0 */ public class AnnotationItemLabel extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AnnotationItemLabelPoint.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AnnotationItemLabelPoint.java index 1290f98d0c3..166fba651d4 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AnnotationItemLabelPoint.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AnnotationItemLabelPoint.java @@ -10,6 +10,8 @@ /** * Contains coordinates for {@link AnnotationItemLabel} + * + * @since 24.0 */ public class AnnotationItemLabelPoint extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AreaOptions.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AreaOptions.java index 52501266a04..a80226255ca 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AreaOptions.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AreaOptions.java @@ -12,6 +12,9 @@ import com.vaadin.flow.component.charts.model.style.Color; +/** + * @since 6.0.1 + */ public abstract class AreaOptions extends AbstractPlotOptions { public static final String LINECAP_ROUND = "round"; @@ -73,11 +76,14 @@ public abstract class AreaOptions extends AbstractPlotOptions { /** * @see #setClip(Boolean) + * @since 18.0 */ public abstract Boolean getClip(); /** * Disable this option to allow series rendering in the whole plotting area. + * + * @since 18.0 */ public abstract void setClip(Boolean clip); @@ -95,6 +101,7 @@ public abstract class AreaOptions extends AbstractPlotOptions { /** * @see #setColorKey(String) + * @since 18.0 */ public abstract String getColorKey(); @@ -103,6 +110,8 @@ public abstract class AreaOptions extends AbstractPlotOptions { * colorAxis is used. Requires to set min and * max if some custom point property is used or if * approximation for data grouping is set to 'sum'. + * + * @since 18.0 */ public abstract void setColorKey(String colorKey); @@ -118,6 +127,7 @@ public abstract class AreaOptions extends AbstractPlotOptions { /** * @see #setCrisp(Boolean) + * @since 18.0 */ public abstract Boolean getCrisp(); @@ -127,6 +137,8 @@ public abstract class AreaOptions extends AbstractPlotOptions { * densely packed columns, this leads to visible difference in column widths * or distance between columns. In these cases, setting crisp to false may * look better, even though each column is rendered blurry. + * + * @since 18.0 */ public abstract void setCrisp(Boolean crisp); @@ -172,6 +184,7 @@ public abstract class AreaOptions extends AbstractPlotOptions { /** * @see #setDashStyle(DashStyle) + * @since 18.0 */ public abstract DashStyle getDashStyle(); @@ -193,6 +206,8 @@ public abstract class AreaOptions extends AbstractPlotOptions { *
  • LongDashDot
    • *
  • LongDashDotDot
    • * + * + * @since 18.0 */ public abstract void setDashStyle(DashStyle dashStyle); @@ -224,17 +239,21 @@ public abstract class AreaOptions extends AbstractPlotOptions { /** * @see #setFillColor(Color) + * @since 18.0 */ public abstract Color getFillColor(); /** * Fill color or gradient for the area. When null, the series' * color is used with the series' fillOpacity. + * + * @since 18.0 */ public abstract void setFillColor(Color fillColor); /** * @see #setFillOpacity(Number) + * @since 18.0 */ public abstract Number getFillOpacity(); @@ -243,6 +262,8 @@ public abstract class AreaOptions extends AbstractPlotOptions { * fillColor, the fillOpacity is not applied. * Instead, you should define the opacity in the fillColor with * an rgba color definition. + * + * @since 18.0 */ public abstract void setFillOpacity(Number fillOpacity); @@ -309,6 +330,7 @@ public abstract class AreaOptions extends AbstractPlotOptions { /** * @see #setLineColor(Color) + * @since 18.0 */ public abstract Color getLineColor(); @@ -317,16 +339,21 @@ public abstract class AreaOptions extends AbstractPlotOptions { * color of the series, but the lineColor setting allows * setting a separate color for the line without altering the * fillColor. + * + * @since 18.0 */ public abstract void setLineColor(Color lineColor); /** * @see #setLineWidth(Number) + * @since 18.0 */ public abstract Number getLineWidth(); /** * Pixel with of the graph line. + * + * @since 18.0 */ public abstract void setLineWidth(Number lineWidth); @@ -355,32 +382,41 @@ public abstract class AreaOptions extends AbstractPlotOptions { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public abstract Color getNegativeColor(); /** * The color for the parts of the graph or points that are below the * threshold. + * + * @since 18.0 */ public abstract void setNegativeColor(Color negativeColor); /** * @see #setNegativeFillColor(Color) + * @since 18.0 */ public abstract Color getNegativeFillColor(); /** * A separate color for the negative part of the area. + * + * @since 18.0 */ public abstract void setNegativeFillColor(Color negativeFillColor); /** * @see #setOpacity(Number) + * @since 18.0 */ public abstract Number getOpacity(); /** * Opacity of a series parts: line, fill (e.g. area) and dataLabels. + * + * @since 18.0 */ public abstract void setOpacity(Number opacity); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Attributes.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Attributes.java index b78c42fb3f2..e6597acb1bc 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Attributes.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Attributes.java @@ -13,6 +13,8 @@ /** * A collection of style attributes for the {@link Halo} + * + * @since 18.0 */ public class Attributes extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Axis.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Axis.java index 736284fc6a9..6bfac974041 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Axis.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Axis.java @@ -15,6 +15,9 @@ import com.vaadin.flow.component.charts.model.style.Color; import com.vaadin.flow.component.charts.util.Util; +/** + * @since 6.0.1 + */ public abstract class Axis extends AbstractConfigurationObject { private static final long serialVersionUID = 1L; @@ -61,6 +64,7 @@ public void setMin(Number min) { * * @param min * @see #setMin(Number) + * @since 24.7 */ public void setMin(Instant min) { this.min = Util.toHighchartsTS(min); @@ -91,6 +95,7 @@ public void setMax(Number max) { * * @param max * @see #setMax(Number) + * @since 24.7 */ public void setMax(Instant max) { this.max = Util.toHighchartsTS(max); @@ -120,6 +125,7 @@ public void setExtremes(Number min, Number max) { * Maximum value as Instant. * * @see #setExtremes(Number, Number) + * @since 25.0 */ public void setExtremes(Instant min, Instant max) { this.setExtremes(min, max, true, true); @@ -160,6 +166,7 @@ public void setExtremes(Number min, Number max, boolean redraw) { * Whether or not to redraw the chart. * * @see #setExtremes(Number, Number, boolean) + * @since 25.0 */ public void setExtremes(Instant min, Instant max, boolean redraw) { this.setExtremes(min, max, redraw, true); @@ -210,6 +217,7 @@ public void setExtremes(Number minimum, Number maximum, boolean redraw, * Whether or not to animate the rescaling. * * @see #setExtremes(Number, Number, boolean, boolean) + * @since 25.0 */ public void setExtremes(Instant minimum, Instant maximum, boolean redraw, boolean animate) { @@ -276,6 +284,8 @@ public void setConfiguration(ChartConfiguration configuration) { /** * When using an alternate grid color, a band is painted across the plot * area between every other grid line. + * + * @since 18.0 */ public abstract void setAlternateGridColor(Color alternateGridColor); @@ -430,21 +440,27 @@ public abstract void setDateTimeLabelFormats( /** * @see #setLineColor(Color) + * @since 18.0 */ public abstract Color getLineColor(); /** * The color of the line marking the axis itself. + * + * @since 18.0 */ public abstract void setLineColor(Color lineColor); /** * @see #setLineWidth(Number) + * @since 18.0 */ public abstract Number getLineWidth(); /** * The width of the line marking the axis itself. + * + * @since 18.0 */ public abstract void setLineWidth(Number lineWidth); @@ -777,11 +793,14 @@ public abstract void setDateTimeLabelFormats( /** * @see #setTickColor(Color) + * @since 18.0 */ public abstract Color getTickColor(); /** * Color for the main tick marks. + * + * @since 18.0 */ public abstract void setTickColor(Color tickColor); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisDimension.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisDimension.java index 22bde2e8e78..cd90f6f5b63 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisDimension.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisDimension.java @@ -10,6 +10,8 @@ /** * Possible axis dimensions with their indexes in client-side + * + * @since 6.0.1 */ public enum AxisDimension { X_AXIS(0), Y_AXIS(1), Z_AXIS(2), COLOR_AXIS(3); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisGrid.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisGrid.java index 184fff73798..dae912b244b 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisGrid.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisGrid.java @@ -12,6 +12,9 @@ import com.vaadin.flow.component.charts.model.style.Color; +/** + * @since 24.7 + */ @SuppressWarnings("unused") public class AxisGrid extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisList.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisList.java index 470f61219e1..4cf23f1f66c 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisList.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisList.java @@ -13,6 +13,8 @@ /** * Alternative AxisContainer to allow multiple axes + * + * @since 6.0.1 */ public class AxisList extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisTitle.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisTitle.java index 97610a86bed..70114c2cac6 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisTitle.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisTitle.java @@ -12,6 +12,8 @@ /** * The axis title, showing next to the axis line. + * + * @since 6.0.1 */ public class AxisTitle extends AbstractConfigurationObject { @@ -114,6 +116,7 @@ public void setRotation(Number rotation) { /** * @see #setStyle(Style) + * @since 18.0 */ public Style getStyle() { if (style == null) { @@ -136,6 +139,8 @@ public Style getStyle() { *

    *

    * Defaults to: { "color": "#666666" } + * + * @since 18.0 */ public void setStyle(Style style) { this.style = style; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisType.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisType.java index f1404ff4af5..9e5629d81b4 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisType.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/AxisType.java @@ -18,6 +18,8 @@ * LINEAR. CATEGORY is a convenience mode for where the point names of the first * series are used for categories - avoiding the need to call * {@link Axis#setCategories(String...)}. + * + * @since 6.0.1 */ public enum AxisType implements ChartEnum { LINEAR("linear"), diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Back.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Back.java index 893fec16791..fc92bb2676b 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Back.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Back.java @@ -12,6 +12,8 @@ /** * Defines the back panel of the frame around 3D charts. + * + * @since 6.0.1 */ public class Back extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Background.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Background.java index eec0db0b015..4ec76b9023a 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Background.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Background.java @@ -17,6 +17,8 @@ *

    * These configuration options apply only to polar and angular gauges trough * the Pane-configuration object. + * + * @since 6.0.1 */ public class Background extends AbstractConfigurationObject { private Color backgroundColor; @@ -30,6 +32,7 @@ public class Background extends AbstractConfigurationObject { /** * @see #setBackgroundColor(Color) + * @since 18.0 */ public Color getBackgroundColor() { return backgroundColor; @@ -39,6 +42,7 @@ public Color getBackgroundColor() { * Sets the background color * * @param backgroundColor + * @since 18.0 */ public void setBackgroundColor(Color backgroundColor) { this.backgroundColor = backgroundColor; @@ -46,6 +50,7 @@ public void setBackgroundColor(Color backgroundColor) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -55,6 +60,7 @@ public Color getBorderColor() { * Sets the border color * * @param borderColor + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -65,6 +71,7 @@ public void setBorderColor(Color borderColor) { * * @see #setBorderRadius(String) * @return The border radius of the background. + * @since 25.0 */ public String getBorderRadius() { return borderRadius; @@ -76,6 +83,7 @@ public String getBorderRadius() { * string. * * @param borderRadius + * @since 25.0 */ public void setBorderRadius(String borderRadius) { this.borderRadius = borderRadius; @@ -83,6 +91,7 @@ public void setBorderRadius(String borderRadius) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -92,6 +101,7 @@ public Number getBorderWidth() { * Sets the width of the border * * @param borderWidth + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; @@ -102,6 +112,7 @@ public void setBorderWidth(Number borderWidth) { * * @see #setClassName(String) * @return The class name of the background + * @since 18.0 */ public String getClassName() { return className; @@ -112,6 +123,7 @@ public String getClassName() { * * @param className * new class name of the background + * @since 18.0 */ public void setClassName(String className) { this.className = className; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/BackgroundShape.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/BackgroundShape.java index 82bd3c9d0d7..430e91628f1 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/BackgroundShape.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/BackgroundShape.java @@ -14,6 +14,8 @@ * axis. * * Defaults to solid. + * + * @since 6.0.1 */ public enum BackgroundShape implements ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Bottom.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Bottom.java index 62b4bb08ffd..2e4daf1dfb7 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Bottom.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Bottom.java @@ -12,6 +12,8 @@ /** * The bottom of the frame around a 3D chart. + * + * @since 6.0.1 */ public class Bottom extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/BoxPlotItem.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/BoxPlotItem.java index ccaf9589a49..bc054eea7fe 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/BoxPlotItem.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/BoxPlotItem.java @@ -15,6 +15,7 @@ * * @see PlotOptionsBoxplot * + * @since 6.0.1 */ public class BoxPlotItem extends DataSeriesItem { // high/low already defined in DataSeriesItem diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Breadcrumbs.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Breadcrumbs.java index 377a002d943..90a3445bf67 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Breadcrumbs.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Breadcrumbs.java @@ -14,6 +14,8 @@ /** * Options for the breadcrumbs, the navigation at the top leading the way up * through the drilldown levels. + * + * @since 25.0 */ public class Breadcrumbs extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/BreadcrumbsPosition.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/BreadcrumbsPosition.java index f3c0209d022..14bb16dc16c 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/BreadcrumbsPosition.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/BreadcrumbsPosition.java @@ -10,6 +10,8 @@ /** * Positioning options for Breadcrumbs navigation. + * + * @since 25.0 */ public class BreadcrumbsPosition extends AbstractConfigurationObject { private String align; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Breaks.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Breaks.java index e91b6bbc0a1..6d39e7e2521 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Breaks.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Breaks.java @@ -15,6 +15,8 @@ /** * An array defining breaks in the axis, the sections defined will be left out * and all the points shifted closer to each other. + * + * @since 6.0.1 */ public class Breaks extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ButtonOptions.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ButtonOptions.java index 7b8a47f3d56..ed5aff60b85 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ButtonOptions.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ButtonOptions.java @@ -22,6 +22,8 @@ * .highcharts-contextbutton and * .highcharts-button-symbol class. *

    + * + * @since 6.0.1 */ public class ButtonOptions extends AbstractConfigurationObject { @@ -96,6 +98,7 @@ public void setHeight(Number height) { /** * @see #setSymbolFill(Color) + * @since 18.0 */ public Color getSymbolFill() { return symbolFill; @@ -105,6 +108,8 @@ public Color getSymbolFill() { * Fill color for the symbol within the button. *

    * Defaults to: #666666 + * + * @since 18.0 */ public void setSymbolFill(Color symbolFill) { this.symbolFill = symbolFill; @@ -128,6 +133,7 @@ public void setSymbolSize(Number symbolSize) { /** * @see #setSymbolStroke(Color) + * @since 18.0 */ public Color getSymbolStroke() { return symbolStroke; @@ -137,6 +143,8 @@ public Color getSymbolStroke() { * The color of the symbol's stroke or line. *

    * Defaults to: #666666 + * + * @since 18.0 */ public void setSymbolStroke(Color symbolStroke) { this.symbolStroke = symbolStroke; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ButtonPosition.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ButtonPosition.java index cebf1daba3f..e78b59e3718 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ButtonPosition.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ButtonPosition.java @@ -10,6 +10,8 @@ /** * Positioning options for buttons + * + * @since 6.0.1 */ public class ButtonPosition extends AbstractConfigurationObject { private VerticalAlign verticalAlign; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ButtonRelativeTo.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ButtonRelativeTo.java index 3591f49d776..11ea82f80c6 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ButtonRelativeTo.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ButtonRelativeTo.java @@ -10,6 +10,8 @@ /** * What box to align the button to. + * + * @since 25.0 */ public enum ButtonRelativeTo implements ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Buttons.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Buttons.java index 04f27edbde9..b3459fdd73b 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Buttons.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Buttons.java @@ -13,6 +13,8 @@ * default buttons listed here, custom buttons can be added. See * navigation.buttonOptions for general * options. + * + * @since 6.0.1 */ public class Buttons extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartConfiguration.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartConfiguration.java index a94ea41004f..5e914f7b8d3 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartConfiguration.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartConfiguration.java @@ -10,6 +10,9 @@ import java.io.Serializable; +/** + * @since 6.0.1 + */ public interface ChartConfiguration extends Serializable { void fireAxesRescaled(Axis axis, Number minimum, Number maximum, diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartConnectors.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartConnectors.java index 9ddf4e0c40d..348bf74e6df 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartConnectors.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartConnectors.java @@ -11,6 +11,8 @@ /** * A configuration object to configure style of connectors (dependencies) * between two points in a Gantt chart. + * + * @since 24.7 */ @SuppressWarnings("unused") public class ChartConnectors extends ConnectorStyle { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartEnum.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartEnum.java index f1c5f737c9b..f27707bb663 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartEnum.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartEnum.java @@ -13,6 +13,8 @@ /** * Interface shared by all enum classes of the vaadin charts. It is used when * serializing enums to JSON. + * + * @since 6.0.1 */ public interface ChartEnum extends Serializable { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartModel.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartModel.java index f7585a5a9a2..89d4065fee9 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartModel.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartModel.java @@ -14,6 +14,8 @@ /** * Options regarding the chart area and plot area as well as general chart * options. + * + * @since 6.0.1 */ public class ChartModel extends AbstractConfigurationObject { @@ -133,6 +135,7 @@ public void setAnimation(Boolean animation) { /** * @see #setBackgroundColor(Color) + * @since 18.0 */ public Color getBackgroundColor() { return backgroundColor; @@ -142,6 +145,8 @@ public Color getBackgroundColor() { * The background color or gradient for the outer chart area. *

    * Defaults to: #FFFFFF + * + * @since 18.0 */ public void setBackgroundColor(Color backgroundColor) { this.backgroundColor = backgroundColor; @@ -149,6 +154,7 @@ public void setBackgroundColor(Color backgroundColor) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -158,6 +164,8 @@ public Color getBorderColor() { * The color of the outer chart border. *

    * Defaults to: #335cad + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -181,6 +189,7 @@ public void setBorderRadius(Number borderRadius) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -190,6 +199,8 @@ public Number getBorderWidth() { * The pixel width of the outer chart border. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; @@ -494,6 +505,7 @@ public void setPinchType(Dimension pinchType) { /** * @see #setPlotBackgroundColor(Color) + * @since 18.0 */ public Color getPlotBackgroundColor() { return plotBackgroundColor; @@ -501,6 +513,8 @@ public Color getPlotBackgroundColor() { /** * The background color or gradient for the plot area. + * + * @since 18.0 */ public void setPlotBackgroundColor(Color plotBackgroundColor) { this.plotBackgroundColor = plotBackgroundColor; @@ -508,6 +522,7 @@ public void setPlotBackgroundColor(Color plotBackgroundColor) { /** * @see #setPlotBackgroundImage(String) + * @since 18.0 */ public String getPlotBackgroundImage() { return plotBackgroundImage; @@ -518,6 +533,8 @@ public String getPlotBackgroundImage() { * the background for the entire chart, set a CSS background image to the * container element. Note that for the image to be applied to exported * charts, its URL needs to be accessible by the export server. + * + * @since 18.0 */ public void setPlotBackgroundImage(String plotBackgroundImage) { this.plotBackgroundImage = plotBackgroundImage; @@ -525,6 +542,7 @@ public void setPlotBackgroundImage(String plotBackgroundImage) { /** * @see #setPlotBorderColor(Color) + * @since 18.0 */ public Color getPlotBorderColor() { return plotBorderColor; @@ -534,6 +552,8 @@ public Color getPlotBorderColor() { * The color of the inner chart or plot area border. *

    * Defaults to: #cccccc + * + * @since 18.0 */ public void setPlotBorderColor(Color plotBorderColor) { this.plotBorderColor = plotBorderColor; @@ -541,6 +561,7 @@ public void setPlotBorderColor(Color plotBorderColor) { /** * @see #setPlotBorderWidth(Number) + * @since 18.0 */ public Number getPlotBorderWidth() { return plotBorderWidth; @@ -550,6 +571,8 @@ public Number getPlotBorderWidth() { * The pixel width of the plot area border. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setPlotBorderWidth(Number plotBorderWidth) { this.plotBorderWidth = plotBorderWidth; @@ -557,6 +580,7 @@ public void setPlotBorderWidth(Number plotBorderWidth) { /** * @see #setPlotShadow(Boolean) + * @since 18.0 */ public Boolean getPlotShadow() { return plotShadow; @@ -569,6 +593,8 @@ public Boolean getPlotShadow() { * , opacity and width. *

    * Defaults to: false + * + * @since 18.0 */ public void setPlotShadow(Boolean plotShadow) { this.plotShadow = plotShadow; @@ -629,6 +655,7 @@ public void setResetZoomButton(ResetZoomButton resetZoomButton) { /** * @see #setSelectionMarkerFill(Color) + * @since 18.0 */ public Color getSelectionMarkerFill() { return selectionMarkerFill; @@ -639,6 +666,8 @@ public Color getSelectionMarkerFill() { * an area of the chart. *

    * Defaults to: rgba(51,92,173,0.25) + * + * @since 18.0 */ public void setSelectionMarkerFill(Color selectionMarkerFill) { this.selectionMarkerFill = selectionMarkerFill; @@ -646,6 +675,7 @@ public void setSelectionMarkerFill(Color selectionMarkerFill) { /** * @see #setShadow(Boolean) + * @since 18.0 */ public Boolean getShadow() { return shadow; @@ -658,6 +688,8 @@ public Boolean getShadow() { * , opacity and width. *

    * Defaults to: false + * + * @since 18.0 */ public void setShadow(Boolean shadow) { this.shadow = shadow; @@ -779,6 +811,7 @@ public void setSpacingTop(Number spacingTop) { /** * @see #setStyle(Style) + * @since 18.0 */ public Style getStyle() { if (style == null) { @@ -794,6 +827,8 @@ public Style getStyle() { *

    * Defaults to: {"fontFamily": "\"Lucida Grande\", \"Lucida Sans Unicode\", * Verdana, Arial, Helvetica, sans-serif" ,"fontSize":"12px"} + * + * @since 18.0 */ public void setStyle(Style style) { this.style = style; @@ -885,6 +920,7 @@ public void setZoomType(Dimension zoomType) { /** * @see #setZooming(Zooming) + * @since 25.0 */ public Zooming getZooming() { if (zooming == null) { @@ -899,6 +935,7 @@ public Zooming getZooming() { * support. * * @param zooming + * @since 25.0 */ public void setZooming(Zooming zooming) { this.zooming = zooming; @@ -936,6 +973,8 @@ public Boolean getStyledMode() { * attributes or CSS are applied to the chart SVG. Instead, CSS rules are * required to style the chart. The default style sheet is available from * https://code.highcharts.com/css/highcharts.css. + * + * @since 18.0 */ public void setStyledMode(Boolean styledMode) { this.styledMode = styledMode; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartType.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartType.java index 9e088f5cdd2..703ff757100 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartType.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ChartType.java @@ -20,6 +20,8 @@ * Configuration specific to each ChartType can be set using * {@link Configuration#setPlotOptions(AbstractPlotOptions...)} or for a single * series using {@link AbstractSeries#setPlotOptions(AbstractPlotOptions)} + * + * @since 6.0.1 */ public class ChartType implements ChartEnum { @@ -41,6 +43,7 @@ public class ChartType implements ChartEnum { public static final ChartType AREASPLINE = new ChartType("areaspline"); /** * @see PlotOptionsBullet + * @since 18.0 */ public static final ChartType BULLET = new ChartType("bullet"); /** @@ -129,6 +132,7 @@ public class ChartType implements ChartEnum { /** * @see PlotOptionsTimeline + * @since 18.0 */ public static final ChartType TIMELINE = new ChartType("timeline"); @@ -139,16 +143,19 @@ public class ChartType implements ChartEnum { /** * @see PlotOptionsOrganization + * @since 18.0 */ public static final ChartType ORGANIZATION = new ChartType("organization"); /** * @see PlotOptionsSankey + * @since 24.3 */ public static final ChartType SANKEY = new ChartType("sankey"); /** * @see PlotOptionsXrange + * @since 18.0 */ public static final ChartType XRANGE = new ChartType("xrange"); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ColorAxis.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ColorAxis.java index db812190cb1..9fd0a51b281 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ColorAxis.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ColorAxis.java @@ -10,6 +10,9 @@ import com.vaadin.flow.component.charts.model.style.Color; +/** + * @since 6.0.1 + */ public class ColorAxis extends YAxis { private static final long serialVersionUID = 1L; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ColumnOptions.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ColumnOptions.java index cac1dd0f181..de4461dfa63 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ColumnOptions.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ColumnOptions.java @@ -12,6 +12,9 @@ import com.vaadin.flow.component.charts.model.style.Color; +/** + * @since 6.0.1 + */ public abstract class ColumnOptions extends AbstractPlotOptions { /** @@ -44,11 +47,14 @@ public abstract class ColumnOptions extends AbstractPlotOptions { /** * @see #setBorderColor(Color) + * @since 18.0 */ public abstract Color getBorderColor(); /** * The color of the border of each waterfall column. + * + * @since 18.0 */ public abstract void setBorderColor(Color borderColor); @@ -64,21 +70,27 @@ public abstract class ColumnOptions extends AbstractPlotOptions { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public abstract Number getBorderWidth(); /** * The width of the border surrounding each column or bar. + * + * @since 18.0 */ public abstract void setBorderWidth(Number borderWidth); /** * @see #setClip(Boolean) + * @since 18.0 */ public abstract Boolean getClip(); /** * Disable this option to allow series rendering in the whole plotting area. + * + * @since 18.0 */ public abstract void setClip(Boolean clip); @@ -96,6 +108,7 @@ public abstract class ColumnOptions extends AbstractPlotOptions { /** * @see #setColorKey(String) + * @since 18.0 */ public abstract String getColorKey(); @@ -104,17 +117,22 @@ public abstract class ColumnOptions extends AbstractPlotOptions { * colorAxis is used. Requires to set min and max * if some custom point property is used or if approximation for data * grouping is set to 'sum''. + * + * @since 18.0 */ public abstract void setColorKey(String colorKey); /** * @see #setColors(Color...) + * @since 18.0 */ public abstract Color[] getColors(); /** * A series specific or series type specific color set to apply instead of * the theme colors when {@link #setColorByPoint(Boolean)} is true. + * + * @since 18.0 */ public abstract void setColors(Color... colors); @@ -124,6 +142,7 @@ public abstract class ColumnOptions extends AbstractPlotOptions { * @param color * to add * @see #setColors(Color...) + * @since 18.0 */ public abstract void addColor(Color color); @@ -133,11 +152,13 @@ public abstract class ColumnOptions extends AbstractPlotOptions { * @param color * to remove * @see #setColors(Color...) + * @since 18.0 */ public abstract void removeColor(Color color); /** * @see #setCrisp(Boolean) + * @since 18.0 */ public abstract Boolean getCrisp(); @@ -147,6 +168,8 @@ public abstract class ColumnOptions extends AbstractPlotOptions { * densely packed columns, this leads to visible difference in column widths * or distance between columns. In these cases, setting crisp to false may * look better, even though each column is rendered blurry. + * + * @since 18.0 */ public abstract void setCrisp(Boolean crisp); @@ -174,11 +197,14 @@ public abstract class ColumnOptions extends AbstractPlotOptions { /** * @see #setEdgeColor(Color) + * @since 18.0 */ public abstract Color getEdgeColor(); /** * 3D columns only. The color of the edges. + * + * @since 18.0 */ public abstract void setEdgeColor(Color edgeColor); @@ -293,11 +319,14 @@ public abstract class ColumnOptions extends AbstractPlotOptions { /** * @see #setOpacity(Number) + * @since 18.0 */ public abstract Number getOpacity(); /** * Opacity of a series parts: line, fill (e.g. area) and dataLabels. + * + * @since 18.0 */ public abstract void setOpacity(Number opacity); @@ -566,6 +595,7 @@ public abstract class ColumnOptions extends AbstractPlotOptions { /** * @see #setPointStart(Number) + * @since 24.9 */ public abstract void setPointStart(Instant instant); } diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Compare.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Compare.java index 478025ea9fc..140e195ff91 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Compare.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Compare.java @@ -11,6 +11,8 @@ /** * The {@link YAxis} will show percentage or absolute change depending on * whether compare is set to {@link Compare#PERCENT} or {@link Compare#VALUE} + * + * @since 6.0.1 */ public enum Compare implements ChartEnum { PERCENT("percent"), VALUE("value"); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Completed.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Completed.java index ed661d6653b..96003710146 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Completed.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Completed.java @@ -12,6 +12,8 @@ /** * Progress indicator, how much of the task completed + * + * @since 24.7 */ @SuppressWarnings("unused") public class Completed extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Condition.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Condition.java index f3c18a7b939..b87d22f030f 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Condition.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Condition.java @@ -10,6 +10,8 @@ /** * Under which conditions the rule applies. + * + * @since 6.0.1 */ public class Condition extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Configuration.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Configuration.java index 51c887f65e0..58fbaa7ed0b 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Configuration.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Configuration.java @@ -32,6 +32,8 @@ /** * Chart's configuration root object containing all the child objects that are * used to configure chart, axes, legend, titles etc. + * + * @since 6.0.1 */ public class Configuration extends AbstractConfigurationObject implements ChartConfiguration { @@ -68,6 +70,7 @@ public class Configuration extends AbstractConfigurationObject /** * @see #setAccessibility(Accessibility) + * @since 7.0 */ public Accessibility getAccessibility() { if (accessibility == null) { @@ -80,6 +83,7 @@ public Accessibility getAccessibility() { * Sets options for configuring accessibility for the chart. * * @param accessibility + * @since 7.0 */ public void setAccessibility(Accessibility accessibility) { this.accessibility = accessibility; @@ -809,6 +813,7 @@ public void setNavigator(Navigator navigator) { /** * @see #setTime(Time) + * @since 18.0 */ public Time getTime() { if (time == null) { @@ -821,6 +826,7 @@ public Time getTime() { * Set configuration for time options * * @param time + * @since 18.0 */ public void setTime(Time time) { this.time = time; @@ -1161,6 +1167,7 @@ public List getLabels() { * * @param labels * The labels to set + * @since 24.0 */ public void setLabels(AnnotationItemLabel... labels) { getLabelsAnnotation().setLabels(labels); @@ -1172,6 +1179,7 @@ public void setLabels(AnnotationItemLabel... labels) { * @param label * The label to add * @see #setLabels(AnnotationItemLabel...) + * @since 24.0 */ public void addLabel(AnnotationItemLabel label) { getLabels().add(label); @@ -1186,6 +1194,7 @@ private AnnotationItem getLabelsAnnotation() { /** * @see #setConnectors(ChartConnectors) + * @since 24.7 */ public ChartConnectors getConnectors() { return connectors; @@ -1203,6 +1212,7 @@ public ChartConnectors getConnectors() { * dependency (see {@link GanttSeriesItemDependency}). * * @param connectors + * @since 24.7 */ public void setConnectors(ChartConnectors connectors) { this.connectors = connectors; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ConnectorStyle.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ConnectorStyle.java index 6ad6c243fbf..9fb182b51b5 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ConnectorStyle.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ConnectorStyle.java @@ -13,6 +13,8 @@ /** * A configuration object to configure style of connectors (dependencies) * between two points in a Gantt chart. + * + * @since 24.7 */ @SuppressWarnings("unused") public class ConnectorStyle extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ContextButton.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ContextButton.java index db926691504..ca678033d56 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ContextButton.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ContextButton.java @@ -13,6 +13,8 @@ /** * Options for the export button. + * + * @since 6.0.1 */ public class ContextButton extends AbstractConfigurationObject { @@ -62,6 +64,7 @@ public ContextButton(Boolean enabled) { * Gets the spacing between the context button and other exporting buttons. * * @return the button spacing + * @since 25.0 */ public Number getButtonSpacing() { return buttonSpacing; @@ -72,6 +75,7 @@ public Number getButtonSpacing() { * * @param buttonSpacing * the spacing value + * @since 25.0 */ public void setButtonSpacing(Number buttonSpacing) { this.buttonSpacing = buttonSpacing; @@ -154,6 +158,7 @@ public void setSymbol(String symbol) { /** * @see #setSymbolFill(Color) + * @since 18.0 */ public Color getSymbolFill() { return symbolFill; @@ -165,6 +170,8 @@ public Color getSymbolFill() { * symbolFill. *

    * Defaults to: #666666 + * + * @since 18.0 */ public void setSymbolFill(Color symbolFill) { this.symbolFill = symbolFill; @@ -172,6 +179,7 @@ public void setSymbolFill(Color symbolFill) { /** * @see #setSymbolSize(Number) + * @since 18.0 */ public Number getSymbolSize() { return symbolSize; @@ -181,6 +189,8 @@ public Number getSymbolSize() { * The pixel size of the symbol on the button. *

    * Defaults to: 14 + * + * @since 18.0 */ public void setSymbolSize(Number symbolSize) { this.symbolSize = symbolSize; @@ -188,6 +198,7 @@ public void setSymbolSize(Number symbolSize) { /** * @see #setSymbolStroke(Color) + * @since 18.0 */ public Color getSymbolStroke() { return symbolStroke; @@ -197,6 +208,8 @@ public Color getSymbolStroke() { * The color of the symbol's stroke or line. *

    * Defaults to: #666666 + * + * @since 18.0 */ public void setSymbolStroke(Color symbolStroke) { this.symbolStroke = symbolStroke; @@ -204,6 +217,7 @@ public void setSymbolStroke(Color symbolStroke) { /** * @see #setSymbolStrokeWidth(Number) + * @since 18.0 */ public Number getSymbolStrokeWidth() { return symbolStrokeWidth; @@ -213,6 +227,8 @@ public Number getSymbolStrokeWidth() { * The pixel stroke width of the symbol on the button. *

    * Defaults to: 1 + * + * @since 18.0 */ public void setSymbolStrokeWidth(Number symbolStrokeWidth) { this.symbolStrokeWidth = symbolStrokeWidth; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ContextButtonMenuItem.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ContextButtonMenuItem.java index 41c943ef278..8baab499c62 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ContextButtonMenuItem.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ContextButtonMenuItem.java @@ -8,6 +8,9 @@ */ package com.vaadin.flow.component.charts.model; +/** + * @since 6.0.1 + */ public class ContextButtonMenuItem extends AbstractConfigurationObject { private String text; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Credits.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Credits.java index f7b0130de41..330a84c0e94 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Credits.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Credits.java @@ -15,6 +15,8 @@ /** * Highchart by default puts a credits label in the lower right corner of the * chart. This can be changed using these options. + * + * @since 6.0.1 */ public class Credits extends AbstractConfigurationObject { @@ -80,6 +82,7 @@ public void setHref(String href) { * * @param href * the URL for the credits label + * @since 25.2 */ public void setUnsafeHref(String href) { this.href = href; @@ -104,6 +107,7 @@ public void setPosition(Position position) { /** * @see #setStyle(Style) + * @since 18.0 */ public Style getStyle() { if (style == null) { @@ -117,6 +121,8 @@ public Style getStyle() { *

    * Defaults to: { "cursor": "pointer", "color": "#999999", "fontSize": * "10px" } + * + * @since 18.0 */ public void setStyle(Style style) { this.style = style; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Crosshair.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Crosshair.java index b45bfef4478..ebca20508e5 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Crosshair.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Crosshair.java @@ -24,6 +24,8 @@ * .highcharts-crosshair, .highcharts-crosshair-thin * or .highcharts-xaxis-category classes. *

    + * + * @since 6.0.1 */ public class Crosshair extends AbstractConfigurationObject { @@ -54,6 +56,7 @@ public void setClassName(String className) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -63,6 +66,8 @@ public Color getColor() { * The color of the crosshair. Defaults to #cccccc for numeric * and datetime axes, and rgba(204,214,235,0.25) for category * axes, where the crosshair by default highlights the whole category. + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -70,6 +75,7 @@ public void setColor(Color color) { /** * @see #setDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getDashStyle() { return dashStyle; @@ -81,6 +87,8 @@ public DashStyle getDashStyle() { * values. *

    * Defaults to: Solid + * + * @since 18.0 */ public void setDashStyle(DashStyle dashStyle) { this.dashStyle = dashStyle; @@ -105,6 +113,7 @@ public void setSnap(Boolean snap) { /** * @see #setWidth(Number) + * @since 18.0 */ public Number getWidth() { return width; @@ -113,6 +122,8 @@ public Number getWidth() { /** * The pixel width of the crosshair. Defaults to 1 for numeric or datetime * axes, and for one category width for category axes. + * + * @since 18.0 */ public void setWidth(Number width) { this.width = width; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/CrosshairLabel.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/CrosshairLabel.java index 8514551b654..2a7dca49a9a 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/CrosshairLabel.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/CrosshairLabel.java @@ -21,6 +21,8 @@ * >styled mode, the label is styled with the * .highcharts-crosshair-label class. *

    + * + * @since 6.0.1 */ public class CrosshairLabel extends AbstractConfigurationObject { @@ -56,6 +58,7 @@ public void setAlign(HorizontalAlign align) { /** * @see #setBackgroundColor(Color) + * @since 18.0 */ public Color getBackgroundColor() { return backgroundColor; @@ -64,6 +67,8 @@ public Color getBackgroundColor() { /** * The background color for the label. Defaults to the related series color, * or #666666 if that is not available. + * + * @since 18.0 */ public void setBackgroundColor(Color backgroundColor) { this.backgroundColor = backgroundColor; @@ -71,6 +76,7 @@ public void setBackgroundColor(Color backgroundColor) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -78,6 +84,8 @@ public Color getBorderColor() { /** * The border color for the crosshair label + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -101,6 +109,7 @@ public void setBorderRadius(Number borderRadius) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -110,6 +119,8 @@ public Number getBorderWidth() { * The border width for the crosshair label. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Cursor.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Cursor.java index b527ab0ccce..5a0638b5c49 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Cursor.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Cursor.java @@ -12,6 +12,8 @@ * You can set the cursor to POINTER("pointer") if you have click events * attached to the series, to signal to the user that the points and lines can * be clicked. Defaults to NONE. + * + * @since 6.0.1 */ public enum Cursor implements ChartEnum { POINTER("pointer"), NONE(""); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DashStyle.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DashStyle.java index 5fa4c348502..3e0887de49c 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DashStyle.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DashStyle.java @@ -16,6 +16,7 @@ * "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAALEAAAFICAMAAAAoHe+SAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAABhQTFRFDg4Ozs7Oqqqq9/f3dnZ2PT097Ozs////ffKyTQAAB9lJREFUeNrsnYuSoyAQRYGG5v//eOkGjHE0ax68qm6qMoliZk8QHXP2kja02s3E1W4gBjGIQfwWMT3WkeOTp5MRuxCCq+vY2Oh9eermJLbGW2/3xM7NTexLV1vvXSa2iZ/T0rx9HGx+8MYrcQiRQvBhVuLEmkgFMzrDhdgbSutnJY4knSvU1thCLPw8L3HqYEMLEafjjHQcMCXwQuwSu5/3XBHk2ON0VpaHeuSlwW3srEees7Wz898/kr+Blvd/Cqci5vRphOVWHsrteWmSm8l/2Va6rUkceaEbruhBDGIQgxjEIAYxiEHcgVg/1731wdnakcTZbfpwwSafsf3Ry15t3cm7qds8YxDJ6Yx33hxFwFDi4jZ9YK9d6bwngbXeGePZGZYPgyFSarCivKRdt6Zhfaxu05sQElcUqRk4pudKbJVYzKEV25lYjbwx3doPMyzqNsVZpe52sv/TchDQ4jtj/WmzMIrb1qPOFeo2ZWQmBsUoqnBHLHY29b3ocCM6TrcO485uqUf/Q6wq0UkfRzWIQ4mtJXWbmdgaR6K6CzGp5bRehwPJkLEU6x4Jw84V6jYzgxCGquzluU2jwIj0jHIcJmo5PfPgUZHdpgpNvVuui5FTj4o1zPIobWZTs27NMcZRZ7fsNqvNkuXyqIJT4Op6Unbatfd+3JtCXuNxTeIhe/erUYErehCDGMQgBjGIQQxiEM/mNscSf+I2hxK/6za9G018121qlFMdxrgef89tsrbMQHzTbZLsC5Wbfvy54pbb1AXJSs5AfM9tZmI3AfFdt5meUHGcw88V/3Wb27Fp8sli+JG3uU26cJuFMO2NvHJwH4uvzJao3HfL9W1ctfe+V1PIq9xXJR62hz8eFbiiBzGIQQxiEIMYxCAGcVviD3KbbiTxF7lNnTjpbWfib3KbLI37edXOdSC+cJv2Tm4zT/eVcGTU1aLwbIc+/jy3mYmdmiKJlvUh/ia3mYnTamlXjRi6nCs+z23WPmYfdi+bxW2e5TYz8fayTn38TW4zEUuj05c5fRn1OFfcc5tnuU0NoQVXfovfDuNJ3CZLaHOX28z3EupMrVxf0d5t1txmScPR4/nDbZb1T7nNfXpul+88rP/l82MKkud/viZxsz3YbFTgih7EIAYxiEEMYhCDGMRwmy3dZsOkZyO32TDp+f2c9FO3aeUV1CTp2chtqutqk/T8ndt0e7epv0L1oSY9f5lCbOQ2Xenj/Dt+mvRs5DYz8Zb0/D3xz93mU9LT/TTp2chtNkx63nab9J7b5L8rG7rN/Zz08ja2OelnbvNhmohOfGf2okQn23+yfGYKeeblVYm/2ku9l3FFD2IQgxjEIAYxiEEMYhAficnnqhULEaeP789+0k9P7NUKsWpNjjYYbxcgtqr+Ul/zKsRcrFoxVGsQOxHXxcAtQOwNr0TMnMthecrDmScnDtVPuuonjZuaWFVgfrapSJ6aeMNd4HGb4b3M46LE640KXB+DGMQgBjGIQQxiEIO4OzE7mpb43G1aY+clPrrNQswTE1e36TRmGTWfKXOgvZ2ZOKcVpaudEXBr0lAxNDEx51pGojZLRNNPOJYPblOi06Lf0g/WcTw3cerZ1K2sEUtngtJOTJzdpmSMZSywKNmpiavbtFI0SL4mIWh0dN5R8XCbkrmU2KWqzXqfkLhWm37g7/TsU9v4peeq47zC0prE0+35/44KXNGDGMQgBjGIQQxiEIN4LuJhdYfqZ+kX//5UVdKfDcvFbaoq6Udiq2aTHWen6bxzLh5npMeRVdIPxDJz3FSnyTr13IRt7vMUVdIPxCHEzWMZS2U+b51fLj+HV0n/6zaFSbA4PzyIRdC644z00cT604ngVGJ9A0p8mJFOA6ukP7lNphDkHgtxgnRlHO9mpLv9jPSBfSxuM4Hl/3GqxDZ/k8PZjHQ7uo9jmbEddbK5fidLmVIu+vswIz1vtNVUH0NcXRHnyeZU/0iks5nd2jaTlDc6t03t1z6bwnNLN9faRYk77tMfjQpc0YMYxCAGMYhBDGIQg7g78bq5TW10kxG/zG0GbXw4NutnIL7IbarMDDkMZ8tqie+5OYivcpuqBknTcKoDggmTEF/lNrPMNJ42ETfLqLjKbdY+1iNRv0GUJyG+ym2W74S0D2KagfhFbjMEZnkH6YxCMnLc0GTkndymNuqhmb9ok4MZfuRd5DaLvqRNHuYv2oxx5IT189xmPFm790p0upa7rD1PQfLEaxcl7rhPfzQqcEUPYhCDGMQgBjGIQQziuYiXzW1S5yrp3+c2e1dJ/z63uask5HpUSf8+t9m7Svp1bpP/5jbvVxLqRvxJbnOr6/5UzqcX8WVus9QFOstt9q6S/m5uM/7Jbf6tJNRa1e5zm+6D3GbvKum3cpu0z23GfW4zF9vpWiX9Rm5zq35eWunomR4hTnphoV47qndaX6cgtTbdZevr9GKj1v8QxxFMd4gb7LvGowJX9CAGMYhBDGIQgxjEIIbbbOc2G1ZJb+Q2G1ZJb+Q2H1XS6ddV0hu5zVolnX9fJb2R22xYJb2R26zEDaqkfz8n/f9V0psRfzgn/dRtNqyS3shtNqyS/sptxr3b5Fduk/+4zXZV0v/vNgPXCu9aTV0FZp2TXt4sHVzn04z1+rvoTX91vdU9t3nP6/XZ6p7bnI74i33Ufytc0YMYxCNu/wQYAKgBouLeSYjpAAAAAElFTkSuQmCC" * /> * + * @since 18.0 */ public enum DashStyle implements ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataGrouping.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataGrouping.java index b5f26634a68..2fed741fc08 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataGrouping.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataGrouping.java @@ -24,6 +24,8 @@ * If data grouping is applied, the grouping information of grouped points can * be read from the Point.dataGroup. *

    + * + * @since 6.0.1 */ public class DataGrouping extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataLabels.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataLabels.java index 11c712712a5..804f735a155 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataLabels.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataLabels.java @@ -25,6 +25,8 @@ * "http://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/css/series-datalabels" * >see example). *

    + * + * @since 6.0.1 */ public class DataLabels extends AbstractDataLabels { @@ -105,6 +107,7 @@ public void setAllowOverlap(Boolean allowOverlap) { /** * @see #setBackgroundColor(Color) + * @since 18.0 */ public Color getBackgroundColor() { return backgroundColor; @@ -113,6 +116,8 @@ public Color getBackgroundColor() { /** * The background color or gradient for the data label. Defaults to * undefined. + * + * @since 18.0 */ public void setBackgroundColor(Color backgroundColor) { this.backgroundColor = backgroundColor; @@ -120,6 +125,7 @@ public void setBackgroundColor(Color backgroundColor) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -127,6 +133,8 @@ public Color getBorderColor() { /** * The border color for the data label. Defaults to undefined. + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -134,6 +142,7 @@ public void setBorderColor(Color borderColor) { /** * @see #setBorderRadius(Number) + * @since 18.0 */ public Number getBorderRadius() { return borderRadius; @@ -143,6 +152,8 @@ public Number getBorderRadius() { * The border radius in pixels for the data label. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setBorderRadius(Number borderRadius) { this.borderRadius = borderRadius; @@ -150,6 +161,7 @@ public void setBorderRadius(Number borderRadius) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -159,6 +171,8 @@ public Number getBorderWidth() { * The border width in pixels for the data label. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; @@ -186,6 +200,7 @@ public void setClassName(String className) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -193,6 +208,8 @@ public Color getColor() { /** * The text color for the data labels. Defaults to null. + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -388,6 +405,7 @@ public void setShape(Shape shape) { /** * @see #setStyle(Style) + * @since 18.0 */ public Style getStyle() { if (style == null) { @@ -410,6 +428,8 @@ public Style getStyle() { *

    * Defaults to: {"color": "contrast", "fontSize": "11px", "fontWeight": * "bold", "textOutline": "1px contrast" } + * + * @since 18.0 */ public void setStyle(Style style) { this.style = style; @@ -501,6 +521,7 @@ public void setZIndex(Number zIndex) { /** * @see #setConnectorColor(Color) + * @since 18.0 */ public Color getConnectorColor() { return connectorColor; @@ -520,6 +541,8 @@ public Color getConnectorColor() { *

    *

    * Defaults to: {point.color} + * + * @since 18.0 */ public void setConnectorColor(Color connectorColor) { this.connectorColor = connectorColor; @@ -543,6 +566,7 @@ public void setConnectorPadding(Number connectorPadding) { /** * @see #setConnectorWidth(Number) + * @since 18.0 */ public Number getConnectorWidth() { return connectorWidth; @@ -561,6 +585,8 @@ public Number getConnectorWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setConnectorWidth(Number connectorWidth) { this.connectorWidth = connectorWidth; @@ -602,6 +628,7 @@ public void setSoftConnector(Boolean softConnector) { /** * @see #setPosition(HorizontalAlign) + * @since 24.7 */ public HorizontalAlign getPosition() { return position; @@ -612,6 +639,7 @@ public HorizontalAlign getPosition() { * possible, it defaults to right. Defaults to "center". * * @param position + * @since 24.7 */ public void setPosition(HorizontalAlign position) { this.position = position; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataLabelsFunnel.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataLabelsFunnel.java index 1730f60a6e4..ece424566fd 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataLabelsFunnel.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataLabelsFunnel.java @@ -12,6 +12,7 @@ import com.vaadin.flow.component.charts.model.style.Style; /** + * @since 6.0.1 */ public class DataLabelsFunnel extends AbstractDataLabels { @@ -49,6 +50,7 @@ public DataLabelsFunnel() { /** * @see #setBackgroundColor(Color) + * @since 18.0 */ public Color getBackgroundColor() { return backgroundColor; @@ -57,6 +59,8 @@ public Color getBackgroundColor() { /** * The background color or gradient for the data label. Defaults to * undefined. + * + * @since 18.0 */ public void setBackgroundColor(Color backgroundColor) { this.backgroundColor = backgroundColor; @@ -64,6 +68,7 @@ public void setBackgroundColor(Color backgroundColor) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -71,6 +76,8 @@ public Color getBorderColor() { /** * The border color for the data label. Defaults to undefined. + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -78,6 +85,7 @@ public void setBorderColor(Color borderColor) { /** * @see #setBorderRadius(Number) + * @since 18.0 */ public Number getBorderRadius() { return borderRadius; @@ -87,6 +95,8 @@ public Number getBorderRadius() { * The border radius in pixels for the data label. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setBorderRadius(Number borderRadius) { this.borderRadius = borderRadius; @@ -94,6 +104,7 @@ public void setBorderRadius(Number borderRadius) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -103,6 +114,8 @@ public Number getBorderWidth() { * The border width in pixels for the data label. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; @@ -130,6 +143,7 @@ public void setClassName(String className) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -137,6 +151,8 @@ public Color getColor() { /** * The text color for the data labels. Defaults to null. + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -144,6 +160,7 @@ public void setColor(Color color) { /** * @see #setConnectorColor(Color) + * @since 18.0 */ public Color getConnectorColor() { return connectorColor; @@ -163,6 +180,8 @@ public Color getConnectorColor() { *

    *

    * Defaults to: {point.color} + * + * @since 18.0 */ public void setConnectorColor(Color connectorColor) { this.connectorColor = connectorColor; @@ -186,6 +205,7 @@ public void setConnectorPadding(Number connectorPadding) { /** * @see #setConnectorWidth(Number) + * @since 18.0 */ public Number getConnectorWidth() { return connectorWidth; @@ -204,6 +224,8 @@ public Number getConnectorWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setConnectorWidth(Number connectorWidth) { this.connectorWidth = connectorWidth; @@ -433,6 +455,7 @@ public void setSoftConnector(Boolean softConnector) { /** * @see #setStyle(Style) + * @since 18.0 */ public Style getStyle() { if (style == null) { @@ -455,6 +478,8 @@ public Style getStyle() { *

    * Defaults to: {"color": "contrast", "fontSize": "11px", "fontWeight": * "bold", "textOutline": "1px contrast" } + * + * @since 18.0 */ public void setStyle(Style style) { this.style = style; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataLabelsRange.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataLabelsRange.java index 88bc5b01de0..ca684a6760b 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataLabelsRange.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataLabelsRange.java @@ -17,6 +17,8 @@ * xLow, xHigh, yLow and * yHigh options to allow the higher and lower data label sets * individually. + * + * @since 6.0.1 */ public class DataLabelsRange extends AbstractDataLabels { @@ -93,6 +95,7 @@ public void setAllowOverlap(Boolean allowOverlap) { /** * @see #setBackgroundColor(Color) + * @since 18.0 */ public Color getBackgroundColor() { return backgroundColor; @@ -101,6 +104,8 @@ public Color getBackgroundColor() { /** * The background color or gradient for the data label. Defaults to * undefined. + * + * @since 18.0 */ public void setBackgroundColor(Color backgroundColor) { this.backgroundColor = backgroundColor; @@ -108,6 +113,7 @@ public void setBackgroundColor(Color backgroundColor) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -115,6 +121,8 @@ public Color getBorderColor() { /** * The border color for the data label. Defaults to undefined. + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -122,6 +130,7 @@ public void setBorderColor(Color borderColor) { /** * @see #setBorderRadius(Number) + * @since 18.0 */ public Number getBorderRadius() { return borderRadius; @@ -131,6 +140,8 @@ public Number getBorderRadius() { * The border radius in pixels for the data label. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setBorderRadius(Number borderRadius) { this.borderRadius = borderRadius; @@ -138,6 +149,7 @@ public void setBorderRadius(Number borderRadius) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -147,6 +159,8 @@ public Number getBorderWidth() { * The border width in pixels for the data label. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; @@ -174,6 +188,7 @@ public void setClassName(String className) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -181,6 +196,8 @@ public Color getColor() { /** * The text color for the data labels. Defaults to null. + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -376,6 +393,7 @@ public void setShape(Shape shape) { /** * @see #setStyle(Style) + * @since 18.0 */ public Style getStyle() { if (style == null) { @@ -398,6 +416,8 @@ public Style getStyle() { *

    * Defaults to: {"color": "contrast", "fontSize": "11px", "fontWeight": * "bold", "textOutline": "1px contrast" } + * + * @since 18.0 */ public void setStyle(Style style) { this.style = style; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataProviderSeries.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataProviderSeries.java index 4c967dbbdf2..9c039ad4516 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataProviderSeries.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataProviderSeries.java @@ -34,6 +34,8 @@ * Note that even if you use a lazy loading {@link DataProvider}, this series * will work in an eager fashion and load all the data from the provider at * once. + * + * @since 6.0.1 */ public class DataProviderSeries extends AbstractSeries { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeries.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeries.java index 6c09f2c61e3..73b0bd8acb1 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeries.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeries.java @@ -27,6 +27,7 @@ * @see ListSeries * @see RangeSeries * @see HeatSeries + * @since 6.0.1 */ public class DataSeries extends AbstractSeries { @@ -134,6 +135,7 @@ public void setData(String[] categoryNames, Number[] values) { * parameter. * @param colors * An array of colors for each category name, value pair. + * @since 18.0 */ public void setData(String[] categoryNames, Number[] values, Color[] colors) { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItem.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItem.java index aedd24442b1..87ad3cee415 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItem.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItem.java @@ -15,6 +15,8 @@ /** * The DataSeriesItem class represents a single entry in a {@link DataSeries}. + * + * @since 6.0.1 */ @SuppressWarnings("serial") public class DataSeriesItem extends AbstractSeriesItem { @@ -65,6 +67,7 @@ public DataSeriesItem(String name, Number y) { * Y-value of the item. * @param color * Color of the item. + * @since 18.0 */ public DataSeriesItem(String name, Number y, Color color) { setName(name); @@ -96,6 +99,7 @@ public DataSeriesItem(Number x, Number y) { * Y-value of the item. * @param color * Color of the item. + * @since 18.0 */ public DataSeriesItem(Number x, Number y, Color color) { setX(x); @@ -220,6 +224,8 @@ public void setMarker(Marker marker) { /** * {@inheritDoc} + * + * @since 18.0 */ @Override public void setColor(Color color) { @@ -376,6 +382,7 @@ public void setCursor(String cursor) { /** * @see #setDescription(String) + * @since 18.0 */ public String getDescription() { return description; @@ -391,6 +398,8 @@ public String getDescription() { *

    *

    * Defaults to: undefined + * + * @since 18.0 */ public void setDescription(String description) { this.description = description; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItem3d.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItem3d.java index 18fd10457fe..23f49ec5a98 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItem3d.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItem3d.java @@ -10,6 +10,8 @@ /** * DataSeriesItem that can hold also Z value. Used in e.g. bubble charts. + * + * @since 6.0.1 */ public class DataSeriesItem3d extends DataSeriesItem { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItemBullet.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItemBullet.java index a6a0e09a042..4cce7c1fc94 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItemBullet.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItemBullet.java @@ -13,6 +13,8 @@ /** * DataSeriesItem that can hold also target and targetOptions. Used in e.g. * bullet series. + * + * @since 18.0 */ public class DataSeriesItemBullet extends DataSeriesItem { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItemSankey.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItemSankey.java index 42693093dfd..70d1991a3f0 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItemSankey.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItemSankey.java @@ -11,6 +11,8 @@ /** * DataSeriesItem that can hold also "from", "to" and "weight". Used in sankey * series. + * + * @since 24.3 */ public class DataSeriesItemSankey extends DataSeriesItem { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItemTimeline.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItemTimeline.java index 988434c9aef..1e106474003 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItemTimeline.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItemTimeline.java @@ -13,6 +13,8 @@ /** * DataSeriesItem that can hold also Label and Description values. Used in e.g. * timeline series. + * + * @since 18.0 */ public class DataSeriesItemTimeline extends DataSeriesItem { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItemXrange.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItemXrange.java index a58ec3818d1..736f9418491 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItemXrange.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DataSeriesItemXrange.java @@ -19,6 +19,8 @@ *

    * To change partial fill amount or color use {@link #getPartialFill()} to get * the configuration object. + * + * @since 18.0 */ public class DataSeriesItemXrange extends DataSeriesItem { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DateTimeLabelFormats.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DateTimeLabelFormats.java index d305e86c554..3e57f2f93a0 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DateTimeLabelFormats.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DateTimeLabelFormats.java @@ -25,6 +25,8 @@ * year: '%Y' * } * + * + * @since 6.0.1 */ @SuppressWarnings("serial") public class DateTimeLabelFormats extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Dial.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Dial.java index b6e52073afe..baf47793ddf 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Dial.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Dial.java @@ -21,6 +21,8 @@ * >styled mode, the dial is styled with the * .highcharts-gauge-series .highcharts-dial rule. *

    + * + * @since 6.0.1 */ public class Dial extends AbstractConfigurationObject { @@ -38,6 +40,7 @@ public Dial() { /** * @see #setBackgroundColor(Color) + * @since 18.0 */ public Color getBackgroundColor() { return backgroundColor; @@ -47,6 +50,8 @@ public Color getBackgroundColor() { * The background or fill color of the gauge's dial. *

    * Defaults to: #000000 + * + * @since 18.0 */ public void setBackgroundColor(Color backgroundColor) { this.backgroundColor = backgroundColor; @@ -88,6 +93,7 @@ public void setBaseWidth(Number baseWidth) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -99,6 +105,8 @@ public Color getBorderColor() { * color. *

    * Defaults to: #cccccc + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -106,6 +114,7 @@ public void setBorderColor(Color borderColor) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -115,6 +124,8 @@ public Number getBorderWidth() { * The width of the gauge dial border in pixels. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Dimension.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Dimension.java index cb8ac7dd4ec..cdb4b4acc71 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Dimension.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Dimension.java @@ -10,6 +10,8 @@ /** * Axial dimension. + * + * @since 6.0.1 */ public enum Dimension implements ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DragDrop.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DragDrop.java index 08e09c411ba..16b0bc46893 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DragDrop.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DragDrop.java @@ -8,6 +8,9 @@ */ package com.vaadin.flow.component.charts.model; +/** + * @since 24.7 + */ @SuppressWarnings("unused") public class DragDrop extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DragHandle.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DragHandle.java index fe8176ab56c..29519325c6f 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DragHandle.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DragHandle.java @@ -10,6 +10,9 @@ import com.vaadin.flow.component.charts.model.style.Color; +/** + * @since 24.7 + */ @SuppressWarnings("unused") public class DragHandle extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Drilldown.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Drilldown.java index 33d46dac99e..0f8d00d19d4 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Drilldown.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Drilldown.java @@ -18,6 +18,8 @@ /** * Options for drill down, the concept of inspecting increasingly high * resolution data through clicking on chart items like columns or pie slices. + * + * @since 6.0.1 */ public class Drilldown extends AbstractConfigurationObject { @@ -63,6 +65,7 @@ public Configuration getConfiguration() { /** * @see #setActiveAxisLabelStyle(Style) * @return + * @since 18.0 */ public Style getActiveAxisLabelStyle() { return activeAxisLabelStyle; @@ -73,6 +76,7 @@ public Style getActiveAxisLabelStyle() { * drilldown data. * * @param activeAxisLabelStyle + * @since 18.0 */ public void setActiveAxisLabelStyle(Style activeAxisLabelStyle) { this.activeAxisLabelStyle = activeAxisLabelStyle; @@ -81,6 +85,7 @@ public void setActiveAxisLabelStyle(Style activeAxisLabelStyle) { /** * @see #setActiveDataLabelStyle(Style) * @return + * @since 18.0 */ public Style getActiveDataLabelStyle() { return activeDataLabelStyle; @@ -91,6 +96,7 @@ public Style getActiveDataLabelStyle() { * drilldown data. * * @param activeDataLabelStyle + * @since 18.0 */ public void setActiveDataLabelStyle(Style activeDataLabelStyle) { this.activeDataLabelStyle = activeDataLabelStyle; @@ -119,6 +125,7 @@ public void setAnimation(Boolean animation) { * Returns the breadcrumbs navigation options for drilldown levels. * * @return Breadcrumbs navigation options + * @since 25.0 */ public Breadcrumbs getBreadcrumbs() { if (breadcrumbs == null) { @@ -133,6 +140,7 @@ public Breadcrumbs getBreadcrumbs() { * * @param breadcrumbs * the Breadcrumbs configuration + * @since 25.0 */ public void setBreadcrumbs(Breadcrumbs breadcrumbs) { this.breadcrumbs = breadcrumbs; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DrilldownCallback.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DrilldownCallback.java index 9fd028e4526..202e4b0dcd9 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DrilldownCallback.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/DrilldownCallback.java @@ -21,6 +21,8 @@ *

    * To enable async drilldown for a series item use * {@link DataSeries#addItemWithDrilldown(com.vaadin.flow.component.charts.model.DataSeriesItem)} + * + * @since 18.0 */ public interface DrilldownCallback extends Serializable { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ExportFileType.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ExportFileType.java index 337120a1c29..e9cf0fadae1 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ExportFileType.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ExportFileType.java @@ -13,6 +13,8 @@ * specifying a type option. * * Defaults to image/png. + * + * @since 6.0.1 */ public enum ExportFileType implements ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Exporting.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Exporting.java index af2404a3477..535c129daa0 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Exporting.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Exporting.java @@ -17,6 +17,8 @@ * Options for the exporting module. For an overview on the matter, see * the docs. + * + * @since 6.0.1 */ public class Exporting extends AbstractConfigurationObject { @@ -200,6 +202,7 @@ public void setLibURL(String libURL) { * @param libURL * the path where Highcharts will look for export module * dependencies + * @since 25.2 */ public void setUnsafeLibURL(String libURL) { this.libURL = libURL; @@ -365,6 +368,7 @@ public void setUrl(String url) { * @param url * the URL for the server module converting the SVG string to an * image format + * @since 25.2 */ public void setUnsafeUrl(String url) { this.url = url; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ExportingMenuItemDefinition.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ExportingMenuItemDefinition.java index 58f5a6a03e9..c3da53c8c71 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ExportingMenuItemDefinition.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ExportingMenuItemDefinition.java @@ -8,6 +8,9 @@ */ package com.vaadin.flow.component.charts.model; +/** + * @since 6.0.1 + */ public class ExportingMenuItemDefinition extends AbstractConfigurationObject { private String _fn_onclick; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/FlagItem.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/FlagItem.java index 1473cb5da75..6ab2ef1cef3 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/FlagItem.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/FlagItem.java @@ -13,6 +13,8 @@ /** * DataSeriesItem that can hold also title and text values. Used in flags * charts. + * + * @since 6.0.1 */ public class FlagItem extends DataSeriesItem { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/FlagShape.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/FlagShape.java index 8a59af61511..bfcd7642dc4 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/FlagShape.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/FlagShape.java @@ -10,6 +10,8 @@ /** * The name of a symbol to use for the border in {@link ChartType#FLAGS} series. + * + * @since 6.0.1 */ public enum FlagShape implements ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Frame.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Frame.java index 886d4adccc7..235a461b40e 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Frame.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Frame.java @@ -11,6 +11,8 @@ /** * Provides the option to draw a frame around the charts by defining a bottom, * front and back panel. + * + * @since 6.0.1 */ public class Frame extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GanttSeries.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GanttSeries.java index a11b1976ea6..3ac229c7a2b 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GanttSeries.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GanttSeries.java @@ -18,6 +18,8 @@ /** * A series of tasks to be used in the Gantt chart. Each task (represented by * {@link GanttSeriesItem}) has a start and an end date. + * + * @since 24.7 */ @SuppressWarnings("unused") public class GanttSeries extends AbstractSeries { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GanttSeriesItem.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GanttSeriesItem.java index 247edf71964..b13f4f4cb02 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GanttSeriesItem.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GanttSeriesItem.java @@ -17,6 +17,8 @@ /** * Data for the {@link GanttSeries}. Represents one task in the Gantt chart. + * + * @since 24.7 */ @SuppressWarnings("unused") public class GanttSeriesItem extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GanttSeriesItemDependency.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GanttSeriesItemDependency.java index 66a9bb2e050..e2183b78559 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GanttSeriesItemDependency.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GanttSeriesItemDependency.java @@ -11,6 +11,8 @@ /** * A configuration object to express dependencies between tasks in a Gantt * chart. + * + * @since 24.7 */ @SuppressWarnings("unused") public class GanttSeriesItemDependency extends ConnectorStyle { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GaugeOptions.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GaugeOptions.java index 5bde83bac96..272e055ef2f 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GaugeOptions.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GaugeOptions.java @@ -8,6 +8,9 @@ */ package com.vaadin.flow.component.charts.model; +/** + * @since 6.0.1 + */ public abstract class GaugeOptions extends AbstractPlotOptions { /** @@ -29,17 +32,21 @@ public abstract class GaugeOptions extends AbstractPlotOptions { /** * @see #setClip(Boolean) + * @since 18.0 */ public abstract Boolean getClip(); /** * Disable this option to allow series rendering in the whole plotting area. * Note that clipping should be always enabled when chart.zoomType is set + * + * @since 18.0 */ public abstract void setClip(Boolean clip); /** * @see #setCrisp(Boolean) + * @since 18.0 */ public abstract Boolean getCrisp(); @@ -50,6 +57,8 @@ public abstract class GaugeOptions extends AbstractPlotOptions { * or distance between columns. In these cases, setting crisp * to false may look better, even though each column is * rendered blurry. + * + * @since 18.0 */ public abstract void setCrisp(Boolean crisp); @@ -132,11 +141,14 @@ public abstract class GaugeOptions extends AbstractPlotOptions { /** * @see #setOpacity(Number) + * @since 18.0 */ public abstract Number getOpacity(); /** * Opacity of a series parts: line, fill (e.g. area) and dataLabels. + * + * @since 18.0 */ public abstract void setOpacity(Number opacity); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Global.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Global.java index 332bd7bee84..dfc8cf5c257 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Global.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Global.java @@ -20,6 +20,8 @@ * } * }); * + * + * @since 6.0.1 */ public class Global extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GuideBox.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GuideBox.java index c72a003c5e1..5c08718221c 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GuideBox.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GuideBox.java @@ -13,6 +13,8 @@ /** * Style options for the guide box. The guide box has one state by default, the * default state. + * + * @since 24.7 */ @SuppressWarnings("unused") public class GuideBox extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GuideBoxDefaultState.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GuideBoxDefaultState.java index e9524272e65..a1938737b18 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GuideBoxDefaultState.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/GuideBoxDefaultState.java @@ -10,6 +10,9 @@ import com.vaadin.flow.component.charts.model.style.Color; +/** + * @since 24.7 + */ public class GuideBoxDefaultState extends AbstractConfigurationObject { private String className; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Halo.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Halo.java index b53457caf2c..66183147713 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Halo.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Halo.java @@ -23,6 +23,8 @@ * >styled mode, the halo is styled with the .highcharts-halo * class, with colors inherited from .highcharts-color-{n}. *

    + * + * @since 6.0.1 */ public class Halo extends AbstractConfigurationObject { @@ -35,6 +37,7 @@ public Halo() { /** * @see #setAttributes(Attributes) + * @since 18.0 */ public Attributes getAttributes() { if (attributes == null) { @@ -47,6 +50,8 @@ public Attributes getAttributes() { * A collection of SVG attributes to override the appearance of the halo, * for example fill, stroke and * stroke-width. + * + * @since 18.0 */ public void setAttributes(Attributes attributes) { this.attributes = attributes; @@ -54,6 +59,7 @@ public void setAttributes(Attributes attributes) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -65,6 +71,8 @@ public Number getOpacity() { * apply opacity to colors of hex or rgb(a) formats. *

    * Defaults to: 0.25 + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Handles.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Handles.java index 61d9559bb3c..9e75f84aacb 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Handles.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Handles.java @@ -23,6 +23,8 @@ * .highcharts-navigator-handle-left and * .highcharts-navigator-handle-right classes. *

    + * + * @since 18.0 */ public class Handles extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/HeatSeries.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/HeatSeries.java index a6774841043..cc5c26c2361 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/HeatSeries.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/HeatSeries.java @@ -10,6 +10,8 @@ /** * A specialized series for use with HeatMaps + * + * @since 6.0.1 */ public class HeatSeries extends AbstractSeries { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/HorizontalAlign.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/HorizontalAlign.java index d2ee820cac6..4c89814d099 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/HorizontalAlign.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/HorizontalAlign.java @@ -12,6 +12,8 @@ * Alignment of the title relative to the axis values and more generically * horizontal alignment. Possible values are RIGHT("right"), CENTER("center") or * LEFT("left") + * + * @since 6.0.1 */ public enum HorizontalAlign implements ChartEnum { RIGHT("right"), CENTER("center"), LEFT("left"); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Hover.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Hover.java index f1b2da009b3..82308532fec 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Hover.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Hover.java @@ -12,6 +12,8 @@ /** * Options for the hovered series + * + * @since 6.0.1 */ public class Hover extends AbstractConfigurationObject { @@ -103,6 +105,7 @@ public void setHalo(Halo halo) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -112,6 +115,8 @@ public Number getLineWidth() { * Pixel with of the graph line. *

    * Defaults to: 2 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -119,6 +124,7 @@ public void setLineWidth(Number lineWidth) { /** * @see #setLineWidthPlus(Number) + * @since 18.0 */ public Number getLineWidthPlus() { return lineWidthPlus; @@ -128,6 +134,8 @@ public Number getLineWidthPlus() { * The additional line width for the graph of a hovered series. *

    * Defaults to: 1 + * + * @since 18.0 */ public void setLineWidthPlus(Number lineWidthPlus) { this.lineWidthPlus = lineWidthPlus; @@ -135,6 +143,7 @@ public void setLineWidthPlus(Number lineWidthPlus) { /** * @see #setFillColor(Color) + * @since 18.0 */ public Color getFillColor() { return fillColor; @@ -142,6 +151,8 @@ public Color getFillColor() { /** * The fill color of the marker in hover state. + * + * @since 18.0 */ public void setFillColor(Color fillColor) { this.fillColor = fillColor; @@ -149,6 +160,7 @@ public void setFillColor(Color fillColor) { /** * @see #setLineColor(Color) + * @since 18.0 */ public Color getLineColor() { return lineColor; @@ -159,6 +171,8 @@ public Color getLineColor() { * series' or point's color is used. *

    * Defaults to: #ffffff + * + * @since 18.0 */ public void setLineColor(Color lineColor) { this.lineColor = lineColor; @@ -199,6 +213,7 @@ public void setRadiusPlus(Number radiusPlus) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -207,6 +222,8 @@ public Color getBorderColor() { /** * A specific border color for the hovered point. Defaults to inherit the * normal state border color. + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -214,6 +231,7 @@ public void setBorderColor(Color borderColor) { /** * @see #setBrightness(Number) + * @since 18.0 */ public Number getBrightness() { return brightness; @@ -233,6 +251,8 @@ public Number getBrightness() { *

    *

    * Defaults to: 0.1 + * + * @since 18.0 */ public void setBrightness(Number brightness) { this.brightness = brightness; @@ -240,6 +260,7 @@ public void setBrightness(Number brightness) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -249,6 +270,8 @@ public Color getColor() { * A specific color for the hovered point. *

    * Defaults to: undefined + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -256,6 +279,7 @@ public void setColor(Color color) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -266,6 +290,8 @@ public Number getOpacity() { * visibility of the children is determined by the opacity. *

    * Defaults to: 0.75 + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Inactive.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Inactive.java index dd8d9c5ca7e..9c3829afe2f 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Inactive.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Inactive.java @@ -10,6 +10,9 @@ import com.vaadin.flow.component.charts.model.style.Color; +/** + * @since 22.0 + */ public class Inactive extends AbstractConfigurationObject { private Boolean animation; @@ -70,6 +73,8 @@ public Number getLineWidth() { * Pixel width of the graph line. *

    * Defaults to: 2 + * + * @since 25.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/IntervalUnit.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/IntervalUnit.java index fabab93f03b..36e0db0ad2a 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/IntervalUnit.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/IntervalUnit.java @@ -10,6 +10,8 @@ /** * Irregular time unit used to define point interval unit. + * + * @since 6.0.1 */ public enum IntervalUnit implements ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ItemPartialFill.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ItemPartialFill.java index b1a374394b1..6f7e3a7d5c5 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ItemPartialFill.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ItemPartialFill.java @@ -13,6 +13,8 @@ /** * PartialFill configuration object to be used in {@link DataSeriesItemXrange}. * Typically used to visualize how much of a task is performed. + * + * @since 18.0 */ public class ItemPartialFill extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Items.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Items.java index 54abc246381..40917911d33 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Items.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Items.java @@ -12,6 +12,8 @@ /** * A HTML label that can be positioned anywhere in the chart area. + * + * @since 18.0 */ public class Items extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/KeyboardNavigation.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/KeyboardNavigation.java index f95814ed864..da1589c7d03 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/KeyboardNavigation.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/KeyboardNavigation.java @@ -10,6 +10,8 @@ /** * Options for keyboard navigation. + * + * @since 6.0.1 */ public class KeyboardNavigation extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Label.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Label.java index b57274a9555..0e63ee9e988 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Label.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Label.java @@ -12,6 +12,8 @@ /** * Text labels for the plot bands + * + * @since 6.0.1 */ public class Label extends AbstractConfigurationObject { @@ -62,6 +64,7 @@ public void setRotation(Number rotation) { /** * @see #setStyle(Style) + * @since 18.0 */ public Style getStyle() { if (style == null) { @@ -81,6 +84,8 @@ public Style getStyle() { * >styled mode, the labels are styled by the * .highcharts-plot-band-label class. *

    + * + * @since 18.0 */ public void setStyle(Style style) { this.style = style; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Labels.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Labels.java index 90482677c3d..8e9a395d7f4 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Labels.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Labels.java @@ -13,6 +13,9 @@ import tools.jackson.databind.annotation.JsonSerialize; +/** + * @since 6.0.1 + */ public class Labels extends AbstractConfigurationObject { private HorizontalAlign align; @@ -238,6 +241,7 @@ public void setStep(Number step) { /** * @see #setStyle(Style) + * @since 18.0 */ public Style getStyle() { if (style == null) { @@ -262,6 +266,8 @@ public Style getStyle() { *

    * Defaults to: { "color": "#666666", "cursor": "default", "fontSize": * "11px" } + * + * @since 18.0 */ public void setStyle(Style style) { this.style = style; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Lang.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Lang.java index 30b1102d258..fee811f0a96 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Lang.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Lang.java @@ -21,6 +21,8 @@ * } * }); * + * + * @since 6.0.1 */ public class Lang extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/LayoutDirection.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/LayoutDirection.java index 4da9bcbd760..519f903ffce 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/LayoutDirection.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/LayoutDirection.java @@ -11,6 +11,8 @@ /** * The layout of the legend items. Can be one of HORIZONTAL("horizontal") or * VERTICAL("vertical"). Defaults to HORIZONTAL. + * + * @since 6.0.1 */ public enum LayoutDirection implements ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Legend.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Legend.java index 62b325e623e..49ab01ee64d 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Legend.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Legend.java @@ -14,6 +14,8 @@ /** * The legend is a box containing a symbol and name for each series item or * point item in the chart. + * + * @since 6.0.1 */ public class Legend extends AbstractConfigurationObject { @@ -84,6 +86,7 @@ public void setAlign(HorizontalAlign align) { /** * @see #setBackgroundColor(Color) + * @since 18.0 */ public Color getBackgroundColor() { return backgroundColor; @@ -91,6 +94,8 @@ public Color getBackgroundColor() { /** * The background color of the legend. + * + * @since 18.0 */ public void setBackgroundColor(Color backgroundColor) { this.backgroundColor = backgroundColor; @@ -98,6 +103,7 @@ public void setBackgroundColor(Color backgroundColor) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -107,6 +113,8 @@ public Color getBorderColor() { * The color of the drawn border around the legend. *

    * Defaults to: #999999 + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -130,6 +138,7 @@ public void setBorderRadius(Number borderRadius) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -139,6 +148,8 @@ public Number getBorderWidth() { * The width of the drawn border around the legend. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; @@ -200,6 +211,7 @@ public void setItemDistance(Number itemDistance) { /** * @see #setItemHiddenStyle(Style) + * @since 18.0 */ public Style getItemHiddenStyle() { if (itemHiddenStyle == null) { @@ -215,6 +227,8 @@ public Style getItemHiddenStyle() { * overridden here. *

    * Defaults to: { "color": "#cccccc" } + * + * @since 18.0 */ public void setItemHiddenStyle(Style itemHiddenStyle) { this.itemHiddenStyle = itemHiddenStyle; @@ -222,6 +236,7 @@ public void setItemHiddenStyle(Style itemHiddenStyle) { /** * @see #setItemHoverStyle(Style) + * @since 18.0 */ public Style getItemHoverStyle() { if (itemHoverStyle == null) { @@ -236,6 +251,8 @@ public Style getItemHoverStyle() { * inherited from style unless overridden here. *

    * Defaults to: { "color": "#000000" } + * + * @since 18.0 */ public void setItemHoverStyle(Style itemHoverStyle) { this.itemHoverStyle = itemHoverStyle; @@ -275,6 +292,7 @@ public void setItemMarginTop(Number itemMarginTop) { /** * @see #setItemStyle(Style) + * @since 18.0 */ public Style getItemStyle() { if (itemStyle == null) { @@ -292,6 +310,8 @@ public Style getItemStyle() { *

    * Defaults to: { "color": "#333333", "cursor": "pointer", "fontSize": * "12px", "fontWeight": "bold", "textOverflow": "ellipsis" } + * + * @since 18.0 */ public void setItemStyle(Style itemStyle) { this.itemStyle = itemStyle; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/LegendNavigation.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/LegendNavigation.java index 250f7dbbb59..c127e47c6a8 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/LegendNavigation.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/LegendNavigation.java @@ -17,6 +17,8 @@ * of working around that is to increase the chart height in export. + * + * @since 6.0.1 */ public class LegendNavigation extends AbstractConfigurationObject { @@ -32,6 +34,7 @@ public LegendNavigation() { /** * @see #setActiveColor(Color) + * @since 18.0 */ public Color getActiveColor() { return activeColor; @@ -41,6 +44,8 @@ public Color getActiveColor() { * The color for the active up or down arrow in the legend page navigation. *

    * Defaults to: #003399 + * + * @since 18.0 */ public void setActiveColor(Color activeColor) { this.activeColor = activeColor; @@ -114,6 +119,7 @@ public void setEnabled(Boolean enabled) { /** * @see #setInactiveColor(Color) + * @since 18.0 */ public Color getInactiveColor() { return inactiveColor; @@ -124,6 +130,8 @@ public Color getInactiveColor() { * . *

    * Defaults to: #cccccc + * + * @since 18.0 */ public void setInactiveColor(Color inactiveColor) { this.inactiveColor = inactiveColor; @@ -131,6 +139,7 @@ public void setInactiveColor(Color inactiveColor) { /** * @see #setStyle(Style) + * @since 18.0 */ public Style getStyle() { if (style == null) { @@ -141,6 +150,8 @@ public Style getStyle() { /** * Text styles for the legend page navigation. + * + * @since 18.0 */ public void setStyle(Style style) { this.style = style; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/LegendTitle.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/LegendTitle.java index 6bbe2438e68..a7490f9fee1 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/LegendTitle.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/LegendTitle.java @@ -12,6 +12,8 @@ /** * A title to be added on top of the legend. + * + * @since 6.0.1 */ public class LegendTitle extends AbstractConfigurationObject { @@ -23,6 +25,7 @@ public LegendTitle() { /** * @see #setStyle(Style) + * @since 18.0 */ public Style getStyle() { if (style == null) { @@ -35,6 +38,8 @@ public Style getStyle() { * Generic CSS styles for the legend title. *

    * Defaults to: {"fontWeight":"bold"} + * + * @since 18.0 */ public void setStyle(Style style) { this.style = style; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Level.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Level.java index 40e8599518a..bf1f32a71c3 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Level.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Level.java @@ -13,6 +13,8 @@ /** * Set options on specific levels. Takes precedence over series options, but not * point options. + * + * @since 6.0.1 */ public class Level extends AbstractConfigurationObject { @@ -30,6 +32,7 @@ public Level() { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -38,6 +41,8 @@ public Color getBorderColor() { /** * Can set a borderColor on all points which lies on the same * level. + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -45,6 +50,7 @@ public void setBorderColor(Color borderColor) { /** * @see #setBorderDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getBorderDashStyle() { return borderDashStyle; @@ -55,6 +61,8 @@ public DashStyle getBorderDashStyle() { * level. See plotOptions.scatter.dashStyle * for possible options. + * + * @since 18.0 */ public void setBorderDashStyle(DashStyle borderDashStyle) { this.borderDashStyle = borderDashStyle; @@ -62,6 +70,7 @@ public void setBorderDashStyle(DashStyle borderDashStyle) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -69,6 +78,8 @@ public Number getBorderWidth() { /** * Can set the borderWidth on all points which lies on the same level. + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; @@ -76,6 +87,7 @@ public void setBorderWidth(Number borderWidth) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -83,6 +95,8 @@ public Color getColor() { /** * Can set a color on all points which lies on the same level. + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Link.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Link.java index 26e971b309d..326c9abebfb 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Link.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Link.java @@ -12,6 +12,8 @@ /** * Link styling options for Organization charts. + * + * @since 25.0 */ public class Link extends AbstractConfigurationObject { private Color color; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/LinkType.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/LinkType.java index 45a20760ec0..a59b1265dee 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/LinkType.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/LinkType.java @@ -10,6 +10,8 @@ /** * The type of the link shape. + * + * @since 25.0 */ public enum LinkType implements ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ListSeries.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ListSeries.java index aa2958d3a78..838e01e49e8 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ListSeries.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ListSeries.java @@ -20,6 +20,8 @@ * pointStart and pointInterval given in the plotOptions. If the axis has * categories, these will be used. This option is not available for range * series. + * + * @since 6.0.1 */ public class ListSeries extends AbstractSeries { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Loading.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Loading.java index fd454f3c647..49f271ad0fd 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Loading.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Loading.java @@ -18,6 +18,8 @@ * retrieving new data via an XHR connection. The "Loading..." text itself is * not part of this configuration object, but part of the lang * object. + * + * @since 6.0.1 */ public class Loading extends AbstractConfigurationObject { @@ -47,6 +49,7 @@ public void setHideDuration(Number hideDuration) { /** * @see #setLabelStyle(Style) + * @since 18.0 */ public Style getLabelStyle() { if (labelStyle == null) { @@ -60,6 +63,8 @@ public Style getLabelStyle() { *

    * Defaults to: { "fontWeight": "bold", "position": "relative", "top": "45%" * } + * + * @since 18.0 */ public void setLabelStyle(Style labelStyle) { this.labelStyle = labelStyle; @@ -83,6 +88,7 @@ public void setShowDuration(Number showDuration) { /** * @see #setStyle(Style) + * @since 18.0 */ public Style getStyle() { if (style == null) { @@ -96,6 +102,8 @@ public Style getStyle() { *

    * Defaults to: { "position": "absolute", "backgroundColor": "#ffffff", * "opacity": 0.5, "textAlign": "center" } + * + * @since 18.0 */ public void setStyle(Style style) { this.style = style; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Marker.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Marker.java index bd077a126f0..241fe4355e0 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Marker.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Marker.java @@ -14,6 +14,8 @@ * In Highcharts 1.0, the appearance of all markers belonging to the hovered * series. For settings on the hover state of the individual point, see * marker.states.hover. + * + * @since 6.0.1 */ public class Marker extends AbstractConfigurationObject { @@ -56,6 +58,7 @@ public void setEnabled(Boolean enabled) { /** * @see #setFillColor(Color) + * @since 18.0 */ public Color getFillColor() { return fillColor; @@ -64,6 +67,8 @@ public Color getFillColor() { /** * The fill color of the point marker. When null, the series' * or point's color is used. + * + * @since 18.0 */ public void setFillColor(Color fillColor) { this.fillColor = fillColor; @@ -88,6 +93,7 @@ public void setHeight(Number height) { /** * @see #setLineColor(Color) + * @since 18.0 */ public Color getLineColor() { return lineColor; @@ -98,6 +104,8 @@ public Color getLineColor() { * series' or point's color is used. *

    * Defaults to: #ffffff + * + * @since 18.0 */ public void setLineColor(Color lineColor) { this.lineColor = lineColor; @@ -105,6 +113,7 @@ public void setLineColor(Color lineColor) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -114,6 +123,8 @@ public Number getLineWidth() { * The width of the point marker's outline. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -179,6 +190,7 @@ public void setSymbol(MarkerSymbol symbol) { /** * @see #setAlign(HorizontalAlign) + * @since 24.7 */ public HorizontalAlign getAlign() { return align; @@ -187,6 +199,8 @@ public HorizontalAlign getAlign() { /** * Supported only in Gantt charts: Horizontal alignment of the markers * relative to the points. Defaults to "center" + * + * @since 24.7 */ public void setAlign(HorizontalAlign align) { this.align = align; @@ -194,6 +208,7 @@ public void setAlign(HorizontalAlign align) { /** * @see #setVerticalAlign(VerticalAlign) + * @since 24.7 */ public VerticalAlign getVerticalAlign() { return verticalAlign; @@ -202,6 +217,8 @@ public VerticalAlign getVerticalAlign() { /** * Supported only in Gantt charts: Vertical alignment of the markers * relative to the points. Defaults to "middle" + * + * @since 24.7 */ public void setVerticalAlign(VerticalAlign verticalAlign) { this.verticalAlign = verticalAlign; @@ -209,6 +226,7 @@ public void setVerticalAlign(VerticalAlign verticalAlign) { /** * @see #setInside(Boolean) + * @since 24.7 */ public Boolean getInside() { return inside; @@ -217,6 +235,8 @@ public Boolean getInside() { /** * Supported only in Gantt charts: Whether to draw the markers inside the * points. Defaults to false. + * + * @since 24.7 */ public void setInside(Boolean inside) { this.inside = inside; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/MarkerSymbol.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/MarkerSymbol.java index 305cbad78d6..44c9a4dfb55 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/MarkerSymbol.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/MarkerSymbol.java @@ -12,6 +12,8 @@ /** * Interface for all marker symbols + * + * @since 6.0.1 */ public interface MarkerSymbol extends Serializable { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/MarkerSymbolEnum.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/MarkerSymbolEnum.java index eb279981356..63a2ffb2c11 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/MarkerSymbolEnum.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/MarkerSymbolEnum.java @@ -14,6 +14,7 @@ * "diamond", "triangle" and "triangle-down". Additionally, the URL to a graphic * can be given on this form: URL.setUrl("url(graphic.png)"). * + * @since 6.0.1 */ public enum MarkerSymbolEnum implements MarkerSymbol, ChartEnum { CIRCLE("circle"), diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/MarkerSymbolUrl.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/MarkerSymbolUrl.java index efd64869760..265749b1be5 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/MarkerSymbolUrl.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/MarkerSymbolUrl.java @@ -11,6 +11,8 @@ /** * Symbol that is fetched from the url, implementing ChartEnum to provide * correct serialization + * + * @since 6.0.1 */ public class MarkerSymbolUrl extends AbstractConfigurationObject implements MarkerSymbol, ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Navigation.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Navigation.java index c17973dbfff..c97a54845e5 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Navigation.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Navigation.java @@ -13,6 +13,8 @@ /** * A collection of options for buttons and menus appearing in the exporting * module. + * + * @since 6.0.1 */ public class Navigation extends AbstractConfigurationObject { @@ -53,6 +55,7 @@ public void setButtonOptions(ButtonOptions buttonOptions) { /** * @see #setMenuItemHoverStyle(Style) + * @since 18.0 */ public Style getMenuItemHoverStyle() { if (menuItemHoverStyle == null) { @@ -67,6 +70,8 @@ public Style getMenuItemHoverStyle() { * are rendered in HTML. *

    * Defaults to: { "background": "#335cad", "color": "#ffffff" } + * + * @since 18.0 */ public void setMenuItemHoverStyle(Style menuItemHoverStyle) { this.menuItemHoverStyle = menuItemHoverStyle; @@ -74,6 +79,7 @@ public void setMenuItemHoverStyle(Style menuItemHoverStyle) { /** * @see #setMenuItemStyle(Style) + * @since 18.0 */ public Style getMenuItemStyle() { if (menuItemStyle == null) { @@ -89,6 +95,8 @@ public Style getMenuItemStyle() { *

    * Defaults to: { "padding": "0.5em 1em", "color": "#333333", "background": * "none" } + * + * @since 18.0 */ public void setMenuItemStyle(Style menuItemStyle) { this.menuItemStyle = menuItemStyle; @@ -96,6 +104,7 @@ public void setMenuItemStyle(Style menuItemStyle) { /** * @see #setMenuStyle(Style) + * @since 18.0 */ public Style getMenuStyle() { if (menuStyle == null) { @@ -110,6 +119,8 @@ public Style getMenuStyle() { *

    * Defaults to: { "border": "1px solid #999999", "background": "#ffffff", * "padding": "5px 0" } + * + * @since 18.0 */ public void setMenuStyle(Style menuStyle) { this.menuStyle = menuStyle; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Navigator.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Navigator.java index 75a0acf09fc..6d2c9975e1f 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Navigator.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Navigator.java @@ -14,6 +14,8 @@ * The navigator is a small series below the main series, displaying a view of * the entire data set. It provides tools to zoom in and out on parts of the * data as well as panning across the dataset. + * + * @since 6.0.1 */ public class Navigator extends AbstractConfigurationObject { @@ -77,6 +79,7 @@ public void setEnabled(Boolean enabled) { /** * @see #setHandles(Handles) + * @since 18.0 */ public Handles getHandles() { if (handles == null) { @@ -98,6 +101,8 @@ public Handles getHandles() { * .highcharts-navigator-handle-left and * .highcharts-navigator-handle-right classes. *

    + * + * @since 18.0 */ public void setHandles(Handles handles) { this.handles = handles; @@ -137,6 +142,7 @@ public void setMargin(Number margin) { /** * @see #setMaskFill(Color) + * @since 18.0 */ public Color getMaskFill() { return maskFill; @@ -148,6 +154,8 @@ public Color getMaskFill() { * with an opacity of 0.3 to see the series below. *

    * Defaults to: rgba(102,133,194,0.3) + * + * @since 18.0 */ public void setMaskFill(Color maskFill) { this.maskFill = maskFill; @@ -189,6 +197,7 @@ public void setOpposite(Boolean opposite) { /** * @see #setOutlineColor(Color) + * @since 18.0 */ public Color getOutlineColor() { return outlineColor; @@ -198,6 +207,8 @@ public Color getOutlineColor() { * The color of the line marking the currently zoomed area in the navigator. *

    * Defaults to: #cccccc + * + * @since 18.0 */ public void setOutlineColor(Color outlineColor) { this.outlineColor = outlineColor; @@ -205,6 +216,7 @@ public void setOutlineColor(Color outlineColor) { /** * @see #setOutlineWidth(Number) + * @since 18.0 */ public Number getOutlineWidth() { return outlineWidth; @@ -214,6 +226,8 @@ public Number getOutlineWidth() { * The width of the line marking the currently zoomed area in the navigator. *

    * Defaults to: 2 + * + * @since 18.0 */ public void setOutlineWidth(Number outlineWidth) { this.outlineWidth = outlineWidth; @@ -257,6 +271,8 @@ public AbstractPlotOptions getSeries() { * } * } * + * + * @since 24.7 */ public void setSeries(AbstractPlotOptions series) { this.series = series; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/NoData.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/NoData.java index 06b30b497a4..d5f2720d390 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/NoData.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/NoData.java @@ -15,6 +15,8 @@ * requires the file no-data-to-display.js to be loaded in the * page. The actual text to display is set in the * lang.noData option. + * + * @since 6.0.1 */ public class NoData extends AbstractConfigurationObject { @@ -47,6 +49,7 @@ public void setPosition(Position position) { /** * @see #setStyle(Style) + * @since 18.0 */ public Style getStyle() { if (style == null) { @@ -60,6 +63,8 @@ public Style getStyle() { *

    * Defaults to: { "fontSize": "12px", "fontWeight": "bold", "color": * "#666666" } + * + * @since 18.0 */ public void setStyle(Style style) { this.style = style; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Node.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Node.java index eb581a61785..bb7b1533c3d 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Node.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Node.java @@ -18,6 +18,8 @@ * A collection of options for the individual nodes. The nodes in an org chart * are auto-generated instances of Highcharts.Point, but options can be applied * here and linked by the id. + * + * @since 18.0 */ @JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id") public class Node extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/NodeLayout.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/NodeLayout.java index e7bd43dee03..a5048dafd10 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/NodeLayout.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/NodeLayout.java @@ -12,6 +12,7 @@ /** * @see Node#setLayout(NodeLayout) + * @since 18.0 */ public enum NodeLayout implements ChartEnum { NORMAL, HANGING; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/NodeSeries.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/NodeSeries.java index 5404973e500..fd419bbf6d5 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/NodeSeries.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/NodeSeries.java @@ -18,6 +18,8 @@ /** * A series containing nodes and links to nodes. + * + * @since 18.0 */ @JsonPropertyOrder({ "nodes", "values" }) public class NodeSeries extends AbstractSeries { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/NodeSeriesItem.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/NodeSeriesItem.java index f0bf5abd56e..443f05496dd 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/NodeSeriesItem.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/NodeSeriesItem.java @@ -14,6 +14,8 @@ /** * Data for the {@link NodeSeries}. Represents a link between the from and to * nodes. + * + * @since 18.0 */ public class NodeSeriesItem extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/OhlcItem.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/OhlcItem.java index f0a9dadea2b..16d6556db64 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/OhlcItem.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/OhlcItem.java @@ -18,6 +18,7 @@ * @see PlotOptionsOhlc * @see PlotOptionsCandlestick * + * @since 6.0.1 */ public class OhlcItem extends DataSeriesItem { // high/low already defined in DataSeriesItem diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/OhlcOptions.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/OhlcOptions.java index e15c3389274..dc88736b5e9 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/OhlcOptions.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/OhlcOptions.java @@ -12,6 +12,9 @@ import com.vaadin.flow.component.charts.model.style.Color; +/** + * @since 6.0.1 + */ public abstract class OhlcOptions extends AbstractPlotOptions { @Override @@ -71,16 +74,20 @@ public abstract class OhlcOptions extends AbstractPlotOptions { /** * @see #setClip(Boolean) + * @since 18.0 */ public abstract Boolean getClip(); /** * Disable this option to allow series rendering in the whole plotting area. + * + * @since 18.0 */ public abstract void setClip(Boolean clip); /** * @see #setColorByPoint(Boolean) + * @since 18.0 */ public abstract Boolean getColorByPoint(); @@ -94,6 +101,8 @@ public abstract class OhlcOptions extends AbstractPlotOptions { * arrays are not supported, and instead this option gives the points * individual color class names on the form * highcharts-color-{n}. + * + * @since 18.0 */ public abstract void setColorByPoint(Boolean colorByPoint); @@ -111,6 +120,7 @@ public abstract class OhlcOptions extends AbstractPlotOptions { /** * @see #setColorKey(String) + * @since 18.0 */ public abstract String getColorKey(); @@ -119,17 +129,22 @@ public abstract class OhlcOptions extends AbstractPlotOptions { * colorAxis is used. Requires to set min and * max if some custom point property is used or if * approximation for data grouping is set to 'sum'. + * + * @since 18.0 */ public abstract void setColorKey(String colorKey); /** * @see #setColors(Color...) + * @since 18.0 */ public abstract Color[] getColors(); /** * A series specific or series type specific color set to apply instead of * the theme colors. + * + * @since 18.0 */ public abstract void setColors(Color... colors); @@ -139,6 +154,7 @@ public abstract class OhlcOptions extends AbstractPlotOptions { * @param color * to add * @see #setColors(Color...) + * @since 18.0 */ public abstract void addColor(Color color); @@ -148,6 +164,7 @@ public abstract class OhlcOptions extends AbstractPlotOptions { * @param color * to remove * @see #setColors(Color...) + * @since 18.0 */ public abstract void removeColor(Color color); @@ -351,11 +368,14 @@ public abstract class OhlcOptions extends AbstractPlotOptions { /** * @see #setLineWidth(Number) + * @since 18.0 */ public abstract Number getLineWidth(); /** * The pixel width of the candlestick line/border. + * + * @since 18.0 */ public abstract void setLineWidth(Number lineWidth); @@ -411,11 +431,14 @@ public abstract void setNavigatorOptions( /** * @see #setOpacity(Number) + * @since 18.0 */ public abstract Number getOpacity(); /** * Opacity of a series parts: line, fill (e.g. area) and dataLabels. + * + * @since 18.0 */ public abstract void setOpacity(Number opacity); @@ -684,11 +707,14 @@ public abstract void setSkipKeyboardNavigation( /** * @see #setUpColor(Color) + * @since 18.0 */ public abstract Color getUpColor(); /** * Line color for up points. + * + * @since 18.0 */ public abstract void setUpColor(Color upColor); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Options3d.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Options3d.java index 836f5aa4d4d..842799bb93f 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Options3d.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Options3d.java @@ -13,6 +13,8 @@ * highcharts-3d.js, found in the download package or online at * code.highcharts.com/ * highcharts-3d.js. + * + * @since 6.0.1 */ public class Options3d extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PanKey.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PanKey.java index 2d0cbb82ef2..3b5569cf29e 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PanKey.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PanKey.java @@ -14,6 +14,8 @@ * (event.altKey, event.ctrlKey, event.metaKey and event.shiftKey). * * Defaults to undefined. + * + * @since 6.0.1 */ public enum PanKey implements ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Pane.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Pane.java index 353a0d8abff..1d032131d56 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Pane.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Pane.java @@ -15,6 +15,8 @@ * Applies only to polar charts and angular gauges. This configuration object * holds general options for the combined X and Y axes set. Each xAxis or yAxis * can reference the pane by index. + * + * @since 6.0.1 */ public class Pane extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PaneList.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PaneList.java index 5f8dbd0b759..f8c40312cc8 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PaneList.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PaneList.java @@ -13,6 +13,8 @@ /** * Pane Container to allow multiple Panes + * + * @since 6.0.1 */ public class PaneList extends AbstractConfigurationObject { private final List paneList = new ArrayList<>(); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PartialFill.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PartialFill.java index b2bfecea2b5..d25af704d0b 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PartialFill.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PartialFill.java @@ -13,6 +13,8 @@ /** * PartialFill configuration object to be used in {@link PlotOptionsXrange}. * Typically used to visualize how much of a task is performed. + * + * @since 18.0 */ public class PartialFill extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PathfinderType.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PathfinderType.java index bcf8fa057f3..363eec5018b 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PathfinderType.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PathfinderType.java @@ -11,6 +11,8 @@ /** * Pathfinder algorithm to use for chart that can connect two points (e.g. * series items). + * + * @since 24.7 */ public enum PathfinderType implements ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Pivot.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Pivot.java index 703f802570e..bd04c3a9a29 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Pivot.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Pivot.java @@ -21,6 +21,8 @@ * >styled mode, the pivot is styled with the * .highcharts-gauge-series .highcharts-pivot rule. *

    + * + * @since 6.0.1 */ public class Pivot extends AbstractConfigurationObject { @@ -34,6 +36,7 @@ public Pivot() { /** * @see #setBackgroundColor(Color) + * @since 18.0 */ public Color getBackgroundColor() { return backgroundColor; @@ -43,6 +46,8 @@ public Color getBackgroundColor() { * The background color or fill of the pivot. *

    * Defaults to: #000000 + * + * @since 18.0 */ public void setBackgroundColor(Color backgroundColor) { this.backgroundColor = backgroundColor; @@ -50,6 +55,7 @@ public void setBackgroundColor(Color backgroundColor) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -60,6 +66,8 @@ public Color getBorderColor() { * borderWidth must also be set to something other than the default 0. *

    * Defaults to: #cccccc + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -67,6 +75,7 @@ public void setBorderColor(Color borderColor) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -76,6 +85,8 @@ public Number getBorderWidth() { * The border or stroke width of the pivot. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotBand.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotBand.java index 3ed4c5483f7..8cb3a033372 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotBand.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotBand.java @@ -15,6 +15,8 @@ /** * An array of objects defining plot bands on the Y axis. + * + * @since 6.0.1 */ public class PlotBand extends AbstractConfigurationObject { @@ -36,6 +38,7 @@ public PlotBand() { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -46,6 +49,8 @@ public Color getBorderColor() { * be set. *

    * Defaults to: null + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -53,6 +58,7 @@ public void setBorderColor(Color borderColor) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -63,6 +69,8 @@ public Number getBorderWidth() { * be set. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; @@ -85,6 +93,7 @@ public void setClassName(String className) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -92,6 +101,8 @@ public Color getColor() { /** * The color of the plot band. + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotLine.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotLine.java index 3a05ad0dfe5..2a29ee344a5 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotLine.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotLine.java @@ -23,6 +23,8 @@ * .highcharts-plot-line class in addition to the * className option. *

    + * + * @since 6.0.1 */ public class PlotLine extends AbstractConfigurationObject { @@ -55,6 +57,7 @@ public void setClassName(String className) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -62,6 +65,8 @@ public Color getColor() { /** * The color of the line. + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -69,6 +74,7 @@ public void setColor(Color color) { /** * @see #setDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getDashStyle() { return dashStyle; @@ -81,6 +87,8 @@ public DashStyle getDashStyle() { * >this overview. *

    * Defaults to: Solid + * + * @since 18.0 */ public void setDashStyle(DashStyle dashStyle) { this.dashStyle = dashStyle; @@ -133,6 +141,7 @@ public void setValue(Number value) { /** * @see #setWidth(Number) + * @since 18.0 */ public Number getWidth() { return width; @@ -140,6 +149,8 @@ public Number getWidth() { /** * The width or thickness of the plot line. + * + * @since 18.0 */ public void setWidth(Number width) { this.width = width; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsArea.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsArea.java index 9538f06b8fa..23c4bab123a 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsArea.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsArea.java @@ -15,6 +15,9 @@ import com.vaadin.flow.component.charts.model.style.Color; import com.vaadin.flow.component.charts.util.Util; +/** + * @since 6.0.1 + */ public class PlotOptionsArea extends AreaOptions { private Boolean allowPointSelect; @@ -156,6 +159,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -166,6 +170,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -173,6 +179,7 @@ public void setClip(Boolean clip) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -197,6 +204,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -222,6 +231,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -234,6 +244,8 @@ public String getColorKey() { * set to 'sum'. *

    * Defaults to y. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -284,6 +296,8 @@ public Boolean getCrisp() { * look better, even though each column is rendered blurry. *

    * Defaults to true. + * + * @since 18.0 */ public void setCrisp(Boolean crisp) { this.crisp = crisp; @@ -330,6 +344,7 @@ public void setCursor(Cursor cursor) { /** * @see #setDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getDashStyle() { return dashStyle; @@ -355,6 +370,8 @@ public DashStyle getDashStyle() { * *

    * Defaults to: Solid + * + * @since 18.0 */ public void setDashStyle(DashStyle dashStyle) { this.dashStyle = dashStyle; @@ -456,6 +473,7 @@ public void setExposeElementToA11y(Boolean exposeElementToA11y) { /** * @see #setFillColor(Color) + * @since 18.0 */ public Color getFillColor() { return fillColor; @@ -464,6 +482,8 @@ public Color getFillColor() { /** * Fill color or gradient for the area. When null, the series' * color is used with the series' fillOpacity. + * + * @since 18.0 */ public void setFillColor(Color fillColor) { this.fillColor = fillColor; @@ -471,6 +491,7 @@ public void setFillColor(Color fillColor) { /** * @see #setFillOpacity(Number) + * @since 18.0 */ public Number getFillOpacity() { return fillOpacity; @@ -485,6 +506,8 @@ public Number getFillOpacity() { * setting. *

    * Defaults to: 0.75 + * + * @since 18.0 */ public void setFillOpacity(Number fillOpacity) { this.fillOpacity = fillOpacity; @@ -580,6 +603,7 @@ public void removeKey(String key) { /** * @see #setLineColor(Color) + * @since 18.0 */ public Color getLineColor() { return lineColor; @@ -590,6 +614,8 @@ public Color getLineColor() { * color of the series, but the lineColor setting allows * setting a separate color for the line without altering the * fillColor. + * + * @since 18.0 */ public void setLineColor(Color lineColor) { this.lineColor = lineColor; @@ -597,6 +623,7 @@ public void setLineColor(Color lineColor) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -606,6 +633,8 @@ public Number getLineWidth() { * Pixel with of the graph line. *

    * Defaults to: 2 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -677,6 +706,7 @@ public void setMarker(Marker marker) { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public Color getNegativeColor() { return negativeColor; @@ -687,6 +717,8 @@ public Color getNegativeColor() { * threshold. *

    * Defaults to: null + * + * @since 18.0 */ public void setNegativeColor(Color negativeColor) { this.negativeColor = negativeColor; @@ -694,6 +726,7 @@ public void setNegativeColor(Color negativeColor) { /** * @see #setNegativeFillColor(Color) + * @since 18.0 */ public Color getNegativeFillColor() { return negativeFillColor; @@ -701,6 +734,8 @@ public Color getNegativeFillColor() { /** * A separate color for the negative part of the area. + * + * @since 18.0 */ public void setNegativeFillColor(Color negativeFillColor) { this.negativeFillColor = negativeFillColor; @@ -708,6 +743,7 @@ public void setNegativeFillColor(Color negativeFillColor) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -717,6 +753,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsArearange.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsArearange.java index 2fd0057c48c..b5f36108d90 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsArearange.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsArearange.java @@ -18,6 +18,8 @@ /** * The area range is a cartesian series type with higher and lower Y values * along an X axis. Requires highcharts-more.js. + * + * @since 6.0.1 */ public class PlotOptionsArearange extends AreaOptions { @@ -157,6 +159,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -167,6 +170,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -174,6 +179,7 @@ public void setClip(Boolean clip) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -198,6 +204,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -223,6 +231,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -235,6 +244,8 @@ public String getColorKey() { * approximation for data grouping is set to 'sum'. *

    * Defaults to low. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -258,6 +269,7 @@ public void setConnectNulls(Boolean connectNulls) { /** * @see #setCrisp(Boolean) + * @since 18.0 */ public Boolean getCrisp() { return crisp; @@ -272,6 +284,8 @@ public Boolean getCrisp() { * rendered blurry. *

    * Defaults to true. + * + * @since 18.0 */ public void setCrisp(Boolean crisp) { this.crisp = crisp; @@ -318,6 +332,7 @@ public void setCursor(Cursor cursor) { /** * @see #setDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getDashStyle() { return dashStyle; @@ -343,6 +358,8 @@ public DashStyle getDashStyle() { * *

    * Defaults to: Solid + * + * @since 18.0 */ public void setDashStyle(DashStyle dashStyle) { this.dashStyle = dashStyle; @@ -436,6 +453,7 @@ public void setExposeElementToA11y(Boolean exposeElementToA11y) { /** * @see #setFillColor(Color) + * @since 18.0 */ public Color getFillColor() { return fillColor; @@ -444,6 +462,8 @@ public Color getFillColor() { /** * Fill color or gradient for the area. When null, the series' * color is used with the series' fillOpacity. + * + * @since 18.0 */ public void setFillColor(Color fillColor) { this.fillColor = fillColor; @@ -451,6 +471,7 @@ public void setFillColor(Color fillColor) { /** * @see #setFillOpacity(Number) + * @since 18.0 */ public Number getFillOpacity() { return fillOpacity; @@ -465,6 +486,8 @@ public Number getFillOpacity() { * setting. *

    * Defaults to: 0.75 + * + * @since 18.0 */ public void setFillOpacity(Number fillOpacity) { this.fillOpacity = fillOpacity; @@ -560,6 +583,7 @@ public void removeKey(String key) { /** * @see #setLineColor(Color) + * @since 18.0 */ public Color getLineColor() { return lineColor; @@ -570,6 +594,8 @@ public Color getLineColor() { * color of the series, but the lineColor setting allows * setting a separate color for the line without altering the * fillColor. + * + * @since 18.0 */ public void setLineColor(Color lineColor) { this.lineColor = lineColor; @@ -577,6 +603,7 @@ public void setLineColor(Color lineColor) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -586,6 +613,8 @@ public Number getLineWidth() { * Pixel width of the arearange graph line. *

    * Defaults to: 1 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -626,6 +655,7 @@ public void setLinkedTo(String linkedTo) { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public Color getNegativeColor() { return negativeColor; @@ -636,6 +666,8 @@ public Color getNegativeColor() { * threshold. *

    * Defaults to: null + * + * @since 18.0 */ public void setNegativeColor(Color negativeColor) { this.negativeColor = negativeColor; @@ -643,6 +675,7 @@ public void setNegativeColor(Color negativeColor) { /** * @see #setNegativeFillColor(Color) + * @since 18.0 */ public Color getNegativeFillColor() { return negativeFillColor; @@ -650,6 +683,8 @@ public Color getNegativeFillColor() { /** * A separate color for the negative part of the area. + * + * @since 18.0 */ public void setNegativeFillColor(Color negativeFillColor) { this.negativeFillColor = negativeFillColor; @@ -657,6 +692,7 @@ public void setNegativeFillColor(Color negativeFillColor) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -666,6 +702,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsAreaspline.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsAreaspline.java index 4072ffd0822..7f2c0701bfa 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsAreaspline.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsAreaspline.java @@ -15,6 +15,9 @@ import com.vaadin.flow.component.charts.model.style.Color; import com.vaadin.flow.component.charts.util.Util; +/** + * @since 6.0.1 + */ public class PlotOptionsAreaspline extends AreaOptions { private Boolean allowPointSelect; @@ -155,6 +158,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -165,6 +169,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -172,6 +178,7 @@ public void setClip(Boolean clip) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -196,6 +203,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -221,6 +230,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -233,6 +243,8 @@ public String getColorKey() { * approximation for data grouping is set to 'sum'. *

    * Defaults to y. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -273,6 +285,7 @@ public void setConnectNulls(Boolean connectNulls) { /** * @see #setCrisp(Boolean) + * @since 18.0 */ public Boolean getCrisp() { return crisp; @@ -287,6 +300,8 @@ public Boolean getCrisp() { * rendered blurry. *

    * Defaults to true. + * + * @since 18.0 */ public void setCrisp(Boolean crisp) { this.crisp = crisp; @@ -333,6 +348,7 @@ public void setCursor(Cursor cursor) { /** * @see #setDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getDashStyle() { return dashStyle; @@ -358,6 +374,8 @@ public DashStyle getDashStyle() { * *

    * Defaults to: Solid + * + * @since 18.0 */ public void setDashStyle(DashStyle dashStyle) { this.dashStyle = dashStyle; @@ -459,6 +477,7 @@ public void setExposeElementToA11y(Boolean exposeElementToA11y) { /** * @see #setFillColor(Color) + * @since 18.0 */ public Color getFillColor() { return fillColor; @@ -467,6 +486,8 @@ public Color getFillColor() { /** * Fill color or gradient for the area. When null, the series' * color is used with the series' fillOpacity. + * + * @since 18.0 */ public void setFillColor(Color fillColor) { this.fillColor = fillColor; @@ -474,6 +495,7 @@ public void setFillColor(Color fillColor) { /** * @see #setFillOpacity(Number) + * @since 18.0 */ public Number getFillOpacity() { return fillOpacity; @@ -488,6 +510,8 @@ public Number getFillOpacity() { * setting. *

    * Defaults to: 0.75 + * + * @since 18.0 */ public void setFillOpacity(Number fillOpacity) { this.fillOpacity = fillOpacity; @@ -583,6 +607,7 @@ public void removeKey(String key) { /** * @see #setLineColor(Color) + * @since 18.0 */ public Color getLineColor() { return lineColor; @@ -593,6 +618,8 @@ public Color getLineColor() { * color of the series, but the lineColor setting allows * setting a separate color for the line without altering the * fillColor. + * + * @since 18.0 */ public void setLineColor(Color lineColor) { this.lineColor = lineColor; @@ -600,6 +627,7 @@ public void setLineColor(Color lineColor) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -609,6 +637,8 @@ public Number getLineWidth() { * Pixel with of the graph line. *

    * Defaults to: 2 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -680,6 +710,7 @@ public void setMarker(Marker marker) { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public Color getNegativeColor() { return negativeColor; @@ -690,6 +721,8 @@ public Color getNegativeColor() { * threshold. *

    * Defaults to: null + * + * @since 18.0 */ public void setNegativeColor(Color negativeColor) { this.negativeColor = negativeColor; @@ -697,6 +730,7 @@ public void setNegativeColor(Color negativeColor) { /** * @see #setNegativeFillColor(Color) + * @since 18.0 */ public Color getNegativeFillColor() { return negativeFillColor; @@ -704,6 +738,8 @@ public Color getNegativeFillColor() { /** * A separate color for the negative part of the area. + * + * @since 18.0 */ public void setNegativeFillColor(Color negativeFillColor) { this.negativeFillColor = negativeFillColor; @@ -711,6 +747,7 @@ public void setNegativeFillColor(Color negativeFillColor) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -720,6 +757,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsAreasplinerange.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsAreasplinerange.java index 8a73503744e..ff9defc476c 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsAreasplinerange.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsAreasplinerange.java @@ -18,6 +18,8 @@ /** * The area spline range is a cartesian series type with higher and lower Y * values along an X axis. Requires highcharts-more.js. + * + * @since 6.0.1 */ public class PlotOptionsAreasplinerange extends AreaOptions { @@ -155,6 +157,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -165,6 +168,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set. *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -172,6 +177,7 @@ public void setClip(Boolean clip) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -196,6 +202,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -221,6 +229,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -233,6 +242,8 @@ public String getColorKey() { * approximation for data grouping is set to 'sum'. *

    * Defaults to low. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -256,6 +267,7 @@ public void setConnectNulls(Boolean connectNulls) { /** * @see #setCrisp(Boolean) + * @since 18.0 */ public Boolean getCrisp() { return crisp; @@ -270,6 +282,8 @@ public Boolean getCrisp() { * rendered blurry. *

    * Defaults to true. + * + * @since 18.0 */ public void setCrisp(Boolean crisp) { this.crisp = crisp; @@ -316,6 +330,7 @@ public void setCursor(Cursor cursor) { /** * @see #setDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getDashStyle() { return dashStyle; @@ -341,6 +356,8 @@ public DashStyle getDashStyle() { * *

    * Defaults to: Solid + * + * @since 18.0 */ public void setDashStyle(DashStyle dashStyle) { this.dashStyle = dashStyle; @@ -434,6 +451,7 @@ public void setExposeElementToA11y(Boolean exposeElementToA11y) { /** * @see #setFillColor(Color) + * @since 18.0 */ public Color getFillColor() { return fillColor; @@ -442,6 +460,8 @@ public Color getFillColor() { /** * Fill color or gradient for the area. When null, the series' * color is used with the series' fillOpacity. + * + * @since 18.0 */ public void setFillColor(Color fillColor) { this.fillColor = fillColor; @@ -449,6 +469,7 @@ public void setFillColor(Color fillColor) { /** * @see #setFillOpacity(Number) + * @since 18.0 */ public Number getFillOpacity() { return fillOpacity; @@ -463,6 +484,8 @@ public Number getFillOpacity() { * setting. *

    * Defaults to: 0.75 + * + * @since 18.0 */ public void setFillOpacity(Number fillOpacity) { this.fillOpacity = fillOpacity; @@ -558,6 +581,7 @@ public void removeKey(String key) { /** * @see #setLineColor(Color) + * @since 18.0 */ public Color getLineColor() { return lineColor; @@ -568,6 +592,8 @@ public Color getLineColor() { * color of the series, but the lineColor setting allows * setting a separate color for the line without altering the * fillColor. + * + * @since 18.0 */ public void setLineColor(Color lineColor) { this.lineColor = lineColor; @@ -575,6 +601,7 @@ public void setLineColor(Color lineColor) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -584,6 +611,8 @@ public Number getLineWidth() { * Pixel width of the arearange graph line. *

    * Defaults to: 1 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -624,6 +653,7 @@ public void setLinkedTo(String linkedTo) { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public Color getNegativeColor() { return negativeColor; @@ -634,6 +664,8 @@ public Color getNegativeColor() { * threshold. *

    * Defaults to: null + * + * @since 18.0 */ public void setNegativeColor(Color negativeColor) { this.negativeColor = negativeColor; @@ -641,6 +673,7 @@ public void setNegativeColor(Color negativeColor) { /** * @see #setNegativeFillColor(Color) + * @since 18.0 */ public Color getNegativeFillColor() { return negativeFillColor; @@ -648,6 +681,8 @@ public Color getNegativeFillColor() { /** * A separate color for the negative part of the area. + * + * @since 18.0 */ public void setNegativeFillColor(Color negativeFillColor) { this.negativeFillColor = negativeFillColor; @@ -655,6 +690,7 @@ public void setNegativeFillColor(Color negativeFillColor) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -664,6 +700,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsBar.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsBar.java index 3ab56513ee9..7fe0d1f2b0f 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsBar.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsBar.java @@ -15,6 +15,9 @@ import com.vaadin.flow.component.charts.model.style.Color; import com.vaadin.flow.component.charts.util.Util; +/** + * @since 6.0.1 + */ public class PlotOptionsBar extends ColumnOptions { private Boolean allowPointSelect; @@ -137,6 +140,7 @@ public void setAnimationLimit(Number animationLimit) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -155,6 +159,8 @@ public Color getBorderColor() { *

    *

    * Defaults to: #ffffff + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -178,6 +184,7 @@ public void setBorderRadius(Number borderRadius) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -196,6 +203,8 @@ public Number getBorderWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; @@ -203,6 +212,7 @@ public void setBorderWidth(Number borderWidth) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -213,6 +223,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -234,6 +246,7 @@ public void setClassName(String className) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -258,6 +271,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -283,6 +298,7 @@ public void setColorByPoint(Boolean colorByPoint) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -295,6 +311,8 @@ public String getColorKey() { * approximation for data grouping is set to 'sum'. *

    * Defaults to y. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -320,6 +338,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColors(Color...) + * @since 18.0 */ public Color[] getColors() { if (colors == null) { @@ -334,6 +353,8 @@ public Color[] getColors() { * A series specific or series type specific color set to apply instead of * the global colors when * colorByPoint is true. + * + * @since 18.0 */ public void setColors(Color... colors) { this.colors = new ArrayList(Arrays.asList(colors)); @@ -345,6 +366,7 @@ public void setColors(Color... colors) { * @param color * to add * @see #setColors(Color...) + * @since 18.0 */ public void addColor(Color color) { if (this.colors == null) { @@ -359,6 +381,7 @@ public void addColor(Color color) { * @param color * to remove * @see #setColors(Color...) + * @since 18.0 */ public void removeColor(Color color) { this.colors.remove(color); @@ -479,6 +502,7 @@ public void setDescription(String description) { /** * @see #setEdgeColor(Color) + * @since 18.0 */ public Color getEdgeColor() { return edgeColor; @@ -488,6 +512,8 @@ public Color getEdgeColor() { * 3D columns only. The color of the edges. Similar to * borderColor, except it defaults to the same color as the * column. + * + * @since 18.0 */ public void setEdgeColor(Color edgeColor) { this.edgeColor = edgeColor; @@ -710,6 +736,7 @@ public void setLinkedTo(String linkedTo) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -719,6 +746,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; @@ -763,6 +792,7 @@ public void setMinPointLength(Number minPointLength) { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public Color getNegativeColor() { return negativeColor; @@ -773,6 +803,8 @@ public Color getNegativeColor() { * threshold. *

    * Defaults to: null + * + * @since 18.0 */ public void setNegativeColor(Color negativeColor) { this.negativeColor = negativeColor; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsBoxplot.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsBoxplot.java index 51c6cfebb9c..7d3ea1a3e98 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsBoxplot.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsBoxplot.java @@ -20,6 +20,8 @@ * five-number summaries: the smallest observation (sample minimum), lower * quartile (Q1), median (Q2), upper quartile (Q3), and largest observation * (sample maximum). + * + * @since 6.0.1 */ public class PlotOptionsBoxplot extends AbstractPlotOptions { @@ -139,6 +141,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -149,6 +152,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set. *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -156,6 +161,7 @@ public void setClip(Boolean clip) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -180,6 +186,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -223,6 +231,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -235,6 +244,8 @@ public String getColorKey() { * grouping is set to 'sum'. *

    * Defaults to high. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -242,6 +253,7 @@ public void setColorKey(String colorKey) { /** * @see #setColors(Color...) + * @since 18.0 */ public Color[] getColors() { if (colors == null) { @@ -256,6 +268,8 @@ public Color[] getColors() { * A series specific or series type specific color set to apply instead of * the global colors when * colorByPoint is true. + * + * @since 18.0 */ public void setColors(Color... colors) { this.colors = new ArrayList(Arrays.asList(colors)); @@ -267,6 +281,7 @@ public void setColors(Color... colors) { * @param color * to add * @see #setColors(Color...) + * @since 18.0 */ public void addColor(Color color) { if (this.colors == null) { @@ -281,6 +296,7 @@ public void addColor(Color color) { * @param color * to remove * @see #setColors(Color...) + * @since 18.0 */ public void removeColor(Color color) { this.colors.remove(color); @@ -364,6 +380,7 @@ public void setDescription(String description) { /** * @see #setEdgeColor(Color) + * @since 18.0 */ public Color getEdgeColor() { return edgeColor; @@ -373,6 +390,8 @@ public Color getEdgeColor() { * 3D columns only. The color of the edges. Similar to * borderColor, except it defaults to the same color as the * column. + * + * @since 18.0 */ public void setEdgeColor(Color edgeColor) { this.edgeColor = edgeColor; @@ -439,6 +458,7 @@ public void setExposeElementToA11y(Boolean exposeElementToA11y) { /** * @see #setFillColor(Color) + * @since 18.0 */ public Color getFillColor() { return fillColor; @@ -448,6 +468,8 @@ public Color getFillColor() { * The fill color of the box. *

    * Defaults to: #ffffff + * + * @since 18.0 */ public void setFillColor(Color fillColor) { this.fillColor = fillColor; @@ -594,6 +616,7 @@ public void removeKey(String key) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -607,6 +630,8 @@ public Number getLineWidth() { * null, the lineWidth also applies to these lines. *

    * Defaults to: 1 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -649,6 +674,7 @@ public void setMaxPointWidth(Number maxPointWidth) { /** * @see #setMedianColor(Color) + * @since 18.0 */ public Color getMedianColor() { return medianColor; @@ -659,6 +685,8 @@ public Color getMedianColor() { * color applies. *

    * Defaults to: null + * + * @since 18.0 */ public void setMedianColor(Color medianColor) { this.medianColor = medianColor; @@ -683,6 +711,7 @@ public void setMedianWidth(Number medianWidth) { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public Color getNegativeColor() { return negativeColor; @@ -693,6 +722,8 @@ public Color getNegativeColor() { * threshold. *

    * Defaults to: null + * + * @since 18.0 */ public void setNegativeColor(Color negativeColor) { this.negativeColor = negativeColor; @@ -700,6 +731,7 @@ public void setNegativeColor(Color negativeColor) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -709,6 +741,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; @@ -963,6 +997,7 @@ public void setStates(States states) { /** * @see #setStemColor(Color) + * @since 18.0 */ public Color getStemColor() { return stemColor; @@ -973,6 +1008,8 @@ public Color getStemColor() { * whiskers. If null, the series color is used. *

    * Defaults to: null + * + * @since 18.0 */ public void setStemColor(Color stemColor) { this.stemColor = stemColor; @@ -980,6 +1017,7 @@ public void setStemColor(Color stemColor) { /** * @see #setStemDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getStemDashStyle() { return stemDashStyle; @@ -990,6 +1028,8 @@ public DashStyle getStemDashStyle() { * the whiskers. *

    * Defaults to: Solid + * + * @since 18.0 */ public void setStemDashStyle(DashStyle stemDashStyle) { this.stemDashStyle = stemDashStyle; @@ -997,6 +1037,7 @@ public void setStemDashStyle(DashStyle stemDashStyle) { /** * @see #setStemWidth(Number) + * @since 18.0 */ public Number getStemWidth() { return stemWidth; @@ -1008,6 +1049,8 @@ public Number getStemWidth() { * lineWidth option. *

    * Defaults to: null + * + * @since 18.0 */ public void setStemWidth(Number stemWidth) { this.stemWidth = stemWidth; @@ -1094,6 +1137,7 @@ public void setVisible(Boolean visible) { /** * @see #setWhiskerColor(Color) + * @since 18.0 */ public Color getWhiskerColor() { return whiskerColor; @@ -1104,6 +1148,8 @@ public Color getWhiskerColor() { * values. When null, the general series color is used. *

    * Defaults to: null + * + * @since 18.0 */ public void setWhiskerColor(Color whiskerColor) { this.whiskerColor = whiskerColor; @@ -1129,6 +1175,7 @@ public void setWhiskerLength(String whiskerLength) { /** * @see #setWhiskerWidth(Number) + * @since 18.0 */ public Number getWhiskerWidth() { return whiskerWidth; @@ -1140,6 +1187,8 @@ public Number getWhiskerWidth() { * lineWidth applies. *

    * Defaults to: 2 + * + * @since 18.0 */ public void setWhiskerWidth(Number whiskerWidth) { this.whiskerWidth = whiskerWidth; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsBubble.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsBubble.java index c0b8921234d..d7dc1c5a280 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsBubble.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsBubble.java @@ -20,6 +20,8 @@ * an X, Y and Z value. Each points is drawn as a bubble where the position * along the X and Y axes mark the X and Y values, and the size of the bubble * relates to the Z value. Requires highcharts-more.js. + * + * @since 6.0.1 */ public class PlotOptionsBubble extends AbstractPlotOptions { @@ -149,6 +151,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -159,6 +162,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set. *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -166,6 +171,7 @@ public void setClip(Boolean clip) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -190,6 +196,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -215,6 +223,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -227,6 +236,8 @@ public String getColorKey() { * approximation for data grouping is set to 'sum'. *

    * Defaults to z. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -234,6 +245,7 @@ public void setColorKey(String colorKey) { /** * @see #setCrisp(Boolean) + * @since 18.0 */ public Boolean getCrisp() { return crisp; @@ -248,6 +260,8 @@ public Boolean getCrisp() { * rendered blurry. *

    * Defaults to true. + * + * @since 18.0 */ public void setCrisp(Boolean crisp) { this.crisp = crisp; @@ -294,6 +308,7 @@ public void setCursor(Cursor cursor) { /** * @see #setDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getDashStyle() { return dashStyle; @@ -319,6 +334,8 @@ public DashStyle getDashStyle() { * *

    * Defaults to: Solid + * + * @since 18.0 */ public void setDashStyle(DashStyle dashStyle) { this.dashStyle = dashStyle; @@ -527,6 +544,7 @@ public void removeKey(String key) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -536,6 +554,8 @@ public Number getLineWidth() { * The width of the line connecting the data points. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -631,6 +651,7 @@ public void setMinSize(String minSize) { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public Color getNegativeColor() { return negativeColor; @@ -642,6 +663,8 @@ public Color getNegativeColor() { * color is used. *

    * Defaults to: null + * + * @since 18.0 */ public void setNegativeColor(Color negativeColor) { this.negativeColor = negativeColor; @@ -649,6 +672,7 @@ public void setNegativeColor(Color negativeColor) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -658,6 +682,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsBullet.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsBullet.java index 827a983768f..7ce2e0f0b0c 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsBullet.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsBullet.java @@ -17,6 +17,8 @@ /** * Plot options for {@link ChartType#BULLET} charts. + * + * @since 18.0 */ public class PlotOptionsBullet extends AbstractPlotOptions { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsCandlestick.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsCandlestick.java index e6dfc535d74..2876bfcad58 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsCandlestick.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsCandlestick.java @@ -17,6 +17,7 @@ /** * + * @since 6.0.1 */ public class PlotOptionsCandlestick extends OhlcOptions { @@ -154,6 +155,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -164,6 +166,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -171,6 +175,7 @@ public void setClip(Boolean clip) { /** * @see #setColorByPoint(Boolean) + * @since 18.0 */ public Boolean getColorByPoint() { return colorByPoint; @@ -188,6 +193,8 @@ public Boolean getColorByPoint() { * highcharts-color-{n}. *

    * Defaults to false. + * + * @since 18.0 */ public void setColorByPoint(Boolean colorByPoint) { this.colorByPoint = colorByPoint; @@ -195,6 +202,7 @@ public void setColorByPoint(Boolean colorByPoint) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -219,6 +227,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -244,6 +254,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -256,6 +267,8 @@ public String getColorKey() { * approximation for data grouping is set to 'sum'. *

    * Defaults to close. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -263,6 +276,7 @@ public void setColorKey(String colorKey) { /** * @see #setColors(Color...) + * @since 18.0 */ public Color[] getColors() { if (colors == null) { @@ -277,6 +291,8 @@ public Color[] getColors() { * A series specific or series type specific color set to apply instead of * the global colors when * colorByPoint is true. + * + * @since 18.0 */ public void setColors(Color... colors) { this.colors = new ArrayList(Arrays.asList(colors)); @@ -288,6 +304,7 @@ public void setColors(Color... colors) { * @param color * to add * @see #setColors(Color...) + * @since 18.0 */ public void addColor(Color color) { if (this.colors == null) { @@ -302,6 +319,7 @@ public void addColor(Color color) { * @param color * to remove * @see #setColors(Color...) + * @since 18.0 */ public void removeColor(Color color) { this.colors.remove(color); @@ -601,6 +619,7 @@ public void setLegendIndex(Number legendIndex) { /** * @see #setLineColor(Color) + * @since 18.0 */ public Color getLineColor() { return lineColor; @@ -619,6 +638,8 @@ public Color getLineColor() { *

    *

    * Defaults to: #000000 + * + * @since 18.0 */ public void setLineColor(Color lineColor) { this.lineColor = lineColor; @@ -626,6 +647,7 @@ public void setLineColor(Color lineColor) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -645,6 +667,8 @@ public Number getLineWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -734,6 +758,7 @@ public void setNavigatorOptions(PlotOptionsSeries navigatorOptions) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -743,6 +768,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; @@ -750,6 +777,7 @@ public void setOpacity(Number opacity) { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public Color getNegativeColor() { return negativeColor; @@ -760,6 +788,8 @@ public Color getNegativeColor() { * threshold. *

    * Defaults to: null + * + * @since 18.0 */ public void setNegativeColor(Color negativeColor) { this.negativeColor = negativeColor; @@ -1166,6 +1196,7 @@ public void setTurboThreshold(Number turboThreshold) { /** * @see #setUpColor(Color) + * @since 18.0 */ public Color getUpColor() { return upColor; @@ -1184,6 +1215,8 @@ public Color getUpColor() { *

    *

    * Defaults to: #ffffff + * + * @since 18.0 */ public void setUpColor(Color upColor) { this.upColor = upColor; @@ -1191,6 +1224,7 @@ public void setUpColor(Color upColor) { /** * @see #setUpLineColor(Color) + * @since 18.0 */ public Color getUpLineColor() { return upLineColor; @@ -1201,6 +1235,8 @@ public Color getUpLineColor() { * the general lineColor setting. *

    * Defaults to: null + * + * @since 18.0 */ public void setUpLineColor(Color upLineColor) { this.upLineColor = upLineColor; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsColumn.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsColumn.java index 1b6aea4703d..6b6a9438b68 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsColumn.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsColumn.java @@ -15,6 +15,9 @@ import com.vaadin.flow.component.charts.model.style.Color; import com.vaadin.flow.component.charts.util.Util; +/** + * @since 6.0.1 + */ public class PlotOptionsColumn extends ColumnOptions { private Boolean allowPointSelect; @@ -144,6 +147,7 @@ public void setAnimationLimit(Number animationLimit) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -162,6 +166,8 @@ public Color getBorderColor() { *

    *

    * Defaults to: #ffffff + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -185,6 +191,7 @@ public void setBorderRadius(Number borderRadius) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -203,6 +210,8 @@ public Number getBorderWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; @@ -224,6 +233,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -234,6 +244,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set *

    * Defaults to false. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -241,6 +253,7 @@ public void setClip(Boolean clip) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -265,6 +278,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -308,6 +323,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -322,6 +338,7 @@ public String getColorKey() { * Defaults to y. * * @param colorKey + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -329,6 +346,7 @@ public void setColorKey(String colorKey) { /** * @see #setColors(Color...) + * @since 18.0 */ public Color[] getColors() { if (colors == null) { @@ -343,6 +361,8 @@ public Color[] getColors() { * A series specific or series type specific color set to apply instead of * the global colors when * colorByPoint is true. + * + * @since 18.0 */ public void setColors(Color... colors) { this.colors = new ArrayList(Arrays.asList(colors)); @@ -354,6 +374,7 @@ public void setColors(Color... colors) { * @param color * to add * @see #setColors(Color...) + * @since 18.0 */ public void addColor(Color color) { if (this.colors == null) { @@ -368,6 +389,7 @@ public void addColor(Color color) { * @param color * to remove * @see #setColors(Color...) + * @since 18.0 */ public void removeColor(Color color) { this.colors.remove(color); @@ -503,6 +525,7 @@ public void setDescription(String description) { /** * @see #setEdgeColor(Color) + * @since 18.0 */ public Color getEdgeColor() { return edgeColor; @@ -512,6 +535,8 @@ public Color getEdgeColor() { * 3D columns only. The color of the edges. Similar to * borderColor, except it defaults to the same color as the * column. + * + * @since 18.0 */ public void setEdgeColor(Color edgeColor) { this.edgeColor = edgeColor; @@ -734,6 +759,7 @@ public void setLinkedTo(String linkedTo) { /** * @see #setOpacity(Number) + * @since 18.0 */ @Override public Number getOpacity() { @@ -744,6 +770,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ @Override public void setOpacity(Number opacity) { @@ -789,6 +817,7 @@ public void setMinPointLength(Number minPointLength) { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public Color getNegativeColor() { return negativeColor; @@ -799,6 +828,8 @@ public Color getNegativeColor() { * threshold. *

    * Defaults to: null + * + * @since 18.0 */ public void setNegativeColor(Color negativeColor) { this.negativeColor = negativeColor; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsColumnrange.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsColumnrange.java index bf59ccf9bf5..0a4ad28f756 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsColumnrange.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsColumnrange.java @@ -20,6 +20,8 @@ * along an X axis. Requires highcharts-more.js. To display * horizontal bars, set chart.inverted to * true. + * + * @since 6.0.1 */ public class PlotOptionsColumnrange extends ColumnOptions { @@ -146,6 +148,7 @@ public void setAnimationLimit(Number animationLimit) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -164,6 +167,8 @@ public Color getBorderColor() { *

    *

    * Defaults to: #ffffff + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -187,6 +192,7 @@ public void setBorderRadius(Number borderRadius) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -205,6 +211,8 @@ public Number getBorderWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; @@ -212,6 +220,7 @@ public void setBorderWidth(Number borderWidth) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -222,6 +231,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -243,6 +254,7 @@ public void setClassName(String className) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -267,6 +279,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -292,6 +306,7 @@ public void setColorByPoint(Boolean colorByPoint) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -304,6 +319,8 @@ public String getColorKey() { * approximation for data grouping is set to 'sum'. *

    * Defaults to y. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -329,6 +346,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColors(Color...) + * @since 18.0 */ public Color[] getColors() { if (colors == null) { @@ -343,6 +361,8 @@ public Color[] getColors() { * A series specific or series type specific color set to apply instead of * the global colors when * colorByPoint is true. + * + * @since 18.0 */ public void setColors(Color... colors) { this.colors = new ArrayList(Arrays.asList(colors)); @@ -354,6 +374,7 @@ public void setColors(Color... colors) { * @param color * to add * @see #setColors(Color...) + * @since 18.0 */ public void addColor(Color color) { if (this.colors == null) { @@ -368,6 +389,7 @@ public void addColor(Color color) { * @param color * to remove * @see #setColors(Color...) + * @since 18.0 */ public void removeColor(Color color) { this.colors.remove(color); @@ -495,6 +517,7 @@ public void setDescription(String description) { /** * @see #setEdgeColor(Color) + * @since 18.0 */ public Color getEdgeColor() { return edgeColor; @@ -504,6 +527,8 @@ public Color getEdgeColor() { * 3D columns only. The color of the edges. Similar to * borderColor, except it defaults to the same color as the * column. + * + * @since 18.0 */ public void setEdgeColor(Color edgeColor) { this.edgeColor = edgeColor; @@ -726,6 +751,7 @@ public void setLinkedTo(String linkedTo) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -735,6 +761,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsErrorbar.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsErrorbar.java index 8a557b6e01a..d88a79b678c 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsErrorbar.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsErrorbar.java @@ -19,6 +19,8 @@ * Error bars are a graphical representation of the variability of data and are * used on graphs to indicate the error, or uncertainty in a reported * measurement. + * + * @since 6.0.1 */ public class PlotOptionsErrorbar extends AbstractPlotOptions { @@ -132,6 +134,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) * @return + * @since 18.0 */ public Boolean getClip() { return clip; @@ -142,6 +145,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set. *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -149,6 +154,7 @@ public void setClip(Boolean clip) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -161,6 +167,8 @@ public Color getColor() { * individually. *

    * Defaults to: #000000 + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -204,6 +212,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -216,6 +225,8 @@ public String getColorKey() { * approximation for data grouping is set to `sum'. *

    * Defaults to high. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -223,6 +234,7 @@ public void setColorKey(String colorKey) { /** * @see #setColors(Color...) + * @since 18.0 */ public Color[] getColors() { if (colors == null) { @@ -237,6 +249,8 @@ public Color[] getColors() { * A series specific or series type specific color set to apply instead of * the global colors when * colorByPoint is true. + * + * @since 18.0 */ public void setColors(Color... colors) { this.colors = new ArrayList(Arrays.asList(colors)); @@ -248,6 +262,7 @@ public void setColors(Color... colors) { * @param color * to add * @see #setColors(Color...) + * @since 18.0 */ public void addColor(Color color) { if (this.colors == null) { @@ -262,6 +277,7 @@ public void addColor(Color color) { * @param color * to remove * @see #setColors(Color...) + * @since 18.0 */ public void removeColor(Color color) { this.colors.remove(color); @@ -345,6 +361,7 @@ public void setDescription(String description) { /** * @see #setEdgeColor(Color) + * @since 18.0 */ public Color getEdgeColor() { return edgeColor; @@ -354,6 +371,8 @@ public Color getEdgeColor() { * 3D columns only. The color of the edges. Similar to * borderColor, except it defaults to the same color as the * column. + * + * @since 18.0 */ public void setEdgeColor(Color edgeColor) { this.edgeColor = edgeColor; @@ -525,6 +544,7 @@ public void removeKey(String key) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -538,6 +558,8 @@ public Number getLineWidth() { * null, the lineWidth also applies to these lines. *

    * Defaults to: 1 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -580,6 +602,7 @@ public void setMaxPointWidth(Number maxPointWidth) { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public Color getNegativeColor() { return negativeColor; @@ -590,6 +613,8 @@ public Color getNegativeColor() { * threshold. *

    * Defaults to: null + * + * @since 18.0 */ public void setNegativeColor(Color negativeColor) { this.negativeColor = negativeColor; @@ -597,6 +622,7 @@ public void setNegativeColor(Color negativeColor) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -605,6 +631,8 @@ public Number getOpacity() { /** * Opacity of a series parts: line, fill (e.g. area) and dataLabels. * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; @@ -840,6 +868,7 @@ public void setStemColor(Color stemColor) { /** * @see #setStemDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getStemDashStyle() { return stemDashStyle; @@ -850,6 +879,8 @@ public DashStyle getStemDashStyle() { * the whiskers. *

    * Defaults to: Solid + * + * @since 18.0 */ public void setStemDashStyle(DashStyle stemDashStyle) { this.stemDashStyle = stemDashStyle; @@ -857,6 +888,7 @@ public void setStemDashStyle(DashStyle stemDashStyle) { /** * @see #setStemWidth(Number) + * @since 18.0 */ public Number getStemWidth() { return stemWidth; @@ -868,6 +900,8 @@ public Number getStemWidth() { * lineWidth option. *

    * Defaults to: null + * + * @since 18.0 */ public void setStemWidth(Number stemWidth) { this.stemWidth = stemWidth; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsFlags.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsFlags.java index f337dabbe2d..8b478205049 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsFlags.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsFlags.java @@ -16,6 +16,7 @@ /** * + * @since 6.0.1 */ public class PlotOptionsFlags extends AbstractPlotOptions { @@ -130,6 +131,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -140,6 +142,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -147,6 +151,7 @@ public void setClip(Boolean clip) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -171,6 +176,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -196,6 +203,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -208,6 +216,8 @@ public String getColorKey() { * approximation for data grouping is set to 'sum'. *

    * Defaults to y. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -215,6 +225,7 @@ public void setColorKey(String colorKey) { /** * @see #setColors(Color...) + * @since 18.0 */ public Color[] getColors() { if (colors == null) { @@ -229,6 +240,8 @@ public Color[] getColors() { * A series specific or series type specific color set to apply instead of * the global colors when * colorByPoint is true. + * + * @since 18.0 */ public void setColors(Color... colors) { this.colors = new ArrayList(Arrays.asList(colors)); @@ -240,6 +253,7 @@ public void setColors(Color... colors) { * @param color * to add * @see #setColors(Color...) + * @since 18.0 */ public void addColor(Color color) { if (this.colors == null) { @@ -254,6 +268,7 @@ public void addColor(Color color) { * @param color * to remove * @see #setColors(Color...) + * @since 18.0 */ public void removeColor(Color color) { this.colors.remove(color); @@ -279,6 +294,7 @@ public void setCompareBase(Number compareBase) { /** * @see #setCrisp(Boolean) + * @since 18.0 */ public Boolean getCrisp() { return crisp; @@ -293,6 +309,8 @@ public Boolean getCrisp() { * rendered blurry. *

    * Defaults to true. + * + * @since 18.0 */ public void setCrisp(Boolean crisp) { this.crisp = crisp; @@ -526,6 +544,7 @@ public void setLegendIndex(Number legendIndex) { /** * @see #setLineColor(Color) + * @since 18.0 */ public Color getLineColor() { return lineColor; @@ -544,6 +563,8 @@ public Color getLineColor() { *

    *

    * Defaults to: #000000 + * + * @since 18.0 */ public void setLineColor(Color lineColor) { this.lineColor = lineColor; @@ -551,6 +572,7 @@ public void setLineColor(Color lineColor) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -561,6 +583,8 @@ public Number getLineWidth() { * 1. *

    * Defaults to: 1 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -631,6 +655,7 @@ public void setNavigatorOptions(PlotOptionsSeries navigatorOptions) { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public Color getNegativeColor() { return negativeColor; @@ -641,6 +666,8 @@ public Color getNegativeColor() { * threshold. *

    * Defaults to: null + * + * @since 18.0 */ public void setNegativeColor(Color negativeColor) { this.negativeColor = negativeColor; @@ -685,6 +712,7 @@ public void setOnSeries(String onSeries) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -694,6 +722,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; @@ -938,6 +968,7 @@ public void setStickyTracking(Boolean stickyTracking) { /** * @see #setStyle(Style) + * @since 18.0 */ public Style getStyle() { if (style == null) { @@ -959,6 +990,8 @@ public Style getStyle() { *

    *

    * Defaults to: { "fontSize": "11px", "fontWeight": "bold" } + * + * @since 18.0 */ public void setStyle(Style style) { this.style = style; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsFunnel.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsFunnel.java index ee3aecc1a6d..2c1471ed34a 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsFunnel.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsFunnel.java @@ -17,6 +17,8 @@ * Funnel charts are a type of chart often used to visualize stages in a sales * project, where the top are the initial stages with the most clients. It * requires that the modules/funnel.js file is loaded. + * + * @since 6.0.1 */ public class PlotOptionsFunnel extends PyramidOptions { @@ -107,6 +109,7 @@ public void setAnimationLimit(Number animationLimit) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -128,6 +131,8 @@ public Color getBorderColor() { *

    *

    * Defaults to: #ffffff + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -135,6 +140,7 @@ public void setBorderColor(Color borderColor) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -160,6 +166,8 @@ public Number getBorderWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; @@ -191,6 +199,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -201,6 +210,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set. *

    * Defaults to false. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -226,6 +237,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -238,6 +250,8 @@ public String getColorKey() { * approximation for data grouping is set to 'sum'. *

    * Defaults to y. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -290,6 +304,7 @@ public void removeColor(Color color) { /** * @see #setCrisp(Boolean) + * @since 18.0 */ public Boolean getCrisp() { return crisp; @@ -304,6 +319,8 @@ public Boolean getCrisp() { * rendered blurry. *

    * Defaults to true. + * + * @since 18.0 */ public void setCrisp(Boolean crisp) { this.crisp = crisp; @@ -480,6 +497,7 @@ public void setHeight(String height) { /** * @see #setIgnoreHiddenPoint(Boolean) + * @since 18.0 */ public Boolean getIgnoreHiddenPoint() { return ignoreHiddenPoint; @@ -490,6 +508,8 @@ public Boolean getIgnoreHiddenPoint() { * point were null. *

    * Defaults to true. + * + * @since 18.0 */ public void setIgnoreHiddenPoint(Boolean ignoreHiddenPoint) { this.ignoreHiddenPoint = ignoreHiddenPoint; @@ -578,6 +598,7 @@ public void setMinSize(Number minSize) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -587,6 +608,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsGantt.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsGantt.java index 2635a16ed08..4807eda1a2d 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsGantt.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsGantt.java @@ -17,6 +17,8 @@ /** * Options for the gantt series type. + * + * @since 24.7 */ @SuppressWarnings("unused") public class PlotOptionsGantt extends AbstractPlotOptions { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsGauge.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsGauge.java index 07985e48ae4..79d6f14e115 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsGauge.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsGauge.java @@ -16,6 +16,8 @@ /** * General plotting options for the gauge series type. Requires * highcharts-more.js + * + * @since 6.0.1 */ public class PlotOptionsGauge extends GaugeOptions { @@ -110,6 +112,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -120,6 +123,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -127,6 +132,7 @@ public void setClip(Boolean clip) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -151,6 +157,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -176,6 +184,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setCrisp(Boolean) + * @since 18.0 */ public Boolean getCrisp() { return crisp; @@ -190,6 +199,8 @@ public Boolean getCrisp() { * rendered blurry. *

    * Defaults to true. + * + * @since 18.0 */ public void setCrisp(Boolean crisp) { this.crisp = crisp; @@ -410,6 +421,7 @@ public void removeKey(String key) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -419,6 +431,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; @@ -443,6 +457,7 @@ public void setLinkedTo(String linkedTo) { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public Color getNegativeColor() { return negativeColor; @@ -453,6 +468,8 @@ public Color getNegativeColor() { * threshold. *

    * Defaults to: null + * + * @since 18.0 */ public void setNegativeColor(Color negativeColor) { this.negativeColor = negativeColor; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsHeatmap.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsHeatmap.java index 648741dd95e..fdff73b0772 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsHeatmap.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsHeatmap.java @@ -23,6 +23,8 @@ * The colors of each heat map point is usually determined by its value and * controlled by settings on the colorAxis. *

    + * + * @since 6.0.1 */ public class PlotOptionsHeatmap extends AbstractPlotOptions { @@ -130,6 +132,7 @@ public void setAnimationLimit(Number animationLimit) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -148,6 +151,8 @@ public Color getBorderColor() { *

    *

    * Defaults to: #ffffff + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -171,6 +176,7 @@ public void setBorderRadius(Number borderRadius) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -189,6 +195,8 @@ public Number getBorderWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; @@ -210,6 +218,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -220,6 +229,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set. *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -227,6 +238,7 @@ public void setClip(Boolean clip) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -239,6 +251,8 @@ public Color getColor() { * pulled from the options.colors array. *

    * Defaults to: null + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -282,6 +296,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -294,6 +309,8 @@ public String getColorKey() { * approximation for data grouping is set to 'sum'. *

    * Defaults to value. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -301,6 +318,7 @@ public void setColorKey(String colorKey) { /** * @see #setColors(Color...) + * @since 18.0 */ public Color[] getColors() { if (colors == null) { @@ -315,6 +333,8 @@ public Color[] getColors() { * A series specific or series type specific color set to apply instead of * the global colors when * colorByPoint is true. + * + * @since 18.0 */ public void setColors(Color... colors) { this.colors = new ArrayList(Arrays.asList(colors)); @@ -326,6 +346,7 @@ public void setColors(Color... colors) { * @param color * to add * @see #setColors(Color...) + * @since 18.0 */ public void addColor(Color color) { if (this.colors == null) { @@ -340,6 +361,7 @@ public void addColor(Color color) { * @param color * to remove * @see #setColors(Color...) + * @since 18.0 */ public void removeColor(Color color) { this.colors.remove(color); @@ -641,6 +663,7 @@ public void setMaxPointWidth(Number maxPointWidth) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -650,6 +673,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsLine.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsLine.java index 26748640db3..9f931191288 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsLine.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsLine.java @@ -15,6 +15,9 @@ import com.vaadin.flow.component.charts.model.style.Color; import com.vaadin.flow.component.charts.util.Util; +/** + * @since 6.0.1 + */ public class PlotOptionsLine extends PointOptions { private Boolean allowPointSelect; @@ -151,6 +154,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -161,6 +165,8 @@ public Boolean getClip() { * Note that lipping should be always enabled when chart.zoomType is set *

    * Defaults to false. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -168,6 +174,7 @@ public void setClip(Boolean clip) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -192,6 +199,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -217,6 +226,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -229,6 +239,8 @@ public String getColorKey() { * set to 'sum'. *

    * Defaults to y. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -236,6 +248,7 @@ public void setColorKey(String colorKey) { /** * @see #setCrisp(Boolean) + * @since 18.0 */ public Boolean getCrisp() { return crisp; @@ -250,6 +263,8 @@ public Boolean getCrisp() { * rendered blurry. *

    * Defaults to true. + * + * @since 18.0 */ public void setCrisp(Boolean crisp) { this.crisp = crisp; @@ -329,6 +344,7 @@ public void setCursor(Cursor cursor) { /** * @see #setDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getDashStyle() { return dashStyle; @@ -354,6 +370,8 @@ public DashStyle getDashStyle() { * *

    * Defaults to: Solid + * + * @since 18.0 */ public void setDashStyle(DashStyle dashStyle) { this.dashStyle = dashStyle; @@ -543,6 +561,7 @@ public void removeKey(String key) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -552,6 +571,8 @@ public Number getLineWidth() { * Pixel with of the graph line. *

    * Defaults to: 2 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -623,6 +644,7 @@ public void setMarker(Marker marker) { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public Color getNegativeColor() { return negativeColor; @@ -633,6 +655,8 @@ public Color getNegativeColor() { * threshold. *

    * Defaults to: null + * + * @since 18.0 */ public void setNegativeColor(Color negativeColor) { this.negativeColor = negativeColor; @@ -640,6 +664,7 @@ public void setNegativeColor(Color negativeColor) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -649,6 +674,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsOhlc.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsOhlc.java index c948f847a33..c4e7791b977 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsOhlc.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsOhlc.java @@ -17,6 +17,7 @@ /** * + * @since 6.0.1 */ public class PlotOptionsOhlc extends OhlcOptions { @@ -153,6 +154,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -163,6 +165,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -170,6 +174,7 @@ public void setClip(Boolean clip) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -194,6 +199,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -237,6 +244,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -249,6 +257,8 @@ public String getColorKey() { * approximation for data grouping is set to 'sum'. *

    * Defaults to close. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -256,6 +266,7 @@ public void setColorKey(String colorKey) { /** * @see #setColors(Color...) + * @since 18.0 */ public Color[] getColors() { if (colors == null) { @@ -270,6 +281,8 @@ public Color[] getColors() { * A series specific or series type specific color set to apply instead of * the global colors when * colorByPoint is true. + * + * @since 18.0 */ public void setColors(Color... colors) { this.colors = new ArrayList(Arrays.asList(colors)); @@ -281,6 +294,7 @@ public void setColors(Color... colors) { * @param color * to add * @see #setColors(Color...) + * @since 18.0 */ public void addColor(Color color) { if (this.colors == null) { @@ -295,6 +309,7 @@ public void addColor(Color color) { * @param color * to remove * @see #setColors(Color...) + * @since 18.0 */ public void removeColor(Color color) { this.colors.remove(color); @@ -615,6 +630,7 @@ public void setLegendIndex(Number legendIndex) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -624,6 +640,8 @@ public Number getLineWidth() { * The pixel width of the line/border. Defaults to 1. *

    * Defaults to: 1 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -713,6 +731,7 @@ public void setNavigatorOptions(PlotOptionsSeries navigatorOptions) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -722,6 +741,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; @@ -729,6 +750,7 @@ public void setOpacity(Number opacity) { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public Color getNegativeColor() { return negativeColor; @@ -739,6 +761,8 @@ public Color getNegativeColor() { * threshold. *

    * Defaults to: null + * + * @since 18.0 */ public void setNegativeColor(Color negativeColor) { this.negativeColor = negativeColor; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsOrganization.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsOrganization.java index 851310d2935..363dfb75b85 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsOrganization.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsOrganization.java @@ -18,6 +18,8 @@ /** * Plot options for {@link ChartType#ORGANIZATION} charts. + * + * @since 18.0 */ public class PlotOptionsOrganization extends AbstractPlotOptions { @@ -438,6 +440,7 @@ private void safeRemove(List list, T item) { /** * @see #setLink(Link) * @return the link configuration + * @since 25.0 */ public Link getLink() { if (link == null) { @@ -448,6 +451,8 @@ public Link getLink() { /** * Link styling options. + * + * @since 25.0 */ public void setLink(Link link) { this.link = link; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsPie.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsPie.java index ccbcaf5a85f..b41b4e846ae 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsPie.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsPie.java @@ -16,6 +16,8 @@ /** * A pie chart is a circular chart divided into sectors, illustrating numerical * proportion. + * + * @since 6.0.1 */ public class PlotOptionsPie extends AbstractPlotOptions { @@ -123,6 +125,7 @@ public void setAnimationLimit(Number animationLimit) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -144,6 +147,8 @@ public Color getBorderColor() { *

    *

    * Defaults to: #ffffff + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -151,6 +156,7 @@ public void setBorderColor(Color borderColor) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -176,6 +182,8 @@ public Number getBorderWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; @@ -211,6 +219,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -223,6 +232,7 @@ public Boolean getClip() { * Defaults to false. * * @param clip + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -248,6 +258,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -262,6 +273,7 @@ public String getColorKey() { * Defaults to y. * * @param colorKey + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -269,6 +281,7 @@ public void setColorKey(String colorKey) { /** * @see #setColors(Color...) + * @since 18.0 */ public Color[] getColors() { if (colors == null) { @@ -282,6 +295,8 @@ public Color[] getColors() { /** * A series specific or series type specific color set to use instead of the * global colors. + * + * @since 18.0 */ public void setColors(Color... colors) { this.colors = new ArrayList(Arrays.asList(colors)); @@ -293,6 +308,7 @@ public void setColors(Color... colors) { * @param color * to add * @see #setColors(Color...) + * @since 18.0 */ public void addColor(Color color) { if (this.colors == null) { @@ -307,6 +323,7 @@ public void addColor(Color color) { * @param color * to remove * @see #setColors(Color...) + * @since 18.0 */ public void removeColor(Color color) { this.colors.remove(color); @@ -314,6 +331,7 @@ public void removeColor(Color color) { /** * @see #setCrisp(Boolean) + * @since 18.0 */ public Boolean getCrisp() { return crisp; @@ -328,6 +346,8 @@ public Boolean getCrisp() { * rendered blurry. *

    * Defaults to true. + * + * @since 18.0 */ public void setCrisp(Boolean crisp) { this.crisp = crisp; @@ -636,6 +656,7 @@ public void setMinSize(Number minSize) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -645,6 +666,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsPolygon.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsPolygon.java index 54ffb138f63..01bed22a37b 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsPolygon.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsPolygon.java @@ -20,6 +20,8 @@ * coordinate system. A fill is applied with the color option, and * stroke is applied through lineWidth and lineColor * options. Requires the highcharts-more.js file. + * + * @since 6.0.1 */ public class PlotOptionsPolygon extends AbstractPlotOptions { @@ -149,6 +151,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -159,6 +162,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -166,6 +171,7 @@ public void setClip(Boolean clip) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -190,6 +196,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -215,6 +223,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -227,6 +236,8 @@ public String getColorKey() { * approximation for data grouping is set to 'sum'. *

    * Defaults to y. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -234,6 +245,7 @@ public void setColorKey(String colorKey) { /** * @see #setCrisp(Boolean) + * @since 18.0 */ public Boolean getCrisp() { return crisp; @@ -248,6 +260,8 @@ public Boolean getCrisp() { * rendered blurry. *

    * Defaults to true. + * + * @since 18.0 */ public void setCrisp(Boolean crisp) { this.crisp = crisp; @@ -294,6 +308,7 @@ public void setCursor(Cursor cursor) { /** * @see #setDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getDashStyle() { return dashStyle; @@ -319,6 +334,8 @@ public DashStyle getDashStyle() { * *

    * Defaults to: Solid + * + * @since 18.0 */ public void setDashStyle(DashStyle dashStyle) { this.dashStyle = dashStyle; @@ -479,6 +496,7 @@ public void removeKey(String key) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -488,6 +506,8 @@ public Number getLineWidth() { * The width of the line connecting the data points. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -543,6 +563,7 @@ public void setMarker(Marker marker) { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public Color getNegativeColor() { return negativeColor; @@ -553,6 +574,8 @@ public Color getNegativeColor() { * threshold. *

    * Defaults to: null + * + * @since 18.0 */ public void setNegativeColor(Color negativeColor) { this.negativeColor = negativeColor; @@ -560,6 +583,7 @@ public void setNegativeColor(Color negativeColor) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -569,6 +593,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsPyramid.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsPyramid.java index ce419da26a1..edac5755779 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsPyramid.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsPyramid.java @@ -17,6 +17,8 @@ * A pyramid chart consists of a single pyramid with item heights corresponding * to each point value. Technically it is the same as a reversed funnel chart * without a neck. + * + * @since 6.0.1 */ public class PlotOptionsPyramid extends PyramidOptions { @@ -105,6 +107,7 @@ public void setAnimationLimit(Number animationLimit) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -126,6 +129,8 @@ public Color getBorderColor() { *

    *

    * Defaults to: #ffffff + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -133,6 +138,7 @@ public void setBorderColor(Color borderColor) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -158,6 +164,8 @@ public Number getBorderWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; @@ -189,6 +197,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -199,6 +208,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set. *

    * Defaults to false. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -224,6 +235,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -236,6 +248,8 @@ public String getColorKey() { * approximation for data grouping is set to 'sum'. *

    * Defaults to y. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -243,6 +257,7 @@ public void setColorKey(String colorKey) { /** * @see #setColors(Color...) + * @since 18.0 */ public Color[] getColors() { if (colors == null) { @@ -256,6 +271,8 @@ public Color[] getColors() { /** * A series specific or series type specific color set to use instead of the * global colors. + * + * @since 18.0 */ public void setColors(Color... colors) { this.colors = new ArrayList(Arrays.asList(colors)); @@ -267,6 +284,7 @@ public void setColors(Color... colors) { * @param color * to add * @see #setColors(Color...) + * @since 18.0 */ public void addColor(Color color) { if (this.colors == null) { @@ -281,6 +299,7 @@ public void addColor(Color color) { * @param color * to remove * @see #setColors(Color...) + * @since 18.0 */ public void removeColor(Color color) { this.colors.remove(color); @@ -288,6 +307,7 @@ public void removeColor(Color color) { /** * @see #setCrisp(Boolean) + * @since 18.0 */ public Boolean getCrisp() { return crisp; @@ -302,6 +322,8 @@ public Boolean getCrisp() { * rendered blurry. *

    * Defaults to true. + * + * @since 18.0 */ public void setCrisp(Boolean crisp) { this.crisp = crisp; @@ -478,6 +500,7 @@ public void setHeight(String height) { /** * @see #setIgnoreHiddenPoint(Boolean) + * @since 18.0 */ public Boolean getIgnoreHiddenPoint() { return ignoreHiddenPoint; @@ -488,6 +511,8 @@ public Boolean getIgnoreHiddenPoint() { * point were null. *

    * Defaults to true. + * + * @since 18.0 */ public void setIgnoreHiddenPoint(Boolean ignoreHiddenPoint) { this.ignoreHiddenPoint = ignoreHiddenPoint; @@ -576,6 +601,7 @@ public void setMinSize(Number minSize) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -585,6 +611,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsSankey.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsSankey.java index 4f787db5ab8..9f62e449904 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsSankey.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsSankey.java @@ -18,6 +18,8 @@ /** * Plot options for {@link ChartType#SANKEY} charts. + * + * @since 24.3 */ public class PlotOptionsSankey extends AbstractPlotOptions { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsScatter.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsScatter.java index 83381ab0d50..0f987fbc795 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsScatter.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsScatter.java @@ -15,6 +15,9 @@ import com.vaadin.flow.component.charts.model.style.Color; import com.vaadin.flow.component.charts.util.Util; +/** + * @since 6.0.1 + */ public class PlotOptionsScatter extends PointOptions { private Boolean allowPointSelect; @@ -146,6 +149,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -156,6 +160,8 @@ public Boolean getClip() { * Note that lipping should be always enabled when chart.zoomType is set *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -163,6 +169,7 @@ public void setClip(Boolean clip) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -187,6 +194,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -212,6 +221,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -226,6 +236,7 @@ public String getColorKey() { * Defaults to y. * * @param colorKey + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -233,6 +244,7 @@ public void setColorKey(String colorKey) { /** * @see #setCrisp(Boolean) + * @since 18.0 */ public Boolean getCrisp() { return crisp; @@ -247,6 +259,8 @@ public Boolean getCrisp() { * rendered blurry. *

    * Defaults to true. + * + * @since 18.0 */ public void setCrisp(Boolean crisp) { this.crisp = crisp; @@ -293,6 +307,7 @@ public void setCursor(Cursor cursor) { /** * @see #setDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getDashStyle() { return dashStyle; @@ -318,6 +333,8 @@ public DashStyle getDashStyle() { * *

    * Defaults to: Solid + * + * @since 18.0 */ public void setDashStyle(DashStyle dashStyle) { this.dashStyle = dashStyle; @@ -507,6 +524,7 @@ public void removeKey(String key) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -516,6 +534,8 @@ public Number getLineWidth() { * The width of the line connecting the data points. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -571,6 +591,7 @@ public void setMarker(Marker marker) { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public Color getNegativeColor() { return negativeColor; @@ -581,6 +602,8 @@ public Color getNegativeColor() { * threshold. *

    * Defaults to: null + * + * @since 18.0 */ public void setNegativeColor(Color negativeColor) { this.negativeColor = negativeColor; @@ -588,6 +611,7 @@ public void setNegativeColor(Color negativeColor) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -596,6 +620,8 @@ public Number getOpacity() { /** * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsSeries.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsSeries.java index 456edcdd1fb..8dc903a6a57 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsSeries.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsSeries.java @@ -19,6 +19,8 @@ *

    * General options for all series types. *

    + * + * @since 6.0.1 */ public class PlotOptionsSeries extends AbstractPlotOptions { @@ -151,6 +153,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -161,6 +164,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set. *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -168,6 +173,7 @@ public void setClip(Boolean clip) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -192,6 +198,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -217,6 +225,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -231,6 +240,7 @@ public String getColorKey() { * Defaults to y. * * @param colorKey + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -271,6 +281,7 @@ public void setConnectNulls(Boolean connectNulls) { /** * @see #setCrisp(Boolean) + * @since 18.0 */ public Boolean getCrisp() { return crisp; @@ -285,6 +296,8 @@ public Boolean getCrisp() { * rendered blurry. *

    * Defaults to true. + * + * @since 18.0 */ public void setCrisp(Boolean crisp) { this.crisp = crisp; @@ -331,6 +344,7 @@ public void setCursor(Cursor cursor) { /** * @see #setDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getDashStyle() { return dashStyle; @@ -356,6 +370,8 @@ public DashStyle getDashStyle() { * *

    * Defaults to: Solid + * + * @since 18.0 */ public void setDashStyle(DashStyle dashStyle) { this.dashStyle = dashStyle; @@ -545,6 +561,7 @@ public void removeKey(String key) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -554,6 +571,8 @@ public Number getLineWidth() { * Pixel with of the graph line. *

    * Defaults to: 2 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -625,6 +644,7 @@ public void setMarker(Marker marker) { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public Color getNegativeColor() { return negativeColor; @@ -635,6 +655,8 @@ public Color getNegativeColor() { * threshold. *

    * Defaults to: null + * + * @since 18.0 */ public void setNegativeColor(Color negativeColor) { this.negativeColor = negativeColor; @@ -642,6 +664,7 @@ public void setNegativeColor(Color negativeColor) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -651,6 +674,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsSolidgauge.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsSolidgauge.java index f3c7db02ae3..30be321808d 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsSolidgauge.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsSolidgauge.java @@ -17,6 +17,8 @@ * extended with some color options, minColor, * maxColor and stops, * to control the color of the gauge itself. + * + * @since 6.0.1 */ public class PlotOptionsSolidgauge extends GaugeOptions { @@ -96,6 +98,7 @@ public void setAnimationLimit(Number animationLimit) { /** * @see #setBorderRadius(String) + * @since 25.0 */ public String getBorderRadius() { return borderRadius; @@ -107,6 +110,7 @@ public String getBorderRadius() { * relative size. * * @param borderRadius + * @since 25.0 */ public void setBorderRadius(String borderRadius) { this.borderRadius = borderRadius; @@ -128,6 +132,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -138,6 +143,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -145,6 +152,7 @@ public void setClip(Boolean clip) { /** * @see #setColorByPoint(Boolean) + * @since 18.0 */ public Boolean getColorByPoint() { return colorByPoint; @@ -154,6 +162,8 @@ public Boolean getColorByPoint() { * Whether to give each point an individual color. *

    * Defaults to true. + * + * @since 18.0 */ public void setColorByPoint(Boolean colorByPoint) { this.colorByPoint = colorByPoint; @@ -179,6 +189,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setCrisp(Boolean) + * @since 18.0 */ public Boolean getCrisp() { return crisp; @@ -193,6 +204,8 @@ public Boolean getCrisp() { * rendered blurry. *

    * Defaults to true. + * + * @since 18.0 */ public void setCrisp(Boolean crisp) { this.crisp = crisp; @@ -387,6 +400,7 @@ public void removeKey(String key) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -396,6 +410,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsSpline.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsSpline.java index b8c312a5d8c..b90e4a1030a 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsSpline.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsSpline.java @@ -15,6 +15,9 @@ import com.vaadin.flow.component.charts.model.style.Color; import com.vaadin.flow.component.charts.util.Util; +/** + * @since 6.0.1 + */ public class PlotOptionsSpline extends PointOptions { private Boolean allowPointSelect; @@ -150,6 +153,7 @@ public void setClassName(String className) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -160,6 +164,8 @@ public Boolean getClip() { * Note that lipping should be always enabled when chart.zoomType is set *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -167,6 +173,7 @@ public void setClip(Boolean clip) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -191,6 +198,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -216,6 +225,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -228,6 +238,8 @@ public String getColorKey() { * set to 'sum'. *

    * Defaults to y. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -235,6 +247,7 @@ public void setColorKey(String colorKey) { /** * @see #setCrisp(Boolean) + * @since 18.0 */ public Boolean getCrisp() { return crisp; @@ -249,6 +262,8 @@ public Boolean getCrisp() { * rendered blurry. *

    * Defaults to true. + * + * @since 18.0 */ public void setCrisp(Boolean crisp) { this.crisp = crisp; @@ -328,6 +343,7 @@ public void setCursor(Cursor cursor) { /** * @see #setDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getDashStyle() { return dashStyle; @@ -353,6 +369,8 @@ public DashStyle getDashStyle() { * *

    * Defaults to: Solid + * + * @since 18.0 */ public void setDashStyle(DashStyle dashStyle) { this.dashStyle = dashStyle; @@ -542,6 +560,7 @@ public void removeKey(String key) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -551,6 +570,8 @@ public Number getLineWidth() { * Pixel with of the graph line. *

    * Defaults to: 2 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -622,6 +643,7 @@ public void setMarker(Marker marker) { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public Color getNegativeColor() { return negativeColor; @@ -632,6 +654,8 @@ public Color getNegativeColor() { * threshold. *

    * Defaults to: null + * + * @since 18.0 */ public void setNegativeColor(Color negativeColor) { this.negativeColor = negativeColor; @@ -639,6 +663,7 @@ public void setNegativeColor(Color negativeColor) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -648,6 +673,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsTimeline.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsTimeline.java index b7e4cb098fa..ad8f30001d5 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsTimeline.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsTimeline.java @@ -15,6 +15,8 @@ /** * Plot options for {@link ChartType#TIMELINE} charts. + * + * @since 18.0 */ public class PlotOptionsTimeline extends AbstractPlotOptions { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsTreemap.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsTreemap.java index 7f79671cf1b..d4c0016f82b 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsTreemap.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsTreemap.java @@ -19,6 +19,8 @@ * functionality such as the * colorAxis is to be * used. + * + * @since 6.0.1 */ public class PlotOptionsTreemap extends AbstractPlotOptions { @@ -119,6 +121,8 @@ public void setAllowPointSelect(Boolean allowPointSelect) { /** * {@see #setAllowTraversingTree(Boolean)} + * + * @since 25.0 */ public Boolean getAllowTraversingTree() { @@ -130,6 +134,8 @@ public Boolean getAllowTraversingTree() { * on its children. *

    * Defaults to: false + * + * @since 25.0 */ public void setAllowTraversingTree(Boolean allowTraversingTree) { this.allowTraversingTree = allowTraversingTree; @@ -191,6 +197,7 @@ public void setAnimationLimit(Number animationLimit) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -200,6 +207,8 @@ public Color getBorderColor() { * The color of the border surrounding each tree map item. *

    * Defaults to: #e6e6e6 + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -207,6 +216,7 @@ public void setBorderColor(Color borderColor) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -225,6 +235,8 @@ public Number getBorderWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; @@ -232,6 +244,8 @@ public void setBorderWidth(Number borderWidth) { /** * {@see #setBreadcrumbs(Breadcrumbs)} + * + * @since 25.0 */ public Breadcrumbs getBreadcrumbs() { if (breadcrumbs == null) { @@ -245,6 +259,7 @@ public Breadcrumbs getBreadcrumbs() { * through the traversed levels. * * @param breadcrumbs + * @since 25.0 */ public void setBreadcrumbs(Breadcrumbs breadcrumbs) { this.breadcrumbs = breadcrumbs; @@ -266,6 +281,7 @@ public void setClassName(String className) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -278,6 +294,8 @@ public Color getColor() { * pulled from the options.colors array. *

    * Defaults to: null + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -321,6 +339,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColors(Color...) + * @since 18.0 */ public Color[] getColors() { if (colors == null) { @@ -335,6 +354,8 @@ public Color[] getColors() { * A series specific or series type specific color set to apply instead of * the global colors when * colorByPoint is true. + * + * @since 18.0 */ public void setColors(Color... colors) { this.colors = new ArrayList(Arrays.asList(colors)); @@ -346,6 +367,7 @@ public void setColors(Color... colors) { * @param color * to add * @see #setColors(Color...) + * @since 18.0 */ public void addColor(Color color) { if (this.colors == null) { @@ -360,6 +382,7 @@ public void addColor(Color color) { * @param color * to remove * @see #setColors(Color...) + * @since 18.0 */ public void removeColor(Color color) { this.colors.remove(color); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsWaterfall.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsWaterfall.java index dcf12946b01..3a0053686e1 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsWaterfall.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsWaterfall.java @@ -17,6 +17,8 @@ /** * Options for the waterfall series type. + * + * @since 6.0.1 */ public class PlotOptionsWaterfall extends ColumnOptions { @@ -140,6 +142,7 @@ public void setAnimationLimit(Number animationLimit) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -158,6 +161,8 @@ public Color getBorderColor() { *

    *

    * Defaults to: #333333 + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -181,6 +186,7 @@ public void setBorderRadius(Number borderRadius) { /** * @see #setBorderWidth(Number) + * @since 18.0 */ public Number getBorderWidth() { return borderWidth; @@ -199,6 +205,8 @@ public Number getBorderWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setBorderWidth(Number borderWidth) { this.borderWidth = borderWidth; @@ -206,6 +214,7 @@ public void setBorderWidth(Number borderWidth) { /** * @see #setClip(Boolean) + * @since 18.0 */ public Boolean getClip() { return clip; @@ -216,6 +225,8 @@ public Boolean getClip() { * Note that clipping should be always enabled when chart.zoomType is set. *

    * Defaults to true. + * + * @since 18.0 */ public void setClip(Boolean clip) { this.clip = clip; @@ -237,6 +248,7 @@ public void setClassName(String className) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -261,6 +273,8 @@ public Color getColor() { * .highcharts-series-{n} class, or individual classes given by * the className option. *

    + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -286,6 +300,7 @@ public void setColorByPoint(Boolean colorByPoint) { /** * @see #setColorKey(String) + * @since 18.0 */ public String getColorKey() { return colorKey; @@ -298,6 +313,8 @@ public String getColorKey() { * approximation for data grouping is set to 'sum'. *

    * Defaults to y. + * + * @since 18.0 */ public void setColorKey(String colorKey) { this.colorKey = colorKey; @@ -324,6 +341,7 @@ public void setColorIndex(Number colorIndex) { /** * @see #setColors(Color...) + * @since 18.0 */ public Color[] getColors() { if (colors == null) { @@ -338,6 +356,8 @@ public Color[] getColors() { * A series specific or series type specific color set to apply instead of * the global colors when * colorByPoint is true. + * + * @since 18.0 */ public void setColors(Color... colors) { this.colors = new ArrayList(Arrays.asList(colors)); @@ -349,6 +369,7 @@ public void setColors(Color... colors) { * @param color * to add * @see #setColors(Color...) + * @since 18.0 */ public void addColor(Color color) { if (this.colors == null) { @@ -363,6 +384,7 @@ public void addColor(Color color) { * @param color * to remove * @see #setColors(Color...) + * @since 18.0 */ public void removeColor(Color color) { this.colors.remove(color); @@ -407,6 +429,7 @@ public void setCursor(Cursor cursor) { /** * @see #setDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getDashStyle() { return dashStyle; @@ -439,6 +462,8 @@ public DashStyle getDashStyle() { *

    *

    * Defaults to: Dot + * + * @since 18.0 */ public void setDashStyle(DashStyle dashStyle) { this.dashStyle = dashStyle; @@ -514,6 +539,7 @@ public void setDescription(String description) { /** * @see #setEdgeColor(Color) + * @since 18.0 */ public Color getEdgeColor() { return edgeColor; @@ -523,6 +549,8 @@ public Color getEdgeColor() { * 3D columns only. The color of the edges. Similar to * borderColor, except it defaults to the same color as the * column. + * + * @since 18.0 */ public void setEdgeColor(Color edgeColor) { this.edgeColor = edgeColor; @@ -728,6 +756,7 @@ public void removeKey(String key) { /** * @see #setLineColor(Color) + * @since 18.0 */ public Color getLineColor() { return lineColor; @@ -746,6 +775,8 @@ public Color getLineColor() { *

    *

    * Defaults to: #333333 + * + * @since 18.0 */ public void setLineColor(Color lineColor) { this.lineColor = lineColor; @@ -753,6 +784,7 @@ public void setLineColor(Color lineColor) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -762,6 +794,8 @@ public Number getLineWidth() { * The width of the line connecting waterfall columns. *

    * Defaults to: 1 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -786,6 +820,7 @@ public void setLinkedTo(String linkedTo) { /** * @see #setOpacity(Number) + * @since 18.0 */ public Number getOpacity() { return opacity; @@ -795,6 +830,8 @@ public Number getOpacity() { * Opacity of a series parts: line, fill (e.g. area) and dataLabels. *

    * Defaults to 1. + * + * @since 18.0 */ public void setOpacity(Number opacity) { this.opacity = opacity; @@ -1193,6 +1230,7 @@ public void setTooltip(SeriesTooltip tooltip) { /** * @see #setUpColor(Color) + * @since 18.0 */ public Color getUpColor() { return upColor; @@ -1211,6 +1249,8 @@ public Color getUpColor() { * .highcharts-point-negative, .highcharts-sum and * .highcharts-intermediate-sum classes. *

    + * + * @since 18.0 */ public void setUpColor(Color upColor) { this.upColor = upColor; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsXrange.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsXrange.java index 9b03fca835e..0facec82d82 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsXrange.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PlotOptionsXrange.java @@ -15,6 +15,8 @@ /** * Options for the xrange series type. + * + * @since 18.0 */ public class PlotOptionsXrange extends AbstractPlotOptions { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PointOptions.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PointOptions.java index fda1f4b0ec0..5f9ec255abb 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PointOptions.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PointOptions.java @@ -12,6 +12,9 @@ import com.vaadin.flow.component.charts.model.style.Color; +/** + * @since 6.0.1 + */ public abstract class PointOptions extends AbstractPlotOptions { @Override @@ -47,6 +50,7 @@ public abstract class PointOptions extends AbstractPlotOptions { /** * @see #setColor(Color) + * @since 18.0 */ public abstract Color getColor(); @@ -55,6 +59,8 @@ public abstract class PointOptions extends AbstractPlotOptions { * and the point markers unless otherwise specified. In bar type series it * applies to the bars unless a color is specified per point. The default * value is pulled from the options.colors array. + * + * @since 18.0 */ public abstract void setColor(Color color); @@ -84,12 +90,15 @@ public abstract class PointOptions extends AbstractPlotOptions { /** * @see #setClip(Boolean) + * @since 18.0 */ public abstract Boolean getClip(); /** * Disable this option to allow series rendering in the whole plotting area. * Note that clipping should be always enabled when chart.zoomType is set + * + * @since 18.0 */ public abstract void setClip(Boolean clip); @@ -112,11 +121,14 @@ public abstract class PointOptions extends AbstractPlotOptions { * colorAxis is used. Requires to set min and * max if some custom point property is used or if * approximation for data grouping is set to 'sum'. + * + * @since 18.0 */ public abstract void setColorKey(String colorKey); /** * @see #setCrisp(Boolean) + * @since 18.0 */ public abstract Boolean getCrisp(); @@ -127,6 +139,8 @@ public abstract class PointOptions extends AbstractPlotOptions { * or distance between columns. In these cases, setting crisp * to false may look better, even though each column is * rendered blurry. + * + * @since 18.0 */ public abstract void setCrisp(Boolean crisp); @@ -172,6 +186,7 @@ public abstract class PointOptions extends AbstractPlotOptions { /** * @see #setDashStyle(DashStyle) + * @since 18.0 */ public abstract DashStyle getDashStyle(); @@ -193,6 +208,8 @@ public abstract class PointOptions extends AbstractPlotOptions { *
  • LongDashDot
    • *
  • LongDashDotDot
    • * + * + * @since 18.0 */ public abstract void setDashStyle(DashStyle dashStyle); @@ -298,11 +315,14 @@ public abstract class PointOptions extends AbstractPlotOptions { /** * @see #setLineWidth(Number) + * @since 18.0 */ public abstract Number getLineWidth(); /** * The width of the line connecting the data points. + * + * @since 18.0 */ public abstract void setLineWidth(Number lineWidth); @@ -331,22 +351,28 @@ public abstract class PointOptions extends AbstractPlotOptions { /** * @see #setNegativeColor(Color) + * @since 18.0 */ public abstract Color getNegativeColor(); /** * The color for the parts of the graph or points that are below the * threshold. + * + * @since 18.0 */ public abstract void setNegativeColor(Color negativeColor); /** * @see #setOpacity(Number) + * @since 18.0 */ public abstract Number getOpacity(); /** * Opacity of a series parts: line, fill (e.g. area) and dataLabels. + * + * @since 18.0 */ public abstract void setOpacity(Number opacity); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PointPlacement.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PointPlacement.java index 82b4976124b..696005b9fdb 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PointPlacement.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PointPlacement.java @@ -18,6 +18,8 @@ * amount between two points in time or in a certain sector of a polar chart. * * Defaults to null in Cartesian charts, BETWEEN in polar charts. + * + * @since 6.0.1 */ public enum PointPlacement implements ChartEnum { ON("on"), BETWEEN("between"); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Position.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Position.java index 3b50a9ae792..f0a23416b4f 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Position.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Position.java @@ -13,6 +13,8 @@ * verticalAlign, x and y. Defaults to * * position: { align: 'right', x: -10, verticalAlign: 'bottom', y: -5 } + * + * @since 6.0.1 */ public class Position extends AbstractConfigurationObject { private VerticalAlign verticalAlign; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PyramidOptions.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PyramidOptions.java index 323fd77fa79..fb4e84bc6c8 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PyramidOptions.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/PyramidOptions.java @@ -10,6 +10,9 @@ import com.vaadin.flow.component.charts.model.style.Color; +/** + * @since 6.0.1 + */ public abstract class PyramidOptions extends AbstractPlotOptions { @Override @@ -58,12 +61,15 @@ public abstract class PyramidOptions extends AbstractPlotOptions { /** * @see #setClip(Boolean) + * @since 18.0 */ public abstract Boolean getClip(); /** * Disable this option to allow series rendering in the whole plotting area. * Note that clipping should be always enabled when chart.zoomType is set + * + * @since 18.0 */ public abstract void setClip(Boolean clip); @@ -81,6 +87,7 @@ public abstract class PyramidOptions extends AbstractPlotOptions { /** * @see #setColorKey(String) + * @since 18.0 */ public abstract String getColorKey(); @@ -89,17 +96,22 @@ public abstract class PyramidOptions extends AbstractPlotOptions { * colorAxis is used. Requires to set min and * max if some custom point property is used or if * approximation for data grouping is set to 'sum'. + * + * @since 18.0 */ public abstract void setColorKey(String colorKey); /** * @see #setColors(Color...) + * @since 18.0 */ public abstract Color[] getColors(); /** * A series specific or series type specific color set to use instead of the * theme colors. + * + * @since 18.0 */ public abstract void setColors(Color... colors); @@ -109,6 +121,7 @@ public abstract class PyramidOptions extends AbstractPlotOptions { * @param color * to add * @see #setColors(Color...) + * @since 18.0 */ public abstract void addColor(Color color); @@ -118,11 +131,13 @@ public abstract class PyramidOptions extends AbstractPlotOptions { * @param color * to remove * @see #setColors(Color...) + * @since 18.0 */ public abstract void removeColor(Color color); /** * @see #setCrisp(Boolean) + * @since 18.0 */ public abstract Boolean getCrisp(); @@ -133,6 +148,8 @@ public abstract class PyramidOptions extends AbstractPlotOptions { * or distance between columns. In these cases, setting crisp to * falase may look better, even though each column is rendered * blurry. + * + * @since 18.0 */ public abstract void setCrisp(Boolean crisp); @@ -257,12 +274,15 @@ public abstract class PyramidOptions extends AbstractPlotOptions { /** * @see #setIgnoreHiddenPoint(Boolean) + * @since 18.0 */ public abstract Boolean getIgnoreHiddenPoint(); /** * This option tells whether the series shall be redrawn as if the hidden * point were null. + * + * @since 18.0 */ public abstract void setIgnoreHiddenPoint(Boolean ignoreHiddenPoint); @@ -323,11 +343,14 @@ public abstract class PyramidOptions extends AbstractPlotOptions { /** * @see #setOpacity(Number) + * @since 18.0 */ public abstract Number getOpacity(); /** * Opacity of a series parts: line, fill (e.g. area) and dataLabels. + * + * @since 18.0 */ public abstract void setOpacity(Number opacity); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/RangeSelector.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/RangeSelector.java index fc51951c1d4..5db83ea4df1 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/RangeSelector.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/RangeSelector.java @@ -20,6 +20,8 @@ * chart. It provides buttons to select preconfigured ranges in the chart, like * 1 day, 1 week, 1 month etc. It also provides input boxes where min and max * dates can be manually input. + * + * @since 6.0.1 */ public class RangeSelector extends AbstractConfigurationObject { @@ -100,6 +102,7 @@ public void setButtonSpacing(Number buttonSpacing) { /** * @see #setButtonTheme(ButtonTheme) + * @since 18.0 */ public ButtonTheme getButtonTheme() { if (buttonTheme == null) { @@ -133,6 +136,8 @@ public ButtonTheme getButtonTheme() { * .highcharts-range-selector-buttons .highcharts-button rule * with its different states. *

    + * + * @since 18.0 */ public void setButtonTheme(ButtonTheme buttonTheme) { this.buttonTheme = buttonTheme; @@ -252,6 +257,7 @@ public void setHeight(Number height) { /** * @see #setInputBoxBorderColor(Color) + * @since 18.0 */ public Color getInputBoxBorderColor() { return inputBoxBorderColor; @@ -261,6 +267,8 @@ public Color getInputBoxBorderColor() { * The border color of the date input boxes. *

    * Defaults to: #cccccc + * + * @since 18.0 */ public void setInputBoxBorderColor(Color inputBoxBorderColor) { this.inputBoxBorderColor = inputBoxBorderColor; @@ -378,6 +386,7 @@ public void setInputPosition(ButtonPosition inputPosition) { /** * @see #setInputStyle(Style) + * @since 18.0 */ public Style getInputStyle() { if (inputStyle == null) { @@ -398,6 +407,8 @@ public Style getInputStyle() { * .highcharts-range-input text rule in SVG mode, and * input.highcharts-range-selector when active. *

    + * + * @since 18.0 */ public void setInputStyle(Style inputStyle) { this.inputStyle = inputStyle; @@ -405,6 +416,7 @@ public void setInputStyle(Style inputStyle) { /** * @see #setLabelStyle(Style) + * @since 18.0 */ public Style getLabelStyle() { if (labelStyle == null) { @@ -424,6 +436,8 @@ public Style getLabelStyle() { * >styled mode, the labels are styled by the * .highcharts-range-label class. *

    + * + * @since 18.0 */ public void setLabelStyle(Style labelStyle) { this.labelStyle = labelStyle; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/RangeSelectorButton.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/RangeSelectorButton.java index 6af3cd7d465..46bcb9524d6 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/RangeSelectorButton.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/RangeSelectorButton.java @@ -10,6 +10,8 @@ /** * Options for range selector buttons. + * + * @since 6.0.1 */ public class RangeSelectorButton extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/RangeSelectorTimespan.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/RangeSelectorTimespan.java index 3d70d4e8999..1041500115c 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/RangeSelectorTimespan.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/RangeSelectorTimespan.java @@ -10,6 +10,8 @@ /** * Possible timespan values for range selector buttons + * + * @since 6.0.1 */ public enum RangeSelectorTimespan implements ChartEnum { MILLISECOND("millisecond"), diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/RangeSeries.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/RangeSeries.java index 2dcc7b041e8..c96f993bf35 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/RangeSeries.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/RangeSeries.java @@ -10,6 +10,8 @@ /** * Series for range type data + * + * @since 6.0.1 */ @SuppressWarnings("serial") public class RangeSeries extends DataSeries { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ResetZoomButton.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ResetZoomButton.java index 1fe7894e418..e98bdcabb78 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ResetZoomButton.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ResetZoomButton.java @@ -13,6 +13,8 @@ /** * The button that appears after a selection zoom, allowing the user to reset * zoom. + * + * @since 6.0.1 */ public class ResetZoomButton extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ResetZoomButtonRelativeTo.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ResetZoomButtonRelativeTo.java index 42865e1bb0d..d8a42e3f5d3 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ResetZoomButtonRelativeTo.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ResetZoomButtonRelativeTo.java @@ -11,6 +11,8 @@ /** * What frame the button should be placed related to. Can be either "plot" or * "chart". Defaults to plot. + * + * @since 6.0.1 */ public enum ResetZoomButtonRelativeTo implements ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Responsive.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Responsive.java index 29087b90cba..f874c29fa58 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Responsive.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Responsive.java @@ -11,6 +11,8 @@ /** * Allows setting a set of rules to apply for different screen or chart sizes. * Each rule specifies additional chart options. + * + * @since 6.0.1 */ public class Responsive extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Rules.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Rules.java index 3a42507eeff..8f5ed72eb08 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Rules.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Rules.java @@ -11,6 +11,8 @@ /** * A set of rules for responsive settings. The rules are executed from the top * down. + * + * @since 6.0.1 */ public class Rules extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Scrollbar.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Scrollbar.java index f8a337e28be..582e3f587b3 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Scrollbar.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Scrollbar.java @@ -26,6 +26,8 @@ * .highcharts-scrollbar-rifles and * .highcharts-scrollbar-track. *

    + * + * @since 6.0.1 */ public class Scrollbar extends AbstractConfigurationObject { @@ -57,6 +59,7 @@ public Scrollbar() { /** * @see #setBarBackgroundColor(Color) + * @since 18.0 */ public Color getBarBackgroundColor() { return barBackgroundColor; @@ -66,6 +69,8 @@ public Color getBarBackgroundColor() { * The background color of the scrollbar itself. *

    * Defaults to: #cccccc + * + * @since 18.0 */ public void setBarBackgroundColor(Color barBackgroundColor) { this.barBackgroundColor = barBackgroundColor; @@ -73,6 +78,7 @@ public void setBarBackgroundColor(Color barBackgroundColor) { /** * @see #setBarBorderColor(Color) + * @since 18.0 */ public Color getBarBorderColor() { return barBorderColor; @@ -82,6 +88,8 @@ public Color getBarBorderColor() { * The color of the scrollbar's border. *

    * Defaults to: #cccccc + * + * @since 18.0 */ public void setBarBorderColor(Color barBorderColor) { this.barBorderColor = barBorderColor; @@ -121,6 +129,7 @@ public void setBarBorderWidth(Number barBorderWidth) { /** * @see #setButtonArrowColor(Color) + * @since 18.0 */ public Color getButtonArrowColor() { return buttonArrowColor; @@ -130,6 +139,8 @@ public Color getButtonArrowColor() { * The color of the small arrow inside the scrollbar buttons. *

    * Defaults to: #333333 + * + * @since 18.0 */ public void setButtonArrowColor(Color buttonArrowColor) { this.buttonArrowColor = buttonArrowColor; @@ -137,6 +148,7 @@ public void setButtonArrowColor(Color buttonArrowColor) { /** * @see #setButtonBackgroundColor(Color) + * @since 18.0 */ public Color getButtonBackgroundColor() { return buttonBackgroundColor; @@ -146,6 +158,8 @@ public Color getButtonBackgroundColor() { * The color of scrollbar buttons. *

    * Defaults to: #e6e6e6 + * + * @since 18.0 */ public void setButtonBackgroundColor(Color buttonBackgroundColor) { this.buttonBackgroundColor = buttonBackgroundColor; @@ -153,6 +167,7 @@ public void setButtonBackgroundColor(Color buttonBackgroundColor) { /** * @see #setButtonBorderColor(Color) + * @since 18.0 */ public Color getButtonBorderColor() { return buttonBorderColor; @@ -162,6 +177,8 @@ public Color getButtonBorderColor() { * The color of the border of the scrollbar buttons. *

    * Defaults to: #cccccc + * + * @since 18.0 */ public void setButtonBorderColor(Color buttonBorderColor) { this.buttonBorderColor = buttonBorderColor; @@ -400,6 +417,7 @@ public void setHeight(Number height) { /** * @see #setTrackBorderWidth(Number) + * @since 24.7 */ public Number getTrackBorderWidth() { return trackBorderWidth; @@ -407,6 +425,8 @@ public Number getTrackBorderWidth() { /** * The width of the border of the scrollbar track. Defaults to 1. + * + * @since 24.7 */ public void setTrackBorderWidth(Number trackBorderWidth) { this.trackBorderWidth = trackBorderWidth; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Select.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Select.java index 451d51f8646..27468b1cf4c 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Select.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Select.java @@ -13,6 +13,8 @@ /** * The appearance of the point marker when selected. In order to allow a point * to be selected, set the series.allowPointSelect option to true. + * + * @since 6.0.1 */ public class Select extends AbstractConfigurationObject { @@ -47,6 +49,7 @@ public void setEnabled(Boolean enabled) { /** * @see #setFillColor(Color) + * @since 18.0 */ public Color getFillColor() { return fillColor; @@ -54,6 +57,8 @@ public Color getFillColor() { /** * The fill color of the point marker. + * + * @since 18.0 */ public void setFillColor(Color fillColor) { this.fillColor = fillColor; @@ -61,6 +66,7 @@ public void setFillColor(Color fillColor) { /** * @see #setLineColor(Color) + * @since 18.0 */ public Color getLineColor() { return lineColor; @@ -71,6 +77,8 @@ public Color getLineColor() { * series' or point's color is used. *

    * Defaults to: #000000 + * + * @since 18.0 */ public void setLineColor(Color lineColor) { this.lineColor = lineColor; @@ -78,6 +86,7 @@ public void setLineColor(Color lineColor) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -87,6 +96,8 @@ public Number getLineWidth() { * The width of the point marker's outline. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Separator.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Separator.java index 53d241a661f..155748d3c98 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Separator.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Separator.java @@ -10,6 +10,9 @@ import com.vaadin.flow.component.charts.model.style.Style; +/** + * @since 25.0 + */ public class Separator extends AbstractConfigurationObject { private String text; private Style style; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Series.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Series.java index 780c35be1b3..bdb65623fca 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Series.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Series.java @@ -12,6 +12,8 @@ /** * Series interface for all kinds of Series + * + * @since 6.0.1 */ public interface Series extends Serializable { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/SeriesConnectorAnimation.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/SeriesConnectorAnimation.java index 6722bfdc4a8..11c9b54c098 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/SeriesConnectorAnimation.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/SeriesConnectorAnimation.java @@ -10,6 +10,8 @@ /** * Animation of Gantt series connector + * + * @since 24.7 */ @SuppressWarnings("unused") public class SeriesConnectorAnimation extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/SeriesConnectors.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/SeriesConnectors.java index 3b7ec2d7eb6..e39c27f8259 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/SeriesConnectors.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/SeriesConnectors.java @@ -11,6 +11,8 @@ /** * A configuration object to override Pathfinder connector options for a series. * Requires Highcharts Gantt. + * + * @since 24.7 */ @SuppressWarnings("unused") public class SeriesConnectors extends ConnectorStyle { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/SeriesTooltip.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/SeriesTooltip.java index be980bb0302..167211251f1 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/SeriesTooltip.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/SeriesTooltip.java @@ -12,6 +12,8 @@ * A configuration object for the tooltip rendering of each single series. * Properties are inherited from tooltip, but only the * following properties can be defined on a series level. + * + * @since 6.0.1 */ public class SeriesTooltip extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Shape.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Shape.java index 519c8491d2e..a7683ba54ed 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Shape.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Shape.java @@ -11,6 +11,8 @@ /** * The name of a symbol to use for the border around the {@link DataLabels} or * {@link Tooltip}. + * + * @since 6.0.1 */ public enum Shape implements ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Side.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Side.java index 47e629a670a..9bfc1403743 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Side.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Side.java @@ -19,6 +19,8 @@ *

    * The side for the frame around a 3D chart. *

    + * + * @since 6.0.1 */ public class Side extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/StackLabels.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/StackLabels.java index b9d10cdc1cd..c30bebd1e36 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/StackLabels.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/StackLabels.java @@ -15,6 +15,8 @@ * chart. The label will be placed on top of positive columns and below negative * columns. In case of an inverted column chart or a bar chart the label is * placed to the right of positive bars and to the left of negative bars. + * + * @since 6.0.1 */ public class StackLabels extends AbstractConfigurationObject { @@ -114,6 +116,7 @@ public void setRotation(Number rotation) { /** * @see #setStyle(Style) + * @since 18.0 */ public Style getStyle() { if (style == null) { @@ -137,6 +140,8 @@ public Style getStyle() { * Defaults to: { "color": "#000000", "fontSize": "11px", "fontWeight": * "bold", "textShadow": "1px 1px contrast, -1px -1px contrast, -1px 1px * contrast, 1px -1px contrast" } + * + * @since 18.0 */ public void setStyle(Style style) { this.style = style; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Stacking.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Stacking.java index 315a6f1d072..a25d7299a0f 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Stacking.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Stacking.java @@ -12,6 +12,8 @@ * Whether to stack the values of each series on top of each other. Possible * values are null to disable, NORMAL to stack by value or PERCENT. Defaults to * null. + * + * @since 6.0.1 */ public enum Stacking implements ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/States.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/States.java index 0800ba0ef11..e70b9cba2ea 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/States.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/States.java @@ -8,6 +8,9 @@ */ package com.vaadin.flow.component.charts.model; +/** + * @since 6.0.1 + */ public class States extends AbstractConfigurationObject { private Hover hover; @@ -57,6 +60,7 @@ public void setSelect(Select select) { /** * @see #setInactive(Inactive) + * @since 22.0 */ public Inactive getInactive() { if (inactive == null) { @@ -71,6 +75,7 @@ public Inactive getInactive() { * Note: Inactive style is not applied to Marker. * * @see #setHover(Hover) + * @since 22.0 */ public void setInactive(Inactive inactive) { this.inactive = inactive; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/StepType.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/StepType.java index 8db9902cbc9..a3aec6931e3 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/StepType.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/StepType.java @@ -10,6 +10,8 @@ /** * Defines different step line types. Configurable in {@link PlotOptionsLine}. + * + * @since 6.0.1 */ public enum StepType implements ChartEnum { RIGHT("right"), CENTER("center"), LEFT("left"), NONE(""); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Stop.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Stop.java index 1a4fb847ee5..7ffd6bbca9b 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Stop.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Stop.java @@ -10,6 +10,9 @@ import com.vaadin.flow.component.charts.model.style.Color; +/** + * @since 6.0.1 + */ public class Stop extends AbstractConfigurationObject { private float position; private Color color; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Subtitle.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Subtitle.java index 8e9d6f78c57..7ebdce6b7d2 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Subtitle.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Subtitle.java @@ -12,6 +12,8 @@ /** * The chart's subtitle + * + * @since 6.0.1 */ public class Subtitle extends AbstractConfigurationObject { @@ -64,6 +66,7 @@ public void setFloating(Boolean floating) { /** * @see #setStyle(Style) + * @since 18.0 */ public Style getStyle() { if (style == null) { @@ -85,6 +88,8 @@ public Style getStyle() { *

    *

    * Defaults to: { "color": "#666666" } + * + * @since 18.0 */ public void setStyle(Style style) { this.style = style; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TargetOptions.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TargetOptions.java index 82d54cc037d..aac24d67697 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TargetOptions.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TargetOptions.java @@ -12,6 +12,8 @@ /** * Set options related with look and position of targets. + * + * @since 18.0 */ public class TargetOptions extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TextAlign.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TextAlign.java index 4d5b0069d46..e314b918e9c 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TextAlign.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TextAlign.java @@ -15,6 +15,8 @@ * option. * * Defaults to undefined. + * + * @since 6.0.1 */ public enum TextAlign implements ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TickPosition.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TickPosition.java index e2d93f4c108..83cf985082f 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TickPosition.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TickPosition.java @@ -11,6 +11,8 @@ /** * The position of the tick marks relative to the axis line. Can be one of * INSIDE and OUTSIDE. Defaults to OUTSIDE. + * + * @since 6.0.1 */ public enum TickPosition implements ChartEnum { INSIDE("inside"), OUTSIDE("outside"); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TickmarkPlacement.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TickmarkPlacement.java index a4444f17958..f1c9130a57a 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TickmarkPlacement.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TickmarkPlacement.java @@ -12,6 +12,8 @@ * For categorized axes only. If ON the tick mark is placed in the center of the * category, if BETWEEN the tick mark is placed between categories. Defaults to * BETWEEN. + * + * @since 6.0.1 */ public enum TickmarkPlacement implements ChartEnum { ON("on"), BETWEEN("between"); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Time.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Time.java index 4fc77c52365..bd191dae2a4 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Time.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Time.java @@ -12,6 +12,8 @@ * These settings affect how datetime axes are laid out, how tooltips are * formatted, how series pointIntervalUnit works and how the Highstock range * selector handles time. + * + * @since 18.0 */ public class Time extends AbstractConfigurationObject { @@ -24,6 +26,7 @@ public Time() { /** * @see #setTimezone(String) + * @since 25.0 */ public String getTimezone() { return timezone; @@ -45,6 +48,7 @@ public String getTimezone() { * {@link #setUseUTC(Boolean) useUTC} to true. * * @param timezone + * @since 25.0 */ public void setTimezone(String timezone) { this.timezone = timezone; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TimeUnit.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TimeUnit.java index e8497709acb..d66168c2c9f 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TimeUnit.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TimeUnit.java @@ -8,6 +8,9 @@ */ package com.vaadin.flow.component.charts.model; +/** + * @since 6.0.1 + */ public enum TimeUnit implements ChartEnum { MILLISECOND("millisecond"), SECOND("second"), diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TimeUnitMultiples.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TimeUnitMultiples.java index c2a8cf1432d..d85122e6310 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TimeUnitMultiples.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TimeUnitMultiples.java @@ -11,6 +11,8 @@ /** * Class used to define allowed multiples a time unit is allowed to be grouped * to. + * + * @since 6.0.1 */ public class TimeUnitMultiples extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Title.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Title.java index dd8d7749fa2..dda3f3598bc 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Title.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Title.java @@ -12,6 +12,8 @@ /** * The chart's main title. + * + * @since 6.0.1 */ public class Title extends AbstractConfigurationObject { @@ -81,6 +83,7 @@ public void setMargin(Number margin) { /** * @see #setStyle(Style) + * @since 18.0 */ public Style getStyle() { if (style == null) { @@ -103,6 +106,8 @@ public Style getStyle() { *

    *

    * Defaults to: { "color": "#333333", "fontSize": "18px" } + * + * @since 18.0 */ public void setStyle(Style style) { this.style = style; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Tooltip.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Tooltip.java index ef5ae5fc6de..0fdb429352f 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Tooltip.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Tooltip.java @@ -14,6 +14,8 @@ /** * Options for the tooltip that appears when the user hovers over a series or * point. + * + * @since 6.0.1 */ public class Tooltip extends AbstractConfigurationObject { @@ -70,6 +72,7 @@ public void setAnimation(Boolean animation) { /** * @see #setBackgroundColor(Color) + * @since 18.0 */ public Color getBackgroundColor() { return backgroundColor; @@ -88,6 +91,8 @@ public Color getBackgroundColor() { *

    *

    * Defaults to: rgba(247,247,247,0.85) + * + * @since 18.0 */ public void setBackgroundColor(Color backgroundColor) { this.backgroundColor = backgroundColor; @@ -95,6 +100,7 @@ public void setBackgroundColor(Color backgroundColor) { /** * @see #setBorderColor(Color) + * @since 18.0 */ public Color getBorderColor() { return borderColor; @@ -105,6 +111,8 @@ public Color getBorderColor() { * the color of the corresponding series or point. *

    * Defaults to: null + * + * @since 18.0 */ public void setBorderColor(Color borderColor) { this.borderColor = borderColor; @@ -497,6 +505,7 @@ public void setSplit(Boolean split) { /** * @see #setStyle(Style) + * @since 18.0 */ public Style getStyle() { if (style == null) { @@ -511,6 +520,8 @@ public Style getStyle() { *

    * Defaults to: { "color": "#333333", "cursor": "default", "fontSize": * "12px", "pointerEvents": "none", "whiteSpace": "nowrap" } + * + * @since 18.0 */ public void setStyle(Style style) { this.style = style; @@ -616,6 +627,7 @@ public void setChangeDecimals(Number changeDecimals) { /** * @see #setOutside(Boolean) + * @since 18.0 */ public Boolean getOutside() { return outside; @@ -629,6 +641,8 @@ public Boolean getOutside() { * area. For small charts, this may result in clipping or overlapping. When * true, a separate SVG element is created and overlaid on the page, * allowing the tooltip to be aligned inside the page itself. + * + * @since 18.0 */ public void setOutside(Boolean outside) { this.outside = outside; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Top.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Top.java index 78eb6d1df0a..1eb1fe093ea 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Top.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Top.java @@ -12,6 +12,8 @@ /** * The top of the frame around a 3D chart. + * + * @since 6.0.1 */ public class Top extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TreeMapLayoutAlgorithm.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TreeMapLayoutAlgorithm.java index 86349760dbe..d250c44a8dd 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TreeMapLayoutAlgorithm.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TreeMapLayoutAlgorithm.java @@ -10,6 +10,8 @@ /** * The layout algorithm used by {@link ChartType#TREEMAP} charts. + * + * @since 6.0.1 */ public enum TreeMapLayoutAlgorithm implements ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TreeMapLayoutStartingDirection.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TreeMapLayoutStartingDirection.java index 0b36e641546..005569f0623 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TreeMapLayoutStartingDirection.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TreeMapLayoutStartingDirection.java @@ -11,6 +11,8 @@ /** * The direction where the layout algorithm will start drawing. Applies to * {@link ChartType#TREEMAP} charts. + * + * @since 6.0.1 */ public enum TreeMapLayoutStartingDirection implements ChartEnum { VERTICAL("vertical"), HORIZONTAL("horizontal"); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TreeSeries.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TreeSeries.java index fb114b28c94..bc8943818d4 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TreeSeries.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TreeSeries.java @@ -18,6 +18,8 @@ * A collection of {@link TreeSeriesItem TreeSeriesItems} that compose a * multi-root tree. This series is meant to be used with * {@link ChartType#TREEMAP} charts. + * + * @since 6.0.1 */ public class TreeSeries extends AbstractSeries { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TreeSeriesItem.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TreeSeriesItem.java index 287fef0fcc8..a5f5cc1659e 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TreeSeriesItem.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/TreeSeriesItem.java @@ -10,6 +10,8 @@ /** * This class represents one node in a {@link TreeSeries}. + * + * @since 6.0.1 */ public class TreeSeriesItem extends AbstractSeriesItem { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/VerticalAlign.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/VerticalAlign.java index e8f1ebbc7e8..b17e7304ec5 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/VerticalAlign.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/VerticalAlign.java @@ -11,6 +11,8 @@ /** * Alignment of the title relative to the axis values and more generically * vertical alignment. + * + * @since 6.0.1 */ public enum VerticalAlign implements ChartEnum { BOTTOM("bottom"), LOW("low"), MIDDLE("middle"), HIGH("high"), TOP("top"); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/WaterFallSum.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/WaterFallSum.java index 0d6f2498077..2ffb2bd367e 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/WaterFallSum.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/WaterFallSum.java @@ -12,6 +12,8 @@ * DataSeriesItem that can be used as sum or intermediate sum in waterfall * charts. Note that sums don't support all standard point features and their * value don't need be be set (automatically calculated). + * + * @since 6.0.1 */ public class WaterFallSum extends DataSeriesItem { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/XAxis.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/XAxis.java index 0b4111ddb1b..ef1e05c8c95 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/XAxis.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/XAxis.java @@ -23,6 +23,8 @@ * See the Axis object for programmatic * access to the axis. *

    + * + * @since 6.0.1 */ public class XAxis extends Axis { @@ -126,6 +128,8 @@ public Color getAlternateGridColor() { /** * When using an alternate grid color, a band is painted across the plot * area between every other grid line. + * + * @since 18.0 */ public void setAlternateGridColor(Color alternateGridColor) { this.alternateGridColor = alternateGridColor; @@ -367,6 +371,7 @@ public void setFloor(Number floor) { /** * @see #setGridLineColor(Color) + * @since 18.0 */ public Color getGridLineColor() { return gridLineColor; @@ -385,6 +390,8 @@ public Color getGridLineColor() { *

    *

    * Defaults to: #e6e6e6 + * + * @since 18.0 */ public void setGridLineColor(Color gridLineColor) { this.gridLineColor = gridLineColor; @@ -392,6 +399,7 @@ public void setGridLineColor(Color gridLineColor) { /** * @see #setGridLineDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getGridLineDashStyle() { return gridLineDashStyle; @@ -404,6 +412,8 @@ public DashStyle getGridLineDashStyle() { * >this demonstration. *

    * Defaults to: Solid + * + * @since 18.0 */ public void setGridLineDashStyle(DashStyle gridLineDashStyle) { this.gridLineDashStyle = gridLineDashStyle; @@ -411,6 +421,7 @@ public void setGridLineDashStyle(DashStyle gridLineDashStyle) { /** * @see #setGridLineWidth(Number) + * @since 18.0 */ public Number getGridLineWidth() { return gridLineWidth; @@ -429,6 +440,8 @@ public Number getGridLineWidth() { *

    *

    * Defaults to: 0 + * + * @since 18.0 */ public void setGridLineWidth(Number gridLineWidth) { this.gridLineWidth = gridLineWidth; @@ -484,6 +497,7 @@ public void setLabels(Labels labels) { /** * @see #setLineColor(Color) + * @since 18.0 */ public Color getLineColor() { return lineColor; @@ -503,6 +517,8 @@ public Color getLineColor() { *

    *

    * Defaults to: #ccd6eb + * + * @since 18.0 */ public void setLineColor(Color lineColor) { this.lineColor = lineColor; @@ -510,6 +526,7 @@ public void setLineColor(Color lineColor) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -529,6 +546,8 @@ public Number getLineWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -646,6 +665,7 @@ public void setMinTickInterval(Number minTickInterval) { /** * @see #setMinorGridLineColor(Color) + * @since 18.0 */ public Color getMinorGridLineColor() { return minorGridLineColor; @@ -665,6 +685,8 @@ public Color getMinorGridLineColor() { *

    *

    * Defaults to: #f2f2f2 + * + * @since 18.0 */ public void setMinorGridLineColor(Color minorGridLineColor) { this.minorGridLineColor = minorGridLineColor; @@ -672,6 +694,7 @@ public void setMinorGridLineColor(Color minorGridLineColor) { /** * @see #setMinorGridLineDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getMinorGridLineDashStyle() { return minorGridLineDashStyle; @@ -684,6 +707,8 @@ public DashStyle getMinorGridLineDashStyle() { * >this demonstration. *

    * Defaults to: Solid + * + * @since 18.0 */ public void setMinorGridLineDashStyle(DashStyle minorGridLineDashStyle) { this.minorGridLineDashStyle = minorGridLineDashStyle; @@ -691,6 +716,7 @@ public void setMinorGridLineDashStyle(DashStyle minorGridLineDashStyle) { /** * @see #setMinorGridLineWidth(Number) + * @since 18.0 */ public Number getMinorGridLineWidth() { return minorGridLineWidth; @@ -709,6 +735,8 @@ public Number getMinorGridLineWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setMinorGridLineWidth(Number minorGridLineWidth) { this.minorGridLineWidth = minorGridLineWidth; @@ -716,6 +744,7 @@ public void setMinorGridLineWidth(Number minorGridLineWidth) { /** * @see #setMinorTickColor(Color) + * @since 18.0 */ public Color getMinorTickColor() { return minorTickColor; @@ -725,6 +754,8 @@ public Color getMinorTickColor() { * Color for the minor tick marks. *

    * Defaults to: #999999 + * + * @since 18.0 */ public void setMinorTickColor(Color minorTickColor) { this.minorTickColor = minorTickColor; @@ -800,6 +831,7 @@ public void setMinorTickPosition(TickPosition minorTickPosition) { /** * @see #setMinorTickWidth(Number) + * @since 18.0 */ public Number getMinorTickWidth() { return minorTickWidth; @@ -809,6 +841,8 @@ public Number getMinorTickWidth() { * The pixel width of the minor tick mark. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setMinorTickWidth(Number minorTickWidth) { this.minorTickWidth = minorTickWidth; @@ -1124,6 +1158,7 @@ public void setTickAmount(Number tickAmount) { /** * @see #setTickColor(Color) + * @since 18.0 */ public Color getTickColor() { return tickColor; @@ -1142,6 +1177,8 @@ public Color getTickColor() { *

    *

    * Defaults to: #ccd6eb + * + * @since 18.0 */ public void setTickColor(Color tickColor) { this.tickColor = tickColor; @@ -1267,6 +1304,7 @@ public void setTickPositions(Number[] tickPositions) { /** * @see #setTickWidth(Number) + * @since 18.0 */ public Number getTickWidth() { return tickWidth; @@ -1285,6 +1323,8 @@ public Number getTickWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setTickWidth(Number tickWidth) { this.tickWidth = tickWidth; @@ -1527,6 +1567,7 @@ public void setLinkedTo(XAxis axis) { /** * @see #setCurrentDateIndicator(PlotLine) + * @since 24.7 */ public PlotLine getCurrentDateIndicator() { return currentDateIndicator; @@ -1537,6 +1578,7 @@ public PlotLine getCurrentDateIndicator() { * current date and time. * * @param currentDateIndicator + * @since 24.7 */ public void setCurrentDateIndicator(Boolean currentDateIndicator) { if (currentDateIndicator) { @@ -1551,6 +1593,7 @@ public void setCurrentDateIndicator(Boolean currentDateIndicator) { * current date and time. * * @param currentDateIndicator + * @since 24.7 */ public void setCurrentDateIndicator(PlotLine currentDateIndicator) { this.currentDateIndicator = currentDateIndicator; @@ -1558,6 +1601,7 @@ public void setCurrentDateIndicator(PlotLine currentDateIndicator) { /** * @see #setGrid(AxisGrid) + * @since 24.7 */ public AxisGrid getGrid() { return grid; @@ -1565,6 +1609,8 @@ public AxisGrid getGrid() { /** * Set grid options for the axis labels. Relevant only for Highcharts Gantt. + * + * @since 24.7 */ public void setGrid(AxisGrid grid) { this.grid = grid; @@ -1572,6 +1618,7 @@ public void setGrid(AxisGrid grid) { /** * @see #setAlignTicks(Boolean) + * @since 24.7 */ public Boolean getAlignTicks() { return alignTicks; @@ -1588,6 +1635,7 @@ public Boolean getAlignTicks() { * Defaults to true. * * @param alignTicks + * @since 24.7 */ public void setAlignTicks(Boolean alignTicks) { this.alignTicks = alignTicks; @@ -1595,6 +1643,7 @@ public void setAlignTicks(Boolean alignTicks) { /** * @see #setMargin(Number) + * @since 24.7 */ public Number getMargin() { return margin; @@ -1606,6 +1655,7 @@ public Number getMargin() { * axes. * * @param margin + * @since 24.7 */ public void setMargin(Number margin) { this.margin = margin; @@ -1613,6 +1663,7 @@ public void setMargin(Number margin) { /** * @see #setMaxRange(Number) + * @since 24.7 */ public Number getMaxRange() { return maxRange; @@ -1623,6 +1674,7 @@ public Number getMaxRange() { * {@link #setMinRange(Number)} * * @param maxRange + * @since 24.7 */ public void setMaxRange(Number maxRange) { this.maxRange = maxRange; @@ -1630,6 +1682,7 @@ public void setMaxRange(Number maxRange) { /** * @see #setPanningEnabled(Boolean) + * @since 24.7 */ public Boolean getPanningEnabled() { return panningEnabled; @@ -1640,6 +1693,7 @@ public Boolean getPanningEnabled() { * disable panning on an individual axis. Defaults to true. * * @param panningEnabled + * @since 24.7 */ public void setPanningEnabled(Boolean panningEnabled) { this.panningEnabled = panningEnabled; @@ -1647,6 +1701,7 @@ public void setPanningEnabled(Boolean panningEnabled) { /** * @see #setMinorTicks(Boolean) + * @since 24.7 */ public Boolean getMinorTicks() { return minorTicks; @@ -1661,6 +1716,7 @@ public Boolean getMinorTicks() { * Defaults to false. * * @param minorTicks + * @since 24.7 */ public void setMinorTicks(Boolean minorTicks) { this.minorTicks = minorTicks; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/YAxis.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/YAxis.java index f73c35bb4ea..cbb6707efe2 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/YAxis.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/YAxis.java @@ -22,6 +22,8 @@ * See the Axis object for * programmatic access to the axis. *

    + * + * @since 6.0.1 */ public class YAxis extends Axis { @@ -134,6 +136,8 @@ public Color getAlternateGridColor() { /** * When using an alternate grid color, a band is painted across the plot * area between every other grid line. + * + * @since 18.0 */ public void setAlternateGridColor(Color alternateGridColor) { this.alternateGridColor = alternateGridColor; @@ -393,6 +397,7 @@ public void setFloor(Number floor) { /** * @see #setGridLineColor(Color) + * @since 18.0 */ public Color getGridLineColor() { return gridLineColor; @@ -411,6 +416,8 @@ public Color getGridLineColor() { *

    *

    * Defaults to: #e6e6e6 + * + * @since 18.0 */ public void setGridLineColor(Color gridLineColor) { this.gridLineColor = gridLineColor; @@ -418,6 +425,7 @@ public void setGridLineColor(Color gridLineColor) { /** * @see #setGridLineDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getGridLineDashStyle() { return gridLineDashStyle; @@ -430,6 +438,8 @@ public DashStyle getGridLineDashStyle() { * >this demonstration. *

    * Defaults to: Solid + * + * @since 18.0 */ public void setGridLineDashStyle(DashStyle gridLineDashStyle) { this.gridLineDashStyle = gridLineDashStyle; @@ -455,6 +465,7 @@ public void setGridLineInterpolation(String gridLineInterpolation) { /** * @see #setGridLineWidth(Number) + * @since 18.0 */ public Number getGridLineWidth() { return gridLineWidth; @@ -464,6 +475,8 @@ public Number getGridLineWidth() { * The width of the grid lines extending the ticks across the plot area. *

    * Defaults to: 1 + * + * @since 18.0 */ public void setGridLineWidth(Number gridLineWidth) { this.gridLineWidth = gridLineWidth; @@ -516,6 +529,7 @@ public void setLabels(Labels labels) { /** * @see #setLineColor(Color) + * @since 18.0 */ public Color getLineColor() { return lineColor; @@ -535,6 +549,8 @@ public Color getLineColor() { *

    *

    * Defaults to: #ccd6eb + * + * @since 18.0 */ public void setLineColor(Color lineColor) { this.lineColor = lineColor; @@ -542,6 +558,7 @@ public void setLineColor(Color lineColor) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -551,6 +568,8 @@ public Number getLineWidth() { * The width of the line marking the axis itself. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -575,6 +594,7 @@ public void setLinkedTo(Number linkedTo) { /** * @see #setMaxColor(Color) + * @since 18.0 */ public Color getMaxColor() { return maxColor; @@ -585,6 +605,8 @@ public Color getMaxColor() { * color to represent the maximum value of the Y axis. *

    * Defaults to: #003399 + * + * @since 18.0 */ public void setMaxColor(Color maxColor) { this.maxColor = maxColor; @@ -610,6 +632,7 @@ public void setMaxPadding(Number maxPadding) { /** * @see #setMinColor(Color) + * @since 18.0 */ public Color getMinColor() { return minColor; @@ -620,6 +643,8 @@ public Color getMinColor() { * color to represent the minimum value of the Y axis. *

    * Defaults to: #e6ebf5 + * + * @since 18.0 */ public void setMinColor(Color minColor) { this.minColor = minColor; @@ -698,6 +723,7 @@ public void setMinTickInterval(Number minTickInterval) { /** * @see #setMinorGridLineColor(Color) + * @since 18.0 */ public Color getMinorGridLineColor() { return minorGridLineColor; @@ -717,6 +743,8 @@ public Color getMinorGridLineColor() { *

    *

    * Defaults to: #f2f2f2 + * + * @since 18.0 */ public void setMinorGridLineColor(Color minorGridLineColor) { this.minorGridLineColor = minorGridLineColor; @@ -724,6 +752,7 @@ public void setMinorGridLineColor(Color minorGridLineColor) { /** * @see #setMinorGridLineDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getMinorGridLineDashStyle() { return minorGridLineDashStyle; @@ -736,6 +765,8 @@ public DashStyle getMinorGridLineDashStyle() { * >this demonstration. *

    * Defaults to: Solid + * + * @since 18.0 */ public void setMinorGridLineDashStyle(DashStyle minorGridLineDashStyle) { this.minorGridLineDashStyle = minorGridLineDashStyle; @@ -743,6 +774,7 @@ public void setMinorGridLineDashStyle(DashStyle minorGridLineDashStyle) { /** * @see #setMinorGridLineWidth(Number) + * @since 18.0 */ public Number getMinorGridLineWidth() { return minorGridLineWidth; @@ -761,6 +793,8 @@ public Number getMinorGridLineWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setMinorGridLineWidth(Number minorGridLineWidth) { this.minorGridLineWidth = minorGridLineWidth; @@ -768,6 +802,7 @@ public void setMinorGridLineWidth(Number minorGridLineWidth) { /** * @see #setMinorTickColor(Color) + * @since 18.0 */ public Color getMinorTickColor() { return minorTickColor; @@ -777,6 +812,8 @@ public Color getMinorTickColor() { * Color for the minor tick marks. *

    * Defaults to: #999999 + * + * @since 18.0 */ public void setMinorTickColor(Color minorTickColor) { this.minorTickColor = minorTickColor; @@ -852,6 +889,7 @@ public void setMinorTickPosition(TickPosition minorTickPosition) { /** * @see #setMinorTickWidth(Number) + * @since 18.0 */ public Number getMinorTickWidth() { return minorTickWidth; @@ -861,6 +899,8 @@ public Number getMinorTickWidth() { * The pixel width of the minor tick mark. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setMinorTickWidth(Number minorTickWidth) { this.minorTickWidth = minorTickWidth; @@ -1187,6 +1227,7 @@ public void setTickAmount(Number tickAmount) { /** * @see #setTickColor(Color) + * @since 18.0 */ public Color getTickColor() { return tickColor; @@ -1205,6 +1246,8 @@ public Color getTickColor() { *

    *

    * Defaults to: #ccd6eb + * + * @since 18.0 */ public void setTickColor(Color tickColor) { this.tickColor = tickColor; @@ -1330,6 +1373,7 @@ public void setTickPositions(Number[] tickPositions) { /** * @see #setTickWidth(Number) + * @since 18.0 */ public Number getTickWidth() { return tickWidth; @@ -1339,6 +1383,8 @@ public Number getTickWidth() { * The pixel width of the major tick marks. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setTickWidth(Number tickWidth) { this.tickWidth = tickWidth; @@ -1695,6 +1741,7 @@ public void removeStop(Stop stop) { /** * @see #setGrid(AxisGrid) + * @since 24.7 */ public AxisGrid getGrid() { return grid; @@ -1702,6 +1749,8 @@ public AxisGrid getGrid() { /** * Set grid options for the axis labels. Relevant only for Highcharts Gantt. + * + * @since 24.7 */ public void setGrid(AxisGrid grid) { this.grid = grid; @@ -1709,6 +1758,7 @@ public void setGrid(AxisGrid grid) { /** * @see #setAlignTicks(Boolean) + * @since 24.7 */ public Boolean getAlignTicks() { return alignTicks; @@ -1725,6 +1775,7 @@ public Boolean getAlignTicks() { * Defaults to true. * * @param alignTicks + * @since 24.7 */ public void setAlignTicks(Boolean alignTicks) { this.alignTicks = alignTicks; @@ -1732,6 +1783,7 @@ public void setAlignTicks(Boolean alignTicks) { /** * @see #setMargin(Number) + * @since 24.7 */ public Number getMargin() { return margin; @@ -1743,6 +1795,7 @@ public Number getMargin() { * axes. * * @param margin + * @since 24.7 */ public void setMargin(Number margin) { this.margin = margin; @@ -1750,6 +1803,7 @@ public void setMargin(Number margin) { /** * @see #setMaxRange(Number) + * @since 24.7 */ public Number getMaxRange() { return maxRange; @@ -1760,6 +1814,7 @@ public Number getMaxRange() { * {@link #setMinRange(Number)} * * @param maxRange + * @since 24.7 */ public void setMaxRange(Number maxRange) { this.maxRange = maxRange; @@ -1767,6 +1822,7 @@ public void setMaxRange(Number maxRange) { /** * @see #setMinorTicks(Boolean) + * @since 24.7 */ public Boolean getMinorTicks() { return minorTicks; @@ -1781,6 +1837,7 @@ public Boolean getMinorTicks() { * Defaults to false. * * @param minorTicks + * @since 24.7 */ public void setMinorTicks(Boolean minorTicks) { this.minorTicks = minorTicks; @@ -1788,6 +1845,7 @@ public void setMinorTicks(Boolean minorTicks) { /** * @see #setStaticScale(Number) + * @since 24.7 */ public Number getStaticScale() { return staticScale; @@ -1801,6 +1859,7 @@ public Number getStaticScale() { * Adding or removing items will make the chart resize. Defaults to 50. * * @param staticScale + * @since 24.7 */ public void setStaticScale(Number staticScale) { this.staticScale = staticScale; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ZAxis.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ZAxis.java index 7c34aaaafe9..255c6f488b5 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ZAxis.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ZAxis.java @@ -21,6 +21,8 @@ * See the Axis object for programmatic * access to the axis. *

    + * + * @since 6.0.1 */ public class ZAxis extends Axis { @@ -113,6 +115,8 @@ public Color getAlternateGridColor() { /** * When using an alternate grid color, a band is painted across the plot * area between every other grid line. + * + * @since 18.0 */ public void setAlternateGridColor(Color alternateGridColor) { this.alternateGridColor = alternateGridColor; @@ -338,6 +342,7 @@ public void setFloor(Number floor) { /** * @see #setGridLineColor(Color) + * @since 18.0 */ public Color getGridLineColor() { return gridLineColor; @@ -356,6 +361,8 @@ public Color getGridLineColor() { *

    *

    * Defaults to: #e6e6e6 + * + * @since 18.0 */ public void setGridLineColor(Color gridLineColor) { this.gridLineColor = gridLineColor; @@ -363,6 +370,7 @@ public void setGridLineColor(Color gridLineColor) { /** * @see #setGridLineDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getGridLineDashStyle() { return gridLineDashStyle; @@ -375,6 +383,8 @@ public DashStyle getGridLineDashStyle() { * >this demonstration. *

    * Defaults to: Solid + * + * @since 18.0 */ public void setGridLineDashStyle(DashStyle gridLineDashStyle) { this.gridLineDashStyle = gridLineDashStyle; @@ -382,6 +392,7 @@ public void setGridLineDashStyle(DashStyle gridLineDashStyle) { /** * @see #setGridLineWidth(Number) + * @since 18.0 */ public Number getGridLineWidth() { return gridLineWidth; @@ -400,6 +411,8 @@ public Number getGridLineWidth() { *

    *

    * Defaults to: 0 + * + * @since 18.0 */ public void setGridLineWidth(Number gridLineWidth) { this.gridLineWidth = gridLineWidth; @@ -455,6 +468,7 @@ public void setLabels(Labels labels) { /** * @see #setLineColor(Color) + * @since 18.0 */ public Color getLineColor() { return lineColor; @@ -474,6 +488,8 @@ public Color getLineColor() { *

    *

    * Defaults to: #ccd6eb + * + * @since 18.0 */ public void setLineColor(Color lineColor) { this.lineColor = lineColor; @@ -481,6 +497,7 @@ public void setLineColor(Color lineColor) { /** * @see #setLineWidth(Number) + * @since 18.0 */ public Number getLineWidth() { return lineWidth; @@ -500,6 +517,8 @@ public Number getLineWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setLineWidth(Number lineWidth) { this.lineWidth = lineWidth; @@ -617,6 +636,7 @@ public void setMinTickInterval(Number minTickInterval) { /** * @see #setMinorGridLineColor(Color) + * @since 18.0 */ public Color getMinorGridLineColor() { return minorGridLineColor; @@ -636,6 +656,8 @@ public Color getMinorGridLineColor() { *

    *

    * Defaults to: #f2f2f2 + * + * @since 18.0 */ public void setMinorGridLineColor(Color minorGridLineColor) { this.minorGridLineColor = minorGridLineColor; @@ -643,6 +665,7 @@ public void setMinorGridLineColor(Color minorGridLineColor) { /** * @see #setMinorGridLineDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getMinorGridLineDashStyle() { return minorGridLineDashStyle; @@ -655,6 +678,8 @@ public DashStyle getMinorGridLineDashStyle() { * >this demonstration. *

    * Defaults to: Solid + * + * @since 18.0 */ public void setMinorGridLineDashStyle(DashStyle minorGridLineDashStyle) { this.minorGridLineDashStyle = minorGridLineDashStyle; @@ -662,6 +687,7 @@ public void setMinorGridLineDashStyle(DashStyle minorGridLineDashStyle) { /** * @see #setMinorGridLineWidth(Number) + * @since 18.0 */ public Number getMinorGridLineWidth() { return minorGridLineWidth; @@ -680,6 +706,8 @@ public Number getMinorGridLineWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setMinorGridLineWidth(Number minorGridLineWidth) { this.minorGridLineWidth = minorGridLineWidth; @@ -687,6 +715,7 @@ public void setMinorGridLineWidth(Number minorGridLineWidth) { /** * @see #setMinorTickColor(Color) + * @since 18.0 */ public Color getMinorTickColor() { return minorTickColor; @@ -696,6 +725,8 @@ public Color getMinorTickColor() { * Color for the minor tick marks. *

    * Defaults to: #999999 + * + * @since 18.0 */ public void setMinorTickColor(Color minorTickColor) { this.minorTickColor = minorTickColor; @@ -771,6 +802,7 @@ public void setMinorTickPosition(TickPosition minorTickPosition) { /** * @see #setMinorTickWidth(Number) + * @since 18.0 */ public Number getMinorTickWidth() { return minorTickWidth; @@ -780,6 +812,8 @@ public Number getMinorTickWidth() { * The pixel width of the minor tick mark. *

    * Defaults to: 0 + * + * @since 18.0 */ public void setMinorTickWidth(Number minorTickWidth) { this.minorTickWidth = minorTickWidth; @@ -1095,6 +1129,7 @@ public void setTickAmount(Number tickAmount) { /** * @see #setTickColor(Color) + * @since 18.0 */ public Color getTickColor() { return tickColor; @@ -1113,6 +1148,8 @@ public Color getTickColor() { *

    *

    * Defaults to: #ccd6eb + * + * @since 18.0 */ public void setTickColor(Color tickColor) { this.tickColor = tickColor; @@ -1238,6 +1275,7 @@ public void setTickPositions(Number[] tickPositions) { /** * @see #setTickWidth(Number) + * @since 18.0 */ public Number getTickWidth() { return tickWidth; @@ -1256,6 +1294,8 @@ public Number getTickWidth() { *

    *

    * Defaults to: 1 + * + * @since 18.0 */ public void setTickWidth(Number tickWidth) { this.tickWidth = tickWidth; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ZoneAxis.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ZoneAxis.java index ed06dbe9581..0f59d43f3cd 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ZoneAxis.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ZoneAxis.java @@ -12,6 +12,8 @@ * Defines the Axis on which the zones are applied. * * Defaults to y. + * + * @since 6.0.1 */ public enum ZoneAxis implements ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Zones.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Zones.java index 4317f40030c..6e9be48cb62 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Zones.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Zones.java @@ -25,6 +25,8 @@ * "http://jsfiddle.net/gh/get/library/pure/highcharts/highcharts/tree/master/samples/highcharts/css/color-zones/" * >view live demo). *

    + * + * @since 6.0.1 */ public class Zones extends AbstractConfigurationObject { @@ -55,6 +57,7 @@ public void setClassName(String className) { /** * @see #setColor(Color) + * @since 18.0 */ public Color getColor() { return color; @@ -62,6 +65,8 @@ public Color getColor() { /** * Defines the color of the series. + * + * @since 18.0 */ public void setColor(Color color) { this.color = color; @@ -69,6 +74,7 @@ public void setColor(Color color) { /** * @see #setDashStyle(DashStyle) + * @since 18.0 */ public DashStyle getDashStyle() { return dashStyle; @@ -76,6 +82,8 @@ public DashStyle getDashStyle() { /** * A name for the dash style to use for the graph. + * + * @since 18.0 */ public void setDashStyle(DashStyle dashStyle) { this.dashStyle = dashStyle; @@ -83,6 +91,7 @@ public void setDashStyle(DashStyle dashStyle) { /** * @see #setFillColor(Color) + * @since 18.0 */ public Color getFillColor() { return fillColor; @@ -90,6 +99,8 @@ public Color getFillColor() { /** * Defines the fill color for the series (in area type series) + * + * @since 18.0 */ public void setFillColor(Color fillColor) { this.fillColor = fillColor; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Zooming.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Zooming.java index 60449378843..4701967c498 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Zooming.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/Zooming.java @@ -11,6 +11,8 @@ /** * Options for zooming configuration. This enables zooming in on plots and * provides options for controlling zoom behavior including mouse wheel support. + * + * @since 25.0 */ public class Zooming extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ZoomingMouseWheel.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ZoomingMouseWheel.java index 5206bf5fd5d..2c694641115 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ZoomingMouseWheel.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ZoomingMouseWheel.java @@ -17,6 +17,8 @@ * {@link Chart#setTimeline(Boolean)} charts. In other chart types, it is * enabled if {@link #getEnabled()} is set. It can be disabled by setting * {@link #setEnabled(Boolean)} option to false. + * + * @since 25.0 */ public class ZoomingMouseWheel extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ZoomingResetButton.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ZoomingResetButton.java index 55cf60411f9..af7f2bb3e75 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ZoomingResetButton.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/ZoomingResetButton.java @@ -16,6 +16,7 @@ * * @apiNote This button is only shown after a selection zoom, not after a mouse * wheel zoom. + * @since 25.0 */ public class ZoomingResetButton extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/AbstractSeriesBeanSerializer.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/AbstractSeriesBeanSerializer.java index a1e6fbf6d70..dac251d8505 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/AbstractSeriesBeanSerializer.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/AbstractSeriesBeanSerializer.java @@ -18,6 +18,7 @@ * Custom bean serializer for {@link AbstractSeries} that adds the type field. * We need to use a bean serializer so that annotations work. * + * @since 6.0.1 */ public class AbstractSeriesBeanSerializer extends BeanSerializationDelegate { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/AxisListSerializer.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/AxisListSerializer.java index af167540575..b648d296320 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/AxisListSerializer.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/AxisListSerializer.java @@ -19,6 +19,7 @@ /** * Serializer for {@link AxisList} * + * @since 6.0.1 */ public class AxisListSerializer extends ValueSerializer { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/AxisTitleBeanSerializer.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/AxisTitleBeanSerializer.java index 87eae8bcc36..f6274f36133 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/AxisTitleBeanSerializer.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/AxisTitleBeanSerializer.java @@ -16,6 +16,7 @@ /** * Serializer for {@link com.vaadin.flow.component.charts.model.AxisTitle}. * + * @since 6.0.1 */ public class AxisTitleBeanSerializer extends BeanSerializationDelegate { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/BeanSerializationDelegate.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/BeanSerializationDelegate.java index c290c4ea51a..fabd8a55491 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/BeanSerializationDelegate.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/BeanSerializationDelegate.java @@ -18,6 +18,7 @@ * implementing {@link BeanSerializerBase}. * * @param + * @since 6.0.1 */ public abstract class BeanSerializationDelegate { public abstract Class getBeanClass(); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/BeanSerializerDelegator.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/BeanSerializerDelegator.java index 4526296c5a5..1a7f9d7f674 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/BeanSerializerDelegator.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/BeanSerializerDelegator.java @@ -26,6 +26,7 @@ * implementing {@link BeanSerializerBase}. * * @param + * @since 6.0.1 */ public class BeanSerializerDelegator extends BeanSerializerBase { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/ChartEnumSerializer.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/ChartEnumSerializer.java index da433ca1fa9..409b0215acd 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/ChartEnumSerializer.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/ChartEnumSerializer.java @@ -19,6 +19,7 @@ /** * Serializer for all classes implementing {@link ChartEnum} * + * @since 6.0.1 */ public class ChartEnumSerializer extends ValueSerializer { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/DataProviderSeriesBeanSerializer.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/DataProviderSeriesBeanSerializer.java index 7b27eccd750..40ca8d86310 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/DataProviderSeriesBeanSerializer.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/DataProviderSeriesBeanSerializer.java @@ -29,6 +29,8 @@ /** * Custom bean serializer for {@link DataProviderSeries} + * + * @since 6.0.1 */ public class DataProviderSeriesBeanSerializer extends BeanSerializationDelegate { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/DataSeriesItemBeanSerializer.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/DataSeriesItemBeanSerializer.java index 1d7e4d980c8..c18e6967b72 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/DataSeriesItemBeanSerializer.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/DataSeriesItemBeanSerializer.java @@ -19,6 +19,7 @@ /** * Custom bean serializer for {@link DataSeriesItem} * + * @since 6.0.1 */ public class DataSeriesItemBeanSerializer extends BeanSerializationDelegate { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/DateSerializer.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/DateSerializer.java index 0d61b4c96e4..87c10ef1971 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/DateSerializer.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/DateSerializer.java @@ -21,6 +21,8 @@ /** * Serializes all {@link Date} objects as UTC long. + * + * @since 6.0.1 */ public class DateSerializer extends ValueSerializer { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/DefaultBeanSerializerModifier.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/DefaultBeanSerializerModifier.java index dd615068608..011952051bc 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/DefaultBeanSerializerModifier.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/DefaultBeanSerializerModifier.java @@ -24,6 +24,8 @@ /** * Logic for altering the bean serialization process. Mainly used when * serialization needs to be customized with a bean serializer. + * + * @since 6.0.1 */ public class DefaultBeanSerializerModifier extends ValueSerializerModifier { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/GradientColorStopsSerializer.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/GradientColorStopsSerializer.java index 8582ef4e149..6715547088e 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/GradientColorStopsSerializer.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/GradientColorStopsSerializer.java @@ -16,6 +16,9 @@ import tools.jackson.databind.ValueSerializer; import tools.jackson.databind.module.SimpleModule; +/** + * @since 18.0 + */ public class GradientColorStopsSerializer extends ValueSerializer { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/InstantSerializer.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/InstantSerializer.java index 64c1f02127c..7f54dc3b269 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/InstantSerializer.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/InstantSerializer.java @@ -21,6 +21,7 @@ /** * Serializes all {@link java.time.Instant} objects as UTC long. * + * @since 6.0.1 */ public class InstantSerializer extends ValueSerializer { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/LabelsRotationSerializer.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/LabelsRotationSerializer.java index c2c7aaae522..92c06b07f13 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/LabelsRotationSerializer.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/LabelsRotationSerializer.java @@ -18,6 +18,8 @@ * Serializer for {@link Labels#getRotation()}. Attempts to serialize the * rotation value as a number, otherwise falls back to writing it as a string to * support values like "auto". + * + * @since 24.7.7 */ public class LabelsRotationSerializer extends ValueSerializer { @Override diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/LegendTitleBeanSerializer.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/LegendTitleBeanSerializer.java index 78ede8bd35d..47bc1480934 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/LegendTitleBeanSerializer.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/LegendTitleBeanSerializer.java @@ -16,6 +16,7 @@ /** * Serializer for {@link com.vaadin.flow.component.charts.model.LegendTitle}. * + * @since 6.0.1 */ public class LegendTitleBeanSerializer extends BeanSerializationDelegate { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/PaneListSerializer.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/PaneListSerializer.java index d3312dc599d..64bc27802d4 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/PaneListSerializer.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/PaneListSerializer.java @@ -19,6 +19,7 @@ /** * Serializer for {@link PaneList} * + * @since 6.0.1 */ public class PaneListSerializer extends ValueSerializer { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/SolidColorSerializer.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/SolidColorSerializer.java index 4646154aec9..a75c8171507 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/SolidColorSerializer.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/SolidColorSerializer.java @@ -19,6 +19,7 @@ /** * Serializer for {@link SolidColor} * + * @since 6.0.1 */ public class SolidColorSerializer extends ValueSerializer { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/StopSerializer.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/StopSerializer.java index ce41926721b..0f69c2669bd 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/StopSerializer.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/StopSerializer.java @@ -19,6 +19,7 @@ /** * Serializer for {@link com.vaadin.flow.component.charts.model.Stop}. * + * @since 6.0.1 */ public class StopSerializer extends ValueSerializer { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/TimeUnitMultiplesSerializer.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/TimeUnitMultiplesSerializer.java index 11ecb1c0518..98fb3f41662 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/TimeUnitMultiplesSerializer.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/TimeUnitMultiplesSerializer.java @@ -20,6 +20,7 @@ * Serializer for * {@link com.vaadin.flow.component.charts.model.TimeUnitMultiples}. * + * @since 6.0.1 */ public class TimeUnitMultiplesSerializer extends ValueSerializer { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/TitleBeanSerializer.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/TitleBeanSerializer.java index b5edc985989..8c7848b6723 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/TitleBeanSerializer.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/serializers/TitleBeanSerializer.java @@ -15,6 +15,8 @@ /** * Serializer for {@link Title} + * + * @since 6.0.1 */ public class TitleBeanSerializer extends BeanSerializationDelegate { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/AxisStyle.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/AxisStyle.java index 159e0b695b7..58b11bbeeb1 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/AxisStyle.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/AxisStyle.java @@ -12,6 +12,8 @@ /** * The AxisStyle class contains options for customizing the style of an axis + * + * @since 18.0 */ @SuppressWarnings("serial") public class AxisStyle extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/ButtonTheme.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/ButtonTheme.java index bae3651fd89..97caa91ada4 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/ButtonTheme.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/ButtonTheme.java @@ -11,6 +11,9 @@ import com.fasterxml.jackson.annotation.JsonProperty; import com.vaadin.flow.component.charts.model.AbstractConfigurationObject; +/** + * @since 6.0.1 + */ public class ButtonTheme extends AbstractConfigurationObject { private Color fill; private Color stroke; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/ChartStyle.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/ChartStyle.java index 86c2b13d5c1..c229a8f4451 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/ChartStyle.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/ChartStyle.java @@ -12,6 +12,8 @@ /** * Styles of chart + * + * @since 18.0 */ @SuppressWarnings("serial") public class ChartStyle extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/Color.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/Color.java index 12e95513fdb..64993678dda 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/Color.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/Color.java @@ -15,6 +15,7 @@ * * @see GradientColor * @see SolidColor + * @since 6.0.1 */ public interface Color extends Serializable { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/FontWeight.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/FontWeight.java index fc52d54ccc6..f3286b28e91 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/FontWeight.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/FontWeight.java @@ -12,6 +12,8 @@ /** * Font weight used by Style class + * + * @since 6.0.1 */ public enum FontWeight implements ChartEnum { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/GradientColor.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/GradientColor.java index 1292d04dfa2..771b5e7e5fb 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/GradientColor.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/GradientColor.java @@ -14,6 +14,8 @@ /** * Class providing gradient colors + * + * @since 18.0 */ public class GradientColor implements Color { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/LegendStyle.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/LegendStyle.java index 1e964286212..18ebe315e19 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/LegendStyle.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/LegendStyle.java @@ -12,6 +12,8 @@ /** * Style options for Legend + * + * @since 18.0 */ public class LegendStyle extends Legend { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/MarkerStyle.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/MarkerStyle.java index 5aaaf7f3e70..64e977eea72 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/MarkerStyle.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/MarkerStyle.java @@ -12,6 +12,8 @@ /** * Marker style + * + * @since 18.0 */ public class MarkerStyle extends AbstractConfigurationObject { private Color lineColor; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/PlotOptionsStyle.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/PlotOptionsStyle.java index 119670b9278..4638d9197d3 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/PlotOptionsStyle.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/PlotOptionsStyle.java @@ -44,6 +44,8 @@ /** * Styles for PlotOptions of different plot types + * + * @since 18.0 */ @SuppressWarnings("serial") public class PlotOptionsStyle extends AbstractConfigurationObject { @@ -547,6 +549,7 @@ public void setXrange(PlotOptionsXrange xrange) { /** * @see #setGantt(PlotOptionsGantt) + * @since 24.7 */ public PlotOptionsGantt getGantt() { return gantt; @@ -556,6 +559,7 @@ public PlotOptionsGantt getGantt() { * Sets the style options for {@link ChartType#GANTT} charts * * @param gantt + * @since 24.7 */ public void setGantt(PlotOptionsGantt gantt) { this.gantt = gantt; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/SolidColor.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/SolidColor.java index 4070393e140..cab16227628 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/SolidColor.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/SolidColor.java @@ -14,6 +14,8 @@ /** * Solid (non gradient) colors + * + * @since 6.0.1 */ @SuppressWarnings("serial") public class SolidColor extends AbstractConfigurationObject implements Color { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/Style.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/Style.java index 9289d66e6f3..cb6be703832 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/Style.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/Style.java @@ -12,6 +12,8 @@ /** * Style options for CSS styling + * + * @since 18.0 */ @SuppressWarnings("serial") public class Style extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/StylePosition.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/StylePosition.java index e14d7258bc3..0e86ada5729 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/StylePosition.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/StylePosition.java @@ -12,6 +12,8 @@ /** * CSS position attribute, ABSOLUTE or RELATIVE + * + * @since 6.0.1 */ public enum StylePosition implements ChartEnum { ABSOLUTE("absolute"), RELATIVE("relative"); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/StyleWrapper.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/StyleWrapper.java index ef19d2de4f2..ef353f35599 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/StyleWrapper.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/StyleWrapper.java @@ -12,6 +12,8 @@ /** * Helper class when JSON structure needs object with just style field + * + * @since 18.0 */ public class StyleWrapper extends AbstractConfigurationObject { private Style style = new Style(); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/Theme.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/Theme.java index 707fcea834a..d2faa2d6937 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/Theme.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/Theme.java @@ -18,6 +18,7 @@ * theme your Charts. * * @see LumoLightTheme + * @since 18.0 */ public class Theme extends AbstractConfigurationObject { private Color[] colors; diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/TickIntervalStyle.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/TickIntervalStyle.java index ce79c8a9c24..4a8f911669e 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/TickIntervalStyle.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/TickIntervalStyle.java @@ -10,6 +10,9 @@ import com.vaadin.flow.component.charts.model.ChartEnum; +/** + * @since 18.0 + */ public enum TickIntervalStyle implements ChartEnum { AUTO("auto"), NONE(""); diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/TooltipStyle.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/TooltipStyle.java index 190cf618953..c2449844fcf 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/TooltipStyle.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/model/style/TooltipStyle.java @@ -12,6 +12,8 @@ /** * Style options for tooltips + * + * @since 18.0 */ public class TooltipStyle extends AbstractConfigurationObject { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/themes/LumoDarkTheme.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/themes/LumoDarkTheme.java index 8c9669d2fb3..474c35954c4 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/themes/LumoDarkTheme.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/themes/LumoDarkTheme.java @@ -20,6 +20,8 @@ /** * The dark version of the default theme for Vaadin Charts. Suitable for use * with the Lumo theme for Vaadin. + * + * @since 18.0 */ @SuppressWarnings("serial") public class LumoDarkTheme extends Theme { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/themes/LumoLightTheme.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/themes/LumoLightTheme.java index 9131a3a405a..7b140fa25ff 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/themes/LumoLightTheme.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/themes/LumoLightTheme.java @@ -20,6 +20,8 @@ /** * The default theme for Vaadin Charts. Suitable for use with the Lumo theme for * Vaadin. + * + * @since 18.0 */ @SuppressWarnings("serial") public class LumoLightTheme extends Theme { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/util/ChartSerialization.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/util/ChartSerialization.java index 94af0377fb2..327c181c6e1 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/util/ChartSerialization.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/util/ChartSerialization.java @@ -35,6 +35,8 @@ /** * Util class that handles the configuration needed for the model classes to be * serialized to JSON. + * + * @since 6.0.1 */ public class ChartSerialization implements Serializable { diff --git a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/util/Util.java b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/util/Util.java index dca83be95f9..7becb2de462 100644 --- a/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/util/Util.java +++ b/vaadin-charts-flow-parent/vaadin-charts-flow/src/main/java/com/vaadin/flow/component/charts/util/Util.java @@ -10,6 +10,9 @@ import java.time.Instant; +/** + * @since 6.0.1 + */ public class Util { /** diff --git a/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/Checkbox.java b/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/Checkbox.java index 0feb1b7c00d..49c6912e2c6 100644 --- a/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/Checkbox.java +++ b/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/Checkbox.java @@ -79,6 +79,7 @@ * {@link #setInvalid(boolean)} and {@link #setErrorMessage(String)} API. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-checkbox") @NpmPackage(value = "@vaadin/checkbox", version = "25.2.0") @@ -201,6 +202,7 @@ public Checkbox(String label, * the value change listener to add * @see AbstractField#setValue(Object) * @see #addValueChangeListener(ValueChangeListener) + * @since 23.1 */ public Checkbox(boolean initialValue, ValueChangeListener<ComponentValueChangeEvent<Checkbox, Boolean>> listener) { @@ -221,6 +223,7 @@ public Checkbox(boolean initialValue, * @see #setLabel(String) * @see AbstractField#setValue(Object) * @see #addValueChangeListener(ValueChangeListener) + * @since 23.1 */ public Checkbox(String labelText, boolean initialValue, ValueChangeListener<ComponentValueChangeEvent<Checkbox, Boolean>> listener) { @@ -240,6 +243,7 @@ public Checkbox(String labelText, boolean initialValue, * {@code true} to make the field required, {@code false} * otherwise * @see CheckboxI18n#setRequiredErrorMessage(String) + * @since 24.5 */ @Override public void setRequiredIndicatorVisible(boolean required) { @@ -251,6 +255,7 @@ public void setRequiredIndicatorVisible(boolean required) { * * @return {@code true} if the field is required, {@code false} otherwise * @see #setRequiredIndicatorVisible(boolean) + * @since 24.5 */ @Override public boolean isRequiredIndicatorVisible() { @@ -412,6 +417,8 @@ public Validator<Boolean> getDefaultValidator() { * message defined in the i18n object is used. * <p> * The method does nothing if the manual validation mode is enabled. + * + * @since 24.4 */ protected void validate() { validationController.validate(getValue()); @@ -444,6 +451,7 @@ boolean isDisabledBoolean() { * {@link #setI18n(CheckboxI18n)} * * @return the i18n object or {@code null} if no i18n object has been set + * @since 24.5 */ public CheckboxI18n getI18n() { return i18n; @@ -454,6 +462,7 @@ public CheckboxI18n getI18n() { * * @param i18n * the i18n object, not {@code null} + * @since 24.5 */ public void setI18n(CheckboxI18n i18n) { this.i18n = Objects.requireNonNull(i18n, @@ -466,6 +475,8 @@ private String getI18nErrorMessage(Function<CheckboxI18n, String> getter) { /** * The internationalization properties for {@link Checkbox}. + * + * @since 24.5 */ public static class CheckboxI18n implements Serializable { diff --git a/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/CheckboxGroup.java b/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/CheckboxGroup.java index 223635c350b..fc873bff021 100644 --- a/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/CheckboxGroup.java +++ b/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/CheckboxGroup.java @@ -109,6 +109,7 @@ * {@link #setInvalid(boolean)} and {@link #setErrorMessage(String)} API. * * @author Vaadin Ltd + * @since 1.1 */ @Tag("vaadin-checkbox-group") @NpmPackage(value = "@vaadin/checkbox-group", version = "25.2.0") @@ -185,6 +186,7 @@ public CheckboxGroup() { * @param label * the label describing the checkbox group * @see #setLabel(String) + * @since 23.1 */ public CheckboxGroup(String label) { this(); @@ -201,6 +203,7 @@ public CheckboxGroup(String label) { * the items to be shown in the list of the checkbox group * @see #setLabel(String) * @see #setItems(Collection) + * @since 23.1 */ public CheckboxGroup(String label, Collection<T> items) { this(); @@ -218,6 +221,7 @@ public CheckboxGroup(String label, Collection<T> items) { * the items to be shown in the list of the checkbox group * @see #setLabel(String) * @see #setItems(Object...) + * @since 23.1 */ @SafeVarargs public CheckboxGroup(String label, T... items) { @@ -232,6 +236,7 @@ public CheckboxGroup(String label, T... items) { * @param listener * the value change listener to add * @see #addValueChangeListener(ValueChangeListener) + * @since 23.1 */ public CheckboxGroup( ValueChangeListener<ComponentValueChangeEvent<CheckboxGroup<T>, Set<T>>> listener) { @@ -249,6 +254,7 @@ public CheckboxGroup( * the value change listener to add * @see #setLabel(String) * @see #addValueChangeListener(ValueChangeListener) + * @since 23.1 */ public CheckboxGroup(String label, ValueChangeListener<ComponentValueChangeEvent<CheckboxGroup<T>, Set<T>>> listener) { @@ -269,6 +275,7 @@ public CheckboxGroup(String label, * @see #setLabel(String) * @see #addValueChangeListener(ValueChangeListener) * @see #setItems(Object...) + * @since 23.1 */ @SafeVarargs public CheckboxGroup(String label, @@ -323,6 +330,7 @@ public CheckboxGroupListDataView<T> setItems( * * @return the list data view that provides access to the data bound to the * checkbox group + * @since 18.0 */ @Override public CheckboxGroupListDataView<T> getListDataView() { @@ -338,6 +346,7 @@ public CheckboxGroupListDataView<T> getListDataView() { * * @return the generic DataView instance implementing * {@link CheckboxGroupDataView} + * @since 18.0 */ @Override public CheckboxGroupDataView<T> getGenericDataView() { @@ -421,6 +430,7 @@ public T getItem() { * * @param dataProvider * DataProvider instance to use, not <code>null</code> + * @since 24.2 */ public void setDataProvider(DataProvider<T, ?> dataProvider) { this.dataProvider.set(dataProvider); @@ -456,6 +466,7 @@ public void updateSelection(Set<T> addedItems, Set<T> removedItems) { * the new value to set, not {@code null} * @throws NullPointerException * if value is {@code null} + * @since 2.0.1 */ @Override public void setValue(Set<T> value) { @@ -488,6 +499,7 @@ public Registration addSelectionListener( * instead. * * @return the data provider used by this CheckboxGroup + * @since 24.2 */ public DataProvider<T, ?> getDataProvider() { // dataProvider reference won't have been initialized before @@ -663,6 +675,7 @@ public Optional<String> getAriaLabelledBy() { * {@code true} to make the field required, {@code false} * otherwise * @see CheckboxGroupI18n#setRequiredErrorMessage(String) + * @since 24.5 */ @Override public void setRequiredIndicatorVisible(boolean required) { @@ -674,6 +687,7 @@ public void setRequiredIndicatorVisible(boolean required) { * * @return {@code true} if the field is required, {@code false} otherwise * @see #setRequiredIndicatorVisible(boolean) + * @since 24.5 */ @Override public boolean isRequiredIndicatorVisible() { @@ -705,6 +719,7 @@ public void setRequired(boolean required) { * * @param disabled * the boolean value to set + * @since 24.0 */ protected void setDisabled(boolean disabled) { getElement().setProperty("disabled", disabled); @@ -714,6 +729,7 @@ protected void setDisabled(boolean disabled) { * If true, the user cannot interact with this element. * * @return the {@code disabled} property from the webcomponent + * @since 24.0 */ protected boolean isDisabledBoolean() { return getElement().getProperty("disabled", false); @@ -792,6 +808,7 @@ public void setRenderer( * the selection preservation mode to switch to, not {@code null} * * @see SelectionPreservationMode + * @since 24.4 */ public void setSelectionPreservationMode( SelectionPreservationMode selectionPreservationMode) { @@ -805,6 +822,7 @@ public void setSelectionPreservationMode( * @return the selection preservation mode * * @see #setSelectionPreservationMode(SelectionPreservationMode) + * @since 24.4 */ public SelectionPreservationMode getSelectionPreservationMode() { return selectionPreservationHandler.getSelectionPreservationMode(); @@ -981,6 +999,8 @@ public Validator<Set<T>> getDefaultValidator() { * message defined in the i18n object is used. * <p> * The method does nothing if the manual validation mode is enabled. + * + * @since 24.0 */ protected void validate() { validationController.validate(getValue()); @@ -994,6 +1014,7 @@ protected void validate() { * {@link #setI18n(CheckboxGroupI18n)} * * @return the i18n object or {@code null} if no i18n object has been set + * @since 24.5 */ public CheckboxGroupI18n getI18n() { return i18n; @@ -1004,6 +1025,7 @@ public CheckboxGroupI18n getI18n() { * * @param i18n * the i18n object, not {@code null} + * @since 24.5 */ public void setI18n(CheckboxGroupI18n i18n) { this.i18n = Objects.requireNonNull(i18n, @@ -1017,6 +1039,8 @@ private String getI18nErrorMessage( /** * The internationalization properties for {@link CheckboxGroup}. + * + * @since 24.5 */ public static class CheckboxGroupI18n implements Serializable { diff --git a/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/CheckboxGroupVariant.java b/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/CheckboxGroupVariant.java index 49d9348a7e9..e811bbde356 100644 --- a/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/CheckboxGroupVariant.java +++ b/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/CheckboxGroupVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-checkbox-group} component. + * + * @since 1.1 */ public enum CheckboxGroupVariant implements ThemeVariant { LUMO_VERTICAL("vertical"), diff --git a/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/CheckboxVariant.java b/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/CheckboxVariant.java index ba5206a47c0..25ded7f7f71 100644 --- a/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/CheckboxVariant.java +++ b/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/CheckboxVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-checkbox} component. + * + * @since 25.0 */ public enum CheckboxVariant implements ThemeVariant { /** diff --git a/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/dataview/CheckboxGroupDataView.java b/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/dataview/CheckboxGroupDataView.java index 80f37bad995..fbbe53b3fb0 100644 --- a/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/dataview/CheckboxGroupDataView.java +++ b/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/dataview/CheckboxGroupDataView.java @@ -28,7 +28,7 @@ * * @param <T> * the item type - * @since + * @since 18.0 */ public class CheckboxGroupDataView<T> extends AbstractDataView<T> { diff --git a/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/dataview/CheckboxGroupListDataView.java b/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/dataview/CheckboxGroupListDataView.java index 614b855022d..ff211bb357f 100644 --- a/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/dataview/CheckboxGroupListDataView.java +++ b/vaadin-checkbox-flow-parent/vaadin-checkbox-flow/src/main/java/com/vaadin/flow/component/checkbox/dataview/CheckboxGroupListDataView.java @@ -31,7 +31,7 @@ * * @param <T> * data type - * @since + * @since 18.0 */ public class CheckboxGroupListDataView<T> extends AbstractListDataView<T> { diff --git a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBox.java b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBox.java index f9080471bf5..62aa3b97e07 100644 --- a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBox.java +++ b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBox.java @@ -86,6 +86,7 @@ * @param <T> * the type of the items to be selectable from the combo box * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-combo-box") @NpmPackage(value = "@vaadin/combo-box", version = "25.2.0") @@ -106,6 +107,7 @@ public class ComboBox<T> extends ComboBoxBase<ComboBox<T>, T, T> * * @param <T> * item (bean) type in ComboBox + * @since 2.0 */ @FunctionalInterface public interface FetchItemsCallback<T> extends Serializable { @@ -127,6 +129,8 @@ public interface FetchItemsCallback<T> extends Serializable { /** * Predicate to check {@link ComboBox} items against user typed strings. + * + * @since 2.0 */ @FunctionalInterface public interface ItemFilter<T> extends SerializableBiPredicate<T, String> { @@ -146,6 +150,7 @@ public interface ItemFilter<T> extends SerializableBiPredicate<T, String> { * @param pageSize * the amount of items to request at a time for lazy loading * @see #setPageSize(int) + * @since 2.0 */ public ComboBox(int pageSize) { super("value", null, String.class, ComboBox::presentationToModel, @@ -235,6 +240,7 @@ public ComboBox(String label, T... items) { * @param listener * the value change listener to add * @see #addValueChangeListener(ValueChangeListener) + * @since 23.1 */ public ComboBox( ValueChangeListener<ComponentValueChangeEvent<ComboBox<T>, T>> listener) { @@ -252,6 +258,7 @@ public ComboBox( * the value change listener to add * @see #setLabel(String) * @see #addValueChangeListener(ValueChangeListener) + * @since 23.1 */ public ComboBox(String label, ValueChangeListener<ComponentValueChangeEvent<ComboBox<T>, T>> listener) { @@ -272,6 +279,7 @@ public ComboBox(String label, * @see #setLabel(String) * @see #addValueChangeListener(ValueChangeListener) * @see #setItems(Object...) + * @since 23.1 */ @SafeVarargs public ComboBox(String label, @@ -303,6 +311,7 @@ private static <T> String modelToPresentation(ComboBox<T> comboBox, /** * @see ComboBoxI18n#setRequiredErrorMessage(String) + * @since 24.5 */ @Override public void setRequiredIndicatorVisible(boolean required) { @@ -395,6 +404,7 @@ public T getEmptyValue() { * {@code true} to scroll to and focus the selected item when the * dropdown opens, {@code false} to keep the default behavior of * opening at the top + * @since 25.2 */ public void setFocusSelectedItem(boolean focusSelectedItem) { this.focusSelectedItem = focusSelectedItem; @@ -407,6 +417,7 @@ public void setFocusSelectedItem(boolean focusSelectedItem) { * @return {@code true} if the dropdown auto-focuses the selected item, * {@code false} otherwise * @see #setFocusSelectedItem(boolean) + * @since 25.2 */ public boolean isFocusSelectedItem() { return focusSelectedItem; @@ -443,6 +454,7 @@ private void focusSelectedItem() { * @param width * the new dropdown width. Pass in null to set the dropdown width * back to the default value. + * @since 24.4 */ public void setOverlayWidth(String width) { getStyle().set("--vaadin-combo-box-overlay-width", width); @@ -456,6 +468,7 @@ public void setOverlayWidth(String width) { * the width of the dropdown. * @param unit * the unit used for the dropdown. + * @since 24.4 */ public void setOverlayWidth(float width, Unit unit) { Objects.requireNonNull(unit, "Unit can not be null"); @@ -470,6 +483,7 @@ public void setOverlayWidth(float width, Unit unit) { * {@link #setI18n(ComboBoxI18n)} * * @return the i18n object or {@code null} if no i18n object has been set + * @since 24.5 */ public ComboBoxI18n getI18n() { return (ComboBoxI18n) super.getI18n(); @@ -480,6 +494,7 @@ public ComboBoxI18n getI18n() { * * @param i18n * the i18n object, not {@code null} + * @since 24.5 */ public void setI18n(ComboBoxI18n i18n) { super.setI18n(i18n); @@ -487,6 +502,8 @@ public void setI18n(ComboBoxI18n i18n) { /** * The internationalization properties for {@link ComboBox}. + * + * @since 24.5 */ public static class ComboBoxI18n implements ComboBoxBaseI18n { diff --git a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBoxBase.java b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBoxBase.java index 2ace4e489a8..732738f9f97 100644 --- a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBoxBase.java +++ b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBoxBase.java @@ -88,6 +88,7 @@ * Type of individual items that are selectable in the combo box * @param <TValue> * Type of the selection / value of the extending component + * @since 23.2 */ public abstract class ComboBoxBase<TComponent extends ComboBoxBase<TComponent, TItem, TValue>, TItem, TValue> extends AbstractSinglePropertyField<TComponent, TValue> implements @@ -371,6 +372,7 @@ protected void setFilter(String filter) { * @param filterTimeout * the time in milliseconds to wait after typing stops before * filtering is triggered + * @since 25.1 */ public void setFilterTimeout(int filterTimeout) { getElement().setProperty("_filterTimeout", filterTimeout); @@ -381,6 +383,7 @@ public void setFilterTimeout(int filterTimeout) { * * @return the time in milliseconds to wait after typing stops before * filtering is triggered + * @since 25.1 */ public int getFilterTimeout() { return getElement().getProperty("_filterTimeout", @@ -398,6 +401,7 @@ public int getFilterTimeout() { * @param required * {@code true} to make the field required, {@code false} * otherwise + * @since 24.5 */ @Override public void setRequiredIndicatorVisible(boolean required) { @@ -409,6 +413,7 @@ public void setRequiredIndicatorVisible(boolean required) { * * @return {@code true} if the field is required, {@code false} otherwise * @see #setRequiredIndicatorVisible(boolean) + * @since 24.5 */ @Override public boolean isRequiredIndicatorVisible() { @@ -548,6 +553,7 @@ public SerializableFunction<TItem, String> getItemClassNameGenerator() { * @param item * the data item * @return string class name for the data item + * @since 24.5 */ protected String generateClassName(TItem item) { if (item == null) { @@ -989,6 +995,9 @@ public ComboBoxLazyDataView<TItem> setItems( return HasLazyDataView.super.setItems(fetchCallback, countCallback); } + /** + * @since 24.7 + */ public interface SpringData extends Serializable { /** * Callback interface for fetching a list of items from a backend based @@ -1054,6 +1063,7 @@ public interface CountCallback<PAGEABLE> extends Serializable { * a function that returns a sorted list of items from the * backend based on the given pageable * @return a data view for further configuration + * @since 24.7 */ public ComboBoxLazyDataView<TItem> setItemsPageable( SpringData.FetchCallback<Pageable, TItem> fetchCallback) { @@ -1084,6 +1094,7 @@ public ComboBoxLazyDataView<TItem> setItemsPageable( * a function that returns the number of items in the back end * based on the filter string * @return LazyDataView instance for further configuration + * @since 24.7 */ public ComboBoxLazyDataView<TItem> setItemsPageable( SpringData.FetchCallback<Pageable, TItem> fetchCallback, @@ -1235,6 +1246,8 @@ public ComboBoxDataView<TItem> setItems( * Use this method when none of the {@code setItems} methods are applicable, * e.g. when having a data provider with filter that cannot be transformed * to {@code DataProvider<T, Void>}. + * + * @since 24.2 */ public <C> void setDataProvider(DataProvider<TItem, C> dataProvider, SerializableFunction<String, C> filterConverter) { @@ -1258,6 +1271,7 @@ public <C> void setDataProvider(DataProvider<TItem, C> dataProvider, * a callback for getting the count of items, not * <code>null</code> * @see CallbackDataProvider + * @since 24.2 */ public void setDataProvider(ComboBox.FetchItemsCallback<TItem> fetchItems, SerializableFunction<String, Integer> sizeCallback) { @@ -1412,6 +1426,8 @@ public Validator<TValue> getDefaultValidator() { * message defined in the i18n object is used. * <p> * The method does nothing if the manual validation mode is enabled. + * + * @since 23.2.12 */ protected void validate() { validationController.validate(getValue()); @@ -1424,6 +1440,7 @@ protected void validate() { * * @param <TComponent> * The specific combo box component type + * @since 23.2.2 */ @DomEvent("custom-value-set") public static class CustomValueSetEvent<TComponent extends ComboBoxBase<TComponent, ?, ?>> @@ -1449,6 +1466,7 @@ public String getDetail() { * {@link #setI18n(ComboBoxBaseI18n)} * * @return the i18n object or {@code null} if no i18n object has been set + * @since 24.5 */ protected ComboBoxBaseI18n getI18n() { return i18n; @@ -1459,6 +1477,7 @@ protected ComboBoxBaseI18n getI18n() { * * @param i18n * the i18n object, not {@code null} + * @since 24.5 */ protected void setI18n(ComboBoxBaseI18n i18n) { this.i18n = Objects.requireNonNull(i18n, diff --git a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBoxBaseI18n.java b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBoxBaseI18n.java index d5711d3dcb8..268ace1ffbd 100644 --- a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBoxBaseI18n.java +++ b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBoxBaseI18n.java @@ -19,6 +19,8 @@ /** * The internationalization properties for {@link ComboBoxBase}. + * + * @since 24.5 */ public interface ComboBoxBaseI18n extends Serializable { /** diff --git a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBoxDataCommunicator.java b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBoxDataCommunicator.java index 4610cb5373f..649be25d269 100644 --- a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBoxDataCommunicator.java +++ b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBoxDataCommunicator.java @@ -33,6 +33,7 @@ * * @param <TItem> * The type of the item selectable in the combo box + * @since 23.2 */ public class ComboBoxDataCommunicator<TItem> extends DataCommunicator<TItem> { diff --git a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBoxVariant.java b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBoxVariant.java index a98e008114e..3f04e67ee68 100644 --- a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBoxVariant.java +++ b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/ComboBoxVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-combo-box} component. + * + * @since 22.0 */ public enum ComboBoxVariant implements ThemeVariant { LUMO_SMALL("small"), diff --git a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/MultiSelectComboBox.java b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/MultiSelectComboBox.java index d4c0321c3c1..3f7265e386d 100644 --- a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/MultiSelectComboBox.java +++ b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/MultiSelectComboBox.java @@ -95,6 +95,7 @@ * @param <TItem> * the type of the items to be selectable from the combo box * @author Vaadin Ltd + * @since 23.2 */ @Tag("vaadin-multi-select-combo-box") @NpmPackage(value = "@vaadin/multi-select-combo-box", version = "25.2.0") @@ -309,6 +310,7 @@ private ObjectNode generateJson(TItem item) { * {@code true} to make the field required, {@code false} * otherwise * @see MultiSelectComboBoxI18n#setRequiredErrorMessage(String) + * @since 24.5 */ @Override public void setRequiredIndicatorVisible(boolean required) { @@ -320,6 +322,7 @@ public void setRequiredIndicatorVisible(boolean required) { * * @return {@code true} if the field is required, {@code false} otherwise * @see #setRequiredIndicatorVisible(boolean) + * @since 24.5 */ @Override public boolean isRequiredIndicatorVisible() { @@ -442,6 +445,8 @@ public void updateSelection(Set<TItem> addedItems, /** * Defines possible behavior of the component when not all selected items * can be displayed as chips within the current field width. + * + * @since 24.3 */ public enum AutoExpandMode { /** @@ -591,6 +596,7 @@ public boolean isKeepFilter() { * * @param keepFilter * whether to keep the filter after selecting an item + * @since 24.4 */ public void setKeepFilter(boolean keepFilter) { getElement().setProperty("keepFilter", keepFilter); @@ -626,6 +632,7 @@ public void setI18n(MultiSelectComboBoxI18n i18n) { * @param width * the new dropdown width. Pass in null to set the dropdown width * back to the default value. + * @since 24.4 */ public void setOverlayWidth(String width) { getStyle().set("--vaadin-multi-select-combo-box-overlay-width", width); @@ -639,6 +646,7 @@ public void setOverlayWidth(String width) { * the width of the dropdown. * @param unit * the unit used for the dropdown. + * @since 24.4 */ public void setOverlayWidth(float width, Unit unit) { Objects.requireNonNull(unit, "Unit can not be null"); diff --git a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/MultiSelectComboBoxI18n.java b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/MultiSelectComboBoxI18n.java index 13db5f7e191..6b8dc34c4dd 100644 --- a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/MultiSelectComboBoxI18n.java +++ b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/MultiSelectComboBoxI18n.java @@ -20,6 +20,8 @@ /** * Class for localization of the {@link MultiSelectComboBox} + * + * @since 23.2 */ @JsonInclude(JsonInclude.Include.NON_NULL) public class MultiSelectComboBoxI18n implements ComboBoxBaseI18n { @@ -36,6 +38,7 @@ public class MultiSelectComboBoxI18n implements ComboBoxBaseI18n { * @return the error message or {@code null} if not set * @see MultiSelectComboBox#isRequiredIndicatorVisible() * @see MultiSelectComboBox#setRequiredIndicatorVisible(boolean) + * @since 24.5 */ @JsonIgnore // Not used in client side public String getRequiredErrorMessage() { @@ -54,6 +57,7 @@ public String getRequiredErrorMessage() { * @return this instance for method chaining * @see MultiSelectComboBox#isRequiredIndicatorVisible() * @see MultiSelectComboBox#setRequiredIndicatorVisible(boolean) + * @since 24.5 */ public MultiSelectComboBoxI18n setRequiredErrorMessage( String errorMessage) { diff --git a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/MultiSelectComboBoxVariant.java b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/MultiSelectComboBoxVariant.java index 23dcbddccbc..08845c63019 100644 --- a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/MultiSelectComboBoxVariant.java +++ b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/MultiSelectComboBoxVariant.java @@ -20,6 +20,8 @@ /** * Set of theme variants applicable for {@code vaadin-multi-select-combo-box} * component. + * + * @since 23.2 */ public enum MultiSelectComboBoxVariant implements ThemeVariant { LUMO_SMALL("small"), diff --git a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/dataview/ComboBoxDataView.java b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/dataview/ComboBoxDataView.java index 9d3d66ddc4a..994835b7e72 100644 --- a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/dataview/ComboBoxDataView.java +++ b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/dataview/ComboBoxDataView.java @@ -36,6 +36,7 @@ * * @param <T> * the item type + * @since 18.0 */ public class ComboBoxDataView<T> extends AbstractDataView<T> { @@ -49,6 +50,7 @@ public class ComboBoxDataView<T> extends AbstractDataView<T> { * the data communicator of the component * @param comboBox * the ComboBox + * @since 23.2 */ public ComboBoxDataView(DataCommunicator<T> dataCommunicator, ComboBoxBase<?, T, ?> comboBox) { diff --git a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/dataview/ComboBoxLazyDataView.java b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/dataview/ComboBoxLazyDataView.java index 13dc91c5d99..937148b0950 100644 --- a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/dataview/ComboBoxLazyDataView.java +++ b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/dataview/ComboBoxLazyDataView.java @@ -36,6 +36,7 @@ * * @param <T> * the type of the items in ComboBox + * @since 18.0 */ public class ComboBoxLazyDataView<T> extends AbstractLazyDataView<T> { diff --git a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/dataview/ComboBoxListDataView.java b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/dataview/ComboBoxListDataView.java index d845020e21f..aadc28e4784 100644 --- a/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/dataview/ComboBoxListDataView.java +++ b/vaadin-combo-box-flow-parent/vaadin-combo-box-flow/src/main/java/com/vaadin/flow/component/combobox/dataview/ComboBoxListDataView.java @@ -36,6 +36,7 @@ * * @param <T> * the type of the items in ComboBox + * @since 18.0 */ public class ComboBoxListDataView<T> extends AbstractListDataView<T> { private final DataCommunicator<T> dataCommunicator; @@ -51,6 +52,7 @@ public class ComboBoxListDataView<T> extends AbstractListDataView<T> { * @param filterOrSortingChangedCallback * callback, which is being invoked when the ComboBox's filtering * or sorting changes, not <code>null</code> + * @since 23.2 */ public ComboBoxListDataView(DataCommunicator<T> dataCommunicator, ComboBoxBase<?, T, ?> comboBox, diff --git a/vaadin-confirm-dialog-flow-parent/vaadin-confirm-dialog-flow/src/main/java/com/vaadin/flow/component/confirmdialog/ConfirmDialog.java b/vaadin-confirm-dialog-flow-parent/vaadin-confirm-dialog-flow/src/main/java/com/vaadin/flow/component/confirmdialog/ConfirmDialog.java index 3e3ffa8dc83..c24ea864e67 100644 --- a/vaadin-confirm-dialog-flow-parent/vaadin-confirm-dialog-flow/src/main/java/com/vaadin/flow/component/confirmdialog/ConfirmDialog.java +++ b/vaadin-confirm-dialog-flow-parent/vaadin-confirm-dialog-flow/src/main/java/com/vaadin/flow/component/confirmdialog/ConfirmDialog.java @@ -61,6 +61,7 @@ * Confirm Dialog is modal in {@link ModalityMode#STRICT} mode. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-confirm-dialog") @NpmPackage(value = "@vaadin/confirm-dialog", version = "25.2.0") @@ -121,6 +122,8 @@ public CancelEvent(ConfirmDialog source, boolean fromClient) { /** * Event that is fired after the dialog's closing animation has finished. * Can be used to remove a dialog from the UI afterward. + * + * @since 25.0 */ @DomEvent("closed") public static class ClosedEvent extends ComponentEvent<ConfirmDialog> { @@ -136,6 +139,8 @@ public ClosedEvent(ConfirmDialog source, boolean fromClient) { * which, when closing the confirm dialog, is before the closing animation * has finished. To wait for the animation to finish, listen for the * {@link ClosedEvent} event. + * + * @since 25.0 */ public static class OpenedChangeEvent extends ComponentEvent<ConfirmDialog> { @@ -168,6 +173,7 @@ public String getWidth() { * * @param width * the width to set, may be {@code null} + * @since 2.0.1 */ @Override public void setWidth(String width) { @@ -196,6 +202,7 @@ public String getHeight() { * * @param height * the height to set, may be {@code null} + * @since 2.0.1 */ @Override public void setHeight(String height) { @@ -210,6 +217,7 @@ public SignalBinding<String> bindHeight(Signal<String> heightSignal) { /** * @throws UnsupportedOperationException * ConfirmDialog does not support adding styles + * @since 23.1 */ @Override public Style getStyle() { @@ -231,6 +239,7 @@ public Style getStyle() { * * @param describedBy * the attribute value + * @since 24.1 */ public void setAriaDescribedBy(String describedBy) { getElement().setProperty("accessibleDescriptionRef", describedBy); @@ -244,6 +253,7 @@ public void setAriaDescribedBy(String describedBy) { * * @return an optional aria-describedby of the dialog, or an empty optional * if no aria-describedby has been set + * @since 24.1 */ public Optional<String> getAriaDescribedBy() { return Optional.ofNullable( @@ -408,6 +418,7 @@ public void setRejectButton(String buttonText, * * @param component * the component to display instead of default Reject button + * @since 1.2 */ public void setRejectButton(Component component) { SlotUtils.setSlot(this, "reject-button", component); @@ -451,6 +462,7 @@ public void setCancelButton(String buttonText, * * @param component * the component to display instead of default Cancel button + * @since 1.2 */ public void setCancelButton(Component component) { SlotUtils.setSlot(this, "cancel-button", component); @@ -493,6 +505,7 @@ public void setConfirmButton(String buttonText, * * @param component * the component to display instead of default Confirm button + * @since 1.2 */ public void setConfirmButton(Component component) { SlotUtils.setSlot(this, "confirm-button", component); @@ -511,6 +524,7 @@ public void setText(String message) { * @param component * the component to display instead of default confirmation text * node + * @since 1.2 */ public void setText(Component component) { getElement().appendChild(component.getElement()); @@ -621,6 +635,7 @@ public Registration addRejectListener( * @param listener * the listener to add * @return a Registration for removing the event listener + * @since 25.0 */ public Registration addClosedListener( ComponentEventListener<ClosedEvent> listener) { @@ -638,6 +653,7 @@ public Registration addClosedListener( * @param listener * the listener to add * @return a Registration for removing the event listener + * @since 25.0 */ public Registration addOpenedChangeListener( ComponentEventListener<OpenedChangeEvent> listener) { @@ -656,6 +672,7 @@ public void setHeader(String header) { * * @param component * the component to display instead of default header text + * @since 1.2 */ public void setHeader(Component component) { SlotUtils.setSlot(this, "header", component); @@ -719,6 +736,7 @@ public void setOpened(boolean opened) { * * @return {@code true} if this dialog can be closed with the esc-key, * {@code false} otherwise + * @since 23.1 */ public boolean isCloseOnEsc() { return !getElement().getProperty("noCloseOnEsc", false); @@ -732,6 +750,7 @@ public boolean isCloseOnEsc() { * @param closeOnEsc * {@code true} to enable closing this dialog with the esc-key, * {@code false} to disable it + * @since 23.1 */ public void setCloseOnEsc(boolean closeOnEsc) { getElement().setProperty("noCloseOnEsc", !closeOnEsc); @@ -742,6 +761,8 @@ public void setCloseOnEsc(boolean closeOnEsc) { * <p> * Removes all components from this component except elements that have slot * attribute, such as header and buttons. + * + * @since 24.4 */ @Override public void removeAll() { diff --git a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/AccessibleDisabledMenuItemsFeatureFlagProvider.java b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/AccessibleDisabledMenuItemsFeatureFlagProvider.java index 6b04dced3d1..f03e768e1ce 100644 --- a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/AccessibleDisabledMenuItemsFeatureFlagProvider.java +++ b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/AccessibleDisabledMenuItemsFeatureFlagProvider.java @@ -20,6 +20,9 @@ import com.vaadin.experimental.Feature; import com.vaadin.experimental.FeatureFlagProvider; +/** + * @since 25.2 + */ public class AccessibleDisabledMenuItemsFeatureFlagProvider implements FeatureFlagProvider { diff --git a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/ContextMenu.java b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/ContextMenu.java index 5365af7a05c..a407a2d2b69 100644 --- a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/ContextMenu.java +++ b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/ContextMenu.java @@ -47,6 +47,7 @@ * as an overflow menu, use Menu Bar. * * @author Vaadin Ltd. + * @since 1.0 */ @SuppressWarnings("serial") public class ContextMenu extends ContextMenuBase<ContextMenu, MenuItem, SubMenu> @@ -87,6 +88,7 @@ public MenuItem addItem(Component component, * Gets position of the context menu with respect to its {@code target}. * * @return the position + * @since 25.0 */ public ContextMenuPosition getPosition() { String positionString = getElement().getProperty("position"); @@ -106,6 +108,7 @@ public ContextMenuPosition getPosition() { * @param position * the position to set * @see #setTarget(Component) + * @since 25.0 */ public void setPosition(ContextMenuPosition position) { getElement().setProperty("position", position.getPosition()); diff --git a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/ContextMenuBase.java b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/ContextMenuBase.java index 84e8a882457..4107e3cc36e 100644 --- a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/ContextMenuBase.java +++ b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/ContextMenuBase.java @@ -53,6 +53,7 @@ * the sub menu type * * @author Vaadin Ltd. + * @since 1.0 */ @SuppressWarnings("serial") @Tag("vaadin-context-menu") @@ -238,6 +239,7 @@ public I addItem(Component component) { * @param tooltipText * the tooltip text for the created menu item * @return the created menu item + * @since 25.2 */ public I addItem(String text, String tooltipText) { return getMenuManager().addItem(text, tooltipText); @@ -252,6 +254,7 @@ public I addItem(String text, String tooltipText) { * @param tooltipText * the tooltip text for the created menu item * @return the created menu item + * @since 25.2 */ public I addItem(Component component, String tooltipText) { return getMenuManager().addItem(component, tooltipText); @@ -267,6 +270,7 @@ public I addItem(Component component, String tooltipText) { * the components to add * @see HasMenuItems#addItem(String, ComponentEventListener) * @see HasMenuItems#addItem(Component, ComponentEventListener) + * @since 24.8 */ public void addComponent(Component... components) { getMenuManager().addComponent(components); @@ -282,6 +286,7 @@ public void addComponent(Component... components) { * the components to add * @see HasMenuItems#addItem(String, ComponentEventListener) * @see HasMenuItems#addItem(Component, ComponentEventListener) + * @since 24.8 */ public void addComponent(Collection<Component> components) { if (components == null) { @@ -318,6 +323,7 @@ public void removeAll() { * the index, where the component will be added * @param component * the component to add + * @since 1.1 */ public void addComponentAtIndex(int index, Component component) { getMenuManager().addComponentAtIndex(index, component); @@ -331,6 +337,7 @@ public void addComponentAtIndex(int index, Component component) { * * @param component * the component to add + * @since 24.8 */ public void addComponentAsFirst(Component component) { getMenuManager().addComponentAtIndex(0, component); @@ -338,6 +345,8 @@ public void addComponentAsFirst(Component component) { /** * Adds a separator between items. + * + * @since 24.8 */ public void addSeparator() { getMenuManager().addSeparator(); @@ -384,6 +393,8 @@ public boolean isOpened() { /** * {@code opened-changed} event is sent when the opened state changes. + * + * @since 23.3 */ public static class OpenedChangeEvent<TComponent extends ContextMenuBase<TComponent, ?, ?>> extends ComponentEvent<TComponent> { @@ -417,6 +428,7 @@ public Registration addOpenedChangeListener( * Gets the menu manager. * * @return the menu manager + * @since 2.0 */ protected MenuManager<C, I, S> getMenuManager() { if (menuManager == null) { @@ -432,6 +444,7 @@ protected MenuManager<C, I, S> getMenuManager() { * @param contentReset * callback to reset the menu content * @return a new menu manager instance + * @since 2.0 */ protected abstract MenuManager<C, I, S> createMenuManager( SerializableRunnable contentReset); @@ -455,6 +468,7 @@ protected abstract MenuManager<C, I, S> createMenuManager( * * @return {@code true} if the context menu should be opened, {@code false} * otherwise. + * @since 25.0 */ protected boolean onBeforeOpenMenu(ObjectNode eventDetail) { return true; diff --git a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/ContextMenuPosition.java b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/ContextMenuPosition.java index 9c0b4194804..a1e359b2439 100644 --- a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/ContextMenuPosition.java +++ b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/ContextMenuPosition.java @@ -17,6 +17,8 @@ /** * Context menu position in relation to the target element. + * + * @since 25.0 */ public enum ContextMenuPosition { TOP_START("top-start"), diff --git a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/HasMenuItems.java b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/HasMenuItems.java index d682791c716..9222a68cca1 100644 --- a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/HasMenuItems.java +++ b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/HasMenuItems.java @@ -29,6 +29,7 @@ * @see SubMenu * * @author Vaadin Ltd. + * @since 2.0 */ public interface HasMenuItems extends Serializable { diff --git a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/MenuItem.java b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/MenuItem.java index 17af8d7af7c..1b310fb0f5a 100644 --- a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/MenuItem.java +++ b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/MenuItem.java @@ -26,6 +26,7 @@ * methods. * * @author Vaadin Ltd. + * @since 1.0 */ @SuppressWarnings("serial") public class MenuItem extends MenuItemBase<ContextMenu, MenuItem, SubMenu> @@ -60,6 +61,8 @@ protected SubMenu createSubMenu() { * <pre> * com.vaadin.experimental.accessibleDisabledMenuItems = true * </pre> + * + * @since 25.2 */ @Override public void setEnabled(boolean enabled) { diff --git a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/MenuItemBase.java b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/MenuItemBase.java index a915f76ab46..18119e1e13a 100644 --- a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/MenuItemBase.java +++ b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/MenuItemBase.java @@ -45,6 +45,7 @@ * the sub menu type * @author Vaadin Ltd. * @see MenuItem + * @since 2.0 */ @SuppressWarnings("serial") @Tag("vaadin-context-menu-item") @@ -84,6 +85,7 @@ public MenuItemBase(C contextMenu) { * the context menu to which this item belongs to * @param contentReset * callback to reset the menu content + * @since 25.2 */ public MenuItemBase(C contextMenu, SerializableRunnable contentReset) { this.contextMenu = contextMenu; @@ -214,6 +216,7 @@ public boolean isChecked() { * @param keepOpen * {@code true} to enable keeping the menu open when toggle this * item selection, {@code false} to disable it. + * @since 24.2 */ public void setKeepOpen(boolean keepOpen) { if (keepOpen && isParentItem()) { @@ -233,6 +236,7 @@ public void setKeepOpen(boolean keepOpen) { * * @return the keep open state of the item * @see #setKeepOpen(boolean) + * @since 24.2 */ public boolean isKeepOpen() { return getElement().getProperty("_keepOpen", false); @@ -255,6 +259,7 @@ public boolean isKeepOpen() { * whether the item should be disabled when clicked * @throws IllegalStateException * if the enabled state is already bound to a signal + * @since 24.6 */ public void setDisableOnClick(boolean disableOnClick) { boolean hasEnabledBinding = getElement().getNode() @@ -273,6 +278,7 @@ public void setDisableOnClick(boolean disableOnClick) { * Gets whether the item is set to be disabled when clicked. * * @return whether the item is set to be disabled on click + * @since 24.6 */ public boolean isDisableOnClick() { return disableOnClickController.isDisableOnClick(); @@ -298,6 +304,7 @@ public void setEnabled(boolean enabled) { * onChange} callbacks * @throws IllegalStateException * if disable-on-click is active + * @since 25.1 */ @Override public SignalBinding<Boolean> bindEnabled(Signal<Boolean> enabledSignal) { @@ -314,6 +321,7 @@ public SignalBinding<Boolean> bindEnabled(Signal<Boolean> enabledSignal) { * * @param themeNames * the theme name or theme names to be added to the item + * @since 22.0 */ public void addThemeNames(String... themeNames) { this.themeNames.addAll(Arrays.asList(themeNames)); @@ -326,6 +334,7 @@ public void addThemeNames(String... themeNames) { * * @param themeNames * the theme name or theme names to be removed from the item + * @since 22.0 */ public void removeThemeNames(String... themeNames) { this.themeNames.removeAll(Arrays.asList(themeNames)); @@ -339,6 +348,7 @@ public void removeThemeNames(String... themeNames) { * the theme name to check for * @return <code>true</code> if the item has the given theme name, * <code>false</code> otherwise + * @since 22.0 */ public boolean hasThemeName(String themeName) { return themeNames.contains(themeName); @@ -365,6 +375,7 @@ private void setThemeName() { * the tooltip text to set for the item, or {@code null} to clear * it * @see #setTooltipPosition(TooltipPosition) + * @since 25.2 */ public void setTooltipText(String tooltipText) { ensureTooltipElement(); @@ -382,6 +393,7 @@ public void setTooltipText(String tooltipText) { * the tooltip position, or {@code null} to clear it and use the * default * @see #setTooltipText(String) + * @since 25.2 */ public void setTooltipPosition(TooltipPosition position) { getElement().setProperty("tooltipPosition", diff --git a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/MenuItemsArrayGenerator.java b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/MenuItemsArrayGenerator.java index ef357005ed2..4e9cfdb6535 100644 --- a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/MenuItemsArrayGenerator.java +++ b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/MenuItemsArrayGenerator.java @@ -30,6 +30,7 @@ * * @param <I> * the menu item type + * @since 2.1 */ public class MenuItemsArrayGenerator<I extends MenuItemBase<?, I, ?>> implements Serializable { diff --git a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/MenuManager.java b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/MenuManager.java index 71727c1fe7c..52492f83645 100644 --- a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/MenuManager.java +++ b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/MenuManager.java @@ -42,6 +42,7 @@ * the sub menu type * * @author Vaadin Ltd. + * @since 2.0 */ public class MenuManager<C extends Component, I extends MenuItemBase<?, I, S>, S extends SubMenuBase<?, I, S>> implements Serializable { @@ -154,6 +155,7 @@ public I addItem(Component component, * @param tooltipText * the tooltip text for the menu item * @return a new menu item + * @since 25.2 */ public I addItem(String text, String tooltipText) { I menuItem = addItem(text); @@ -169,6 +171,7 @@ public I addItem(String text, String tooltipText) { * @param tooltipText * the tooltip text for the menu item * @return a new menu item + * @since 25.2 */ public I addItem(Component component, String tooltipText) { I menuItem = addItem(component); @@ -186,6 +189,7 @@ public I addItem(Component component, String tooltipText) { * @param clickListener * a click listener * @return a new menu item + * @since 25.2 */ public I addItem(String text, String tooltipText, ComponentEventListener<ClickEvent<I>> clickListener) { @@ -204,6 +208,7 @@ public I addItem(String text, String tooltipText, * @param clickListener * a click listener * @return a new menu item + * @since 25.2 */ public I addItem(Component component, String tooltipText, ComponentEventListener<ClickEvent<I>> clickListener) { @@ -222,6 +227,7 @@ public I addItem(Component component, String tooltipText, * components to add * @see #remove(Component...) * @see #addComponentAtIndex(int, Component) + * @since 24.8 */ public void addComponent(Component... components) { if (parentMenuItem != null && parentMenuItem.isCheckable()) { @@ -335,6 +341,8 @@ public List<I> getItems() { /** * Adds a separator between items. + * + * @since 24.8 */ public void addSeparator() { addComponent(new Hr()); diff --git a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/SubMenu.java b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/SubMenu.java index 3ebb05833e6..09984b8fb69 100644 --- a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/SubMenu.java +++ b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/SubMenu.java @@ -27,6 +27,7 @@ * only if content has been added inside it. * * @author Vaadin Ltd. + * @since 2.0 */ public class SubMenu extends SubMenuBase<ContextMenu, MenuItem, SubMenu> implements HasMenuItems { @@ -59,6 +60,7 @@ public MenuItem addItem(Component component, * @param tooltipText * the tooltip text for the new item * @return the added {@link MenuItem} component + * @since 25.2 */ public MenuItem addItem(String text, String tooltipText) { return getMenuManager().addItem(text, tooltipText); @@ -74,6 +76,7 @@ public MenuItem addItem(String text, String tooltipText) { * @param tooltipText * the tooltip text for the new item * @return the added {@link MenuItem} component + * @since 25.2 */ public MenuItem addItem(Component component, String tooltipText) { return getMenuManager().addItem(component, tooltipText); @@ -91,6 +94,7 @@ public MenuItem addItem(Component component, String tooltipText) { * the handler for clicking the new item, can be {@code null} to * not add listener * @return the added {@link MenuItem} component + * @since 25.2 */ public MenuItem addItem(String text, String tooltipText, ComponentEventListener<ClickEvent<MenuItem>> clickListener) { @@ -110,6 +114,7 @@ public MenuItem addItem(String text, String tooltipText, * the handler for clicking the new item, can be {@code null} to * not add listener * @return the added {@link MenuItem} component + * @since 25.2 */ public MenuItem addItem(Component component, String tooltipText, ComponentEventListener<ClickEvent<MenuItem>> clickListener) { diff --git a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/SubMenuBase.java b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/SubMenuBase.java index 1adf0ca9b89..4a2beb9faec 100644 --- a/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/SubMenuBase.java +++ b/vaadin-context-menu-flow-parent/vaadin-context-menu-flow/src/main/java/com/vaadin/flow/component/contextmenu/SubMenuBase.java @@ -33,6 +33,7 @@ * the menu-item type * @param <S> * the sub menu type + * @since 2.0 */ public abstract class SubMenuBase<C extends ContextMenuBase<C, I, S>, I extends MenuItemBase<C, I, S>, S extends SubMenuBase<C, I, S>> implements Serializable { @@ -78,6 +79,7 @@ public I addItem(Component component) { * the components to add * @see HasMenuItems#addItem(String, ComponentEventListener) * @see HasMenuItems#addItem(Component, ComponentEventListener) + * @since 24.8 */ public void addComponent(Component... components) { getMenuManager().addComponent(components); @@ -151,6 +153,8 @@ public I getParentMenuItem() { /** * Adds a separator between items. + * + * @since 24.8 */ public void addSeparator() { getMenuManager().addSeparator(); diff --git a/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/BinderCrudEditor.java b/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/BinderCrudEditor.java index 3d65846223f..fc5904ef448 100644 --- a/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/BinderCrudEditor.java +++ b/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/BinderCrudEditor.java @@ -20,6 +20,7 @@ * @param <E> * the bean type * @see Binder + * @since 1.0 */ public class BinderCrudEditor<E> implements CrudEditor<E> { diff --git a/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/Crud.java b/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/Crud.java index 1dac39658c1..413d8bba8ce 100644 --- a/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/Crud.java +++ b/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/Crud.java @@ -46,6 +46,7 @@ * @param <E> * the bean type * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-crud") @NpmPackage(value = "@vaadin/crud", version = "25.2.0") @@ -267,6 +268,7 @@ private void registerHandlers() { * the item to be edited * @param editMode * the edit mode + * @since 2.0 */ public void edit(E item, EditMode editMode) { final CrudEvent<E> event; @@ -312,6 +314,7 @@ public void setOpened(boolean opened) { * @param dirty * true if dirty and false if otherwise. * @see #getSaveButton() + * @since 2.0 */ public void setDirty(boolean dirty) { getElement().executeJs("this.__isDirty = $0", dirty); @@ -433,6 +436,7 @@ public void setEditor(CrudEditor<E> editor) { * @param editorPosition * the editor position, never <code>null</code> * @see CrudEditorPosition + * @since 2.1 */ public void setEditorPosition(CrudEditorPosition editorPosition) { if (editorPosition == null) { @@ -449,6 +453,7 @@ public void setEditorPosition(CrudEditorPosition editorPosition) { * The default position is {@link CrudEditorPosition#OVERLAY}. * * @return the editor position + * @since 2.1 */ public CrudEditorPosition getEditorPosition() { return CrudEditorPosition.toPosition( @@ -465,6 +470,7 @@ public CrudEditorPosition getEditorPosition() { * * @param editOnClick * {@code true} to enable it ({@code false}, by default). + * @since 2.1 */ public void setEditOnClick(boolean editOnClick) { getElement().setProperty("editOnClick", editOnClick); @@ -494,6 +500,7 @@ public void setEditOnClick(boolean editOnClick) { * Gets whether click on row to edit item is enabled or not. * * @return {@code true} if enabled, {@code false} otherwise + * @since 2.1 */ public boolean isEditOnClick() { return getElement().getProperty("editOnClick", false); @@ -537,6 +544,7 @@ private void setI18n(CrudI18n i18n, boolean fireEvent) { * Controls visiblity of toolbar * * @param value + * @since 22.0 */ public void setToolbarVisible(boolean value) { toolbarVisible = value; @@ -552,6 +560,7 @@ public void setToolbarVisible(boolean value) { * * @param * @return true if toolbar is visible false otherwise + * @since 22.0 */ public boolean getToolbarVisible() { return toolbarVisible; @@ -561,6 +570,7 @@ public boolean getToolbarVisible() { * Gets the Crud new item button * * @return the new item button + * @since 24.0 */ public Component getNewButton() { return newButton; @@ -570,6 +580,7 @@ public Component getNewButton() { * Sets the Crud new item button * * @param button + * @since 24.0 */ public void setNewButton(Component button) { newButton = button; @@ -580,6 +591,7 @@ public void setNewButton(Component button) { * Gets the Crud editor delete button * * @return the delete button + * @since 22.0 */ public Button getDeleteButton() { return deleteButton; @@ -594,6 +606,7 @@ public Button getDeleteButton() { * * @return the save button * @see Crud#setDirty(boolean) + * @since 22.0 */ public Button getSaveButton() { return saveButton; @@ -603,6 +616,7 @@ public Button getSaveButton() { * Gets the Crud cancel button * * @return the cancel button + * @since 22.0 */ public Button getCancelButton() { return cancelButton; @@ -903,6 +917,7 @@ public static class EditEvent<E> extends CrudEvent<E> { * represented in Grid * @param ignored * an ignored parameter for a side effect + * @since 25.0 */ public EditEvent(Crud<E> source, boolean fromClient, @EventData("event.detail.item") ObjectNode item, @@ -974,6 +989,7 @@ private NewEvent(Crud<E> source, boolean fromClient, E item, * Gets new item being created * * @return a new instance of bean type + * @since 2.0 */ @Override public E getItem() { @@ -1013,6 +1029,7 @@ public SaveEvent(Crud<E> source, boolean fromClient, * new item or an existing item. * * @see Crud#edit(Object, EditMode) + * @since 2.0 */ public enum EditMode { /** diff --git a/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudEditor.java b/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudEditor.java index d0e03b4845b..11afef08fe4 100644 --- a/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudEditor.java +++ b/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudEditor.java @@ -17,6 +17,7 @@ * * @param <E> * the bean type + * @since 1.0 */ public interface CrudEditor<E> extends Serializable { @@ -61,6 +62,7 @@ default void setItem(E item) { * indicators for invalid fields. * * @return true if valid or false if otherwise + * @since 2.0 */ boolean validate(); diff --git a/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudEditorPosition.java b/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudEditorPosition.java index f81f2a74d50..b247e116744 100644 --- a/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudEditorPosition.java +++ b/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudEditorPosition.java @@ -12,6 +12,8 @@ /** * Enum with the possible values for the crud's editor position. + * + * @since 2.1 */ public enum CrudEditorPosition { diff --git a/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudFilter.java b/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudFilter.java index 25ead5f361c..45cad10bcb4 100644 --- a/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudFilter.java +++ b/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudFilter.java @@ -17,6 +17,8 @@ /** * The filter type for use with {@link CrudGrid}. This provides information * about the filter constraints and sort orders applied to the grid by the user. + * + * @since 1.0 */ public class CrudFilter implements Serializable { diff --git a/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudGrid.java b/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudGrid.java index aa2a43275b9..a94d56fdf11 100644 --- a/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudGrid.java +++ b/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudGrid.java @@ -25,6 +25,7 @@ * * @param <E> * the bean type + * @since 1.0 */ public class CrudGrid<E> extends Grid<E> { diff --git a/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudI18n.java b/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudI18n.java index 3f07bedeb70..b530652f2cc 100644 --- a/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudI18n.java +++ b/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudI18n.java @@ -23,6 +23,7 @@ * {@link CrudI18n#createDefault()} * * @see Crud#setI18n(CrudI18n) + * @since 1.0 */ @JsonInclude(JsonInclude.Include.NON_NULL) public class CrudI18n implements Serializable { diff --git a/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudI18nUpdatedEvent.java b/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudI18nUpdatedEvent.java index 1b93120e667..4ab9b6bdb6b 100644 --- a/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudI18nUpdatedEvent.java +++ b/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudI18nUpdatedEvent.java @@ -22,6 +22,8 @@ * // Localize an item in myGrid.<br> * });<br> * </code> + * + * @since 1.0 */ public class CrudI18nUpdatedEvent extends ComponentEvent<Crud<?>> { diff --git a/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudVariant.java b/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudVariant.java index bcb164c6e8e..aaea06825d2 100644 --- a/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudVariant.java +++ b/vaadin-crud-flow-parent/vaadin-crud-flow/src/main/java/com/vaadin/flow/component/crud/CrudVariant.java @@ -10,6 +10,8 @@ /** * The set of theme variants applicable to the {@code vaadin-crud} component. + * + * @since 1.0 */ public enum CrudVariant { NO_BORDER("no-border"), diff --git a/vaadin-custom-field-flow-parent/vaadin-custom-field-flow/src/main/java/com/vaadin/flow/component/customfield/CustomField.java b/vaadin-custom-field-flow-parent/vaadin-custom-field-flow/src/main/java/com/vaadin/flow/component/customfield/CustomField.java index 12bde2b1821..f29465843d9 100644 --- a/vaadin-custom-field-flow-parent/vaadin-custom-field-flow/src/main/java/com/vaadin/flow/component/customfield/CustomField.java +++ b/vaadin-custom-field-flow-parent/vaadin-custom-field-flow/src/main/java/com/vaadin/flow/component/customfield/CustomField.java @@ -44,6 +44,7 @@ * * @param <T> * field value type + * @since 1.0 */ @Tag("vaadin-custom-field") @NpmPackage(value = "@vaadin/custom-field", version = "25.2.0") @@ -86,6 +87,7 @@ public CustomField(T defaultValue) { * by default. * * @see AbstractField#AbstractField(Object) + * @since 24.9 */ public CustomField(T defaultValue, boolean manualValueUpdate) { super(defaultValue); @@ -146,6 +148,7 @@ protected void updateValue() { * * @param components * the components to add + * @since 2.0 */ protected void add(Component... components) { Objects.requireNonNull(components, "Components should not be null"); @@ -163,6 +166,7 @@ protected void add(Component... components) { * the components to remove * @throws IllegalArgumentException * if any of the components is not a child of this component + * @since 2.0 */ protected void remove(Component... components) { Objects.requireNonNull(components, "Components should not be null"); @@ -210,6 +214,7 @@ public void setLabel(String label) { * * @param variants * theme variants to add + * @since 23.1 */ public void addThemeVariants(CustomFieldVariant... variants) { getThemeNames().addAll( @@ -222,6 +227,7 @@ public void addThemeVariants(CustomFieldVariant... variants) { * * @param variants * theme variants to remove + * @since 23.1 */ public void removeThemeVariants(CustomFieldVariant... variants) { getThemeNames().removeAll( diff --git a/vaadin-custom-field-flow-parent/vaadin-custom-field-flow/src/main/java/com/vaadin/flow/component/customfield/CustomFieldVariant.java b/vaadin-custom-field-flow-parent/vaadin-custom-field-flow/src/main/java/com/vaadin/flow/component/customfield/CustomFieldVariant.java index 9eea4a09a88..8cfc6532eea 100644 --- a/vaadin-custom-field-flow-parent/vaadin-custom-field-flow/src/main/java/com/vaadin/flow/component/customfield/CustomFieldVariant.java +++ b/vaadin-custom-field-flow-parent/vaadin-custom-field-flow/src/main/java/com/vaadin/flow/component/customfield/CustomFieldVariant.java @@ -18,6 +18,8 @@ /** * The set of theme variants applicable to the {@code vaadin-custom-field} * component. + * + * @since 23.1 */ public enum CustomFieldVariant { diff --git a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/Dashboard.java b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/Dashboard.java index dca5087626d..fa463f1c65a 100644 --- a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/Dashboard.java +++ b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/Dashboard.java @@ -57,6 +57,7 @@ * @see DashboardI18n * * @author Vaadin Ltd + * @since 24.6 */ @Tag("vaadin-dashboard") @JsModule("@vaadin/dashboard/src/vaadin-dashboard.js") @@ -352,6 +353,7 @@ public void setMinimumRowHeight(String minRowHeight) { * Returns the fixed row height of the dashboard. * * @return the fixed row height of the dashboard + * @since 25.2 */ public String getRowHeight() { return getStyle().get("--vaadin-dashboard-row-height"); @@ -366,6 +368,7 @@ public String getRowHeight() { * @param rowHeight * the new fixed row height. Pass in {@code null} to set the row * height back to the default value. + * @since 25.2 */ public void setRowHeight(String rowHeight) { getStyle().set("--vaadin-dashboard-row-height", rowHeight); @@ -515,6 +518,7 @@ public Registration addItemRemovedListener( * behavior * @see DashboardItemRemoveHandler * @see DashboardItemRemoveEvent + * @since 25.1 */ public void setItemRemoveHandler(DashboardItemRemoveHandler handler) { this.itemRemoveHandler = handler; @@ -525,6 +529,7 @@ public void setItemRemoveHandler(DashboardItemRemoveHandler handler) { * * @return the current handler, or {@code null} if no handler is set * @see #setItemRemoveHandler(DashboardItemRemoveHandler) + * @since 25.1 */ public DashboardItemRemoveHandler getItemRemoveHandler() { return itemRemoveHandler; @@ -629,6 +634,7 @@ public void setVisible(boolean visible) { * onChange} callbacks * @deprecated This method is not supported and will throw an exception when * called. + * @since 25.1 */ @Deprecated @Override @@ -657,6 +663,7 @@ public boolean isVisible() { * * @param rootHeadingLevel * the root heading level property, {@code null} to remove + * @since 24.8 */ public void setRootHeadingLevel(Integer rootHeadingLevel) { if (rootHeadingLevel == null) { diff --git a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardChildDetachHandler.java b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardChildDetachHandler.java index dc6ecd6af35..50092745a13 100644 --- a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardChildDetachHandler.java +++ b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardChildDetachHandler.java @@ -18,6 +18,9 @@ import com.vaadin.flow.dom.ElementDetachListener; import com.vaadin.flow.shared.Registration; +/** + * @since 24.6 + */ public abstract class DashboardChildDetachHandler implements ElementDetachListener { diff --git a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemMoveModeChangedEvent.java b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemMoveModeChangedEvent.java index 6e3c7b9ab42..ecfd4fb42f1 100644 --- a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemMoveModeChangedEvent.java +++ b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemMoveModeChangedEvent.java @@ -20,6 +20,7 @@ * * @author Vaadin Ltd. * @see Dashboard#addItemMoveModeChangedListener(ComponentEventListener) + * @since 24.6 */ @DomEvent("dashboard-item-move-mode-changed") public class DashboardItemMoveModeChangedEvent diff --git a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemMovedEvent.java b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemMovedEvent.java index e7268ed0aa6..1249e7e1763 100644 --- a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemMovedEvent.java +++ b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemMovedEvent.java @@ -20,6 +20,7 @@ * * @author Vaadin Ltd. * @see Dashboard#addItemMovedListener(ComponentEventListener) + * @since 24.6 */ public class DashboardItemMovedEvent extends ComponentEvent<Dashboard> { diff --git a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemRemoveEvent.java b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemRemoveEvent.java index 80ef6c447b6..4ed91e5f1ab 100644 --- a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemRemoveEvent.java +++ b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemRemoveEvent.java @@ -23,6 +23,7 @@ * @author Vaadin Ltd. * @see DashboardItemRemoveHandler * @see Dashboard#setItemRemoveHandler(DashboardItemRemoveHandler) + * @since 25.1 */ public class DashboardItemRemoveEvent implements Serializable { diff --git a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemRemoveHandler.java b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemRemoveHandler.java index 0a896798630..bfe619678ea 100644 --- a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemRemoveHandler.java +++ b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemRemoveHandler.java @@ -31,6 +31,7 @@ * @author Vaadin Ltd. * @see Dashboard#setItemRemoveHandler(DashboardItemRemoveHandler) * @see DashboardItemRemoveEvent + * @since 25.1 */ @FunctionalInterface public interface DashboardItemRemoveHandler extends Serializable { diff --git a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemRemovedEvent.java b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemRemovedEvent.java index c3004282133..455870e2d0a 100644 --- a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemRemovedEvent.java +++ b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemRemovedEvent.java @@ -19,6 +19,7 @@ * * @author Vaadin Ltd. * @see Dashboard#addItemRemovedListener(ComponentEventListener) + * @since 24.6 */ public class DashboardItemRemovedEvent extends ComponentEvent<Dashboard> { diff --git a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemResizeModeChangedEvent.java b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemResizeModeChangedEvent.java index ed96eb56655..2a523615dbf 100644 --- a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemResizeModeChangedEvent.java +++ b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemResizeModeChangedEvent.java @@ -20,6 +20,7 @@ * * @author Vaadin Ltd. * @see Dashboard#addItemResizeModeChangedListener(ComponentEventListener) + * @since 24.6 */ @DomEvent("dashboard-item-resize-mode-changed") public class DashboardItemResizeModeChangedEvent diff --git a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemResizedEvent.java b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemResizedEvent.java index 172c50bdc32..69fb62a2a17 100644 --- a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemResizedEvent.java +++ b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemResizedEvent.java @@ -19,6 +19,7 @@ * * @author Vaadin Ltd. * @see Dashboard#addItemResizedListener(ComponentEventListener) + * @since 24.6 */ public class DashboardItemResizedEvent extends ComponentEvent<Dashboard> { diff --git a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemSelectedChangedEvent.java b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemSelectedChangedEvent.java index a2ac3aca68a..23c012b2c84 100644 --- a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemSelectedChangedEvent.java +++ b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardItemSelectedChangedEvent.java @@ -19,6 +19,7 @@ * * @author Vaadin Ltd. * @see Dashboard#addItemSelectedChangedListener(ComponentEventListener) + * @since 24.6 */ @DomEvent("dashboard-item-selected-changed") public class DashboardItemSelectedChangedEvent diff --git a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardSection.java b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardSection.java index d259fc66038..5467dbb8779 100644 --- a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardSection.java +++ b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardSection.java @@ -32,6 +32,7 @@ * @see DashboardWidget * * @author Vaadin Ltd + * @since 24.6 */ @Tag("vaadin-dashboard-section") @JsModule("@vaadin/dashboard/src/vaadin-dashboard-section.js") @@ -205,6 +206,7 @@ public void setVisible(boolean visible) { * onChange} callbacks * @deprecated This method is not supported and will throw an exception when * called. + * @since 25.1 */ @Deprecated @Override diff --git a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardVariant.java b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardVariant.java index 1035c960048..14a2e9986a1 100644 --- a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardVariant.java +++ b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardVariant.java @@ -13,6 +13,8 @@ /** * The set of theme variants applicable to the {@code vaadin-dashboard} and * {@code vaadin-dashboard-layout} components. + * + * @since 24.8 */ public enum DashboardVariant implements ThemeVariant { diff --git a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardWidget.java b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardWidget.java index ff918a828fd..626434a1226 100644 --- a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardWidget.java +++ b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/DashboardWidget.java @@ -24,6 +24,7 @@ * @see Dashboard * * @author Vaadin Ltd + * @since 24.6 */ @Tag("vaadin-dashboard-widget") @JsModule("@vaadin/dashboard/src/vaadin-dashboard-widget.js") @@ -239,6 +240,7 @@ public void setVisible(boolean visible) { * onChange} callbacks * @deprecated This method is not supported and will throw an exception when * called. + * @since 25.1 */ @Deprecated @Override diff --git a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/HasWidgets.java b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/HasWidgets.java index 9d0d066fbdb..5569f80e992 100644 --- a/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/HasWidgets.java +++ b/vaadin-dashboard-flow-parent/vaadin-dashboard-flow/src/main/java/com/vaadin/flow/component/dashboard/HasWidgets.java @@ -22,6 +22,7 @@ * @see DashboardWidget * * @author Vaadin Ltd + * @since 24.6 */ public interface HasWidgets extends Serializable { @@ -85,6 +86,7 @@ default void add(DashboardWidget... widgets) { * @throws IllegalArgumentException * if the reference widget is not found in this component or any * of its sections + * @since 25.1 */ void addWidgetAfter(DashboardWidget referenceWidget, DashboardWidget newWidget); diff --git a/vaadin-date-picker-flow-parent/vaadin-date-picker-flow/src/main/java/com/vaadin/flow/component/datepicker/DatePicker.java b/vaadin-date-picker-flow-parent/vaadin-date-picker-flow/src/main/java/com/vaadin/flow/component/datepicker/DatePicker.java index fbfb0517b60..a8aeb2907f3 100644 --- a/vaadin-date-picker-flow-parent/vaadin-date-picker-flow/src/main/java/com/vaadin/flow/component/datepicker/DatePicker.java +++ b/vaadin-date-picker-flow-parent/vaadin-date-picker-flow/src/main/java/com/vaadin/flow/component/datepicker/DatePicker.java @@ -126,6 +126,7 @@ * {@link #setInvalid(boolean)} and {@link #setErrorMessage(String)} API. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-date-picker") @NpmPackage(value = "@vaadin/date-picker", version = "25.2.0") @@ -399,6 +400,8 @@ public DatePicker(LocalDate initialDate, Locale locale) { * respective properties. However, note that the error message set with * {@link #setErrorMessage(String)} will take priority and override any i18n * error messages if both are set. + * + * @since 24.5 */ @Override public void setErrorMessage(String errorMessage) { @@ -705,6 +708,7 @@ private void fireValidationStatusChangeEvent() { * @return <code>true</code> if the input element's value is populated, * <code>false</code> otherwise * @deprecated Since v24.8 + * @since 24.0 */ @Deprecated(since = "24.8") protected boolean isInputValuePresent() { @@ -718,6 +722,7 @@ protected boolean isInputValuePresent() { * * @return <code>true</code> if the input element's value is populated and * unparsable, <code>false</code> otherwise + * @since 24.8 */ protected final boolean isInputUnparsable() { return unparsableValue != null; @@ -774,6 +779,7 @@ private void setInputElementValue(String value) { * * @param fallbackParser * the parser function + * @since 24.6 */ public void setFallbackParser( SerializableFunction<String, Result<LocalDate>> fallbackParser) { @@ -786,6 +792,7 @@ public void setFallbackParser( * parsed using the i18n date formats. * * @return the parser function + * @since 24.6 */ public SerializableFunction<String, Result<LocalDate>> getFallbackParser() { return fallbackParser; @@ -975,6 +982,7 @@ public SignalBinding<String> bindInitialPosition(Signal<LocalDate> signal) { * {@code true} to make the field required, {@code false} * otherwise * @see DatePickerI18n#setRequiredErrorMessage(String) + * @since 2.0.3 */ @Override public void setRequiredIndicatorVisible(boolean required) { @@ -986,6 +994,7 @@ public void setRequiredIndicatorVisible(boolean required) { * * @return {@code true} if the field is required, {@code false} otherwise * @see #setRequiredIndicatorVisible(boolean) + * @since 24.5 */ @Override public boolean isRequiredIndicatorVisible() { @@ -1110,6 +1119,8 @@ public void setManualValidation(boolean enabled) { * message defined in the i18n object is used. * <p> * The method does nothing if the manual validation mode is enabled. + * + * @since 2.0.5 */ protected void validate() { validationController.validate(getValue()); @@ -1118,6 +1129,8 @@ protected void validate() { /** * {@code opened-changed} event is sent when the overlay opened state * changes. + * + * @since 23.3 */ public static class OpenedChangeEvent extends ComponentEvent<DatePicker> { private final boolean opened; @@ -1147,6 +1160,8 @@ public Registration addOpenedChangeListener( /** * {@code invalid-changed} event is sent when the invalid state changes. + * + * @since 23.3 */ public static class InvalidChangeEvent extends ComponentEvent<DatePicker> { private final boolean invalid; @@ -1280,6 +1295,7 @@ public DatePickerI18n setWeekdaysShort(List<String> weekdaysShort) { * date displayed in the text field, and for parsing the user input * * @return list of date patterns or null + * @since 22.0 */ public List<String> getDateFormats() { return dateFormats; @@ -1315,6 +1331,7 @@ public List<String> getDateFormats() { * A string with a date format pattern, or null to remove the * previous custom format * @return this instance for method chaining + * @since 22.0 */ public DatePickerI18n setDateFormat(String dateFormat) { this.setDateFormats(dateFormat); @@ -1349,6 +1366,7 @@ public DatePickerI18n setDateFormat(String dateFormat) { * @param additionalParsingFormats * Additional date format patterns to be used for parsing * @return this instance for method chaining + * @since 22.0 */ public DatePickerI18n setDateFormats(String primaryFormat, String... additionalParsingFormats) { @@ -1446,6 +1464,7 @@ public DatePickerI18n setCancel(String cancel) { * Gets the {@code referenceDate}. * * @return the reference date + * @since 23.3 */ public LocalDate getReferenceDate() { return referenceDate; @@ -1464,6 +1483,7 @@ public LocalDate getReferenceDate() { * @param referenceDate * the date used to base relative dates on * @return this instance for method chaining + * @since 23.3 */ public DatePickerI18n setReferenceDate(LocalDate referenceDate) { this.referenceDate = referenceDate; @@ -1475,6 +1495,7 @@ public DatePickerI18n setReferenceDate(LocalDate referenceDate) { * that the server is unable to convert to type {@link LocalDate}. * * @return the error message or {@code null} if not set + * @since 24.5 */ @JsonIgnore // Not used in client side public String getBadInputErrorMessage() { @@ -1492,6 +1513,7 @@ public String getBadInputErrorMessage() { * @param errorMessage * the error message to set, or {@code null} to clear * @return this instance for method chaining + * @since 24.5 */ public DatePickerI18n setBadInputErrorMessage(String errorMessage) { badInputErrorMessage = errorMessage; @@ -1505,6 +1527,7 @@ public DatePickerI18n setBadInputErrorMessage(String errorMessage) { * @return the error message or {@code null} if not set * @see DatePicker#isRequiredIndicatorVisible() * @see DatePicker#setRequiredIndicatorVisible(boolean) + * @since 24.5 */ @JsonIgnore // Not used in client side public String getRequiredErrorMessage() { @@ -1524,6 +1547,7 @@ public String getRequiredErrorMessage() { * @return this instance for method chaining * @see DatePicker#isRequiredIndicatorVisible() * @see DatePicker#setRequiredIndicatorVisible(boolean) + * @since 24.5 */ public DatePickerI18n setRequiredErrorMessage(String errorMessage) { requiredErrorMessage = errorMessage; @@ -1537,6 +1561,7 @@ public DatePickerI18n setRequiredErrorMessage(String errorMessage) { * @return the error message or {@code null} if not set * @see DatePicker#getMin() * @see DatePicker#setMin(LocalDate) + * @since 24.5 */ @JsonIgnore // Not used in client side public String getMinErrorMessage() { @@ -1556,6 +1581,7 @@ public String getMinErrorMessage() { * @return this instance for method chaining * @see DatePicker#getMin() * @see DatePicker#setMin(LocalDate) + * @since 24.5 */ public DatePickerI18n setMinErrorMessage(String errorMessage) { minErrorMessage = errorMessage; @@ -1569,6 +1595,7 @@ public DatePickerI18n setMinErrorMessage(String errorMessage) { * @return the error message or {@code null} if not set * @see DatePicker#getMax() * @see DatePicker#setMax(LocalDate) + * @since 24.5 */ @JsonIgnore // Not used in client side public String getMaxErrorMessage() { @@ -1588,6 +1615,7 @@ public String getMaxErrorMessage() { * @return this instance for method chaining * @see DatePicker#getMax() * @see DatePicker#setMax(LocalDate) + * @since 24.5 */ public DatePickerI18n setMaxErrorMessage(String errorMessage) { maxErrorMessage = errorMessage; diff --git a/vaadin-date-picker-flow-parent/vaadin-date-picker-flow/src/main/java/com/vaadin/flow/component/datepicker/DatePickerVariant.java b/vaadin-date-picker-flow-parent/vaadin-date-picker-flow/src/main/java/com/vaadin/flow/component/datepicker/DatePickerVariant.java index 7e39d17a03b..4f0526dc528 100644 --- a/vaadin-date-picker-flow-parent/vaadin-date-picker-flow/src/main/java/com/vaadin/flow/component/datepicker/DatePickerVariant.java +++ b/vaadin-date-picker-flow-parent/vaadin-date-picker-flow/src/main/java/com/vaadin/flow/component/datepicker/DatePickerVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-date-picker} component. + * + * @since 22.0 */ public enum DatePickerVariant implements ThemeVariant { LUMO_SMALL("small"), diff --git a/vaadin-date-time-picker-flow-parent/vaadin-date-time-picker-flow/src/main/java/com/vaadin/flow/component/datetimepicker/DateTimePicker.java b/vaadin-date-time-picker-flow-parent/vaadin-date-time-picker-flow/src/main/java/com/vaadin/flow/component/datetimepicker/DateTimePicker.java index e16456629e3..5908d666409 100644 --- a/vaadin-date-time-picker-flow-parent/vaadin-date-time-picker-flow/src/main/java/com/vaadin/flow/component/datetimepicker/DateTimePicker.java +++ b/vaadin-date-time-picker-flow-parent/vaadin-date-time-picker-flow/src/main/java/com/vaadin/flow/component/datetimepicker/DateTimePicker.java @@ -91,6 +91,7 @@ boolean isPickerInputUnparsable() { * the fields are focused. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-date-time-picker") @NpmPackage(value = "@vaadin/date-time-picker", version = "25.2.0") @@ -490,6 +491,7 @@ public String getLabel() { * * @param ariaLabel * the value to set as aria-label + * @since 24.1 */ public void setAriaLabel(String ariaLabel) { getElement().setProperty("accessibleName", ariaLabel); @@ -500,6 +502,7 @@ public void setAriaLabel(String ariaLabel) { * * @return an optional aria-label or an empty optional if no aria-label has * been set + * @since 24.1 */ public Optional<String> getAriaLabel() { return Optional.ofNullable(getElement().getProperty("accessibleName")); @@ -517,6 +520,7 @@ public Optional<String> getAriaLabel() { * @param dateLabel * the value to be used as a suffix in the date picker * aria-label. + * @since 24.1 */ public void setDateAriaLabel(String dateLabel) { dateAriaLabel = dateLabel; @@ -532,6 +536,7 @@ public void setDateAriaLabel(String dateLabel) { * * @return an optional label or an empty optional if no label has been set * with this method before. + * @since 24.1 */ public Optional<String> getDateAriaLabel() { return Optional.ofNullable(dateAriaLabel); @@ -549,6 +554,7 @@ public Optional<String> getDateAriaLabel() { * @param timeLabel * the value to be used as a suffix in the time picker * aria-label. + * @since 24.1 */ public void setTimeAriaLabel(String timeLabel) { timeAriaLabel = timeLabel; @@ -564,6 +570,7 @@ public void setTimeAriaLabel(String timeLabel) { * * @return an optional label or an empty optional if no label has been set * with this method before. + * @since 24.1 */ public Optional<String> getTimeAriaLabel() { return Optional.ofNullable(timeAriaLabel); @@ -1011,6 +1018,7 @@ public void setDatePickerI18n(DatePickerI18n i18n) { * * @return the i18n object. It will be <code>null</code>, If the i18n * properties weren't set. + * @since 24.5 */ public DateTimePickerI18n getI18n() { return i18n; @@ -1021,6 +1029,7 @@ public DateTimePickerI18n getI18n() { * * @param i18n * the internationalized properties, not <code>null</code> + * @since 24.5 */ public void setI18n(DateTimePickerI18n i18n) { this.i18n = Objects.requireNonNull(i18n, @@ -1050,6 +1059,7 @@ private void updateI18n() { * * @param autoOpen * Value for the auto open property, + * @since 14.5 */ public void setAutoOpen(boolean autoOpen) { getElement().setProperty("autoOpenDisabled", !autoOpen); @@ -1064,6 +1074,8 @@ private String getI18nErrorMessage( /** * The internationalization properties for {@link DateTimePicker}. + * + * @since 24.1 */ public static class DateTimePickerI18n implements Serializable { private String dateLabel; @@ -1139,6 +1151,7 @@ public DateTimePickerI18n setTimeLabel(String timeLabel) { * that the server is unable to convert to type {@link LocalDateTime}. * * @return the error message or {@code null} if not set + * @since 24.5 */ @JsonIgnore // Not used on the client side public String getBadInputErrorMessage() { @@ -1156,6 +1169,7 @@ public String getBadInputErrorMessage() { * @param errorMessage * the error message to set, or {@code null} to clear * @return this instance for method chaining + * @since 24.5 */ public DateTimePickerI18n setBadInputErrorMessage(String errorMessage) { badInputErrorMessage = errorMessage; @@ -1167,6 +1181,7 @@ public DateTimePickerI18n setBadInputErrorMessage(String errorMessage) { * empty. * * @return the error message or {@code null} if not set + * @since 24.8 */ @JsonIgnore // Not used on the client side public String getIncompleteInputErrorMessage() { @@ -1184,6 +1199,7 @@ public String getIncompleteInputErrorMessage() { * @param errorMessage * the error message to set, or {@code null} to clear * @return this instance for method chaining + * @since 24.8 */ public DateTimePickerI18n setIncompleteInputErrorMessage( String errorMessage) { @@ -1198,6 +1214,7 @@ public DateTimePickerI18n setIncompleteInputErrorMessage( * @return the error message or {@code null} if not set * @see DateTimePicker#isRequiredIndicatorVisible() * @see DateTimePicker#setRequiredIndicatorVisible(boolean) + * @since 24.5 */ @JsonIgnore // Not used on the client side public String getRequiredErrorMessage() { @@ -1217,6 +1234,7 @@ public String getRequiredErrorMessage() { * @return this instance for method chaining * @see DateTimePicker#isRequiredIndicatorVisible() * @see DateTimePicker#setRequiredIndicatorVisible(boolean) + * @since 24.5 */ public DateTimePickerI18n setRequiredErrorMessage(String errorMessage) { requiredErrorMessage = errorMessage; @@ -1230,6 +1248,7 @@ public DateTimePickerI18n setRequiredErrorMessage(String errorMessage) { * @return the error message or {@code null} if not set * @see DateTimePicker#getMin() * @see DateTimePicker#setMin(LocalDateTime) + * @since 24.5 */ @JsonIgnore // Not used on the client side public String getMinErrorMessage() { @@ -1249,6 +1268,7 @@ public String getMinErrorMessage() { * @return this instance for method chaining * @see DateTimePicker#getMin() * @see DateTimePicker#setMin(LocalDateTime) + * @since 24.5 */ public DateTimePickerI18n setMinErrorMessage(String errorMessage) { minErrorMessage = errorMessage; @@ -1262,6 +1282,7 @@ public DateTimePickerI18n setMinErrorMessage(String errorMessage) { * @return the error message or {@code null} if not set * @see DateTimePicker#getMax() * @see DateTimePicker#setMax(LocalDateTime) + * @since 24.5 */ @JsonIgnore // Not used on the client side public String getMaxErrorMessage() { @@ -1281,6 +1302,7 @@ public String getMaxErrorMessage() { * @return this instance for method chaining * @see DateTimePicker#getMax() * @see DateTimePicker#setMax(LocalDateTime) + * @since 24.5 */ public DateTimePickerI18n setMaxErrorMessage(String errorMessage) { maxErrorMessage = errorMessage; diff --git a/vaadin-date-time-picker-flow-parent/vaadin-date-time-picker-flow/src/main/java/com/vaadin/flow/component/datetimepicker/DateTimePickerVariant.java b/vaadin-date-time-picker-flow-parent/vaadin-date-time-picker-flow/src/main/java/com/vaadin/flow/component/datetimepicker/DateTimePickerVariant.java index a6122657595..d30de4a2ae0 100644 --- a/vaadin-date-time-picker-flow-parent/vaadin-date-time-picker-flow/src/main/java/com/vaadin/flow/component/datetimepicker/DateTimePickerVariant.java +++ b/vaadin-date-time-picker-flow-parent/vaadin-date-time-picker-flow/src/main/java/com/vaadin/flow/component/datetimepicker/DateTimePickerVariant.java @@ -20,6 +20,8 @@ /** * Set of theme variants applicable for {@code vaadin-date-time-picker} * component. + * + * @since 23.1 */ public enum DateTimePickerVariant implements ThemeVariant { LUMO_SMALL("small"), diff --git a/vaadin-details-flow-parent/vaadin-details-flow/src/main/java/com/vaadin/flow/component/details/Details.java b/vaadin-details-flow-parent/vaadin-details-flow/src/main/java/com/vaadin/flow/component/details/Details.java index 8be51337739..9c90db15dab 100644 --- a/vaadin-details-flow-parent/vaadin-details-flow/src/main/java/com/vaadin/flow/component/details/Details.java +++ b/vaadin-details-flow-parent/vaadin-details-flow/src/main/java/com/vaadin/flow/component/details/Details.java @@ -54,6 +54,7 @@ * inaccessible by keyboard or screen reader. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-details") @NpmPackage(value = "@vaadin/details", version = "25.2.0") @@ -98,6 +99,7 @@ public Details() { * @param summary * the summary component to set. * @see #setSummaryText(String) + * @since 23.1 */ public Details(String summary) { this(); @@ -110,6 +112,7 @@ public Details(String summary) { * @param summary * the summary component to set. * @see #setSummary(Component) + * @since 23.1 */ public Details(Component summary) { this(); @@ -161,6 +164,7 @@ public Details(Component summary, Component content) { * * @see #setSummaryText(String) * @see #add(Component...) + * @since 23.1 */ public Details(String summary, Component... components) { this(summary); @@ -178,6 +182,7 @@ public Details(String summary, Component... components) { * * @see #setSummary(Component) * @see #add(Component...) + * @since 23.1 */ public Details(Component summary, Component... components) { this(summary); @@ -188,6 +193,7 @@ public Details(Component summary, Component... components) { * Creates the summary container component. * * @return the summary container + * @since 24.0 */ protected Component createSummaryContainer() { return new DetailsSummary(); @@ -246,6 +252,7 @@ public String getSummaryText() { * @see #getContent() * @param components * the components to add + * @since 24.2 */ @Override public void add(Collection<Component> components) { @@ -258,6 +265,7 @@ public void add(Collection<Component> components) { * @see #getContent() * @param text * the text to add, not null + * @since 24.2 */ @Override public void add(String text) { @@ -269,6 +277,7 @@ public void add(String text) { * * @param components * the components to remove + * @since 24.2 */ @Override public void remove(Collection<Component> components) { @@ -277,6 +286,8 @@ public void remove(Collection<Component> components) { /** * Removes all components from the content section + * + * @since 24.2 */ @Override public void removeAll() { @@ -295,6 +306,7 @@ public void removeAll() { * be non-negative and may not exceed the children count * @param component * the component to add, value should not be null + * @since 24.2 */ @Override public void addComponentAtIndex(int index, Component component) { diff --git a/vaadin-details-flow-parent/vaadin-details-flow/src/main/java/com/vaadin/flow/component/details/DetailsVariant.java b/vaadin-details-flow-parent/vaadin-details-flow/src/main/java/com/vaadin/flow/component/details/DetailsVariant.java index 31468c830c5..216ef4df1c9 100644 --- a/vaadin-details-flow-parent/vaadin-details-flow/src/main/java/com/vaadin/flow/component/details/DetailsVariant.java +++ b/vaadin-details-flow-parent/vaadin-details-flow/src/main/java/com/vaadin/flow/component/details/DetailsVariant.java @@ -19,6 +19,8 @@ /** * The set of theme variants applicable to the {@code vaadin-details} component. + * + * @since 1.0 */ public enum DetailsVariant implements ThemeVariant { FILLED("filled"), diff --git a/vaadin-dialog-flow-parent/vaadin-dialog-flow/src/main/java/com/vaadin/flow/component/dialog/Dialog.java b/vaadin-dialog-flow-parent/vaadin-dialog-flow/src/main/java/com/vaadin/flow/component/dialog/Dialog.java index efdde9af5e9..15d90d439d4 100644 --- a/vaadin-dialog-flow-parent/vaadin-dialog-flow/src/main/java/com/vaadin/flow/component/dialog/Dialog.java +++ b/vaadin-dialog-flow-parent/vaadin-dialog-flow/src/main/java/com/vaadin/flow/component/dialog/Dialog.java @@ -78,6 +78,7 @@ * appropriate. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-dialog") @NpmPackage(value = "@vaadin/dialog", version = "25.2.0") @@ -150,6 +151,7 @@ public DialogCloseActionEvent(Dialog source, boolean fromClient) { * Gets the top position of the dialog. * * @return the top position of the dialog + * @since 24.6 */ public String getTop() { return getElement().getProperty("top"); @@ -165,6 +167,7 @@ public String getTop() { * * @param top * the top position of the dialog + * @since 24.6 */ public void setTop(String top) { getElement().setProperty("top", top); @@ -174,6 +177,7 @@ public void setTop(String top) { * Gets the left position of the dialog. * * @return the left position of the dialog + * @since 24.6 */ public String getLeft() { return getElement().getProperty("left"); @@ -189,6 +193,7 @@ public String getLeft() { * * @param left * the left position of the dialog + * @since 24.6 */ public void setLeft(String left) { getElement().setProperty("left", left); @@ -196,6 +201,8 @@ public void setLeft(String left) { /** * `resize` event is sent when the user finishes resizing the dialog. + * + * @since 3.1 */ @DomEvent("resize") public static class DialogResizeEvent extends ComponentEvent<Dialog> { @@ -239,6 +246,7 @@ public String getHeight() { * Gets the left position of the dialog after resize is done * * @return the left position in pixels of the dialog + * @since 24.6 */ public String getLeft() { return left; @@ -248,6 +256,7 @@ public String getLeft() { * Gets the top position of the dialog after resize is done * * @return the top position in pixels of the dialog + * @since 24.6 */ public String getTop() { return top; @@ -256,6 +265,8 @@ public String getTop() { /** * `dragged` event is sent when the user finishes dragging the dialog. + * + * @since 24.6 */ @DomEvent("dragged") public static class DialogDraggedEvent extends ComponentEvent<Dialog> { @@ -296,6 +307,8 @@ public String getTop() { * which, when closing the dialog, is before the closing animation has * finished. To wait for the animation to finish, listen for the * {@link ClosedEvent} event. + * + * @since 23.3 */ public static class OpenedChangeEvent extends ComponentEvent<Dialog> { private final boolean opened; @@ -313,6 +326,8 @@ public boolean isOpened() { /** * Event that is fired after the dialog's closing animation has finished. * Can be used to remove a dialog from the UI afterward. + * + * @since 25.0 */ @DomEvent("closed") public static class ClosedEvent extends ComponentEvent<Dialog> { @@ -341,6 +356,7 @@ public void setWidth(String value) { * onChange} callbacks * @deprecated This method is not supported and will throw an exception when * called. + * @since 25.1 */ @Deprecated @Override @@ -381,6 +397,7 @@ public void setHeight(String value) { * onChange} callbacks * @deprecated This method is not supported and will throw an exception when * called. + * @since 25.1 */ @Deprecated @Override @@ -488,6 +505,7 @@ public Registration addDialogCloseActionListener( * @param listener * the listener to add * @return registration for removal of listener + * @since 3.1 */ public Registration addResizeListener( ComponentEventListener<DialogResizeEvent> listener) { @@ -505,6 +523,7 @@ public Registration addResizeListener( * @param listener * the listener to add * @return registration for removal of listener + * @since 24.6 */ public Registration addDraggedListener( ComponentEventListener<DialogDraggedEvent> listener) { @@ -528,6 +547,7 @@ public Dialog(Component... components) { * * @param title * the title of the component + * @since 24.1 */ public Dialog(String title) { this(); @@ -541,6 +561,7 @@ public Dialog(String title) { * the title of the component * @param components * the components inside the dialog + * @since 24.1 */ public Dialog(String title, Component... components) { this(components); @@ -552,6 +573,7 @@ public Dialog(String title, Component... components) { * * @param components * the components to add + * @since 24.0 */ @Override public void add(Collection<Component> components) { @@ -567,6 +589,7 @@ public void add(Collection<Component> components) { * the index, where the component will be added. * @param component * the component to add + * @since 1.1 */ @Override public void addComponentAtIndex(int index, Component component) { @@ -643,6 +666,7 @@ public void setCloseOnOutsideClick(boolean closeOnOutsideClick) { * * @return {@code true} if focus trap is enabled (default), {@code false} * otherwise + * @since 25.1 */ public boolean isFocusTrap() { return !getElement().getProperty("noFocusTrap", false); @@ -657,6 +681,7 @@ public boolean isFocusTrap() { * * @param focusTrap * {@code true} to enable focus trap, {@code false} to disable it + * @since 25.1 */ public void setFocusTrap(boolean focusTrap) { getElement().setProperty("noFocusTrap", !focusTrap); @@ -701,6 +726,7 @@ public void close() { * {@code false} to enable dialog to open as modeless modal, * {@code true} otherwise. * @deprecated use {@link #setModality(ModalityMode)} instead + * @since 3.1 */ @Deprecated(since = "25.0", forRemoval = true) public void setModal(boolean modal) { @@ -712,6 +738,7 @@ public void setModal(boolean modal) { * * @return {@code true} if modal dialog (default), {@code false} otherwise. * @deprecated use {@link #getModality()} instead + * @since 3.1 */ @Deprecated(since = "25.0", forRemoval = true) public boolean isModal() { @@ -742,6 +769,7 @@ public boolean isModal() { * * @param mode * the modality mode, not null + * @since 25.0 */ public void setModality(ModalityMode mode) { this.modality = Objects.requireNonNull(mode, @@ -754,6 +782,7 @@ public void setModality(ModalityMode mode) { * Gets the modality of the dialog. {@link ModalityMode#VISUAL} by default. * * @return the modality mode, not null + * @since 25.0 */ public ModalityMode getModality() { return modality; @@ -775,6 +804,7 @@ public ModalityMode getModality() { * @param draggable * {@code true} to enable dragging of the dialog, {@code false} * otherwise + * @since 3.1 */ public void setDraggable(boolean draggable) { getElement().setProperty("draggable", draggable); @@ -785,6 +815,7 @@ public void setDraggable(boolean draggable) { * * @return {@code true} if dragging is enabled, {@code false} otherwise * (default). + * @since 3.1 */ public boolean isDraggable() { return getElement().getProperty("draggable", false); @@ -800,6 +831,7 @@ public boolean isDraggable() { * @param keepInViewport * {@code true} to prevent the dialog from moving outside the * viewport bounds, {@code false} otherwise + * @since 25.1 */ public void setKeepInViewport(boolean keepInViewport) { getElement().setProperty("keepInViewport", keepInViewport); @@ -811,6 +843,7 @@ public void setKeepInViewport(boolean keepInViewport) { * * @return {@code true} if the dialog is prevented from moving outside the * viewport bounds, {@code false} otherwise + * @since 25.1 */ public boolean isKeepInViewport() { return getElement().getProperty("keepInViewport", false); @@ -822,6 +855,7 @@ public boolean isKeepInViewport() { * @param resizable * {@code true} to enabled resizing of the dialog, {@code false} * otherwise. + * @since 3.1 */ public void setResizable(boolean resizable) { getElement().setProperty("resizable", resizable); @@ -832,6 +866,7 @@ public void setResizable(boolean resizable) { * * @return {@code true} if resizing is enabled, {@code falsoe} otherwiser * (default). + * @since 3.1 */ public boolean isResizable() { return getElement().getProperty("resizable", false); @@ -842,6 +877,7 @@ public boolean isResizable() { * * @param title * title to be rendered + * @since 23.1 */ public void setHeaderTitle(String title) { getElement().setProperty("headerTitle", title); @@ -851,6 +887,7 @@ public void setHeaderTitle(String title) { * Gets the title set for the dialog header. * * @return the title or an empty string, if a header title is not defined. + * @since 23.1 */ public String getHeaderTitle() { return getElement().getProperty("headerTitle", ""); @@ -863,6 +900,7 @@ public String getHeaderTitle() { * {@link DialogHeaderFooter#add(Component...)}. * * @return the header object + * @since 23.1 */ public DialogHeader getHeader() { if (this.dialogHeader == null) { @@ -877,6 +915,7 @@ public DialogHeader getHeader() { * component added with {@link DialogHeaderFooter#add(Component...)}. * * @return the header object + * @since 23.1 */ public DialogFooter getFooter() { if (this.dialogFooter == null) { @@ -887,6 +926,8 @@ public DialogFooter getFooter() { /** * Class for adding and removing components to the header part of a dialog. + * + * @since 23.1 */ final public static class DialogHeader extends DialogHeaderFooter { private DialogHeader(Dialog dialog) { @@ -896,6 +937,8 @@ private DialogHeader(Dialog dialog) { /** * Class for adding and removing components to the footer part of a dialog. + * + * @since 23.1 */ final public static class DialogFooter extends DialogHeaderFooter { private DialogFooter(Dialog dialog) { @@ -1040,6 +1083,7 @@ public Element getElement() { * @param visible * dialog visibility * @see Component#setVisible(boolean) + * @since 23.0 */ @Override public void setVisible(boolean visible) { @@ -1158,6 +1202,7 @@ public Registration addOpenedChangeListener( * @param listener * the listener to add * @return a Registration for removing the event listener + * @since 25.0 */ public Registration addClosedListener( ComponentEventListener<ClosedEvent> listener) { @@ -1252,6 +1297,7 @@ protected void onAttach(AttachEvent attachEvent) { * * @param role * the role to set + * @since 25.0 */ public void setRole(String role) { Objects.requireNonNull(role, "Role cannot be null"); @@ -1265,6 +1311,7 @@ public void setRole(String role) { * @param role * the role to set * @deprecated Use {@link #setRole(String)} instead + * @since 24.5 */ @Deprecated(since = "25.0", forRemoval = true) public void setOverlayRole(String role) { @@ -1278,6 +1325,7 @@ public void setOverlayRole(String role) { * Defaults to {@code dialog}. * * @return the role + * @since 25.0 */ public String getRole() { return getElement().getProperty("role"); @@ -1289,6 +1337,7 @@ public String getRole() { * * @return the role * @deprecated Use {@link #getRole()} instead + * @since 24.5 */ @Deprecated(since = "25.0", forRemoval = true) public String getOverlayRole() { @@ -1305,6 +1354,7 @@ public String getOverlayRole() { * the returned value may not be the same as in client side. * * @return the {@code ariaLabel} property from the webcomponent + * @since 24.0 */ protected String getAriaLabel() { return getElement().getProperty("ariaLabel"); @@ -1318,6 +1368,7 @@ protected String getAriaLabel() { * * @param ariaLabel * the String value to set + * @since 24.0 */ protected void setAriaLabel(String ariaLabel) { getElement().setProperty("ariaLabel", @@ -1359,6 +1410,7 @@ private void attachComponentRenderer() { /** * @throws UnsupportedOperationException * Dialog does not support adding styles + * @since 23.1 */ @Override public Style getStyle() { @@ -1394,6 +1446,7 @@ private void applyModality() { * @throws UnsupportedOperationException * always thrown, as Dialog does not support binding children * directly + * @since 25.1 */ @Override public <T, S extends Signal<T>> void bindChildren(Signal<List<S>> list, diff --git a/vaadin-dialog-flow-parent/vaadin-dialog-flow/src/main/java/com/vaadin/flow/component/dialog/DialogVariant.java b/vaadin-dialog-flow-parent/vaadin-dialog-flow/src/main/java/com/vaadin/flow/component/dialog/DialogVariant.java index a71ef240d62..758881e52ad 100644 --- a/vaadin-dialog-flow-parent/vaadin-dialog-flow/src/main/java/com/vaadin/flow/component/dialog/DialogVariant.java +++ b/vaadin-dialog-flow-parent/vaadin-dialog-flow/src/main/java/com/vaadin/flow/component/dialog/DialogVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-dialog} component. + * + * @since 20.0 */ public enum DialogVariant implements ThemeVariant { LUMO_NO_PADDING("no-padding"), diff --git a/vaadin-field-highlighter-flow-parent/vaadin-field-highlighter-flow/src/main/java/com/vaadin/flow/component/fieldhighlighter/FieldHighlighterInitializer.java b/vaadin-field-highlighter-flow-parent/vaadin-field-highlighter-flow/src/main/java/com/vaadin/flow/component/fieldhighlighter/FieldHighlighterInitializer.java index 290caf6360c..5aad0a74a86 100644 --- a/vaadin-field-highlighter-flow-parent/vaadin-field-highlighter-flow/src/main/java/com/vaadin/flow/component/fieldhighlighter/FieldHighlighterInitializer.java +++ b/vaadin-field-highlighter-flow-parent/vaadin-field-highlighter-flow/src/main/java/com/vaadin/flow/component/fieldhighlighter/FieldHighlighterInitializer.java @@ -21,6 +21,9 @@ import com.vaadin.flow.server.Command; import com.vaadin.flow.shared.Registration; +/** + * @since 23.0.15 + */ @NpmPackage(value = "@vaadin/field-highlighter", version = "25.2.0") @JsModule("@vaadin/field-highlighter/src/vaadin-field-highlighter.js") public class FieldHighlighterInitializer { diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasAllowedCharPattern.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasAllowedCharPattern.java index cd447df910d..6a118dc88e5 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasAllowedCharPattern.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasAllowedCharPattern.java @@ -23,6 +23,7 @@ * pasting text. * * @author Vaadin Ltd + * @since 23.2 */ public interface HasAllowedCharPattern extends HasElement { diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasAutoOpen.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasAutoOpen.java index f4ec204c55e..77d467344ba 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasAutoOpen.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasAutoOpen.java @@ -22,6 +22,7 @@ * control whether the overlay should open on input click or not. * * @author Vaadin Ltd + * @since 24.0 */ public interface HasAutoOpen extends HasElement { diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasClearButton.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasClearButton.java index 8eb693b6bf6..3e9b03510a9 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasClearButton.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasClearButton.java @@ -27,6 +27,7 @@ * Used to toggle the visibility of the clear button. * * @author Vaadin Ltd + * @since 23.1 */ public interface HasClearButton extends HasElement { diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasPrefix.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasPrefix.java index 3fa64d046e0..ef6f11a42ba 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasPrefix.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasPrefix.java @@ -22,6 +22,7 @@ * Mixin interface for components that have a prefix slot. * * @author Vaadin Ltd + * @since 24.0 */ public interface HasPrefix extends HasElement { /** diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasSuffix.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasSuffix.java index 6931b084db4..6a2b3304b74 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasSuffix.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasSuffix.java @@ -22,6 +22,7 @@ * Mixin interface for components that have a suffix slot. * * @author Vaadin Ltd + * @since 24.0 */ public interface HasSuffix extends HasElement { /** diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasThemeVariant.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasThemeVariant.java index 8ccf25cc4fc..ceaaa2ef5b8 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasThemeVariant.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasThemeVariant.java @@ -29,6 +29,7 @@ * * @param <TVariantEnum> * The specific theme variant enum type + * @since 23.2 */ public interface HasThemeVariant<TVariantEnum extends ThemeVariant> extends HasTheme { @@ -64,6 +65,7 @@ default void removeThemeVariants(TVariantEnum... variants) { * @param set * <code>true</code> to add the theme variant, <code>false</code> * to remove it + * @since 25.0 */ @SuppressWarnings("unchecked") default void setThemeVariant(TVariantEnum variant, boolean set) { @@ -80,6 +82,7 @@ default void setThemeVariant(TVariantEnum variant, boolean set) { * * @param variants * the theme variants to set + * @since 25.0 */ @SuppressWarnings("unchecked") default void setThemeVariants(TVariantEnum... variants) { @@ -95,6 +98,7 @@ default void setThemeVariants(TVariantEnum... variants) { * <code>false</code> to remove them * @param variants * the theme variants to add or remove + * @since 25.0 */ @SuppressWarnings("unchecked") default void setThemeVariants(boolean set, TVariantEnum... variants) { @@ -118,6 +122,7 @@ default void setThemeVariants(boolean set, TVariantEnum... variants) { * {@link SignalBinding#onChange(com.vaadin.flow.function.SerializableConsumer) * onChange} callbacks * @see HasTheme#bindThemeName(String, Signal) + * @since 25.1 */ default SignalBinding<Boolean> bindThemeVariant(TVariantEnum variant, Signal<Boolean> signal) { @@ -139,6 +144,7 @@ default SignalBinding<Boolean> bindThemeVariant(TVariantEnum variant, * {@link SignalBinding#onChange(com.vaadin.flow.function.SerializableConsumer) * onChange} callbacks * @see HasTheme#bindThemeNames(Signal) + * @since 25.2 */ default SignalBinding<List<TVariantEnum>> bindThemeVariants( Signal<List<TVariantEnum>> variants) { diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasTooltip.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasTooltip.java index ba5631b08cc..601145b2c8b 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasTooltip.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasTooltip.java @@ -33,6 +33,7 @@ * * * @author Vaadin Ltd + * @since 23.3 */ public interface HasTooltip extends HasElement { @@ -60,6 +61,7 @@ default Tooltip setTooltipText(String text) { * The tooltip text in Markdown format * * @return the tooltip handle + * @since 25.0 */ default Tooltip setTooltipMarkdown(String markdown) { var tooltip = Tooltip.getForElement(getElement()); diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasValidationProperties.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasValidationProperties.java index 19f7d40a661..01601d97158 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasValidationProperties.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/HasValidationProperties.java @@ -23,6 +23,7 @@ * state and error message string to show when invalid. * * @author Vaadin Ltd + * @since 24.0 */ public interface HasValidationProperties extends HasElement, HasValidation { diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/InputField.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/InputField.java index 429c75fdc28..167a9595a14 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/InputField.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/InputField.java @@ -43,7 +43,7 @@ * the value type * * @author Vaadin Ltd - * @since 24.1 + * @since 24.2 */ public interface InputField<E extends HasValue.ValueChangeEvent<V>, V> extends HasEnabled, HasHelper, HasLabel, HasSize, HasStyle, HasTooltip, diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/SelectionPreservationHandler.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/SelectionPreservationHandler.java index 2a7e3d28524..636e5200f35 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/SelectionPreservationHandler.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/SelectionPreservationHandler.java @@ -30,6 +30,7 @@ * * @see SelectionPreservationMode * @author Vaadin Ltd. + * @since 24.4 */ public abstract class SelectionPreservationHandler<T> implements Serializable { diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/SelectionPreservationMode.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/SelectionPreservationMode.java index 01e1a68fe41..59760debc68 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/SelectionPreservationMode.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/SelectionPreservationMode.java @@ -27,6 +27,7 @@ * * @see SelectionPreservationHandler * @author Vaadin Ltd. + * @since 24.4 */ public enum SelectionPreservationMode { diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/SlotUtils.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/SlotUtils.java index b177c9cf4a2..ee75b8f1890 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/SlotUtils.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/SlotUtils.java @@ -28,6 +28,7 @@ * Util methods for handling child elements inside slots. * * @author Vaadin Ltd + * @since 23.1 */ public class SlotUtils { @@ -91,6 +92,7 @@ public static Component getChildInSlot(HasElement parent, String slot) { * if any of the components is a {@link Text} component. * @throws NullPointerException * if the components array is null. + * @since 24.0 */ public static void addToSlot(HasElement parent, String slot, Component... components) { @@ -120,6 +122,7 @@ public static void addToSlot(HasElement parent, String slot, * elements to add to the specified slot. * @throws NullPointerException * if the elements array is null. + * @since 24.0 */ public static void addToSlot(HasElement parent, String slot, Element... elements) { @@ -145,6 +148,7 @@ public static void addToSlot(HasElement parent, String slot, * components to add to the specified slot. * @throws NullPointerException * if the components array is null. + * @since 24.0 */ public static void setSlot(HasElement parent, String slot, Component... components) { @@ -165,6 +169,7 @@ public static void setSlot(HasElement parent, String slot, * elements to add to the specified slot. * @throws NullPointerException * if the elements array is null. + * @since 24.0 */ public static void setSlot(HasElement parent, String slot, Element... elements) { diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/ThemeVariant.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/ThemeVariant.java index c10866b4a0e..9f852144b01 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/ThemeVariant.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/ThemeVariant.java @@ -19,6 +19,8 @@ /** * Base definition for a typed theme variant enum of a component + * + * @since 23.2 */ public interface ThemeVariant extends Serializable { /** diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/Tooltip.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/Tooltip.java index 0233edd1fb7..452a1b17693 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/Tooltip.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/Tooltip.java @@ -30,6 +30,7 @@ * A handle that can be used to configure and control tooltips. * * @author Vaadin Ltd + * @since 23.3 */ @NpmPackage(value = "@vaadin/tooltip", version = "25.2.0") @JsModule("@vaadin/tooltip/src/vaadin-tooltip.js") @@ -80,6 +81,7 @@ public String getPosition() { * @param position * the position string * @return the {@link TooltipPosition} + * @since 24.7 */ public static TooltipPosition fromPosition(String position) { return Arrays.stream(TooltipPosition.values()) @@ -91,6 +93,8 @@ public static TooltipPosition fromPosition(String position) { /** * Controls which ARIA attribute links the target element(s) with the * tooltip content. + * + * @since 25.2 */ public enum AriaLinkMode { /** @@ -229,6 +233,7 @@ public void setText(String text) { * * @param markdown * the text to set in Markdown format + * @since 25.0 */ public void setMarkdown(String markdown) { tooltipElement.setProperty("text", markdown); @@ -260,6 +265,7 @@ public Tooltip withText(String text) { * * @param markdown * the text to set in Markdown format + * @since 25.0 */ public Tooltip withMarkdown(String markdown) { setMarkdown(markdown); @@ -459,6 +465,7 @@ public boolean isOpened() { * @param ariaLinkMode * the ARIA link mode to set, or {@code null} to reset to the * default {@link AriaLinkMode#ARIA_DESCRIBED_BY} + * @since 25.2 */ public void setAriaLinkMode(AriaLinkMode ariaLinkMode) { if (ariaLinkMode == null) { @@ -472,6 +479,7 @@ public void setAriaLinkMode(AriaLinkMode ariaLinkMode) { * tooltip content. Defaults to {@link AriaLinkMode#ARIA_DESCRIBED_BY}. * * @return the ARIA link mode + * @since 25.2 */ public AriaLinkMode getAriaLinkMode() { return AriaLinkMode @@ -486,6 +494,7 @@ public AriaLinkMode getAriaLinkMode() { * the ARIA link mode to set, or {@code null} to reset to the * default {@link AriaLinkMode#ARIA_DESCRIBED_BY} * @return the tooltip handle for chaining + * @since 25.2 */ public Tooltip withAriaLinkMode(AriaLinkMode ariaLinkMode) { setAriaLinkMode(ariaLinkMode); diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/TooltipConfiguration.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/TooltipConfiguration.java index b35dc7d02d8..1a30984b460 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/TooltipConfiguration.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/TooltipConfiguration.java @@ -26,6 +26,7 @@ * A configuration class for a tooltips default behavior. * * @author Vaadin Ltd + * @since 23.3 */ @NpmPackage(value = "@vaadin/tooltip", version = "25.2.0") @JsModule("./tooltip.ts") diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/ValidationUtil.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/ValidationUtil.java index 128bbf2993e..545b4278b40 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/ValidationUtil.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/ValidationUtil.java @@ -21,6 +21,8 @@ /** * Util methods for component validation + * + * @since 23.2 */ public class ValidationUtil { @@ -69,6 +71,7 @@ public static <V> ValidationResult checkRequired(boolean required, V value, * the value considered to be empty * @return {@code ValidationResult.ok()} if the value does not equal to the * empty value, {@code ValidationResult.error()} otherwise + * @since 24.5 */ public static <V> ValidationResult validateRequiredConstraint( String errorMessage, boolean required, V value, V emptyValue) { @@ -115,6 +118,7 @@ public static <V extends Comparable<V>> ValidationResult checkGreaterThanMax( * the maximum allowed value * @return {@code ValidationResult.ok()} if the value is smaller or equal to * the maximum value, {@code ValidationResult.error()} otherwise + * @since 24.5 */ public static <V extends Comparable<V>> ValidationResult validateMaxConstraint( String errorMessage, V value, V maxValue) { @@ -162,6 +166,7 @@ public static <V extends Comparable<V>> ValidationResult checkSmallerThanMin( * the minimum allowed value * @return {@code ValidationResult.ok()} if the value is greater or equal to * the minimum value, {@code ValidationResult.error()} otherwise + * @since 24.5 */ public static <V extends Comparable<V>> ValidationResult validateMinConstraint( String errorMessage, V value, V minValue) { @@ -185,6 +190,7 @@ public static <V extends Comparable<V>> ValidationResult validateMinConstraint( * @return {@code ValidationResult.ok()} if the value is longer than or * equal to the minimum length, {@code ValidationResult.error()} * otherwise + * @since 24.5 */ public static ValidationResult validateMinLengthConstraint( String errorMessage, String value, Integer minLength) { @@ -208,6 +214,7 @@ public static ValidationResult validateMinLengthConstraint( * @return {@code ValidationResult.ok()} if the value is shorter than or * equal to the maximum length, {@code ValidationResult.error()} * otherwise + * @since 24.5 */ public static ValidationResult validateMaxLengthConstraint( String errorMessage, String value, Integer maxLength) { @@ -230,6 +237,7 @@ public static ValidationResult validateMaxLengthConstraint( * the pattern to match * @return {@code ValidationResult.ok()} if the value matches the pattern, * {@code ValidationResult.error()} otherwise + * @since 24.5 */ public static ValidationResult validatePatternConstraint( String errorMessage, String value, String pattern) { diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/DisableOnClickController.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/DisableOnClickController.java index 18c73a88e5d..299851c6ed7 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/DisableOnClickController.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/DisableOnClickController.java @@ -38,6 +38,7 @@ * * @param <C> * Type of the component that uses this controller. + * @since 24.6 */ @JsModule("./disableOnClickFunctions.js") public class DisableOnClickController<C extends Component & HasEnabled> diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/ModalRoot.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/ModalRoot.java index 2c65a468143..7b2dd2ae52e 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/ModalRoot.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/ModalRoot.java @@ -38,6 +38,8 @@ * <p> * <strong> Internal use only. May be renamed or removed in a future release. * </strong> + * + * @since 24.9.3 */ @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.TYPE) diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/OverlayAutoAddController.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/OverlayAutoAddController.java index 082bc21fdc2..7f5946e4bcb 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/OverlayAutoAddController.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/OverlayAutoAddController.java @@ -32,6 +32,7 @@ * * @param <C> * Type of the component that uses this controller. + * @since 24.7 */ public class OverlayAutoAddController<C extends Component> implements Serializable { @@ -80,6 +81,8 @@ public OverlayAutoAddController(C component, * the current opened state of the component. Allows components with custom * opening logic, such as ContextMenu, to add themselves to the UI and reuse * the automatic removal logic when the component is closed. + * + * @since 25.0 */ public void add() { if (!isAttached()) { @@ -101,6 +104,8 @@ public void add() { * Force remove the component from the UI in case it was auto-added. Can be * used by components with custom closing logic. For example, Notification * removes itself from the UI whenever it is detached. + * + * @since 25.0 */ public void remove() { handleClose(); @@ -112,6 +117,7 @@ public void remove() { * * @param skipOnNavigation * whether to skip auto-adding on navigation + * @since 24.7.3 */ public void setSkipOnNavigation(boolean skipOnNavigation) { this.skipOnNavigation = skipOnNavigation; diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/OverlayClassListProxy.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/OverlayClassListProxy.java index 6ffe4db6afc..6b234f44f40 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/OverlayClassListProxy.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/OverlayClassListProxy.java @@ -28,6 +28,8 @@ * Internal class that provides shared functionality for setting CSS class names * to overlay only components that support {@link HasStyle}, such as * {@code Dialog}. Not intended to be used publicly. + * + * @since 24.0 */ public class OverlayClassListProxy extends AbstractSet<String> implements ClassList { diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/SignalBindingUtil.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/SignalBindingUtil.java index 211e8f62396..dbbc8975da2 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/SignalBindingUtil.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/SignalBindingUtil.java @@ -32,6 +32,8 @@ * Internal utility for working with signal bindings in components. * <p> * For internal use only. May be renamed or removed in a future release. + * + * @since 25.2 */ public final class SignalBindingUtil { diff --git a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/ValidationController.java b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/ValidationController.java index fa781636304..446dfb079d0 100644 --- a/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/ValidationController.java +++ b/vaadin-flow-components-shared-parent/vaadin-flow-components-base/src/main/java/com/vaadin/flow/component/shared/internal/ValidationController.java @@ -31,6 +31,7 @@ * Type of the component that uses this controller. * @param <V> * Type of the value of the extending component. + * @since 24.5 */ public class ValidationController<C extends Component & HasValidator<V> & HasValidation, V> implements Serializable { diff --git a/vaadin-form-layout-flow-parent/vaadin-form-layout-flow/src/main/java/com/vaadin/flow/component/formlayout/FormLayout.java b/vaadin-form-layout-flow-parent/vaadin-form-layout-flow/src/main/java/com/vaadin/flow/component/formlayout/FormLayout.java index 434c5df35e0..444db5316c4 100644 --- a/vaadin-form-layout-flow-parent/vaadin-form-layout-flow/src/main/java/com/vaadin/flow/component/formlayout/FormLayout.java +++ b/vaadin-form-layout-flow-parent/vaadin-form-layout-flow/src/main/java/com/vaadin/flow/component/formlayout/FormLayout.java @@ -169,6 +169,7 @@ * default position above the fields only when there isn't enough space. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-form-layout") @NpmPackage(value = "@vaadin/form-layout", version = "25.2.0") @@ -307,6 +308,7 @@ public static class FormItem extends Component * construction with {@link #add(Component...)}. * * @see HasComponents#add(Component...) + * @since 1.0.3 */ public FormItem() { } @@ -336,6 +338,7 @@ public FormItem(Component... components) { * @see <a href= * "https://html.spec.whatwg.org/multipage/scripting.html#the-slot-element">Spec * website about slots</a> + * @since 24.0 */ protected void addToLabel(Component... components) { SlotUtils.addToSlot(this, "label", components); @@ -401,6 +404,7 @@ public void remove(Component... components) { * </pre> * * @author Vaadin Ltd + * @since 24.8 */ @Tag("vaadin-form-row") @NpmPackage(value = "@vaadin/form-layout", version = "25.2.0") @@ -531,6 +535,7 @@ public FormLayout(Component... components) { * @param colspan * the desired colspan for the component * + * @since 2.0 */ public void setColspan(Component component, int colspan) { Objects.requireNonNull(component, "component cannot be null"); @@ -549,6 +554,7 @@ public void setColspan(Component component, int colspan) { * @param colspan * the desired colspan for the component * + * @since 2.0 */ public void add(Component component, int colspan) { add(component); @@ -562,6 +568,7 @@ public void add(Component component, int colspan) { * @param component * the component whose colspan is retrieved * @return the colspan of the given component or 1 if none is set + * @since 2.0 */ public int getColspan(Component component) { String colspan = component.getElement().getAttribute("colspan"); @@ -678,6 +685,7 @@ public FormItem addFormItem(Component field, Component label) { * @param components * the components to add to the row * @return the created form row + * @since 24.8 */ public FormRow addFormRow(Component... components) { FormRow formRow = new FormRow(); @@ -694,6 +702,7 @@ public FormRow addFormRow(Component... components) { * @see <a href= * "https://vaadin.com/docs/latest/components/form-layout#label-position">Label * position</a> + * @since 24.5 */ public void setLabelWidth(String width) { getStyle().set("--vaadin-form-layout-label-width", width); @@ -707,6 +716,7 @@ public void setLabelWidth(String width) { * @param unit * the CSS unit of the width * @see #setLabelWidth(String) + * @since 24.8 */ public void setLabelWidth(float width, Unit unit) { Objects.requireNonNull(unit, "Unit cannot be null"); @@ -720,6 +730,7 @@ public void setLabelWidth(float width, Unit unit) { * @see <a href= * "https://vaadin.com/docs/latest/components/form-layout#label-position">Label * position</a> + * @since 24.5 */ public String getLabelWidth() { return getStyle().get("--vaadin-form-layout-label-width"); @@ -733,6 +744,7 @@ public String getLabelWidth() { * @param labelSpacing * the gap between the label and the field * @see #setLabelSpacing(float, Unit) + * @since 24.8 */ public void setLabelSpacing(String labelSpacing) { getStyle().set("--vaadin-form-layout-label-spacing", labelSpacing); @@ -748,6 +760,7 @@ public void setLabelSpacing(String labelSpacing) { * @param unit * the CSS unit of the gap * @see #setLabelSpacing(String) + * @since 24.8 */ public void setLabelSpacing(float labelSpacing, Unit unit) { Objects.requireNonNull(unit, "Unit cannot be null"); @@ -761,6 +774,7 @@ public void setLabelSpacing(float labelSpacing, Unit unit) { * @return the value and CSS unit as a string * @see #setLabelSpacing(String) * @see #setLabelSpacing(float, Unit) + * @since 24.8 */ public String getLabelSpacing() { return getStyle().get("--vaadin-form-layout-label-spacing"); @@ -773,6 +787,7 @@ public String getLabelSpacing() { * @param columnSpacing * the gap between the columns * @see #setColumnSpacing(float, Unit) + * @since 24.8 */ public void setColumnSpacing(String columnSpacing) { getStyle().set("--vaadin-form-layout-column-spacing", columnSpacing); @@ -787,6 +802,7 @@ public void setColumnSpacing(String columnSpacing) { * @param unit * the CSS unit of the gap * @see #setColumnSpacing(String) + * @since 24.8 */ public void setColumnSpacing(float columnSpacing, Unit unit) { Objects.requireNonNull(unit, "Unit cannot be null"); @@ -799,6 +815,7 @@ public void setColumnSpacing(float columnSpacing, Unit unit) { * @return the value and CSS unit as a string * @see #setColumnSpacing(String) * @see #setColumnSpacing(float, Unit) + * @since 24.8 */ public String getColumnSpacing() { return getStyle().get("--vaadin-form-layout-column-spacing"); @@ -811,6 +828,7 @@ public String getColumnSpacing() { * @param rowSpacing * the gap between the rows * @see #setRowSpacing(float, Unit) + * @since 24.8 */ public void setRowSpacing(String rowSpacing) { getStyle().set("--vaadin-form-layout-row-spacing", rowSpacing); @@ -825,6 +843,7 @@ public void setRowSpacing(String rowSpacing) { * @param unit * the CSS unit of the gap * @see #setRowSpacing(String) + * @since 24.8 */ public void setRowSpacing(float rowSpacing, Unit unit) { Objects.requireNonNull(unit, "Unit cannot be null"); @@ -837,6 +856,7 @@ public void setRowSpacing(float rowSpacing, Unit unit) { * @return the value and CSS unit as a string * @see #setRowSpacing(String) * @see #setRowSpacing(float, Unit) + * @since 24.8 */ public String getRowSpacing() { return getStyle().get("--vaadin-form-layout-row-spacing"); @@ -874,6 +894,7 @@ public String getRowSpacing() { * @param autoResponsive * {@code true} to enable auto responsive mode, {@code false} to * disable + * @since 24.8 */ public void setAutoResponsive(boolean autoResponsive) { getElement().setProperty("autoResponsive", autoResponsive); @@ -893,6 +914,7 @@ public void setAutoResponsive(boolean autoResponsive) { * * @param autoRows * {@code true} to enable auto rows mode, {@code false} otherwise + * @since 24.8 */ public void setAutoRows(boolean autoRows) { getElement().setProperty("autoRows", autoRows); @@ -906,6 +928,7 @@ public void setAutoRows(boolean autoRows) { * @return {@code true} if auto rows mode is enabled, {@code false} * otherwise * @see #setAutoRows(boolean) + * @since 24.8 */ public boolean isAutoRows() { return getElement().getProperty("autoRows", false); @@ -925,6 +948,7 @@ public boolean isAutoRows() { * * @param columnWidth * the width of columns or {@code null} to use the default + * @since 24.8 */ public void setColumnWidth(String columnWidth) { getElement().setProperty("columnWidth", columnWidth); @@ -946,6 +970,7 @@ public void setColumnWidth(String columnWidth) { * the width of columns * @param unit * the CSS unit of the width + * @since 24.8 */ public void setColumnWidth(float columnWidth, Unit unit) { Objects.requireNonNull(unit, "Unit cannot be null"); @@ -964,6 +989,7 @@ public void setColumnWidth(float columnWidth, Unit unit) { * in which case the web component uses its default value * @see #setColumnWidth(String) * @see #setColumnWidth(float, Unit) + * @since 24.8 */ public String getColumnWidth() { return getElement().getProperty("columnWidth"); @@ -981,6 +1007,7 @@ public String getColumnWidth() { * * @param maxColumns * the maximum number of columns + * @since 24.8 */ public void setMaxColumns(int maxColumns) { getElement().setProperty("maxColumns", maxColumns); @@ -992,6 +1019,7 @@ public void setMaxColumns(int maxColumns) { * * @return the maximum number of columns or 0 if not explicitly set * @see #setMaxColumns(int) + * @since 24.8 */ public int getMaxColumns() { return getElement().getProperty("maxColumns", 0); @@ -1007,6 +1035,7 @@ public int getMaxColumns() { * * @param minColumns * the minimum number of columns + * @since 24.8 */ public void setMinColumns(int minColumns) { getElement().setProperty("minColumns", minColumns); @@ -1018,6 +1047,7 @@ public void setMinColumns(int minColumns) { * * @return the minimum number of columns or 0 if not explicitly set * @see #setMinColumns(int) + * @since 24.8 */ public int getMinColumns() { return getElement().getProperty("minColumns", 0); @@ -1034,6 +1064,7 @@ public int getMinColumns() { * * @param expandColumns * {@code true} to expand columns, {@code false} otherwise + * @since 24.8 */ public void setExpandColumns(boolean expandColumns) { getElement().setProperty("expandColumns", expandColumns); @@ -1045,6 +1076,7 @@ public void setExpandColumns(boolean expandColumns) { * * @return {@code true} if columns should expand, {@code false} otherwise * @see #setExpandColumns(boolean) + * @since 24.8 */ public boolean isExpandColumns() { return getElement().getProperty("expandColumns", false); @@ -1061,6 +1093,7 @@ public boolean isExpandColumns() { * * @param expandFields * {@code true} to expand fields, {@code false} otherwise + * @since 24.8 */ public void setExpandFields(boolean expandFields) { getElement().setProperty("expandFields", expandFields); @@ -1072,6 +1105,7 @@ public void setExpandFields(boolean expandFields) { * * @return {@code true} if fields should expand, {@code false} otherwise * @see #setExpandFields(boolean) + * @since 24.8 */ public boolean isExpandFields() { return getElement().getProperty("expandFields", false); @@ -1101,6 +1135,7 @@ public boolean isExpandFields() { * * @param labelsAside * {@code true} to position labels aside, {@code false} otherwise + * @since 24.8 */ public void setLabelsAside(boolean labelsAside) { getElement().setProperty("labelsAside", labelsAside); @@ -1113,6 +1148,7 @@ public void setLabelsAside(boolean labelsAside) { * @return {@code true} if labels are positioned aside, {@code false} * otherwise * @see #setLabelsAside(boolean) + * @since 24.8 */ public boolean isLabelsAside() { return getElement().getProperty("labelsAside", false); diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/AbstractGridMultiSelectionModel.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/AbstractGridMultiSelectionModel.java index ddbead3130a..828b8caeeba 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/AbstractGridMultiSelectionModel.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/AbstractGridMultiSelectionModel.java @@ -57,6 +57,7 @@ * @param <T> * the grid type * @author Vaadin Ltd. + * @since 1.0 */ public abstract class AbstractGridMultiSelectionModel<T> extends AbstractGridExtension<T> implements GridMultiSelectionModel<T> { @@ -192,6 +193,7 @@ public Set<T> getSelectedItems() { * * @return An unmodifiable view of the selected item ids. Updates in the * selection may or may not be directly reflected in the Set. + * @since 23.2 */ protected Set<Object> getSelectedItemIds() { return Collections.unmodifiableSet(this.selected.keySet()); diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/AbstractGridSingleSelectionModel.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/AbstractGridSingleSelectionModel.java index fa0bc9fe733..f5803225e0c 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/AbstractGridSingleSelectionModel.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/AbstractGridSingleSelectionModel.java @@ -44,6 +44,7 @@ * * @param <T> * the grid type + * @since 1.0 */ public abstract class AbstractGridSingleSelectionModel<T> extends AbstractGridExtension<T> implements GridSingleSelectionModel<T> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/CellFocusEvent.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/CellFocusEvent.java index 9e75d858254..6f17929ada4 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/CellFocusEvent.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/CellFocusEvent.java @@ -30,6 +30,7 @@ * @author Vaadin Ltd * <p> * @see Grid#addCellFocusListener(com.vaadin.flow.component.ComponentEventListener) + * @since 21.0 */ @DomEvent("grid-cell-focus") public class CellFocusEvent<T> extends ComponentEvent<Grid<T>> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ClientItemToggleEvent.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ClientItemToggleEvent.java index bb5dc732578..8f7fd17ab05 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ClientItemToggleEvent.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ClientItemToggleEvent.java @@ -31,6 +31,7 @@ * the grid bean type * @author Vaadin Ltd * @see GridMultiSelectionModel#addClientItemToggleListener(com.vaadin.flow.component.ComponentEventListener) + * @since 24.7 */ public class ClientItemToggleEvent<T> extends ComponentEvent<Grid<T>> { private final T item; diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnPathRenderer.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnPathRenderer.java index ee16da5c7fc..be5f927f2a6 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnPathRenderer.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnPathRenderer.java @@ -37,6 +37,7 @@ * @param <SOURCE> * the object model type * @see Grid#addColumn(ValueProvider) + * @since 3.0 */ public class ColumnPathRenderer<SOURCE> extends Renderer<SOURCE> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnRendering.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnRendering.java index 871c34091ef..a0cd4da8b32 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnRendering.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnRendering.java @@ -21,6 +21,7 @@ * @author Vaadin Ltd. * * @see Grid#setColumnRendering(ColumnRendering) + * @since 24.1 */ public enum ColumnRendering { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnReorderEvent.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnReorderEvent.java index 2814c8288b7..e1c392485e5 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnReorderEvent.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnReorderEvent.java @@ -35,6 +35,7 @@ * * @see Grid#addColumnReorderListener(com.vaadin.flow.component.ComponentEventListener) * + * @since 4.1 */ @DomEvent("column-reorder-all-columns") public class ColumnReorderEvent<T> extends ComponentEvent<Grid<T>> { @@ -57,6 +58,7 @@ public class ColumnReorderEvent<T> extends ComponentEvent<Grid<T>> { * the internal column IDs; automatically translated to proper * Grid Column instances. * + * @since 25.0 */ public ColumnReorderEvent(Grid<T> source, boolean fromClient, @EventData("event.detail.columns") ArrayNode columnIDs) { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnResizeEvent.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnResizeEvent.java index 5e1b8179f62..48094cfdbfb 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnResizeEvent.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnResizeEvent.java @@ -30,6 +30,7 @@ * * @see Grid#addColumnResizeListener(com.vaadin.flow.component.ComponentEventListener) * + * @since 4.1 */ @DomEvent("column-drag-resize") public class ColumnResizeEvent<T> extends ComponentEvent<Grid<T>> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnTextAlign.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnTextAlign.java index 83e016992b0..3580d5c7c50 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnTextAlign.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ColumnTextAlign.java @@ -22,6 +22,7 @@ * * @see ColumnBase#setTextAlign(ColumnTextAlign) * + * @since 2.1 */ public enum ColumnTextAlign { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/FooterRow.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/FooterRow.java index db5587577f2..ddfa0d51e83 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/FooterRow.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/FooterRow.java @@ -26,6 +26,7 @@ * One row of {@link FooterCell}s in a Grid. * * @author Vaadin Ltd. + * @since 1.0 */ public class FooterRow extends AbstractRow<FooterCell> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/Grid.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/Grid.java index 82dc2420377..7af3ebb8362 100755 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/Grid.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/Grid.java @@ -211,6 +211,7 @@ * @param <T> * the grid bean type * + * @since 1.0 */ @Tag("vaadin-grid") @NpmPackage(value = "@vaadin/grid", version = "25.2.0") @@ -231,6 +232,8 @@ public class Grid<T> extends Component implements HasStyle, HasSize, /** * behavior when parsing nested properties which may contain * <code>null</code> values in the property chain + * + * @since 14.5 */ public enum NestedNullBehavior { /** @@ -250,6 +253,9 @@ public enum NestedNullBehavior { // package-private because it's used in tests static final String DRAG_SOURCE_DATA_KEY = "drag-source-data"; + /** + * @since 1.1 + */ protected static class UpdateQueue implements Update { private final ArrayList<SerializableRunnable> queue = new ArrayList<>(); private final Element element; @@ -378,6 +384,7 @@ protected void fireSelectionEvent( * * @see Grid#setSelectionMode(SelectionMode) * @see Grid#setMultiSort(boolean, MultiSortPriority) + * @since 23.2 */ public enum MultiSortPriority { /** @@ -407,6 +414,7 @@ public enum MultiSortPriority { * * @param priority * the multi-sort priority to be used by all grid instances + * @since 23.2 */ public static void setDefaultMultiSortPriority(MultiSortPriority priority) { defaultMultiSortPriority = priority; @@ -513,6 +521,7 @@ protected String getInternalId() { * * @return the renderer used for this column, should never be * {@code null} + * @since 2.0 */ public Renderer<T> getRenderer() { return renderer; @@ -649,6 +658,7 @@ public int getFlexGrow() { * whether to enable or disable automatic width on this * column * @return this column, for method chaining + * @since 4.0 */ public Column<T> setAutoWidth(boolean autoWidth) { getElement().setProperty("autoWidth", autoWidth); @@ -659,6 +669,7 @@ public Column<T> setAutoWidth(boolean autoWidth) { * Gets this column's auto width state. * * @return whether this column has automatic width enabled + * @since 4.0 */ public boolean isAutoWidth() { return getElement().getProperty("autoWidth", false); @@ -973,6 +984,7 @@ public Column<T> setFooter(Component footerComponent) { * * @see Grid#getEditor() * @see Binder#bind(HasValue, ValueProvider, Setter) + * @since 2.1 */ public Column<T> setEditorComponent(Component editorComponent) { if (editorComponent == null) { @@ -997,6 +1009,7 @@ public Column<T> setEditorComponent(Component editorComponent) { * * @see Grid#getEditor() * @see #setEditorComponent(Component) + * @since 2.1 */ public Column<T> setEditorComponent( SerializableFunction<T, ? extends Component> componentCallback) { @@ -1020,6 +1033,7 @@ public Column<T> setEditorComponent( * {@link #setEditorComponent(SerializableFunction)}. * * @see #setEditorComponent(Component) + * @since 2.1 */ public Component getEditorComponent() { return editorComponent; @@ -1041,6 +1055,7 @@ public Component getEditorComponent() { * @throws NullPointerException * if {@code partNameGenerator} is {@code null} * @see Grid#setPartNameGenerator(SerializableFunction) + * @since 24.0 */ public Column<T> setPartNameGenerator( SerializableFunction<T, String> partNameGenerator) { @@ -1061,6 +1076,7 @@ public Column<T> setPartNameGenerator( * @return this column * @throws NullPointerException * if {@code tooltipGenerator} is {@code null} + * @since 23.3 */ public Column<T> setTooltipGenerator( SerializableFunction<T, String> tooltipGenerator) { @@ -1077,6 +1093,7 @@ public Column<T> setTooltipGenerator( * cells in this column. * * @return the part name generator + * @since 24.0 */ public SerializableFunction<T, String> getPartNameGenerator() { return partNameGenerator; @@ -1091,6 +1108,7 @@ public SerializableFunction<T, String> getTooltipGenerator() { * * @return whether cells in this column should be announced as row * headers. + * @since 24.2 */ public boolean isRowHeader() { return getElement().getProperty("rowHeader", false); @@ -1109,6 +1127,7 @@ public boolean isRowHeader() { * @param rowHeader * whether cells in this column should be announced as row * headers + * @since 24.2 */ public Column<T> setRowHeader(boolean rowHeader) { getElement().setProperty("rowHeader", rowHeader); @@ -1410,6 +1429,7 @@ public Grid() { * @param dataProvider * the data provider, not {@code null} * + * @since 24.1 */ public Grid(DataProvider<T, Void> dataProvider) { this(); @@ -1422,6 +1442,7 @@ public Grid(DataProvider<T, Void> dataProvider) { * @param dataProvider * the data provider, not {@code null} * + * @since 24.1 */ public Grid(BackEndDataProvider<T, Void> dataProvider) { this(); @@ -1434,6 +1455,7 @@ public Grid(BackEndDataProvider<T, Void> dataProvider) { * @param inMemoryDataProvider * the data provider, not {@code null} * + * @since 24.1 */ public Grid(InMemoryDataProvider<T> inMemoryDataProvider) { this(); @@ -1446,6 +1468,7 @@ public Grid(InMemoryDataProvider<T> inMemoryDataProvider) { * @param dataProvider * the data provider, not {@code null} * + * @since 24.1 */ public Grid(ListDataProvider<T> dataProvider) { this(); @@ -1459,6 +1482,7 @@ public Grid(ListDataProvider<T> dataProvider) { * @param items * the collection of items, not {@code null} * + * @since 24.1 */ public Grid(Collection<T> items) { this(); @@ -1502,6 +1526,7 @@ public Grid(int pageSize) { * @param autoCreateColumns * when <code>true</code>, columns are created automatically for * the properties of the beanType + * @since 2.0 */ public Grid(Class<T> beanType, boolean autoCreateColumns) { this(); @@ -1550,6 +1575,7 @@ public Grid(Class<T> beanType) { * the data communicator builder type * @param <U> * the GridArrayUpdater type + * @since 24.9 */ protected <U extends GridArrayUpdater, B extends DataCommunicatorBuilder<T, U>> Grid( Class<T> beanType, B dataCommunicatorBuilder) { @@ -1583,6 +1609,7 @@ protected <U extends GridArrayUpdater, B extends DataCommunicatorBuilder<T, U>> * @param autoCreateColumns * when <code>true</code>, columns are created automatically for * the properties of the beanType + * @since 24.9 */ protected <U extends GridArrayUpdater, B extends DataCommunicatorBuilder<T, U>> Grid( Class<T> beanType, B dataCommunicatorBuilder, @@ -1611,6 +1638,7 @@ protected <U extends GridArrayUpdater, B extends DataCommunicatorBuilder<T, U>> * the data communicator builder type * @param <U> * the GridArrayUpdater type + * @since 24.9 */ @SuppressWarnings("unchecked") protected <U extends GridArrayUpdater, B extends DataCommunicatorBuilder<T, U>> Grid( @@ -1719,6 +1747,7 @@ protected void initConnector() { * * @param <U> * the ArrayUpdater type + * @since 1.1 */ protected static class DataCommunicatorBuilder<T, U extends ArrayUpdater> implements Serializable { @@ -1738,6 +1767,7 @@ protected static class DataCommunicatorBuilder<T, U extends ArrayUpdater> * the unique key value provider supplier for the data * communicator * @return the build data communicator object + * @since 2.0 */ protected DataCommunicator<T> build(Element element, CompositeDataGenerator<T> dataGenerator, U arrayUpdater, @@ -1809,6 +1839,7 @@ public Column<T> addColumn(ValueProvider<T, ?> valueProvider) { * @see #addComponentColumn(ValueProvider) * @see #addColumn(Renderer) * @see #removeColumn(Column) + * @since 3.0 */ protected <C extends Column<T>> C addColumn( ValueProvider<T, ?> valueProvider, @@ -1978,6 +2009,7 @@ public Column<T> addColumn(Renderer<T> renderer) { * @see LitRenderer#of(String) * @see #addComponentColumn(ValueProvider) * @see #removeColumn(Column) + * @since 3.0 */ protected <C extends Column<T>> C addColumn(Renderer<T> renderer, BiFunction<Renderer<T>, String, C> columnFactory) { @@ -2034,6 +2066,7 @@ protected <C extends Column<T>> C addColumn(Renderer<T> renderer, * {@link #getDefaultColumnFactory} should be used instead. * @see #createColumnId(boolean) * @see Renderer + * @since 2.1 */ @Deprecated protected Column<T> createColumn(Renderer<T> renderer, String columnId) { @@ -2046,6 +2079,7 @@ protected Column<T> createColumn(Renderer<T> renderer, String columnId) { * This method must not return <code>null</code>. * * @return method for column creation + * @since 3.0 */ protected BiFunction<Renderer<T>, String, Column<T>> getDefaultColumnFactory() { return this::createColumn; @@ -2124,6 +2158,7 @@ public Column<T> addColumn(String propertyName) { * the method that creates a new column instance for this * {@link Grid} instance. * @return the created column + * @since 3.0 */ protected <C extends Column<T>> C addColumn(String propertyName, BiFunction<Renderer<T>, String, C> columnFactory) { @@ -2196,6 +2231,7 @@ private Object runPropertyValueGetter(PropertyDefinition<T, ?> property, * the property names of the new columns, not <code>null</code> * @see #addColumn(String) * @see #removeColumn(Column) + * @since 2.0 */ public void addColumns(String... propertyNames) { checkForBeanGrid(); @@ -2247,6 +2283,7 @@ public void setColumns(String... propertyNames) { * * @see #setColumns(String...) * @see #getColumnByKey(String) + * @since 2.0 */ public void setSortableColumns(String... propertyNames) { checkForBeanGrid(); @@ -2338,6 +2375,7 @@ public HeaderRow appendHeaderRow() { * rows * @throws NoSuchElementException * if the header row cannot be found + * @since 24.4 */ public void removeHeaderRow(HeaderRow headerRow) { Objects.requireNonNull(headerRow); @@ -2382,6 +2420,7 @@ private void removeNonDefaultHeaderInBottomLayer(HeaderRow headerRow) { * Removes all header rows from the grid. * * @see #removeHeaderRow(HeaderRow) + * @since 24.4 */ public void removeAllHeaderRows() { var headerRows = getHeaderRows(); @@ -2449,6 +2488,7 @@ public FooterRow appendFooterRow() { * the footer row to remove * @throws NoSuchElementException * if the footer row cannot be found + * @since 24.4 */ public void removeFooterRow(FooterRow footerRow) { Objects.requireNonNull(footerRow); @@ -2495,6 +2535,7 @@ private void removeFooterInBottomLayer(FooterRow footerRow) { * Removes all footer rows from the grid. * * @see #removeFooterRow(FooterRow) + * @since 24.4 */ public void removeAllFooterRows() { getFooterRows().forEach(this::removeFooterRow); @@ -2552,6 +2593,7 @@ public List<FooterRow> getFooterRows() { * * @param variants * theme variants to add + * @since 2.0 */ public void addThemeVariants(GridVariant... variants) { getThemeNames().addAll(Stream.of(variants) @@ -2563,6 +2605,7 @@ public void addThemeVariants(GridVariant... variants) { * * @param variants * theme variants to remove + * @since 2.0 */ public void removeThemeVariants(GridVariant... variants) { getThemeNames().removeAll(Stream.of(variants) @@ -2786,6 +2829,7 @@ protected SerializablePredicate<T> getFilter(Query<T, Void> query) { * @return the generic {@link DataView} implementation for grid * @see #getListDataView() * @see #getLazyDataView() + * @since 18.0 */ @Override public GridDataView<T> getGenericDataView() { @@ -2810,6 +2854,7 @@ public GridListDataView<T> setItems(ListDataProvider<T> dataProvider) { * fetched lazily, use {@link #getLazyDataView()} instead. * * @return the list data view that provides access to the items in the grid + * @since 18.0 */ @Override public GridListDataView<T> getListDataView() { @@ -2825,6 +2870,9 @@ public GridLazyDataView<T> setItems( return getLazyDataView(); } + /** + * @since 24.7 + */ public interface SpringData extends Serializable { /** * Callback interface for fetching a list of items from a backend based @@ -2885,6 +2933,7 @@ public interface CountCallback<PAGEABLE> extends Serializable { * a function that returns a sorted list of items from the * backend based on the given pageable * @return a data view for further configuration + * @since 24.7 */ public GridLazyDataView<T> setItemsPageable( SpringData.FetchCallback<Pageable, T> fetchCallback) { @@ -2914,6 +2963,7 @@ public GridLazyDataView<T> setItemsPageable( * @param countCallback * a function that returns the number of items in the back end * @return LazyDataView instance for further configuration + * @since 24.7 */ public GridLazyDataView<T> setItemsPageable( SpringData.FetchCallback<Pageable, T> fetchCallback, @@ -2962,6 +3012,7 @@ private static <PAGEABLE> int handleSpringCountCallback( * * @return the lazy data view that provides access to the data bound to the * grid + * @since 18.0 */ @Override public GridLazyDataView<T> getLazyDataView() { @@ -3075,6 +3126,7 @@ protected void updateSelectionModeOnClient() { * Returns the selection mode for this grid. * * @return the selection mode, not null + * @since 24.4 */ public SelectionMode getSelectionMode() { assert selectionMode != null : "No selection mode set by " @@ -3125,6 +3177,7 @@ SerializablePredicate<T> getItemSelectableProvider() { * the function to use to determine whether an item may be * selected or deselected by the user, or {@code null} to allow * all items to be selected or deselected + * @since 24.6 */ public void setItemSelectableProvider(SerializablePredicate<T> provider) { selectableProvider = provider; @@ -3245,6 +3298,7 @@ public void deselectAll() { * the selection preservation mode to switch to, not {@code null} * * @see SelectionPreservationMode + * @since 24.4 */ public void setSelectionPreservationMode( SelectionPreservationMode selectionPreservationMode) { @@ -3263,6 +3317,7 @@ public void setSelectionPreservationMode( * @return the selection preservation mode * * @see #setSelectionPreservationMode(SelectionPreservationMode) + * @since 24.4 */ public SelectionPreservationMode getSelectionPreservationMode() { return selectionPreservationHandler.getSelectionPreservationMode(); @@ -3315,6 +3370,7 @@ private void callJsFunctionBeforeClientResponse(String functionName, * * @param action * the scroll action to execute + * @since 25.1 */ protected void scheduleScrollExecution(SerializableRunnable action) { getElement().getNode().runWhenAttached(ui -> { @@ -3462,6 +3518,7 @@ public Column<T> getColumnByKey(String columnKey) { * the internal identifier of the column to get * @return the column corresponding to the given column identifier, or * {@code null} if no column has such an identifier + * @since 24.7.4 */ protected final Column<T> getColumnByInternalId(String internalId) { return idToColumnMap.get(internalId); @@ -3527,6 +3584,7 @@ public void removeColumn(Column<T> column) { * if the column is {@code null} * @throws IllegalArgumentException * if the column is not owned by this Grid + * @since 4.1 */ public void removeColumns(Column<T>... columns) { for (Column<T> column : columns) { @@ -3536,6 +3594,8 @@ public void removeColumns(Column<T>... columns) { /** * Removes all columns from this Grid. + * + * @since 3.0 */ public void removeAllColumns() { getColumns().forEach(c -> removeColumn(c)); @@ -3643,6 +3703,7 @@ public void setMultiSort(boolean multiSort) { * the multi-sort priority to set, not {@code null} * * @see MultiSortPriority + * @since 23.2 */ public void setMultiSort(boolean multiSort, MultiSortPriority priority) { doSetMultiSort(multiSort); @@ -3659,6 +3720,7 @@ public void setMultiSort(boolean multiSort, MultiSortPriority priority) { * {@code true} to enable multi-sort by shift-clicking (when * {@code multiSort = true}), {@code false} for normal multi-sort * behavior + * @since 23.3 */ public void setMultiSort(boolean multiSort, boolean onShiftClickOnly) { doSetMultiSort(multiSort); @@ -3681,6 +3743,7 @@ public void setMultiSort(boolean multiSort, boolean onShiftClickOnly) { * behavior * * @see MultiSortPriority + * @since 23.3 */ public void setMultiSort(boolean multiSort, MultiSortPriority priority, boolean onShiftClickOnly) { @@ -3737,6 +3800,7 @@ private void updateContextMenuTargetItem(String key, String colId) { * * @param ariaLabel * the aria-label text to set or {@code null} to clear + * @since 24.6 */ public void setAriaLabel(String ariaLabel) { if (ariaLabel == null) { @@ -3751,6 +3815,7 @@ public void setAriaLabel(String ariaLabel) { * * @return an optional aria-label of the component if no aria-label has been * set + * @since 24.6 */ public Optional<String> getAriaLabel() { return Optional.ofNullable(getElement().getProperty("accessibleName")); @@ -3760,6 +3825,7 @@ public Optional<String> getAriaLabel() { * Adds a new context-menu for this grid. * * @return the added context-menu + * @since 1.2 */ public GridContextMenu<T> addContextMenu() { return new GridContextMenu<T>(this); @@ -3883,6 +3949,7 @@ private void sortersChanged(ArrayNode sorters) { * <code>null</code> to reset any sort orders. * @see #setMultiSort(boolean) * @see #getSortOrder() + * @since 2.0 */ public void sort(List<GridSortOrder<T>> order) { if (order == null) { @@ -3966,6 +4033,7 @@ private void setSortOrder(List<GridSortOrder<T>> order, * Gets an list of the current sort orders in the Grid. * * @return an unmodifiable list of sort orders + * @since 2.0 */ public List<GridSortOrder<T>> getSortOrder() { return Collections.unmodifiableList(sortOrder); @@ -4073,6 +4141,7 @@ protected SerializableComparator<T> createSortingComparator() { * @param allRowsVisible * <code>true</code> to make Grid compute its height by the * number of rows, <code>false</code> for the default behavior + * @since 21.0 */ public void setAllRowsVisible(boolean allRowsVisible) { getElement().setProperty("allRowsVisible", allRowsVisible); @@ -4083,6 +4152,7 @@ public void setAllRowsVisible(boolean allRowsVisible) { * * @return <code>true</code> if Grid computes its height by the number of * rows, <code>false</code> otherwise + * @since 21.0 */ @Synchronize("all-rows-visible-changed") public boolean isAllRowsVisible() { @@ -4121,6 +4191,7 @@ public void onEnabledStateChanged(boolean enabled) { * <code>null</code> * @return a registration that can be used to remove the ValueProvider from * the Grid + * @since 2.0 */ public Registration addValueProvider(String property, ValueProvider<T, ?> valueProvider) { @@ -4171,6 +4242,7 @@ protected static int compareMaybeComparables(Object a, Object b) { * @param autoCreateColumns * when <code>true</code>, columns are created automatically for * the properties of the beanType + * @since 21.0 */ public void configureBeanType(Class<T> beanType, boolean autoCreateColumns) { @@ -4199,6 +4271,7 @@ public void configureBeanType(Class<T> beanType, * {@link #Grid(Class)}. Or null if not constructed from a bean type. * * @return the Class of bean this Grid is constructed with + * @since 4.0 */ public Class<T> getBeanType() { return beanType; @@ -4209,6 +4282,7 @@ public Class<T> getBeanType() { * {@link #Grid(Class)}. Or null if not constructed from a bean type. * * @return the {@link PropertySet} of bean this Grid is constructed with + * @since 1.1 */ public PropertySet<T> getPropertySet() { return propertySet; @@ -4222,6 +4296,7 @@ public PropertySet<T> getPropertySet() { * @return a handle that can be used for removing the listener * * @see #addItemDoubleClickListener(ComponentEventListener) + * @since 2.1 */ @SuppressWarnings({ "unchecked", "rawtypes" }) public Registration addItemClickListener( @@ -4237,6 +4312,7 @@ public Registration addItemClickListener( * @param listener * the listener to add, not <code>null</code> * @return a handle that can be used for removing the listener + * @since 4.1 */ @SuppressWarnings({ "unchecked", "rawtypes" }) public Registration addColumnResizeListener( @@ -4263,6 +4339,7 @@ public Registration addColumnResizeListener( * @return a handle that can be used for removing the listener * * @see #addItemClickListener(ComponentEventListener) + * @since 2.1 */ @SuppressWarnings({ "unchecked", "rawtypes" }) public Registration addItemDoubleClickListener( @@ -4295,6 +4372,7 @@ public Registration addItemDoubleClickListener( * @param listener * the listener to add, not <code>null</code> * @return a handle that can be used for removing the listener + * @since 21.0 */ @SuppressWarnings({ "unchecked", "rawtypes" }) public Registration addCellFocusListener( @@ -4311,6 +4389,7 @@ public Registration addCellFocusListener( * @see #createEditor() * * @return the editor instance + * @since 2.1 */ public Editor<T> getEditor() { if (editor == null) { @@ -4334,6 +4413,7 @@ public Editor<T> getEditor() { * @throws NullPointerException * if {@code partNameGenerator} is {@code null} * @see Column#setPartNameGenerator(SerializableFunction) + * @since 24.0 */ public void setPartNameGenerator( SerializableFunction<T, String> partNameGenerator) { @@ -4348,6 +4428,7 @@ public void setPartNameGenerator( * to {@code true}. * * @see Column#setAutoWidth(boolean) + * @since 4.0 */ public void recalculateColumnWidths() { // Defer column width recalculation to occur after the data was @@ -4365,6 +4446,7 @@ public void recalculateColumnWidths() { * this grid. * * @return the part name generator + * @since 24.0 */ public SerializableFunction<T, String> getPartNameGenerator() { return partNameGenerator; @@ -4444,6 +4526,7 @@ private void generateSelectableData(T item, ObjectNode jsonObject) { * automatically added to {@link DataCommunicator}. * * @return editor + * @since 2.1 */ protected Editor<T> createEditor() { return new EditorImpl<>(this, propertySet); @@ -4453,6 +4536,7 @@ protected Editor<T> createEditor() { * Gets optional value provider for unique key in row's generated JSON. * * @return ValueProvider for unique key for row or null if not set + * @since 1.1 */ protected ValueProvider<T, String> getUniqueKeyProvider() { return uniqueKeyProvider; @@ -4465,6 +4549,7 @@ protected ValueProvider<T, String> getUniqueKeyProvider() { * * @param uniqueKeyProvider * ValueProvider for unique key for row + * @since 1.1 */ protected void setUniqueKeyProvider( ValueProvider<T, String> uniqueKeyProvider) { @@ -4475,6 +4560,7 @@ protected void setUniqueKeyProvider( * Gets property name for unique key in row's generated JSON. * * @return the optional property name for unique key + * @since 1.1 */ protected String getUniqueKeyProperty() { return uniqueKeyProperty; @@ -4485,6 +4571,7 @@ protected String getUniqueKeyProperty() { * * @param uniqueKeyProperty * the new optional property name for unique key + * @since 1.1 */ protected void setUniqueKeyProperty(String uniqueKeyProperty) { this.uniqueKeyProperty = uniqueKeyProperty; @@ -4508,6 +4595,7 @@ protected GridArrayUpdater getArrayUpdater() { * @see DataChangeEvent * @see DataProviderListener * + * @since 3.0 */ protected void onDataProviderChange() { SerializableSupplier<Editor<T>> factory = editorFactory; @@ -4571,6 +4659,7 @@ private void handleDataProviderChange(DataProvider<T, ?> dataProvider) { * @param listener * the listener to add, not <code>null</code> * @return a handle that can be used for removing the listener + * @since 4.0 */ @SuppressWarnings({ "unchecked", "rawtypes" }) public Registration addDropListener( @@ -4585,6 +4674,7 @@ public Registration addDropListener( * @param listener * the listener to add, not <code>null</code> * @return a handle that can be used for removing the listener + * @since 4.0 */ @SuppressWarnings({ "unchecked", "rawtypes" }) public Registration addDragStartListener( @@ -4599,6 +4689,7 @@ public Registration addDragStartListener( * @param listener * the listener to add, not <code>null</code> * @return a handle that can be used for removing the listener + * @since 4.0 */ @SuppressWarnings({ "unchecked", "rawtypes" }) public Registration addDragEndListener( @@ -4637,6 +4728,7 @@ public Registration addDragEndListener( * Grid's row. Can be {@code null} to disable dropping on the * grid. * @see GridDropEvent#getDropLocation() + * @since 4.0 */ public void setDropMode(GridDropMode dropMode) { getElement().setProperty("dropMode", @@ -4649,6 +4741,7 @@ public void setDropMode(GridDropMode dropMode) { * * @return Drop mode that describes the allowed drop locations within the * Grid's row. {@code null} if dropping is not enabled. + * @since 4.0 */ public GridDropMode getDropMode() { String dropMode = getElement().getProperty("dropMode"); @@ -4663,6 +4756,7 @@ public GridDropMode getDropMode() { * @param rowsDraggable * {@code true} if the rows can be dragged by the user; * {@code false} if not + * @since 4.0 */ public void setRowsDraggable(boolean rowsDraggable) { getElement().setProperty("rowsDraggable", rowsDraggable); @@ -4673,6 +4767,7 @@ public void setRowsDraggable(boolean rowsDraggable) { * Gets whether rows of the grid can be dragged. * * @return {@code true} if the rows are draggable, {@code false} otherwise + * @since 4.0 */ public boolean isRowsDraggable() { return getElement().getProperty("rowsDraggable", false); @@ -4682,6 +4777,7 @@ public boolean isRowsDraggable() { * Gets the active drop filter. * * @return The drop filter function + * @since 4.0 */ public SerializablePredicate<T> getDropFilter() { return dropFilter; @@ -4691,6 +4787,7 @@ public SerializablePredicate<T> getDropFilter() { * Gets the active drag filter. * * @return The drag filter function + * @since 4.0 */ public SerializablePredicate<T> getDragFilter() { return dragFilter; @@ -4718,6 +4815,8 @@ public SerializablePredicate<T> getDragFilter() { * <em>NOTE: If the filtering conditions change dynamically, remember to * explicitly invoke {@code getDataProvider().refreshItem(item)} for the * relevant items to get the filters re-run for them. + * + * @since 4.0 */ public void setDropFilter(SerializablePredicate<T> dropFilter) { Objects.requireNonNull(dropFilter, "Drop filter can not be null"); @@ -4738,6 +4837,8 @@ public void setDropFilter(SerializablePredicate<T> dropFilter) { * <em>NOTE: If the filtering conditions change dynamically, remember to * explicitly invoke {@code getDataProvider().refreshItem(item)} for the * relevant items to get the filters re-run for them. + * + * @since 4.0 */ public void setDragFilter(SerializablePredicate<T> dragFilter) { Objects.requireNonNull(dragFilter, "Drag filter can not be null"); @@ -4759,6 +4860,7 @@ public void setDragFilter(SerializablePredicate<T> dragFilter) { * accessible during drop using this type. * @param dragDataGenerator * Function to be executed on row data generation. + * @since 4.0 */ public void setDragDataGenerator(String type, SerializableFunction<T, String> dragDataGenerator) { @@ -4797,6 +4899,7 @@ public void setTooltipGenerator( * focused. The default position is {@link TooltipPosition#BOTTOM}. * * @return the position of the tooltip + * @since 24.7 */ public TooltipPosition getTooltipPosition() { String position = getTooltipElement() @@ -4811,6 +4914,7 @@ public TooltipPosition getTooltipPosition() { * * @param position * the position to set + * @since 24.7 */ public void setTooltipPosition(TooltipPosition position) { Objects.requireNonNull(position, "Position cannot be null"); @@ -4826,6 +4930,7 @@ public void setTooltipPosition(TooltipPosition position) { * * @return {@code true} if the content is rendered as Markdown, * {@code false} if it is treated as plain text + * @since 25.0 */ public boolean isTooltipMarkdownEnabled() { return getTooltipElement().map( @@ -4840,6 +4945,7 @@ public boolean isTooltipMarkdownEnabled() { * @param markdownEnabled * {@code true} to render the content as Markdown, {@code false} * to treat it as plain text + * @since 25.0 */ public void setTooltipMarkdownEnabled(boolean markdownEnabled) { addTooltipElementToTooltipSlot(); @@ -4885,6 +4991,7 @@ private Optional<Element> getTooltipElement() { * @param dragData * The drag data for selection drag. The map should consist of * data type:data -entries + * @since 4.0 */ public void setSelectionDragDetails(int draggedItemsCount, Map<String, String> dragData) { @@ -4908,6 +5015,7 @@ public void setSelectionDragDetails(int draggedItemsCount, * @param listener * the listener to add, not <code>null</code> * @return a handle that can be used for removing the listener + * @since 4.1 */ @SuppressWarnings({ "unchecked", "rawtypes" }) public Registration addColumnReorderListener( @@ -4942,6 +5050,7 @@ public Registration addColumnReorderListener( * contain all columns currently present in the Grid, or if the * column rearranging would require to split a joined * header/footer cell group. + * @since 4.1 */ public void setColumnOrder(Column<T>... columns) { setColumnOrder(Arrays.asList(columns)); @@ -4973,6 +5082,7 @@ public void setColumnOrder(Column<T>... columns) { * contain all columns currently present in the Grid, or if the * column rearranging would require to split a joined * header/footer cell group. + * @since 4.1 */ public void setColumnOrder(List<Column<T>> columns) { new GridColumnOrderHelper<>(this).setColumnOrder(columns); @@ -4993,6 +5103,7 @@ private void fireColumnReorderEvent(List<Column<T>> columns) { * * @param rowIndex * zero based index of the item to scroll to in the current view. + * @since 4.1 */ public void scrollToIndex(int rowIndex) { setViewportRangeByIndex(rowIndex); @@ -5044,6 +5155,7 @@ private void setViewportRangeByIndex(int rowIndex) { * @throws UnsupportedOperationException * if {@link ItemIndexProvider} is missing for grid with a lazy * loading data provider. + * @since 24.4 */ public void scrollToItem(T item) { Objects.requireNonNull(item, "Item to scroll to cannot be null."); @@ -5063,6 +5175,8 @@ public void scrollToItem(T item) { /** * Scrolls to the beginning of the first data row. + * + * @since 4.1 */ public void scrollToStart() { scrollToIndex(0); @@ -5070,6 +5184,8 @@ public void scrollToStart() { /** * Scrolls to the last data row of the grid. + * + * @since 4.1 */ public void scrollToEnd() { scheduleScrollExecution(() -> getElement() @@ -5082,6 +5198,7 @@ public void scrollToEnd() { * * @param columnIndex * the index of the column to scroll to + * @since 25.1 */ public void scrollToColumn(int columnIndex) { getElement().callJsFunction("scrollToColumn", columnIndex); @@ -5092,6 +5209,7 @@ public void scrollToColumn(int columnIndex) { * * @param column * the column to scroll to + * @since 25.1 */ public void scrollToColumn(Column<T> column) { getElement().callJsFunction("scrollToColumn", column.getElement()); @@ -5116,6 +5234,7 @@ private void onDragEnd(GridDragEndEvent<T> event) { * * @param nestedNullBehavior * the behavior when facing nested <code>null</code> values. + * @since 14.5 */ public void setNestedNullBehavior(NestedNullBehavior nestedNullBehavior) { this.nestedNullBehavior = nestedNullBehavior; @@ -5125,6 +5244,7 @@ public void setNestedNullBehavior(NestedNullBehavior nestedNullBehavior) { * Get the behavior when facing nested <code>null</code> values. * * @return The current behavior when facing nested <code>null</code> values. + * @since 14.5 */ public NestedNullBehavior getNestedNullBehavior() { return nestedNullBehavior; @@ -5179,6 +5299,7 @@ public NestedNullBehavior getNestedNullBehavior() { * @param columnRendering * the column rendering mode to use * @see ColumnRendering + * @since 24.1 */ public void setColumnRendering(ColumnRendering columnRendering) { getElement().setProperty("columnRendering", @@ -5191,6 +5312,7 @@ public void setColumnRendering(ColumnRendering columnRendering) { * Gets the current column rendering mode. * * @return the current column rendering mode + * @since 24.1 */ public ColumnRendering getColumnRendering() { return ColumnRendering @@ -5269,6 +5391,7 @@ private String getUniqueKey(T item) { * @param emptyStateComponent * the component to be displayed when the grid is empty, or null * to clear the empty state content + * @since 24.5 */ public void setEmptyStateComponent(Component emptyStateComponent) { this.emptyStateText = null; @@ -5285,6 +5408,7 @@ public void setEmptyStateComponent(Component emptyStateComponent) { * @param emptyStateText * the text to be displayed when the grid is empty, or null to * clear the empty state content + * @since 24.5 */ public void setEmptyStateText(String emptyStateText) { this.emptyStateComponent = null; @@ -5297,6 +5421,7 @@ public void setEmptyStateText(String emptyStateText) { * * @return the component that is displayed when the grid is empty or null if * no empty state component is set + * @since 24.5 */ public Component getEmptyStateComponent() { return emptyStateComponent; @@ -5307,6 +5432,7 @@ public Component getEmptyStateComponent() { * * @return the text that is displayed when the grid is empty or null if no * empty state text is set + * @since 24.5 */ public String getEmptyStateText() { return emptyStateText; diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridArrayUpdater.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridArrayUpdater.java index 9cad967bbd9..726c9579507 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridArrayUpdater.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridArrayUpdater.java @@ -21,6 +21,7 @@ * Array update strategy aware class for Grid. * * @author Vaadin Ltd + * @since 1.1 */ public interface GridArrayUpdater extends ArrayUpdater { } diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridMultiSelectionModel.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridMultiSelectionModel.java index e20b4ed88b4..d0a833176df 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridMultiSelectionModel.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridMultiSelectionModel.java @@ -31,6 +31,7 @@ * * @param <T> * the type of items in grid + * @since 1.0 */ public interface GridMultiSelectionModel<T> extends GridSelectionModel<T>, SelectionModel.Multi<Grid<T>, T> { @@ -104,6 +105,7 @@ Registration addMultiSelectionListener( * @param listener * the client item toggle listener, not {@code null} * @return a registration for the listener + * @since 24.7 */ Registration addClientItemToggleListener( ComponentEventListener<ClientItemToggleEvent<T>> listener); @@ -177,6 +179,7 @@ void setSelectAllCheckboxVisibility( * @param dragSelect * <code>true</code> to enable drag select feature, * <code>false</code> for disabling it + * @since 24.2 */ void setDragSelect(boolean dragSelect); @@ -185,6 +188,7 @@ void setSelectAllCheckboxVisibility( * * @return <code>true</code> if drag select feature is enabled, * <code>false</code> otherwise + * @since 24.2 */ boolean isDragSelect(); } diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridNoneSelectionModel.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridNoneSelectionModel.java index b542ec4ad0f..c1e57f47ee4 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridNoneSelectionModel.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridNoneSelectionModel.java @@ -27,6 +27,7 @@ * * @param <T> * the grid bean type + * @since 1.0 */ public class GridNoneSelectionModel<T> implements GridSelectionModel<T> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSelectionColumn.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSelectionColumn.java index 40058a7998c..b039d459cf7 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSelectionColumn.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSelectionColumn.java @@ -26,6 +26,7 @@ * Server side implementation for the flow specific grid selection column. * * @author Vaadin Ltd. + * @since 1.0 */ @Tag("vaadin-grid-flow-selection-column") @JsModule("./vaadin-grid-flow-selection-column.js") @@ -67,6 +68,7 @@ public void setSelectAllCheckboxState(boolean selectAll) { * * @param indeterminate * the new indeterminate state of the select all checkbox + * @since 23.0.4 */ public void setSelectAllCheckboxIndeterminateState(boolean indeterminate) { getElement().setProperty("_indeterminate", indeterminate); @@ -109,6 +111,7 @@ public boolean isFrozen() { * @param dragSelect * <code>true</code> to enable drag select feature, * <code>false</code> for disabling it + * @since 24.2 */ public void setDragSelect(boolean dragSelect) { getElement().setProperty("dragSelect", dragSelect); @@ -119,6 +122,7 @@ public void setDragSelect(boolean dragSelect) { * * @return <code>true</code> if drag select feature is enabled, * <code>false</code> otherwise + * @since 24.2 */ @Synchronize("drag-select-changed") public boolean isDragSelect() { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSelectionModel.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSelectionModel.java index 15c61027b3e..53874ec6fd2 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSelectionModel.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSelectionModel.java @@ -22,6 +22,7 @@ * * @param <T> * the grid bean type + * @since 1.0 */ public interface GridSelectionModel<T> extends SelectionModel<Grid<T>, T> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSingleSelectionModel.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSingleSelectionModel.java index 05506791ecb..fb6c3aa8915 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSingleSelectionModel.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSingleSelectionModel.java @@ -28,6 +28,7 @@ * * @param <T> * the type of items in grid + * @since 1.0 */ public interface GridSingleSelectionModel<T> extends GridSelectionModel<T>, SelectionModel.Single<Grid<T>, T> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSortOrder.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSortOrder.java index c5f65be69b8..66a3c0ca108 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSortOrder.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSortOrder.java @@ -26,6 +26,7 @@ * * @param <T> * the grid type + * @since 1.0 */ public class GridSortOrder<T> extends SortOrder<Column<T>> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSortOrderBuilder.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSortOrderBuilder.java index 7ce3fb70bf0..0c210e89294 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSortOrderBuilder.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridSortOrderBuilder.java @@ -33,6 +33,7 @@ * * @param <T> * the type of the grid + * @since 1.0 */ public class GridSortOrderBuilder<T> extends SortOrderBuilder<GridSortOrder<T>, Column<T>> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridVariant.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridVariant.java index 6ee0c65a035..c1ea40167ed 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridVariant.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/GridVariant.java @@ -17,6 +17,8 @@ /** * Set of theme variants applicable for {@code vaadin-grid} component. + * + * @since 2.0 */ public enum GridVariant { LUMO_NO_BORDER("no-border"), diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/HeaderRow.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/HeaderRow.java index 234689e8c9f..3dfcf506e0a 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/HeaderRow.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/HeaderRow.java @@ -30,6 +30,7 @@ * One row of {@link HeaderCell}s in a Grid. * * @author Vaadin Ltd. + * @since 1.0 */ public class HeaderRow extends AbstractRow<HeaderCell> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ItemClickEvent.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ItemClickEvent.java index b1be85ebeec..3e6192e8002 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ItemClickEvent.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ItemClickEvent.java @@ -29,6 +29,7 @@ * * @see Grid#addItemClickListener(com.vaadin.flow.component.ComponentEventListener) * + * @since 2.1 */ @DomEvent("item-click") public class ItemClickEvent<T> extends ClickEvent<Grid<T>> { @@ -79,6 +80,7 @@ public class ItemClickEvent<T> extends ClickEvent<Grid<T>> { * <code>true</code> if the meta key was down when the event was * fired, <code>false</code> otherwise * + * @since 4.1 */ public ItemClickEvent(Grid<T> source, boolean fromClient, @EventData("event.detail.itemKey") String itemKey, @@ -113,6 +115,7 @@ public T getItem() { * * @return the clicked column or {@code null} if it was the multi-selection * column. + * @since 4.1 */ public Grid.Column<T> getColumn() { return column; diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ItemDoubleClickEvent.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ItemDoubleClickEvent.java index 6c25de5fc02..1cdc3c1c9ba 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ItemDoubleClickEvent.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/ItemDoubleClickEvent.java @@ -29,6 +29,7 @@ * * @author Vaadin Ltd * + * @since 2.1 */ @DomEvent("item-double-click") public class ItemDoubleClickEvent<T> extends ItemClickEvent<T> { @@ -75,6 +76,7 @@ public class ItemDoubleClickEvent<T> extends ItemClickEvent<T> { * <code>true</code> if the meta key was down when the event was * fired, <code>false</code> otherwise * + * @since 4.1 */ public ItemDoubleClickEvent(Grid<T> source, boolean fromClient, @EventData("event.detail.itemKey") String itemKey, diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/SortOrderProvider.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/SortOrderProvider.java index e29f5c3ac60..45c0d6f36a6 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/SortOrderProvider.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/SortOrderProvider.java @@ -28,6 +28,7 @@ * @see Column#setSortOrderProvider * * @author Vaadin Ltd + * @since 1.0 */ @FunctionalInterface public interface SortOrderProvider diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/contextmenu/GridContextMenu.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/contextmenu/GridContextMenu.java index c78e6155753..dd8bb951376 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/contextmenu/GridContextMenu.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/contextmenu/GridContextMenu.java @@ -35,6 +35,7 @@ * {@link Grid}. * * @author Vaadin Ltd. + * @since 3.0 */ @SuppressWarnings("serial") public class GridContextMenu<T> extends @@ -86,6 +87,9 @@ public Optional<T> getItem() { } } + /** + * @since 4.0 + */ public static class GridContextMenuOpenedEvent<T> extends OpenedChangeEvent<GridContextMenu<T>> { @@ -203,6 +207,7 @@ protected MenuManager<GridContextMenu<T>, GridMenuItem<T>, GridSubMenu<T>> creat * @param listener * the listener to add * @return a Registration for removing the event listener + * @since 4.0 */ public Registration addGridContextMenuOpenedListener( ComponentEventListener<GridContextMenuOpenedEvent<T>> listener) { @@ -222,6 +227,7 @@ public Registration addGridContextMenuOpenedListener( * * @return the callback function that is executed before opening the context * menu, or {@code null} if not specified. + * @since 4.1 */ public SerializablePredicate<T> getDynamicContentHandler() { return dynamicContentHandler; @@ -244,6 +250,7 @@ public SerializablePredicate<T> getDynamicContentHandler() { * @param dynamicContentHandler * the callback function that will be executed before opening the * context menu. + * @since 4.1 */ public void setDynamicContentHandler( SerializablePredicate<T> dynamicContentHandler) { @@ -252,6 +259,8 @@ public void setDynamicContentHandler( /** * {@inheritDoc} + * + * @since 25.0 */ @Override protected boolean onBeforeOpenMenu(ObjectNode eventDetail) { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/contextmenu/GridMenuItem.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/contextmenu/GridMenuItem.java index 8bd9b7de200..e8a579f147c 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/contextmenu/GridMenuItem.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/contextmenu/GridMenuItem.java @@ -29,6 +29,7 @@ * methods. * * @author Vaadin Ltd. + * @since 3.0 */ @SuppressWarnings("serial") public class GridMenuItem<T> extends diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/contextmenu/GridSubMenu.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/contextmenu/GridSubMenu.java index f9da9e2a608..34424b1b5df 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/contextmenu/GridSubMenu.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/contextmenu/GridSubMenu.java @@ -31,6 +31,7 @@ * sub menu. Sub menu will be rendered only if content has been added inside it. * * @author Vaadin Ltd. + * @since 3.0 */ public class GridSubMenu<T> extends SubMenuBase<GridContextMenu<T>, GridMenuItem<T>, GridSubMenu<T>> diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dataview/GridDataView.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dataview/GridDataView.java index f25dde400a7..d5db754e4cb 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dataview/GridDataView.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dataview/GridDataView.java @@ -28,7 +28,7 @@ * * @param <T> * the item type - * @since + * @since 18.0 */ public class GridDataView<T> extends AbstractDataView<T> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dataview/GridLazyDataView.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dataview/GridLazyDataView.java index 47a00935d82..b078e0cfe99 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dataview/GridLazyDataView.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dataview/GridLazyDataView.java @@ -30,6 +30,7 @@ * * @param <T> * the type of the items in grid + * @since 18.0 */ public class GridLazyDataView<T> extends AbstractLazyDataView<T> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dataview/GridListDataView.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dataview/GridListDataView.java index 9cc0b2cc0ce..47b29289491 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dataview/GridListDataView.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dataview/GridListDataView.java @@ -31,7 +31,7 @@ * * @param <T> * data type - * @since + * @since 18.0 */ public class GridListDataView<T> extends AbstractListDataView<T> { private DataCommunicator<T> dataCommunicator; diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDragEndEvent.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDragEndEvent.java index 13fb42b9e3c..262188aebee 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDragEndEvent.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDragEndEvent.java @@ -26,6 +26,7 @@ * The Grid bean type. * @author Vaadin Ltd. * @see Grid#addDragEndListener(GridDragEndListener) + * @since 4.0 */ @SuppressWarnings("serial") @DomEvent("grid-dragend") diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDragStartEvent.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDragStartEvent.java index e52ef902315..075915cd3fe 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDragStartEvent.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDragStartEvent.java @@ -35,6 +35,7 @@ * The Grid bean type. * @author Vaadin Ltd. * @see Grid#addDragStartListener(GridDragStartListener) + * @since 4.0 */ @SuppressWarnings("serial") @DomEvent("grid-dragstart") @@ -52,6 +53,7 @@ public class GridDragStartEvent<T> extends ComponentEvent<Grid<T>> { * side, <code>false</code> otherwise * @param details * Event details from {@code detail}. + * @since 25.0 */ public GridDragStartEvent(Grid<T> source, boolean fromClient, @EventData("event.detail") ObjectNode details) { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDropEvent.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDropEvent.java index 39e68c111af..226df9df531 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDropEvent.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDropEvent.java @@ -38,6 +38,7 @@ * The Grid bean type. * @author Vaadin Ltd. * @see Grid#addDropListener(GridDropListener) + * @since 4.0 */ @SuppressWarnings("serial") @DomEvent("grid-drop") @@ -62,6 +63,7 @@ public class GridDropEvent<T> extends ComponentEvent<Grid<T>> { * Drop location from {@code detail.dropLocation}. * @param dragData * Drag data from {@code detail.dragData}. + * @since 25.0 */ public GridDropEvent(Grid<T> source, boolean fromClient, @EventData("event.detail.dropTargetItem") ObjectNode item, diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDropLocation.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDropLocation.java index f25d375c94d..467f8185d29 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDropLocation.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDropLocation.java @@ -19,6 +19,7 @@ * Defines drop locations within a Grid row. * * @author Vaadin Ltd. + * @since 4.0 */ public enum GridDropLocation { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDropMode.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDropMode.java index 5a110fec4a2..f6c9520544d 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDropMode.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/dnd/GridDropMode.java @@ -19,6 +19,7 @@ * Defines the locations within the Grid row where an element can be dropped. * * @author Vaadin Ltd. + * @since 4.0 */ public enum GridDropMode { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/Editor.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/Editor.java index 009cfee4765..26e753a7d2c 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/Editor.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/Editor.java @@ -31,6 +31,7 @@ * * @param <T> * the type of the row/item being edited + * @since 2.1 */ public interface Editor<T> extends Serializable { @@ -116,6 +117,7 @@ public interface Editor<T> extends Serializable { * * @throws UnsupportedOperationException * thrown if trying to close editor in buffered mode + * @since 3.0 */ void closeEditor(); diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorCancelEvent.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorCancelEvent.java index d5386529b31..890f602271f 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorCancelEvent.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorCancelEvent.java @@ -24,6 +24,7 @@ * * @param <T> * the item type + * @since 2.1 */ public class EditorCancelEvent<T> extends EditorEvent<T> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorCancelListener.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorCancelListener.java index a73c538deba..33b761ee78c 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorCancelListener.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorCancelListener.java @@ -29,6 +29,7 @@ * * @param <T> * the bean type + * @since 2.1 */ @FunctionalInterface public interface EditorCancelListener<T> extends Serializable { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorCloseEvent.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorCloseEvent.java index 911c11dc6de..790be96cb0d 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorCloseEvent.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorCloseEvent.java @@ -24,6 +24,7 @@ * * @param <T> * the item type + * @since 2.1 */ public class EditorCloseEvent<T> extends EditorEvent<T> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorCloseListener.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorCloseListener.java index 736d9001e81..c4bb05c8f4f 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorCloseListener.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorCloseListener.java @@ -29,6 +29,7 @@ * * @see EditorCloseEvent * @see Editor#addCloseListener(EditorCloseListener) + * @since 2.1 */ @FunctionalInterface public interface EditorCloseListener<T> extends Serializable { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorEvent.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorEvent.java index a66f1539f7c..32bcb8f0a34 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorEvent.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorEvent.java @@ -31,6 +31,7 @@ * * @param <T> * the item type + * @since 2.1 */ public abstract class EditorEvent<T> extends EventObject { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorImpl.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorImpl.java index e04d79079c4..25ca1d4170f 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorImpl.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorImpl.java @@ -40,6 +40,7 @@ * * @param <T> * the grid bean type + * @since 2.1 */ public class EditorImpl<T> extends AbstractGridExtension<T> implements Editor<T> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorOpenEvent.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorOpenEvent.java index 876f725c953..e6a2b8e9354 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorOpenEvent.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorOpenEvent.java @@ -24,6 +24,7 @@ * * @param <T> * the item type + * @since 2.1 */ public class EditorOpenEvent<T> extends EditorEvent<T> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorOpenListener.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorOpenListener.java index edd02abbb4a..c307254d0e0 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorOpenListener.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorOpenListener.java @@ -29,6 +29,7 @@ * * @see EditorOpenEvent * @see Editor#addOpenListener(EditorOpenListener) + * @since 2.1 */ @FunctionalInterface public interface EditorOpenListener<T> extends Serializable { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorRenderer.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorRenderer.java index 50171b16b77..56ac8051050 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorRenderer.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorRenderer.java @@ -46,6 +46,7 @@ * * @see Column#setEditorComponent(Component) * @see Column#setEditorComponent(SerializableFunction) + * @since 2.1 */ public class EditorRenderer<T> extends Renderer<T> implements DataGenerator<T> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorSaveEvent.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorSaveEvent.java index 4024a377ca3..b76aa4db199 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorSaveEvent.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorSaveEvent.java @@ -24,6 +24,7 @@ * * @param <T> * the item type + * @since 2.1 */ public class EditorSaveEvent<T> extends EditorEvent<T> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorSaveListener.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorSaveListener.java index 167b492c46a..6939c84d2f0 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorSaveListener.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/grid/editor/EditorSaveListener.java @@ -26,6 +26,7 @@ * * @see EditorSaveEvent * @see Editor#addSaveListener(EditorSaveListener) + * @since 2.1 */ @FunctionalInterface public interface EditorSaveListener<T> extends Serializable { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/treegrid/CollapseEvent.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/treegrid/CollapseEvent.java index 9f18dd11c3e..132cb853b56 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/treegrid/CollapseEvent.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/treegrid/CollapseEvent.java @@ -22,6 +22,9 @@ import com.vaadin.flow.component.Component; import com.vaadin.flow.component.ComponentEvent; +/** + * @since 1.1 + */ public class CollapseEvent<T, C extends Component> extends ComponentEvent<C> { private final Collection<T> items; diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/treegrid/ExpandEvent.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/treegrid/ExpandEvent.java index 22d1c377f08..bbff21a4674 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/treegrid/ExpandEvent.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/treegrid/ExpandEvent.java @@ -22,6 +22,9 @@ import com.vaadin.flow.component.Component; import com.vaadin.flow.component.ComponentEvent; +/** + * @since 1.1 + */ public class ExpandEvent<T, C extends Component> extends ComponentEvent<C> { private final Collection<T> items; diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/treegrid/HierarchyColumnComponentRenderer.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/treegrid/HierarchyColumnComponentRenderer.java index ba97c907eae..b75e18f2481 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/treegrid/HierarchyColumnComponentRenderer.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/treegrid/HierarchyColumnComponentRenderer.java @@ -28,6 +28,7 @@ * the type of the output component * @param <SOURCE> * the type of the input model object + * @since 5.1 */ public class HierarchyColumnComponentRenderer<COMPONENT extends Component, SOURCE> extends ComponentRenderer<COMPONENT, SOURCE> { diff --git a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/treegrid/TreeGrid.java b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/treegrid/TreeGrid.java index b6e1951cb90..97390eb959f 100644 --- a/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/treegrid/TreeGrid.java +++ b/vaadin-grid-flow-parent/vaadin-grid-flow/src/main/java/com/vaadin/flow/component/treegrid/TreeGrid.java @@ -70,6 +70,7 @@ * @param <T> * the grid bean type * @author Vaadin Ltd + * @since 1.1 */ @JsModule("@vaadin/grid/src/vaadin-grid-tree-toggle.js") @JsModule("./treeGridConnector.ts") @@ -96,6 +97,7 @@ public TreeGrid() { * @param dataCommunicatorBuilder * Builder for {@link DataCommunicator} implementation this Grid * uses to handle all data communication. + * @since 24.5 */ protected TreeGrid(int pageSize, DataCommunicatorBuilder<T, GridArrayUpdater> dataCommunicatorBuilder) { @@ -169,6 +171,7 @@ public TreeGrid(Class<T> beanType) { * @param autoCreateColumns * when <code>true</code>, columns are created automatically for * the properties of the beanType + * @since 24.5 */ public TreeGrid(Class<T> beanType, boolean autoCreateColumns) { this(beanType, new TreeDataCommunicatorBuilder<>(), autoCreateColumns); @@ -186,6 +189,7 @@ public TreeGrid(Class<T> beanType, boolean autoCreateColumns) { * @param dataCommunicatorBuilder * Builder for {@link DataCommunicator} implementation this Grid * uses to handle all data communication. + * @since 24.5 */ protected TreeGrid(Class<T> beanType, DataCommunicatorBuilder<T, GridArrayUpdater> dataCommunicatorBuilder) { @@ -327,6 +331,7 @@ public void setDataProvider( * {@link #setItems(Collection, ValueProvider)}, * {@link #setItems(Stream, ValueProvider)} or * {@link #setTreeData(TreeData)} instead. + * @since 18.0 */ @Deprecated @Override @@ -352,6 +357,7 @@ public GridLazyDataView<T> setItems( * {@link #setItems(Collection, ValueProvider)}, * {@link #setItems(Stream, ValueProvider)} or * {@link #setTreeData(TreeData)} instead. + * @since 18.0 */ @Deprecated @Override @@ -378,6 +384,7 @@ public GridLazyDataView<T> setItems( * {@link #setItems(Collection, ValueProvider)}, * {@link #setItems(Stream, ValueProvider)} or * {@link #setTreeData(TreeData)} instead. + * @since 18.0 */ @Deprecated @Override @@ -402,6 +409,7 @@ public GridListDataView<T> setItems(ListDataProvider<T> dataProvider) { * {@link #setItems(Collection, ValueProvider)}, * {@link #setItems(Stream, ValueProvider)} or * {@link #setTreeData(TreeData)} instead. + * @since 18.0 */ @Deprecated @Override @@ -426,6 +434,7 @@ public GridListDataView<T> setItems(T... items) { * {@link #setItems(Collection, ValueProvider)}, * {@link #setItems(Stream, ValueProvider)} or * {@link #setTreeData(TreeData)} instead. + * @since 18.0 */ @Deprecated @Override @@ -445,6 +454,7 @@ public GridListDataView<T> setItems(Collection<T> items) { * * @return exception is thrown * @deprecated not supported + * @since 18.0 */ @Deprecated @Override @@ -462,6 +472,7 @@ public GridListDataView<T> getListDataView() { * * @return exception is thrown * @deprecated not supported + * @since 18.0 */ @Deprecated @Override @@ -479,6 +490,7 @@ public GridLazyDataView<T> getLazyDataView() { * * @return exception is thrown * @deprecated not supported + * @since 18.0 */ @Deprecated @Override @@ -539,6 +551,7 @@ public Column<T> addHierarchyColumn(ValueProvider<T, ?> valueProvider) { * @return the new column * @see #addColumn(Renderer) * @see #removeColumn(Column) + * @since 5.1 */ public <V extends Component> Column<T> addComponentHierarchyColumn( ValueProvider<T, V> componentProvider) { @@ -771,7 +784,6 @@ protected void expand(Collection<T> items, boolean userOriginated) { * the items to expand recursively * @param depth * the maximum depth of recursion - * @since 8.4 */ public void expandRecursively(Stream<T> items, int depth) { expandRecursively(items.toList(), depth); @@ -790,7 +802,6 @@ public void expandRecursively(Stream<T> items, int depth) { * the items to expand recursively * @param depth * the maximum depth of recursion - * @since 8.4 */ public void expandRecursively(Collection<T> items, int depth) { var expandedItems = getDataCommunicator() @@ -850,7 +861,6 @@ protected void collapse(Collection<T> items, boolean userOriginated) { * the items to collapse recursively * @param depth * the maximum depth of recursion - * @since 8.4 */ public void collapseRecursively(Stream<T> items, int depth) { collapseRecursively(items.toList(), depth); @@ -869,7 +879,6 @@ public void collapseRecursively(Stream<T> items, int depth) { * the items to collapse recursively * @param depth * the maximum depth of recursion - * @since 8.4 */ public void collapseRecursively(Collection<T> items, int depth) { var collapsedItems = getDataCommunicator() @@ -957,6 +966,7 @@ public HierarchicalDataProvider<T, SerializablePredicate<T>> getDataProvider() { * * @param index * zero based index of the item to scroll to + * @since 20.0.5 */ @Override public void scrollToIndex(int index) { @@ -988,6 +998,7 @@ public void scrollToIndex(int index) { * @throws UnsupportedOperationException * if the data provider uses a hierarchy format other than * {@link HierarchyFormat#NESTED} + * @since 24.1 */ public void scrollToIndex(int... path) { if (!getDataProvider().getHierarchyFormat() @@ -1126,6 +1137,7 @@ int setViewportRangeByIndexPath(int[] path, int padding) { * the item to scroll to * @throws NoSuchElementException * if the item does not belong to the tree + * @since 24.4 */ @Override public void scrollToItem(T item) { diff --git a/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/EditColumnConfigurator.java b/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/EditColumnConfigurator.java index 74ba9353e0c..0012460cb8f 100644 --- a/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/EditColumnConfigurator.java +++ b/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/EditColumnConfigurator.java @@ -32,6 +32,7 @@ * @author Vaadin Ltd. * @param <T> * the grid bean type + * @since 1.0 */ public class EditColumnConfigurator<T> implements Serializable { @@ -118,6 +119,7 @@ public Column<T> text(ItemUpdater<T, String> itemUpdater) { * changed. It receives the edited item, and the new value from * the editor. * @return the configured column + * @since 23.1.1 */ public <V> Column<T> custom(HasValueAndElement<?, V> component, ItemUpdater<T, V> itemUpdater) { @@ -145,6 +147,7 @@ public <V> Column<T> custom(HasValueAndElement<?, V> component, * changed. It receives the edited item, and the new value from * the editor. * @return the configured column + * @since 24.0 */ public <V> Column<T> custom(HasValueAndElement<?, V> component, ValueProvider<T, V> valueProvider, ItemUpdater<T, V> itemUpdater) { @@ -312,6 +315,7 @@ public <E extends Enum<E>> Column<T> select(ItemUpdater<T, E> itemUpdater, * performed in the provided item updater manually. * * @return the configurator + * @since 24.3 */ public EditColumnConfigurator<T> withManualRefresh() { column.setManualRefresh(true); @@ -327,6 +331,7 @@ public EditColumnConfigurator<T> withManualRefresh() { * * @param cellEditableProvider * the cell editable provider + * @since 24.4 */ public EditColumnConfigurator<T> withCellEditableProvider( SerializablePredicate<T> cellEditableProvider) { diff --git a/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/EditorType.java b/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/EditorType.java index 9dad11797da..c82ae8ac2c6 100644 --- a/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/EditorType.java +++ b/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/EditorType.java @@ -11,6 +11,8 @@ /** * Set of editor types applicable for editor of the * {@code vaadin-grid-edit-column} component. + * + * @since 1.0 */ public enum EditorType { TEXT("text"), CHECKBOX("checkbox"), SELECT("select"), CUSTOM("custom"); diff --git a/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/GridPro.java b/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/GridPro.java index 9532a3c33c2..4f25269245b 100644 --- a/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/GridPro.java +++ b/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/GridPro.java @@ -45,6 +45,9 @@ import tools.jackson.databind.node.ArrayNode; import tools.jackson.databind.node.ObjectNode; +/** + * @since 1.0 + */ @Tag("vaadin-grid-pro") @NpmPackage(value = "@vaadin/grid-pro", version = "25.2.0") @JsModule("@vaadin/grid-pro/src/vaadin-grid-pro.js") @@ -368,6 +371,7 @@ public EditColumnConfigurator<E> addEditColumn( * @see EditColumnConfigurator#checkbox(ItemUpdater) * @see EditColumnConfigurator#select(ItemUpdater, List) * @see #removeColumn(Column) + * @since 2.0 */ public EditColumnConfigurator<E> addEditColumn( ValueProvider<E, ?> valueProvider, Renderer<E> renderer) { @@ -403,6 +407,7 @@ public EditColumnConfigurator<E> addEditColumn( * @see EditColumnConfigurator#checkbox(ItemUpdater) * @see EditColumnConfigurator#select(ItemUpdater, List) * @see #removeColumn(Column) + * @since 2.0 */ public <V extends Comparable<? super V>> EditColumnConfigurator<E> addEditColumn( ValueProvider<E, V> valueProvider, String... sortingProperties) { @@ -472,6 +477,7 @@ public boolean getEnterNextRow() { * when <code>true</code>, after moving to next or previous * editable cell using Tab / Shift+Tab, it will be focused * without edit mode + * @since 2.0 */ public void setSingleCellEdit(boolean singleCellEdit) { getElement().setProperty("singleCellEdit", singleCellEdit); @@ -483,6 +489,7 @@ public void setSingleCellEdit(boolean singleCellEdit) { * cell using Tab / Shift+Tab, it will be focused without edit mode. * * @return singleCellEdit value + * @since 2.0 */ public boolean getSingleCellEdit() { return getElement().getProperty("singleCellEdit", false); @@ -496,6 +503,7 @@ public boolean getSingleCellEdit() { * @param editOnClick * when <code>true</code>, cell edit mode gets activated on a * single click instead of the default double click + * @since 19.0 */ public void setEditOnClick(boolean editOnClick) { getElement().setProperty("editOnClick", editOnClick); @@ -507,6 +515,7 @@ public void setEditOnClick(boolean editOnClick) { * instead of the default double click. * * @return editOnClick value + * @since 19.0 */ @Synchronize("edit-on-click-changed") public boolean getEditOnClick() { @@ -559,6 +568,7 @@ private void generateCellEditableData(E item, ObjectNode jsonObject) { * * @param <E> * the bean type + * @since 2.0 */ @DomEvent("cell-edit-started") public static class CellEditStartedEvent<E> @@ -580,6 +590,7 @@ public static class CellEditStartedEvent<E> * represented in Grid * @param path * item subproperty that was changed + * @since 25.0 */ public CellEditStartedEvent(GridPro<E> source, boolean fromClient, @EventData("event.detail.item") ObjectNode item, @@ -616,6 +627,7 @@ private String getPath() { * @param listener * a listener to be notified * @return a handle that can be used to unregister the listener + * @since 2.0 */ public Registration addCellEditStartedListener( ComponentEventListener<CellEditStartedEvent<E>> listener) { @@ -650,6 +662,7 @@ public static class ItemPropertyChangedEvent<E> * represented in Grid * @param path * item subproperty that was changed + * @since 25.0 */ public ItemPropertyChangedEvent(GridPro<E> source, boolean fromClient, @EventData("event.detail.item") ObjectNode item, @@ -802,6 +815,7 @@ public Optional<DataGenerator<SOURCE>> getDataGenerator() { * * @param variants * theme variants to add + * @since 23.1 */ public void addThemeVariants(GridProVariant... variants) { getThemeNames() @@ -814,6 +828,7 @@ public void addThemeVariants(GridProVariant... variants) { * * @param variants * theme variants to remove + * @since 23.1 */ public void removeThemeVariants(GridProVariant... variants) { getThemeNames().removeAll( diff --git a/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/GridProVariant.java b/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/GridProVariant.java index 0cb5321da05..1f364be9805 100644 --- a/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/GridProVariant.java +++ b/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/GridProVariant.java @@ -10,6 +10,8 @@ /** * Set of theme variants applicable for {@code vaadin-grid-pro} component. + * + * @since 23.1 */ public enum GridProVariant { LUMO_NO_BORDER("no-border"), diff --git a/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/ItemUpdater.java b/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/ItemUpdater.java index b239c516654..eb39ab0c0ca 100644 --- a/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/ItemUpdater.java +++ b/vaadin-grid-pro-flow-parent/vaadin-grid-pro-flow/src/main/java/com/vaadin/flow/component/gridpro/ItemUpdater.java @@ -19,6 +19,7 @@ * @param <V> * the value type * + * @since 1.0 */ public interface ItemUpdater<T, V> extends SerializableBiConsumer<T, V> { diff --git a/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/AbstractIcon.java b/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/AbstractIcon.java index fbde13f84f3..fb3534093e7 100644 --- a/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/AbstractIcon.java +++ b/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/AbstractIcon.java @@ -27,6 +27,7 @@ * Abstract base class for icon components * * @author Vaadin Ltd + * @since 24.2 */ @Tag("vaadin-icon") @NpmPackage(value = "@vaadin/icon", version = "25.2.0") diff --git a/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/FontIcon.java b/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/FontIcon.java index aa0d8703c68..3bf8a5c7d34 100644 --- a/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/FontIcon.java +++ b/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/FontIcon.java @@ -28,6 +28,7 @@ * the application's theme. * * @author Vaadin Ltd + * @since 24.2 */ public class FontIcon extends AbstractIcon<FontIcon> { diff --git a/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/Icon.java b/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/Icon.java index 8cb94df48b6..f276dd99f47 100644 --- a/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/Icon.java +++ b/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/Icon.java @@ -28,6 +28,7 @@ * * @author Vaadin Ltd * @see VaadinIcon + * @since 1.0 */ @NpmPackage(value = "@vaadin/icons", version = "25.2.0") @JsModule("@vaadin/icons/vaadin-iconset.js") @@ -76,6 +77,7 @@ public Icon(Signal<VaadinIcon> iconSignal) { * * @param icon * the icon name + * @since 2.1 */ public Icon(String icon) { setIcon(icon); @@ -114,6 +116,7 @@ public Icon(String collection, String icon) { * * @param icon * the icon name + * @since 24.4 */ public void setIcon(String icon) { if (icon.contains(":")) { @@ -133,6 +136,7 @@ public void setIcon(String icon) { * * @param icon * the icon name + * @since 24.4 */ public void setIcon(VaadinIcon icon) { setIcon(VAADIN_ICON_COLLECTION_NAME, normalizeIcon(icon)); @@ -170,6 +174,7 @@ public SignalBinding<String> bindIcon(Signal<VaadinIcon> signal) { * Gets the full icon name, including the collection. * * @return the icon name or {@code null} if no icon is set + * @since 24.4 */ public String getIcon() { return getElement().getAttribute(ICON_ATTRIBUTE_NAME); @@ -194,6 +199,7 @@ public String getIcon() { * the icon collection * @param icon * the icon name + * @since 24.4 */ public void setIcon(String collection, String icon) { getElement().setAttribute(ICON_ATTRIBUTE_NAME, collection + ':' + icon); @@ -204,6 +210,7 @@ public void setIcon(String collection, String icon) { * * @return the collection of the icon or {@code null} if no collection is * set + * @since 24.4 */ public String getCollection() { String icon = getIcon(); diff --git a/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/IconFactory.java b/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/IconFactory.java index ddd72f58210..42353761314 100644 --- a/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/IconFactory.java +++ b/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/IconFactory.java @@ -19,6 +19,8 @@ /** * Factory for icons. + * + * @since 2.0 */ @FunctionalInterface public interface IconFactory extends Serializable { diff --git a/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/SvgIcon.java b/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/SvgIcon.java index 8864cf07d0d..57077e2511e 100644 --- a/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/SvgIcon.java +++ b/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/SvgIcon.java @@ -28,6 +28,7 @@ * Component for displaying an icon from a SVG file. * * @author Vaadin Ltd + * @since 24.2 */ public class SvgIcon extends AbstractIcon<SvgIcon> { private static final String STYLE_FILL = "fill"; @@ -105,6 +106,7 @@ public SvgIcon(AbstractStreamResource src, String symbol) { * @param src * the download handler resource * @see #setSrc(AbstractStreamResource) + * @since 24.8 */ public SvgIcon(DownloadHandler src) { setSrc(src); @@ -124,6 +126,7 @@ public SvgIcon(DownloadHandler src) { * the symbol reference of the icon * @see #setSrc(AbstractStreamResource) * @see #setSymbol(String) + * @since 24.8 */ public SvgIcon(DownloadHandler src, String symbol) { this(src); @@ -259,6 +262,7 @@ public void setSrc(AbstractStreamResource src, String symbol) { * * @param src * the source value, not null + * @since 24.8 */ public void setSrc(DownloadHandler src) { if (src instanceof AbstractDownloadHandler<?> handler) { @@ -285,6 +289,7 @@ public void setSrc(DownloadHandler src) { * the symbol reference of the icon * @see #setSrc(AbstractStreamResource) * @see #setSymbol(String) + * @since 24.8 */ public void setSrc(DownloadHandler src, String symbol) { setSrc(src); diff --git a/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/VaadinIcon.java b/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/VaadinIcon.java index 5b634822f60..c9646cd4a85 100644 --- a/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/VaadinIcon.java +++ b/vaadin-icons-flow-parent/vaadin-icons-flow/src/main/java/com/vaadin/flow/component/icon/VaadinIcon.java @@ -24,6 +24,7 @@ * * @author Vaadin Ltd * + * @since 1.0 */ public enum VaadinIcon implements IconFactory { diff --git a/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/ListBox.java b/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/ListBox.java index 86dfcdbda41..84d50fe7891 100644 --- a/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/ListBox.java +++ b/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/ListBox.java @@ -47,6 +47,7 @@ * @param <T> * the type of the items contained by this component * @see MultiSelectListBox + * @since 1.0 */ public class ListBox<T> extends ListBoxBase<ListBox<T>, T, T> implements SingleSelect<ListBox<T>, T> { @@ -97,6 +98,7 @@ private static <T> Integer modelToPresentation(ListBox<T> listBox, * the second instance * @return <code>true</code> if the instances are equal; otherwise * <code>false</code> + * @since 18.0 */ @Override protected boolean valueEquals(T value1, T value2) { diff --git a/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/ListBoxBase.java b/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/ListBoxBase.java index 76c8b5b7df9..19a89c0b1b4 100644 --- a/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/ListBoxBase.java +++ b/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/ListBoxBase.java @@ -68,6 +68,7 @@ * Base class for the {@link ListBox} and {@link MultiSelectListBox}. * * @author Vaadin Ltd + * @since 2.1 */ @Tag("vaadin-list-box") @NpmPackage(value = "@vaadin/list-box", version = "25.2.0") @@ -108,6 +109,7 @@ <P> ListBoxBase(String propertyName, Class<P> elementPropertyType, * * @param dataProvider * DataProvider instance to use, not <code>null</code> + * @since 24.2 */ public void setDataProvider(DataProvider<ITEM, ?> dataProvider) { this.dataProvider.set(Objects.requireNonNull(dataProvider)); @@ -159,6 +161,7 @@ protected void onDetach(DetachEvent detachEvent) { * {@link #getListDataView()} or {@link #getGenericDataView()} instead. * * @return the data provider used by this ListBox + * @since 24.2 */ public DataProvider<ITEM, ?> getDataProvider() { return dataProvider.get(); @@ -194,6 +197,7 @@ public void setRenderer( * * @param itemLabelGenerator * the item label provider to use, not null + * @since 23.0 */ public void setItemLabelGenerator( ItemLabelGenerator<ITEM> itemLabelGenerator) { @@ -208,6 +212,7 @@ public void setItemLabelGenerator( * in the ListBox for each item. * * @return the item label generator used, not null + * @since 23.0 */ public ItemLabelGenerator<ITEM> getItemLabelGenerator() { return itemLabelGenerator; @@ -272,6 +277,7 @@ public void setRequiredIndicatorVisible(boolean requiredIndicatorVisible) { * onChange} callbacks * @deprecated This method is not supported and will throw an exception when * called. + * @since 25.1 */ @Deprecated @Override @@ -367,6 +373,7 @@ List<VaadinItem<ITEM>> getItemComponents() { * @param dataProvider * DataProvider instance to use, not <code>null</code> * @return ListBoxDataView providing information on the data + * @since 18.0 */ @Override public ListBoxDataView<ITEM> setItems( @@ -386,6 +393,7 @@ public ListBoxDataView<ITEM> setItems( * @param inMemoryDataProvider * InMemoryDataProvider to use, not <code>null</code> * @return ListBoxDataView providing information on the data + * @since 18.0 */ @Override public ListBoxDataView<ITEM> setItems( @@ -415,6 +423,7 @@ protected SerializablePredicate<ITEM> getFilter( * @param listDataProvider * ListDataProvider providing items to the ListBox. * @return ListBoxListDataView providing access to the items + * @since 18.0 */ @Override public ListBoxListDataView<ITEM> setItems( @@ -435,6 +444,7 @@ public ListBoxListDataView<ITEM> setItems( * * @return the list data view that provides access to the data bound to the * ListBox + * @since 18.0 */ @Override public ListBoxListDataView<ITEM> getListDataView() { @@ -449,6 +459,7 @@ public ListBoxListDataView<ITEM> getListDataView() { * * @return the generic DataView instance implementing * {@link ListBoxDataView} + * @since 18.0 */ @Override public ListBoxDataView<ITEM> getGenericDataView() { diff --git a/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/MultiSelectListBox.java b/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/MultiSelectListBox.java index 84a108727fd..292dfc1405a 100644 --- a/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/MultiSelectListBox.java +++ b/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/MultiSelectListBox.java @@ -46,6 +46,7 @@ * @param <T> * the type of the items contained by this component * @see ListBox + * @since 2.1 */ public class MultiSelectListBox<T> extends ListBoxBase<MultiSelectListBox<T>, T, Set<T>> @@ -186,6 +187,7 @@ public Registration addSelectionListener( * the selection preservation mode to switch to, not {@code null} * * @see SelectionPreservationMode + * @since 24.4 */ public void setSelectionPreservationMode( SelectionPreservationMode selectionPreservationMode) { @@ -199,6 +201,7 @@ public void setSelectionPreservationMode( * @return the selection preservation mode * * @see #setSelectionPreservationMode(SelectionPreservationMode) + * @since 24.4 */ public SelectionPreservationMode getSelectionPreservationMode() { return selectionPreservationHandler.getSelectionPreservationMode(); @@ -246,6 +249,7 @@ void handleDataChange(DataChangeEvent<T> dataChangeEvent) { * the second set of instance * @return <code>true</code> if sets are equal in size and also the items; * otherwise <code>false</code> + * @since 18.0 */ @Override protected boolean valueEquals(Set<T> value1, Set<T> value2) { diff --git a/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/dataview/ListBoxDataView.java b/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/dataview/ListBoxDataView.java index c0a31423113..416ca314271 100644 --- a/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/dataview/ListBoxDataView.java +++ b/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/dataview/ListBoxDataView.java @@ -26,7 +26,7 @@ * * @param <T> * the item type - * @since + * @since 18.0 */ public class ListBoxDataView<T> extends AbstractDataView<T> { diff --git a/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/dataview/ListBoxListDataView.java b/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/dataview/ListBoxListDataView.java index 2ca2a847b4f..707138cbb59 100644 --- a/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/dataview/ListBoxListDataView.java +++ b/vaadin-list-box-flow-parent/vaadin-list-box-flow/src/main/java/com/vaadin/flow/component/listbox/dataview/ListBoxListDataView.java @@ -29,7 +29,7 @@ * * @param <T> * data type - * @since + * @since 18.0 */ public class ListBoxListDataView<T> extends AbstractListDataView<T> { diff --git a/vaadin-login-flow-parent/vaadin-login-flow/src/main/java/com/vaadin/flow/component/login/AbstractLogin.java b/vaadin-login-flow-parent/vaadin-login-flow/src/main/java/com/vaadin/flow/component/login/AbstractLogin.java index bd1ee0671bb..ed9bee26dee 100644 --- a/vaadin-login-flow-parent/vaadin-login-flow/src/main/java/com/vaadin/flow/component/login/AbstractLogin.java +++ b/vaadin-login-flow-parent/vaadin-login-flow/src/main/java/com/vaadin/flow/component/login/AbstractLogin.java @@ -60,6 +60,7 @@ * that can in turn cancel a potential redirect issued by the form submission. * * @author Vaadin Ltd + * @since 1.0 */ public abstract class AbstractLogin extends Component implements HasEnabled { @@ -145,6 +146,7 @@ public void setAction(String action) { * @param action * the action URL, or {@code null} to remove the action and * restore the default login listener handling + * @since 25.2 */ public void setUnsafeAction(String action) { doSetAction(action); @@ -275,6 +277,7 @@ LoginI18n getI18n() { * onChange} callbacks * @deprecated This method is not supported and will throw an exception when * called. + * @since 25.1 */ @Deprecated @Override @@ -292,6 +295,7 @@ public SignalBinding<Boolean> bindEnabled(Signal<Boolean> enabledSignal) { * @param message * the {@link LoginI18n.ErrorMessage#getMessage() error message}, * may be null. + * @since 24.4 */ public void showErrorMessage(String title, String message) { var loginI18n = getI18n(); diff --git a/vaadin-login-flow-parent/vaadin-login-flow/src/main/java/com/vaadin/flow/component/login/LoginForm.java b/vaadin-login-flow-parent/vaadin-login-flow/src/main/java/com/vaadin/flow/component/login/LoginForm.java index 5b656e9add4..1b87a27740b 100644 --- a/vaadin-login-flow-parent/vaadin-login-flow/src/main/java/com/vaadin/flow/component/login/LoginForm.java +++ b/vaadin-login-flow-parent/vaadin-login-flow/src/main/java/com/vaadin/flow/component/login/LoginForm.java @@ -39,6 +39,7 @@ * automatically enabled for the next login attempt. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-login-form") @NpmPackage(value = "@vaadin/login", version = "25.2.0") diff --git a/vaadin-login-flow-parent/vaadin-login-flow/src/main/java/com/vaadin/flow/component/login/LoginI18n.java b/vaadin-login-flow-parent/vaadin-login-flow/src/main/java/com/vaadin/flow/component/login/LoginI18n.java index d7005c9dced..899b5d45efe 100644 --- a/vaadin-login-flow-parent/vaadin-login-flow/src/main/java/com/vaadin/flow/component/login/LoginI18n.java +++ b/vaadin-login-flow-parent/vaadin-login-flow/src/main/java/com/vaadin/flow/component/login/LoginI18n.java @@ -30,6 +30,7 @@ * {@link LoginI18n#createDefault()} * * @see LoginForm#setI18n(LoginI18n) + * @since 1.0 */ @JsonInclude(JsonInclude.Include.NON_NULL) public class LoginI18n implements Serializable { @@ -289,6 +290,7 @@ public void setMessage(String message) { /** * @return current value for the username property + * @since 24.1 */ public String getUsername() { return username; @@ -299,6 +301,7 @@ public String getUsername() { * * @param username * new value for the username property + * @since 24.1 */ public void setUsername(String username) { this.username = username; @@ -306,6 +309,7 @@ public void setUsername(String username) { /** * @return current value for the password property + * @since 24.1 */ public String getPassword() { return password; @@ -316,6 +320,7 @@ public String getPassword() { * * @param password * new value for the password property + * @since 24.1 */ public void setPassword(String password) { this.password = password; diff --git a/vaadin-login-flow-parent/vaadin-login-flow/src/main/java/com/vaadin/flow/component/login/LoginOverlay.java b/vaadin-login-flow-parent/vaadin-login-flow/src/main/java/com/vaadin/flow/component/login/LoginOverlay.java index 2f1fc190582..1816eb0a3cf 100644 --- a/vaadin-login-flow-parent/vaadin-login-flow/src/main/java/com/vaadin/flow/component/login/LoginOverlay.java +++ b/vaadin-login-flow-parent/vaadin-login-flow/src/main/java/com/vaadin/flow/component/login/LoginOverlay.java @@ -45,6 +45,7 @@ * Login Overlay is modal in {@link ModalityMode#STRICT} mode. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-login-overlay") @NpmPackage(value = "@vaadin/login", version = "25.2.0") @@ -237,6 +238,8 @@ public LoginOverlayFooter getFooter() { /** * Class for adding and removing components to the custom form area of the * overlay. + * + * @since 24.2 */ final public static class LoginOverlayCustomFormArea extends LoginOverlayContent { @@ -248,6 +251,8 @@ private LoginOverlayCustomFormArea(LoginOverlay overlay) { /** * Class for adding and removing components to the footer area of the * overlay. + * + * @since 24.2 */ final public static class LoginOverlayFooter extends LoginOverlayContent { private LoginOverlayFooter(LoginOverlay overlay) { @@ -316,6 +321,7 @@ public void removeAll() { * @throws UnsupportedOperationException * LoginOverlay does not support adding styles to overlay * wrapper + * @since 23.1 */ @Override public Style getStyle() { diff --git a/vaadin-lumo-theme-flow-parent/vaadin-lumo-theme-flow/src/main/java/com/vaadin/flow/theme/lumo/Lumo.java b/vaadin-lumo-theme-flow-parent/vaadin-lumo-theme-flow/src/main/java/com/vaadin/flow/theme/lumo/Lumo.java index 7b7beae9a13..ada3eee96ac 100644 --- a/vaadin-lumo-theme-flow-parent/vaadin-lumo-theme-flow/src/main/java/com/vaadin/flow/theme/lumo/Lumo.java +++ b/vaadin-lumo-theme-flow-parent/vaadin-lumo-theme-flow/src/main/java/com/vaadin/flow/theme/lumo/Lumo.java @@ -29,6 +29,8 @@ /** * Lumo component theme class implementation. + * + * @since 1.0 */ @NpmPackage(value = "@vaadin/vaadin-themable-mixin", version = "25.2.0") @NpmPackage(value = "@vaadin/vaadin-lumo-styles", version = "25.2.0") @@ -42,6 +44,8 @@ public class Lumo implements AbstractTheme { * The path to the Lumo stylesheet. Can be used as argument to a * {@link StyleSheet} on an {@link AppShellConfigurator} class to apply the * Lumo theme to an application. + * + * @since 25.0 */ public static final String STYLESHEET = "lumo/lumo.css"; @@ -50,6 +54,8 @@ public class Lumo implements AbstractTheme { * used as argument to a {@link StyleSheet} on an * {@link AppShellConfigurator} class to apply the utility classes to an * application. + * + * @since 25.0 */ public static final String UTILITY_STYLESHEET = "lumo/utility.css"; @@ -63,6 +69,8 @@ public class Lumo implements AbstractTheme { * stylesheet referenced by {@link #STYLESHEET}, not instead of it. Make * sure to load the compact preset after the main Lumo stylesheet so that it * can override the relevant CSS custom properties. + * + * @since 25.0 */ public static final String COMPACT_STYLESHEET = "lumo/presets/compact.css"; diff --git a/vaadin-lumo-theme-flow-parent/vaadin-lumo-theme-flow/src/main/java/com/vaadin/flow/theme/lumo/LumoIcon.java b/vaadin-lumo-theme-flow-parent/vaadin-lumo-theme-flow/src/main/java/com/vaadin/flow/theme/lumo/LumoIcon.java index cde57b3cac1..828932944ff 100644 --- a/vaadin-lumo-theme-flow-parent/vaadin-lumo-theme-flow/src/main/java/com/vaadin/flow/theme/lumo/LumoIcon.java +++ b/vaadin-lumo-theme-flow-parent/vaadin-lumo-theme-flow/src/main/java/com/vaadin/flow/theme/lumo/LumoIcon.java @@ -34,6 +34,7 @@ * bundle. * * @author Vaadin Ltd + * @since 23.2 */ @NpmPackage(value = "@vaadin/vaadin-lumo-styles", version = "25.2.0") @JsModule("@vaadin/vaadin-lumo-styles/vaadin-iconset.js") diff --git a/vaadin-lumo-theme-flow-parent/vaadin-lumo-theme-flow/src/main/java/com/vaadin/flow/theme/lumo/LumoUtility.java b/vaadin-lumo-theme-flow-parent/vaadin-lumo-theme-flow/src/main/java/com/vaadin/flow/theme/lumo/LumoUtility.java index 322975e8f3e..89192c31ecd 100644 --- a/vaadin-lumo-theme-flow-parent/vaadin-lumo-theme-flow/src/main/java/com/vaadin/flow/theme/lumo/LumoUtility.java +++ b/vaadin-lumo-theme-flow-parent/vaadin-lumo-theme-flow/src/main/java/com/vaadin/flow/theme/lumo/LumoUtility.java @@ -17,6 +17,8 @@ /** * Contains the definition for all the CSS utility classes provided by Lumo. + * + * @since 23.1 */ public final class LumoUtility { @@ -75,6 +77,8 @@ private AlignItems() { * Set of classes for aligning items along a flexbox’s cross axis or a * grid’s block axis that will be applied only for certain viewport * sizes. Applies to flexbox and grid layouts. + * + * @since 24.4.7 */ public static final class Breakpoint { private Breakpoint() { @@ -183,6 +187,8 @@ private AlignSelf() { /** * Classes for setting the aspect ratio of an element. + * + * @since 24.4.7 */ public static final class AspectRatio { public static final String SQUARE = "aspect-square"; @@ -195,6 +201,8 @@ private AspectRatio() { /** * Classes for setting the backdrop blur of an element. + * + * @since 24.4.7 */ public static final class BackdropBlur { public static final String NONE = "backdrop-blur-none"; @@ -509,6 +517,8 @@ private XXLarge() { /** * Classes for setting borders between elements. + * + * @since 24.4.7 */ public static final class Divide { public static final String X = "divide-x"; @@ -1278,6 +1288,8 @@ private Vertical() { /** * Set of classes defining negative margins for an element. + * + * @since 24.4.7 */ public static final class Minus { @@ -1649,6 +1661,8 @@ private Position() { /** * Classes for setting the bottom position of an element. + * + * @since 24.4.7 */ public static final class Bottom { public static final String NONE = "bottom-0"; @@ -1666,6 +1680,8 @@ private Bottom() { /** * Classes for setting the end position of an element. + * + * @since 24.4.7 */ public static final class End { public static final String NONE = "end-0"; @@ -1683,6 +1699,8 @@ private End() { /** * Classes for setting the start position of an element. + * + * @since 24.4.7 */ public static final class Start { public static final String NONE = "start-0"; @@ -1700,6 +1718,8 @@ private Start() { /** * Classes for setting the top position of an element. + * + * @since 24.4.7 */ public static final class Top { public static final String NONE = "top-0"; @@ -1717,6 +1737,8 @@ private Top() { /** * Classes for setting a negative position for an element. + * + * @since 24.4.7 */ public static final class Minus { @@ -1787,6 +1809,8 @@ private Top() { /** * Set of classes defining the position of an element that will be * applied only for certain viewport sizes. + * + * @since 24.4.7 */ public static final class Breakpoint { private Breakpoint() { @@ -1946,6 +1970,8 @@ private TextTransform() { /** * Classes for transitioning various properties. + * + * @since 24.4.7 */ public static final class Transition { public static final String NONE = "transition-none"; @@ -1997,6 +2023,8 @@ private Width() { /** * Classes for setting the z-index of an element. + * + * @since 24.4.7 */ public static final class ZIndex { public static final String NONE = "z-0"; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/Assets.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/Assets.java index f3607994ac4..dd839b2eb19 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/Assets.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/Assets.java @@ -16,6 +16,8 @@ /** * Defines the default assets that the Map component provides + * + * @since 23.0 */ public class Assets { public static final ImageAsset PIN = new ImageAsset("pin.png", diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/Map.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/Map.java index 0d5c7cc6e9c..18ea1694de9 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/Map.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/Map.java @@ -79,6 +79,8 @@ * the box, the map component has support for the {@code EPSG:4326} and * {@code EPSG:3857} projections. Custom coordinate projections can be defined * using {@link #defineProjection(String, String)}. + * + * @since 23.0 */ @Tag("vaadin-map") @NpmPackage(value = "@vaadin/map", version = "25.2.0") @@ -123,6 +125,7 @@ public class Map extends MapBase { * * @param projection * the user projection to use for all public facing API + * @since 23.2 */ public static void setUserProjection(String projection) { UI.getCurrentOrThrow().getPage().executeJs( @@ -161,6 +164,7 @@ public static void setUserProjection(String projection) { * a user or view projection * @param wksDefinition * the Well Known Text (WKS) definition of the projection + * @since 23.2 */ public static void defineProjection(String projectionName, String wksDefinition) { @@ -327,6 +331,7 @@ public double getZoom() { * * @param zoom * new zoom level + * @since 24.0 */ public void setZoom(double zoom) { getView().setZoom(zoom); @@ -338,6 +343,7 @@ public void setZoom(double zoom) { * * @param features * the features to fit in the viewport + * @since 25.0 */ public void zoomToFit(List<Feature> features) { zoomToFit(features, 50, 400); @@ -352,6 +358,7 @@ public void zoomToFit(List<Feature> features) { * padding in pixels to add around the features * @param duration * animation duration in milliseconds, 0 for no animation + * @since 25.0 */ public void zoomToFit(List<Feature> features, int padding, int duration) { ArrayNode featureIds = JacksonUtils.createArrayNode(); @@ -380,6 +387,7 @@ public void zoomToFit(List<Feature> features, int padding, int duration) { * {@link Control#setVisible} method. * * @return the default controls + * @since 25.1 */ public Controls getControls() { return controls; @@ -387,6 +395,8 @@ public Controls getControls() { /** * The default controls available in the map. + * + * @since 25.1 */ public static final class Controls implements Serializable { private final AttributionControl attributionControl = new AttributionControl(); diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/MapBase.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/MapBase.java index 6e4de2f0041..2ed32efb91d 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/MapBase.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/MapBase.java @@ -43,6 +43,8 @@ * used directly, instead use {@link Map}, which also provides some * out-of-the-box conveniences such as a pre-configured background layer, and a * feature layer. + * + * @since 23.0 */ public abstract class MapBase extends Component implements HasSize, HasStyle, HasThemeVariant<MapVariant> { @@ -189,6 +191,7 @@ public Registration addViewMoveEndEventListener( * @param listener * the listener to add * @return a registration object for removing the added listener + * @since 25.0 */ public Registration addViewMoveEndListener( ComponentEventListener<MapViewMoveEndEvent> listener) { @@ -223,6 +226,7 @@ public Registration addClickEventListener( * @param listener * the listener to add * @return a registration object for removing the added listener + * @since 25.0 */ public Registration addClickListener( ComponentEventListener<MapClickEvent> listener) { @@ -287,6 +291,7 @@ public Registration addFeatureClickListener( * @param listener * the listener to trigger * @return registration for the listener + * @since 25.0 */ public Registration addClusterClickListener( ComponentEventListener<MapClusterClickEvent> listener) { @@ -302,6 +307,7 @@ public Registration addClusterClickListener( * the listener to trigger * @return registration for the listener * @see Feature + * @since 24.1 */ public Registration addFeatureDropListener( ComponentEventListener<MapFeatureDropEvent> listener) { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/MapVariant.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/MapVariant.java index f622d8f6c83..6729cfbc50e 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/MapVariant.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/MapVariant.java @@ -12,6 +12,8 @@ /** * Set of theme variants applicable for the {@code vaadin-map} component. + * + * @since 23.0 */ public enum MapVariant implements ThemeVariant { /** diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/AbstractConfigurationObject.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/AbstractConfigurationObject.java index 09fa92d17af..97cc6684506 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/AbstractConfigurationObject.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/AbstractConfigurationObject.java @@ -82,6 +82,8 @@ * just add more overhead, and where it's reasonable to just create new * instances instead.</li> * </ul> + * + * @since 23.0 */ public abstract class AbstractConfigurationObject implements Serializable { @@ -179,6 +181,8 @@ protected void addChild(AbstractConfigurationObject configurationObject) { /** * Convenience wrapper for {@link #addChild(AbstractConfigurationObject)} * that allows {@code configurationObject} to be a null reference. + * + * @since 24.1 */ protected void addNullableChild( AbstractConfigurationObject configurationObject) { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Configuration.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Configuration.java index 371d2a1c388..46b5c617bf9 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Configuration.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Configuration.java @@ -25,6 +25,8 @@ /** * Contains the configuration for the map, such as layers, sources, features. + * + * @since 23.0 */ public class Configuration extends AbstractConfigurationObject { private final List<Layer> layers = new ArrayList<>(); @@ -105,6 +107,7 @@ public void removeLayer(Layer layer) { * The list of controls added to the map. This returns an immutable list. * * @return the list of controls added to the map + * @since 25.1 */ @JsonIgnore public List<Control> getControls() { @@ -116,6 +119,7 @@ public List<Control> getControls() { * list. * * @return the list of visible controls added to the map + * @since 25.1 */ @JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id") @JsonIdentityReference(alwaysAsId = true) @@ -132,6 +136,7 @@ public List<Control> getVisibleControls() { * the control to be added * @throws IllegalArgumentException * if a control of the same type already exists + * @since 25.1 */ public void addControl(Control control) { Objects.requireNonNull(control); @@ -154,6 +159,7 @@ public void addControl(Control control) { * * @param control * the control to be removed + * @since 25.1 */ public void removeControl(Control control) { Objects.requireNonNull(control); diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Constants.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Constants.java index 2f814cdb5d9..616f72a2086 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Constants.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Constants.java @@ -12,6 +12,8 @@ * Defines constants for OpenLayers types, which are uses by the client-side * synchronization mechanism to identify which OL class to construct and * synchronize into. + * + * @since 23.0 */ public class Constants { // Layers diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Coordinate.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Coordinate.java index 7a071136d09..53f62dc9a87 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Coordinate.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Coordinate.java @@ -18,6 +18,8 @@ * {@code EPSG:4326}, also referred to as GPS coordinates. If the user * projection has been changed using {@link Map#setUserProjection(String)}, then * coordinates must be specified in that projection instead. + * + * @since 23.0 */ public class Coordinate implements Serializable { private final double x; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Extent.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Extent.java index 8f4b92b4f53..8f4bf990768 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Extent.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Extent.java @@ -18,6 +18,8 @@ * {@code EPSG:4326}, also referred to as GPS coordinates. If the user * projection has been changed using {@link Map#setUserProjection(String)}, then * coordinates must be specified in that projection instead. + * + * @since 23.0 */ public class Extent implements Serializable { private final double minX; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Feature.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Feature.java index 2f6da7ada2e..9bbe6743707 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Feature.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Feature.java @@ -23,6 +23,8 @@ /** * A geographic feature to be displayed on a map. A feature represents a point * of interest, such as an address, a building, a vehicle, or any other entity. + * + * @since 23.0 */ public abstract class Feature extends AbstractConfigurationObject { @@ -89,6 +91,7 @@ public void setStyle(Style style) { * The text that should be displayed next to the feature. * * @return the text string + * @since 24.1 */ public String getText() { return text; @@ -100,6 +103,7 @@ public String getText() { * * @param text * the new text string, or {@code null} to remove the text + * @since 24.1 */ public void setText(String text) { this.text = text; @@ -113,6 +117,7 @@ public void setText(String text) { * * @return the custom text style, or {@code null} if no custom text style * has been set + * @since 24.1 */ public TextStyle getTextStyle() { return style != null ? style.getTextStyle() : null; @@ -131,6 +136,7 @@ public TextStyle getTextStyle() { * @param textStyle * the new custom text style, or {@code null} to remove the * custom text style + * @since 24.1 */ public void setTextStyle(TextStyle textStyle) { if (style == null && textStyle == null) { @@ -147,6 +153,8 @@ public void setTextStyle(TextStyle textStyle) { /** * Whether the feature can be dragged on the map using pointing devices or * not + * + * @since 24.1 */ public boolean isDraggable() { return draggable; @@ -162,6 +170,7 @@ public boolean isDraggable() { * * @param draggable * whether the feature can be dragged or not + * @since 24.1 */ public void setDraggable(boolean draggable) { this.draggable = draggable; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Projection.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Projection.java index 7fffd0ab34d..8bccf153fc9 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Projection.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/Projection.java @@ -12,6 +12,8 @@ * Defines constants for map coordinate projections. This is not an exhaustive * list of projections that can be used with the map component, it is possible * to use other projections as well. + * + * @since 23.0 */ public enum Projection { EPSG_3857("EPSG:3857"); diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/SerializablePropertyChangeListener.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/SerializablePropertyChangeListener.java index 8c81d4c6544..9fb5ab4a605 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/SerializablePropertyChangeListener.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/SerializablePropertyChangeListener.java @@ -13,6 +13,8 @@ /** * A {@link PropertyChangeListener} that is also {@link Serializable}. + * + * @since 24.9.5 */ public interface SerializablePropertyChangeListener extends PropertyChangeListener, Serializable { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/View.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/View.java index 0a3437f3a7f..f1ec8b613bd 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/View.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/View.java @@ -17,6 +17,8 @@ /** * Represents a map's viewport, responsible for changing properties like center * and zoom level + * + * @since 23.0 */ public class View extends AbstractConfigurationObject { @@ -103,6 +105,7 @@ public double getRotation() { * * @param rotation * the rotation in radians format + * @since 24.0 */ public void setRotation(double rotation) { this.rotation = rotation; @@ -128,6 +131,7 @@ public double getZoom() { * * @param zoom * new zoom level + * @since 24.0 */ public void setZoom(double zoom) { this.zoom = zoom; @@ -172,6 +176,7 @@ public Extent getExtent() { * the updated zoom level * @param extent * the updated extent + * @since 24.0 */ public void updateInternalViewState(Coordinate center, double rotation, double zoom, Extent extent) { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/controls/AttributionControl.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/controls/AttributionControl.java index efc1f6f8f46..c1a517cf690 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/controls/AttributionControl.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/controls/AttributionControl.java @@ -12,6 +12,8 @@ /** * A control that displays attribution information on the map. + * + * @since 25.1 */ public class AttributionControl extends Control { @Override diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/controls/Control.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/controls/Control.java index 0be6f963186..4df5e824ece 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/controls/Control.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/controls/Control.java @@ -12,6 +12,8 @@ /** * Base class for map controls, such as zoom and attribution controls. + * + * @since 25.1 */ public abstract class Control extends AbstractConfigurationObject { private boolean visible = false; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/controls/ScaleControl.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/controls/ScaleControl.java index dc31fdffaf8..f77449e9f71 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/controls/ScaleControl.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/controls/ScaleControl.java @@ -18,6 +18,7 @@ * segments. * * @see DisplayMode + * @since 25.1 */ public class ScaleControl extends Control { private int minWidth = 64; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/controls/ZoomControl.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/controls/ZoomControl.java index 0425c10e405..a8b58cd60dc 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/controls/ZoomControl.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/controls/ZoomControl.java @@ -12,6 +12,8 @@ /** * A control that provides zooming functionality on the map. + * + * @since 25.1 */ public class ZoomControl extends Control { @Override diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/feature/LineStringFeature.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/feature/LineStringFeature.java index 0cbf8a071c6..1c2269e7c06 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/feature/LineStringFeature.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/feature/LineStringFeature.java @@ -28,6 +28,8 @@ * <p> * Technically this is a {@link Feature} that uses a {@link LineString} geometry * for representation. + * + * @since 25.1 */ public class LineStringFeature extends Feature { /** diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/feature/MarkerFeature.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/feature/MarkerFeature.java index b77d386f329..66a44aa889d 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/feature/MarkerFeature.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/feature/MarkerFeature.java @@ -28,6 +28,8 @@ * representation, and a visual {@link Style} configured to use an {@link Icon}. * <p> * The class provides a default marker icon if no custom icon is provided. + * + * @since 23.0 */ public class MarkerFeature extends PointBasedFeature { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/feature/PointBasedFeature.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/feature/PointBasedFeature.java index a71a1c1412e..589192399b8 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/feature/PointBasedFeature.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/feature/PointBasedFeature.java @@ -26,6 +26,8 @@ * <p> * Technically this is a {@link Feature} that uses a {@link Point} geometry for * representation. + * + * @since 23.0 */ public abstract class PointBasedFeature extends Feature { protected PointBasedFeature() { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/feature/PolygonFeature.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/feature/PolygonFeature.java index ef07d63feb6..c7a1b9c158f 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/feature/PolygonFeature.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/feature/PolygonFeature.java @@ -28,6 +28,8 @@ * <p> * Technically this is a {@link Feature} that uses a {@link Polygon} geometry * for representation. + * + * @since 24.8 */ public class PolygonFeature extends Feature { /** diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/geometry/LineString.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/geometry/LineString.java index e5449729124..9f77af6c6b8 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/geometry/LineString.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/geometry/LineString.java @@ -17,6 +17,8 @@ /** * Geometry that represents a line string, which is a series of connected line * segments. + * + * @since 25.1 */ public class LineString extends SimpleGeometry { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/geometry/Point.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/geometry/Point.java index 4c2469defb9..e04f3b14024 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/geometry/Point.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/geometry/Point.java @@ -16,6 +16,8 @@ /** * Geometry that is represented by a single point and coordinate. + * + * @since 23.0 */ public class Point extends SimpleGeometry { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/geometry/Polygon.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/geometry/Polygon.java index 9ac8cd92281..d8d95657e74 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/geometry/Polygon.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/geometry/Polygon.java @@ -20,6 +20,7 @@ * @apiNote <a href= * "https://openlayers.org/en/latest/apidoc/module-ol_geom_Polygon-Polygon.html">ol/geom/Polygon~Polygon * </a> + * @since 24.8 */ public class Polygon extends SimpleGeometry { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/geometry/SimpleGeometry.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/geometry/SimpleGeometry.java index 41e2ef0aec3..9e06dd7abd1 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/geometry/SimpleGeometry.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/geometry/SimpleGeometry.java @@ -12,6 +12,8 @@ /** * Abstract base class for geometries + * + * @since 23.0 */ public abstract class SimpleGeometry extends AbstractConfigurationObject { /** @@ -21,6 +23,7 @@ public abstract class SimpleGeometry extends AbstractConfigurationObject { * amount to move on x-axis * @param deltaY * amount to move on y-axis + * @since 24.1 */ public abstract void translate(double deltaX, double deltaY); } diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/FeatureLayer.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/FeatureLayer.java index 9eedfb09d68..80d68060200 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/FeatureLayer.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/FeatureLayer.java @@ -40,6 +40,8 @@ * features that extend from {@link PointBasedFeature}, such as * {@link MarkerFeature} can be added to the layer. Enabling clustering will * switch the layer's source to a {@link ClusterSource}. + * + * @since 23.0 */ public class FeatureLayer extends VectorLayer { @@ -110,6 +112,8 @@ public void removeFeature(Feature feature) { /** * Removes all features from the layer + * + * @since 24.0 */ public void removeAllFeatures() { this.getSource().removeAllFeatures(); @@ -119,6 +123,7 @@ public void removeAllFeatures() { * Returns whether clustering is enabled for this layer. * * @return true if clustering is enabled, false otherwise + * @since 25.0 */ @JsonIgnore public boolean isClusteringEnabled() { @@ -137,6 +142,7 @@ public boolean isClusteringEnabled() { * * @param clusteringEnabled * true to enable clustering, false to disable + * @since 25.0 */ public void setClusteringEnabled(boolean clusteringEnabled) { if (this.clusteringEnabled != clusteringEnabled) { @@ -152,6 +158,7 @@ public void setClusteringEnabled(boolean clusteringEnabled) { * Only applies when clustering is enabled. * * @return the distance in pixels within which features should be clustered + * @since 25.0 */ @JsonIgnore public int getClusterDistance() { @@ -166,6 +173,7 @@ public int getClusterDistance() { * @param clusterDistance * the distance in pixels within which features should be * clustered + * @since 25.0 */ public void setClusterDistance(int clusterDistance) { this.clusterDistance = clusterDistance; @@ -184,6 +192,7 @@ public void setClusterDistance(int clusterDistance) { * Only applies when clustering is enabled. * * @return the minimum distance between clusters in pixels + * @since 25.0 */ @JsonIgnore public int getClusterMinDistance() { @@ -197,6 +206,7 @@ public int getClusterMinDistance() { * * @param clusterMinDistance * the minimum distance between clusters in pixels + * @since 25.0 */ public void setClusterMinDistance(int clusterMinDistance) { this.clusterMinDistance = clusterMinDistance; @@ -212,6 +222,7 @@ public void setClusterMinDistance(int clusterMinDistance) { * features are rendered using their own style. * * @return the current cluster style + * @since 25.0 */ @JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id") @JsonIdentityReference(alwaysAsId = true) @@ -225,6 +236,7 @@ public Style getClusterStyle() { * * @param clusterStyle * the new cluster style, not null + * @since 25.0 */ public void setClusterStyle(Style clusterStyle) { Objects.requireNonNull(clusterStyle); diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/ImageLayer.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/ImageLayer.java index d4dc3d8c3a0..12a8586bc19 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/ImageLayer.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/ImageLayer.java @@ -19,6 +19,8 @@ /** * Layer for server-rendered images that are available in arbitrary extents and * resolutions. + * + * @since 23.0 */ public class ImageLayer extends Layer { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/Layer.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/Layer.java index 53e47a384d2..219b01a9710 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/Layer.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/Layer.java @@ -13,6 +13,8 @@ /** * Abstract base class for all map layers + * + * @since 23.0 */ public abstract class Layer extends AbstractConfigurationObject { private double opacity = 1; @@ -35,6 +37,7 @@ public double getOpacity() { * * @param opacity * new opacity of the layer + * @since 24.0 */ public void setOpacity(double opacity) { this.opacity = opacity; @@ -95,6 +98,7 @@ public Double getMinZoom() { * * @param minZoom * the new minimum zoom level, or null to remove it + * @since 24.0 */ public void setMinZoom(Double minZoom) { this.minZoom = minZoom; @@ -114,6 +118,7 @@ public Double getMaxZoom() { * * @param maxZoom * the new maximum zoom level, or null to remove it + * @since 24.0 */ public void setMaxZoom(Double maxZoom) { this.maxZoom = maxZoom; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/TileLayer.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/TileLayer.java index 174834a5ff0..5bfe91d3b96 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/TileLayer.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/TileLayer.java @@ -19,6 +19,8 @@ /** * Layer for displaying tiled map data + * + * @since 23.0 */ public class TileLayer extends Layer { private TileSource source; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/VectorLayer.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/VectorLayer.java index 0fce2d02644..832235f3401 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/VectorLayer.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/layer/VectorLayer.java @@ -19,6 +19,8 @@ /** * Layer for rendering vector data client-side + * + * @since 23.0 */ public class VectorLayer extends Layer { // Store source as the more general Source instead of VectorSource diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/ClusterSource.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/ClusterSource.java index 854cce48550..ff831fffdb0 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/ClusterSource.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/ClusterSource.java @@ -24,6 +24,8 @@ * a {@link FeatureLayer} which exposes the same API as this source. Clustering * can be enabled in a feature layer using * {@link FeatureLayer#setClusteringEnabled(boolean)}. + * + * @since 25.0 */ public class ClusterSource extends VectorSource { private int distance = 50; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/ImageSource.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/ImageSource.java index 62d05008a04..d38a51918f9 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/ImageSource.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/ImageSource.java @@ -10,12 +10,17 @@ /** * Abstract base class for all sources providing a single image + * + * @since 23.0 */ public abstract class ImageSource extends Source { public ImageSource(Options options) { super(options); } + /** + * @since 23.1 + */ protected static abstract class Options extends Source.Options { } } diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/ImageWMSSource.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/ImageWMSSource.java index 7cb8bc2c1a0..87b43937130 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/ImageWMSSource.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/ImageWMSSource.java @@ -15,6 +15,8 @@ /** * Source for WMS servers providing single, untiled images + * + * @since 23.0 */ public class ImageWMSSource extends ImageSource { @@ -157,6 +159,7 @@ public void setCrossOrigin(String crossOrigin) { /** * @see ImageWMSSource#getRatio() + * @since 24.0 */ public void setRatio(double ratio) { this.ratio = ratio; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/OSMSource.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/OSMSource.java index 6fc172b8153..232db7ebbda 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/OSMSource.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/OSMSource.java @@ -14,6 +14,8 @@ * Map source for loading tiled images from an OpenStreetMap service. The source * will use the official OpenStreetMap service by default. A custom URL can be * configured to load data from a different service. + * + * @since 23.0 */ public class OSMSource extends XYZSource { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/Source.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/Source.java index a43caa76f7e..331ff81f09d 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/Source.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/Source.java @@ -15,6 +15,8 @@ /** * Abstract base class for all map sources + * + * @since 23.0 */ public abstract class Source extends AbstractConfigurationObject { @@ -92,6 +94,9 @@ public String getProjection() { return projection; } + /** + * @since 23.1 + */ protected static abstract class Options { private List<String> attributions; private boolean attributionsCollapsible = true; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/TileImageSource.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/TileImageSource.java index 26f81eb7fd8..bae804fd51e 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/TileImageSource.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/TileImageSource.java @@ -10,6 +10,8 @@ /** * Abstract base class for map sources providing tiled images from a URL + * + * @since 23.0 */ public abstract class TileImageSource extends UrlTileSource { @@ -32,6 +34,9 @@ public String getCrossOrigin() { return crossOrigin; } + /** + * @since 23.1 + */ protected static abstract class Options extends UrlTileSource.Options { private String crossOrigin; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/TileSource.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/TileSource.java index a4e56f80edf..31dfe8760b6 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/TileSource.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/TileSource.java @@ -10,6 +10,8 @@ /** * Abstract base class for map sources providing tiled map data + * + * @since 23.0 */ public abstract class TileSource extends Source { @@ -34,6 +36,9 @@ public boolean isOpaque() { return opaque; } + /** + * @since 23.1 + */ protected static abstract class Options extends Source.Options { private boolean opaque = false; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/TileWMSSource.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/TileWMSSource.java index 564f2e39822..fbd87007c2a 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/TileWMSSource.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/TileWMSSource.java @@ -17,6 +17,8 @@ * Source for loading tile data from WMS (Web Map Service) servers * <p> * See https://www.ogc.org/standards/wms + * + * @since 23.0 */ public class TileWMSSource extends TileImageSource { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/UrlTileSource.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/UrlTileSource.java index c923f54d408..2db3adf63fe 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/UrlTileSource.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/UrlTileSource.java @@ -10,6 +10,8 @@ /** * Abstract base class for map sources providing tiled map data from a URL + * + * @since 23.0 */ public abstract class UrlTileSource extends TileSource { @@ -38,6 +40,9 @@ public void setUrl(String url) { markAsDirty(); } + /** + * @since 23.1 + */ protected static abstract class Options extends TileSource.Options { private String url; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/VectorSource.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/VectorSource.java index 3b60de0358f..6427abc3a53 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/VectorSource.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/VectorSource.java @@ -19,6 +19,9 @@ import com.vaadin.flow.component.map.configuration.Constants; import com.vaadin.flow.component.map.configuration.Feature; +/** + * @since 23.0 + */ public class VectorSource extends Source { private final List<Feature> features = new ArrayList<>(); diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/XYZSource.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/XYZSource.java index 1da6bb178e8..a08ca2620f8 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/XYZSource.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/source/XYZSource.java @@ -17,6 +17,8 @@ * <p> * This is commonly used by OpenStreetMap, as well as other services who have * adopted the OSM tile numbering scheme. + * + * @since 23.0 */ public class XYZSource extends TileImageSource { @@ -64,6 +66,7 @@ public void setUrl(String url) { public static class Options extends TileImageSource.Options { /** * @see XYZSource#getUrl() + * @since 23.1 */ @Override public void setUrl(String url) { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/Fill.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/Fill.java index 6aabeda92e1..69fe816f7c7 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/Fill.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/Fill.java @@ -11,6 +11,9 @@ import com.vaadin.flow.component.map.configuration.AbstractConfigurationObject; import com.vaadin.flow.component.map.configuration.Constants; +/** + * @since 23.0 + */ public class Fill extends AbstractConfigurationObject { private String color; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/Icon.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/Icon.java index cdcb5aa9d4d..ff2dd0f944d 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/Icon.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/Icon.java @@ -21,6 +21,8 @@ /** * An icon or image that can be used to visually represent a {@link Feature}, by * using it as the feature's {@link Style#setImage(ImageStyle)} + * + * @since 23.0 */ public class Icon extends ImageStyle { @@ -141,6 +143,7 @@ public StreamResource getImg() { * be set initially by passing an options object to the constructor. * * @return the stream resource containing the icon's image + * @since 24.8 */ @JsonInclude(JsonInclude.Include.NON_NULL) @JsonProperty("img") @@ -238,6 +241,7 @@ public void setImg(StreamResource img) { /** * @see Icon#getImgHandler() + * @since 24.8 */ public void setImg(DownloadHandler imgHandler) { if (imgHandler instanceof AbstractDownloadHandler<?> handler) { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/ImageStyle.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/ImageStyle.java index a2a8d37d65d..a12365b2290 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/ImageStyle.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/ImageStyle.java @@ -12,6 +12,8 @@ /** * Abstract base class for drawing image-based features + * + * @since 23.0 */ public abstract class ImageStyle extends AbstractConfigurationObject { @@ -35,6 +37,7 @@ public double getOpacity() { * * @param opacity * the new opacity + * @since 24.0 */ public void setOpacity(double opacity) { this.opacity = opacity; @@ -71,6 +74,7 @@ public double getRotation() { * * @param rotation * the new rotation + * @since 24.0 */ public void setRotation(double rotation) { this.rotation = rotation; @@ -91,6 +95,7 @@ public double getScale() { * * @param scale * the new scaling + * @since 24.0 */ public void setScale(double scale) { this.scale = scale; @@ -104,6 +109,9 @@ public ImageStyle(Options options) { scale = options.scale; } + /** + * @since 23.1 + */ protected static abstract class Options { private double opacity = 1; private boolean rotateWithView = false; @@ -112,6 +120,7 @@ protected static abstract class Options { /** * @see ImageStyle#getOpacity() + * @since 24.0 */ public void setOpacity(double opacity) { this.opacity = opacity; @@ -126,6 +135,7 @@ public void setRotateWithView(boolean rotateWithView) { /** * @see ImageStyle#getRotation() + * @since 24.0 */ public void setRotation(double rotation) { this.rotation = rotation; @@ -133,6 +143,7 @@ public void setRotation(double rotation) { /** * @see ImageStyle#getScale() + * @since 24.0 */ public void setScale(double scale) { this.scale = scale; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/Stroke.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/Stroke.java index f41960fe81e..44666ff6301 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/Stroke.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/Stroke.java @@ -11,6 +11,9 @@ import com.vaadin.flow.component.map.configuration.AbstractConfigurationObject; import com.vaadin.flow.component.map.configuration.Constants; +/** + * @since 23.0 + */ public class Stroke extends AbstractConfigurationObject { private String color; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/Style.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/Style.java index 4cbedf6de02..ba7768fdc91 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/Style.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/Style.java @@ -18,6 +18,8 @@ /** * Defines how to visually represent a {@link Feature} + * + * @since 23.0 */ public class Style extends AbstractConfigurationObject { @@ -73,6 +75,7 @@ public void setStroke(Stroke stroke) { * used instead. * * @return the text style, or {@code null} if no text style is defined + * @since 24.1 */ @JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id") @JsonIdentityReference(alwaysAsId = true) @@ -88,6 +91,7 @@ public TextStyle getTextStyle() { * * @param textStyle * the new text style, or {@code null} + * @since 24.1 */ public void setTextStyle(TextStyle textStyle) { removeChild(this.textStyle); diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/TextStyle.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/TextStyle.java index ac3ea0672d4..2ca4b4fe208 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/TextStyle.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/configuration/style/TextStyle.java @@ -18,6 +18,8 @@ /** * Text style that defines how to render texts on the map. + * + * @since 24.1 */ public class TextStyle extends AbstractConfigurationObject { private String font; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/FeatureEventDetails.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/FeatureEventDetails.java index e6f64368927..3b06c7d565d 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/FeatureEventDetails.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/FeatureEventDetails.java @@ -16,6 +16,8 @@ /** * Stores information about a {@link Feature} that is part of an event + * + * @since 23.0 */ public class FeatureEventDetails implements Serializable { private final Feature feature; diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapClickEvent.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapClickEvent.java index 32f77533c9e..3b7cdcb0a94 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapClickEvent.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapClickEvent.java @@ -23,6 +23,8 @@ /** * Representing OpenLayers' @code{click} event + * + * @since 23.0 */ @DomEvent("map-click") public class MapClickEvent extends ComponentEvent<MapBase> { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapClusterClickEvent.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapClusterClickEvent.java index 386e05a6d9a..283aabddd2e 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapClusterClickEvent.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapClusterClickEvent.java @@ -25,6 +25,8 @@ /** * Provides data for click events on a cluster of features + * + * @since 25.0 */ @DomEvent("map-cluster-click") public class MapClusterClickEvent extends ComponentEvent<MapBase> { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapFeatureClickEvent.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapFeatureClickEvent.java index 62c4d88a2c8..3c59b288c52 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapFeatureClickEvent.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapFeatureClickEvent.java @@ -18,6 +18,8 @@ /** * Provides data for click events on geographic features + * + * @since 23.0 */ @DomEvent("map-feature-click") public class MapFeatureClickEvent extends ComponentEvent<Map> { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapFeatureDropEvent.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapFeatureDropEvent.java index 135d4c125b5..8211b498735 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapFeatureDropEvent.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapFeatureDropEvent.java @@ -21,6 +21,8 @@ /** * Provides data for when a feature is dropped after a drag operation + * + * @since 24.1 */ @DomEvent("map-feature-drop") public class MapFeatureDropEvent extends ComponentEvent<Map> { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapViewMoveEndEvent.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapViewMoveEndEvent.java index b2d96d02949..f4aad4e1eec 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapViewMoveEndEvent.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MapViewMoveEndEvent.java @@ -20,6 +20,8 @@ /** * Fired when viewport movement has ended. + * + * @since 23.0 */ @DomEvent("map-view-moveend") public class MapViewMoveEndEvent extends ComponentEvent<MapBase> { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MouseEventDetails.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MouseEventDetails.java index 98fbeefc428..0e67642ce07 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MouseEventDetails.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/events/MouseEventDetails.java @@ -12,6 +12,8 @@ /** * Helper class to store and transfer mouse event details. + * + * @since 23.0 */ public class MouseEventDetails implements Serializable { diff --git a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/serialization/MapSerializer.java b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/serialization/MapSerializer.java index 756c5900abe..67d7d5f0676 100644 --- a/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/serialization/MapSerializer.java +++ b/vaadin-map-flow-parent/vaadin-map-flow/src/main/java/com/vaadin/flow/component/map/serialization/MapSerializer.java @@ -30,6 +30,8 @@ /** * Custom JSON serializer for the map component using a Jackson * {@link ObjectMapper} + * + * @since 23.0 */ public class MapSerializer { diff --git a/vaadin-markdown-flow-parent/vaadin-markdown-flow/src/main/java/com/vaadin/flow/component/markdown/Markdown.java b/vaadin-markdown-flow-parent/vaadin-markdown-flow/src/main/java/com/vaadin/flow/component/markdown/Markdown.java index a37efd75084..f1cb071ccd4 100644 --- a/vaadin-markdown-flow-parent/vaadin-markdown-flow/src/main/java/com/vaadin/flow/component/markdown/Markdown.java +++ b/vaadin-markdown-flow-parent/vaadin-markdown-flow/src/main/java/com/vaadin/flow/component/markdown/Markdown.java @@ -29,6 +29,7 @@ * source as input and renders the corresponding HTML. * * @author Vaadin Ltd + * @since 24.8 */ @Tag("vaadin-markdown") @NpmPackage(value = "@vaadin/markdown", version = "25.2.0") diff --git a/vaadin-master-detail-layout-flow-parent/vaadin-master-detail-layout-flow/src/main/java/com/vaadin/flow/component/masterdetaillayout/MasterDetailLayout.java b/vaadin-master-detail-layout-flow-parent/vaadin-master-detail-layout-flow/src/main/java/com/vaadin/flow/component/masterdetaillayout/MasterDetailLayout.java index 619054968e6..8f1461e6816 100644 --- a/vaadin-master-detail-layout-flow-parent/vaadin-master-detail-layout-flow/src/main/java/com/vaadin/flow/component/masterdetaillayout/MasterDetailLayout.java +++ b/vaadin-master-detail-layout-flow-parent/vaadin-master-detail-layout-flow/src/main/java/com/vaadin/flow/component/masterdetaillayout/MasterDetailLayout.java @@ -45,6 +45,7 @@ * on top of, the master area, depending on configuration and viewport size. * * @author Vaadin Ltd + * @since 24.8 */ @Tag("vaadin-master-detail-layout") @NpmPackage(value = "@vaadin/master-detail-layout", version = "25.2.0") @@ -68,6 +69,8 @@ public enum Orientation { /** * Supported overlay containment values for {@link MasterDetailLayout}. + * + * @since 25.2 */ public enum OverlayContainment { LAYOUT, PAGE @@ -86,6 +89,7 @@ public MasterDetailLayout() { * the size of the master area in CSS length units * @param detailSize * the size of the detail area in CSS length units + * @since 25.2 */ public MasterDetailLayout(String masterSize, String detailSize) { setMasterSize(masterSize); @@ -103,6 +107,7 @@ public MasterDetailLayout(String masterSize, String detailSize) { * the size of the detail area * @param detailUnit * the unit for the detail size + * @since 25.2 */ public MasterDetailLayout(float masterSize, Unit masterUnit, float detailSize, Unit detailUnit) { @@ -163,6 +168,7 @@ public void setDetail(Component component) { * * @return the component in the detail placeholder area, or {@code null} if * there is no component in the detail placeholder area + * @since 25.2 */ public Component getDetailPlaceholder() { return SlotUtils.getElementsInSlot(this, DETAIL_PLACEHOLDER_SLOT) @@ -178,6 +184,7 @@ public Component getDetailPlaceholder() { * @param component * the component to display in the detail placeholder area, or * {@code null} to clear the detail placeholder area + * @since 25.2 */ public void setDetailPlaceholder(Component component) { SlotUtils.clearSlot(this, DETAIL_PLACEHOLDER_SLOT); @@ -275,6 +282,7 @@ public void setMasterSize(float size, Unit unit) { * otherwise * @see #setMasterSize(String) * @see #setExpandMaster(boolean) + * @since 25.2 */ public void setMasterSize(String size, boolean expand) { setMasterSize(size); @@ -294,6 +302,7 @@ public void setMasterSize(String size, boolean expand) { * otherwise * @see #setMasterSize(float, Unit) * @see #setExpandMaster(boolean) + * @since 25.2 */ public void setMasterSize(float size, Unit unit, boolean expand) { setMasterSize(size, unit); @@ -358,6 +367,7 @@ public void setDetailSize(float size, Unit unit) { * otherwise * @see #setDetailSize(String) * @see #setExpandDetail(boolean) + * @since 25.2 */ public void setDetailSize(String size, boolean expand) { setDetailSize(size); @@ -377,6 +387,7 @@ public void setDetailSize(String size, boolean expand) { * otherwise * @see #setDetailSize(float, Unit) * @see #setExpandDetail(boolean) + * @since 25.2 */ public void setDetailSize(float size, Unit unit, boolean expand) { setDetailSize(size, unit); @@ -393,6 +404,7 @@ public void setDetailSize(float size, Unit unit, boolean expand) { * the overlay size in CSS length units * @see #setDetailSize(String) * @see #setOverlaySize(String) + * @since 25.2 */ public void setDetailSize(String size, String overlaySize) { setDetailSize(size); @@ -413,6 +425,7 @@ public void setDetailSize(String size, String overlaySize) { * the unit for the overlay size * @see #setDetailSize(float, Unit) * @see #setOverlaySize(float, Unit) + * @since 25.2 */ public void setDetailSize(float size, Unit unit, float overlaySize, Unit overlayUnit) { @@ -435,6 +448,7 @@ public void setDetailSize(float size, Unit unit, float overlaySize, * @see #setDetailSize(String) * @see #setExpandDetail(boolean) * @see #setOverlaySize(String) + * @since 25.2 */ public void setDetailSize(String size, boolean expand, String overlaySize) { setDetailSize(size); @@ -461,6 +475,7 @@ public void setDetailSize(String size, boolean expand, String overlaySize) { * @see #setDetailSize(float, Unit) * @see #setExpandDetail(boolean) * @see #setOverlaySize(float, Unit) + * @since 25.2 */ public void setDetailSize(float size, Unit unit, boolean expand, float overlaySize, Unit overlayUnit) { @@ -502,6 +517,7 @@ public void setOrientation(Orientation orientation) { * {@link OverlayContainment#LAYOUT}. * * @return the overlay containment + * @since 25.2 */ public OverlayContainment getOverlayContainment() { String overlayContainment = getElement() @@ -521,6 +537,7 @@ public OverlayContainment getOverlayContainment() { * * @param overlayContainment * the overlay containment + * @since 25.2 */ public void setOverlayContainment(OverlayContainment overlayContainment) { Objects.requireNonNull(overlayContainment, @@ -534,6 +551,7 @@ public void setOverlayContainment(OverlayContainment overlayContainment) { * * @return the overlay size in CSS length units, or {@code null} if the * overlay size is not set + * @since 25.2 */ public String getOverlaySize() { return getElement().getProperty("overlaySize"); @@ -546,6 +564,7 @@ public String getOverlaySize() { * * @param size * the overlay size in CSS length units + * @since 25.2 */ public void setOverlaySize(String size) { getElement().setProperty("overlaySize", size); @@ -560,6 +579,7 @@ public void setOverlaySize(String size) { * the overlay size * @param unit * the unit + * @since 25.2 */ public void setOverlaySize(float size, Unit unit) { Objects.requireNonNull(unit, "Unit cannot be null"); @@ -571,6 +591,7 @@ public void setOverlaySize(float size, Unit unit) { * {@code false}. * * @return {@code true} if the master area expands, {@code false} otherwise + * @since 25.2 */ public boolean isExpandMaster() { return getElement().getProperty("expandMaster", false); @@ -585,6 +606,7 @@ public boolean isExpandMaster() { * @param expandMaster * {@code true} to expand the master area, {@code false} * otherwise + * @since 25.2 */ public void setExpandMaster(boolean expandMaster) { getElement().setProperty("expandMaster", expandMaster); @@ -595,6 +617,7 @@ public void setExpandMaster(boolean expandMaster) { * {@code false}. * * @return {@code true} if the detail area expands, {@code false} otherwise + * @since 25.2 */ public boolean isExpandDetail() { return getElement().getProperty("expandDetail", false); @@ -609,6 +632,7 @@ public boolean isExpandDetail() { * @param expandDetail * {@code true} to expand the detail area, {@code false} * otherwise + * @since 25.2 */ public void setExpandDetail(boolean expandDetail) { getElement().setProperty("expandDetail", expandDetail); diff --git a/vaadin-menu-bar-flow-parent/vaadin-menu-bar-flow/src/main/java/com/vaadin/flow/component/menubar/MenuBar.java b/vaadin-menu-bar-flow-parent/vaadin-menu-bar-flow/src/main/java/com/vaadin/flow/component/menubar/MenuBar.java index a5f241dbf47..279631e425f 100644 --- a/vaadin-menu-bar-flow-parent/vaadin-menu-bar-flow/src/main/java/com/vaadin/flow/component/menubar/MenuBar.java +++ b/vaadin-menu-bar-flow-parent/vaadin-menu-bar-flow/src/main/java/com/vaadin/flow/component/menubar/MenuBar.java @@ -48,6 +48,7 @@ * items can either trigger an action, open a menu, or work as a toggle. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-menu-bar") @JsModule("./menubarConnector.js") @@ -198,6 +199,7 @@ public MenuItem addItem(Component component, * @param tooltipText * the tooltip text for the new item * @return the added {@link MenuItem} component + * @since 23.3 */ public MenuItem addItem(String text, String tooltipText) { return menuManager.addItem(text, tooltipText); @@ -221,6 +223,7 @@ public MenuItem addItem(String text, String tooltipText) { * @param tooltipText * the tooltip text for the new item * @return the added {@link MenuItem} component + * @since 23.3 */ public MenuItem addItem(Component component, String tooltipText) { return menuManager.addItem(component, tooltipText); @@ -247,6 +250,7 @@ public MenuItem addItem(Component component, String tooltipText) { * the handler for clicking the new item, can be {@code null} to * not add listener * @return the added {@link MenuItem} component + * @since 23.3 */ public MenuItem addItem(String text, String tooltipText, ComponentEventListener<ClickEvent<MenuItem>> clickListener) { @@ -274,6 +278,7 @@ public MenuItem addItem(String text, String tooltipText, * the handler for clicking the new item, can be {@code null} to * not add listener * @return the added {@link MenuItem} component + * @since 23.3 */ public MenuItem addItem(Component component, String tooltipText, ComponentEventListener<ClickEvent<MenuItem>> clickListener) { @@ -289,6 +294,7 @@ public MenuItem addItem(Component component, String tooltipText, * the tooltip text to set for the item * @deprecated Use {@link MenuItem#setTooltipText(String)} instead. This * method is scheduled for removal in Vaadin 26. + * @since 24.1.5 */ @Deprecated public void setTooltipText(MenuItem item, String tooltipText) { @@ -371,6 +377,7 @@ public boolean isOpenOnHover() { * If {@code true}, the buttons will be collapsed into the * overflow menu starting from the "start" end of the bar instead * of the "end". + * @since 24.4 */ public void setReverseCollapseOrder(boolean reverseCollapseOrder) { getElement().setProperty("reverseCollapse", reverseCollapseOrder); @@ -383,6 +390,7 @@ public void setReverseCollapseOrder(boolean reverseCollapseOrder) { * menu starting from the "start" end of the bar instead of the * "end". * + * @since 24.4 */ public boolean isReverseCollapseOrder() { return getElement().getProperty("reverseCollapse", false); @@ -394,6 +402,7 @@ public boolean isReverseCollapseOrder() { * @param tabNavigation * If {@code true}, the top-level menu items is traversable by * tab instead of arrow keys (i.e. disabling roving tabindex) + * @since 24.5 */ public void setTabNavigation(boolean tabNavigation) { getElement().setProperty("tabNavigation", tabNavigation); @@ -405,6 +414,7 @@ public void setTabNavigation(boolean tabNavigation) { * @return {@code true} if the top-level menu items is traversable by tab * instead of arrow keys (i.e. disabling roving tabindex) * + * @since 24.5 */ public boolean isTabNavigation() { return getElement().getProperty("tabNavigation", false); @@ -417,6 +427,7 @@ public boolean isTabNavigation() { * update the component if not set again using {@link #setI18n(MenuBarI18n)} * * @return the i18n object or {@code null} if no i18n object has been set + * @since 22.0 */ public MenuBarI18n getI18n() { return i18n; @@ -427,6 +438,7 @@ public MenuBarI18n getI18n() { * * @param i18n * the i18n object, not {@code null} + * @since 22.0 */ public void setI18n(MenuBarI18n i18n) { this.i18n = Objects.requireNonNull(i18n, @@ -467,6 +479,8 @@ private void runBeforeClientResponse(SerializableConsumer<UI> command) { /** * The internationalization properties for {@link MenuBar} + * + * @since 22.0 */ @JsonInclude(JsonInclude.Include.NON_NULL) public static class MenuBarI18n implements Serializable { @@ -498,6 +512,8 @@ public MenuBarI18n setMoreOptions(String moreOptions) { /** * Closes the current submenu. + * + * @since 24.4 */ public void close() { getElement().callJsFunction("close"); diff --git a/vaadin-menu-bar-flow-parent/vaadin-menu-bar-flow/src/main/java/com/vaadin/flow/component/menubar/MenuBarVariant.java b/vaadin-menu-bar-flow-parent/vaadin-menu-bar-flow/src/main/java/com/vaadin/flow/component/menubar/MenuBarVariant.java index 28a4017e8d4..8b87634abc1 100644 --- a/vaadin-menu-bar-flow-parent/vaadin-menu-bar-flow/src/main/java/com/vaadin/flow/component/menubar/MenuBarVariant.java +++ b/vaadin-menu-bar-flow-parent/vaadin-menu-bar-flow/src/main/java/com/vaadin/flow/component/menubar/MenuBarVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-menu-bar} component. + * + * @since 1.0 */ public enum MenuBarVariant implements ThemeVariant { LUMO_SMALL("small"), diff --git a/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageInput.java b/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageInput.java index 2004b269157..68c90d4f8e8 100644 --- a/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageInput.java +++ b/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageInput.java @@ -45,6 +45,7 @@ * Use the {@link MessageList} component to show messages that users have sent. * * @author Vaadin Ltd. + * @since 14.7 */ @Tag("vaadin-message-input") @JsModule("@vaadin/message-input/src/vaadin-message-input.js") diff --git a/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageInputI18n.java b/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageInputI18n.java index b2a4991bdb8..a5f23db0fae 100644 --- a/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageInputI18n.java +++ b/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageInputI18n.java @@ -27,6 +27,7 @@ * @see MessageInput#setI18n(MessageInputI18n) * * @author Vaadin Ltd. + * @since 14.7 */ @JsonInclude(JsonInclude.Include.NON_NULL) public class MessageInputI18n implements Serializable { diff --git a/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageInputVariant.java b/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageInputVariant.java index 4a792894ab6..e871a063461 100644 --- a/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageInputVariant.java +++ b/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageInputVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-message-input} component. + * + * @since 25.0 */ public enum MessageInputVariant implements ThemeVariant { AURA_ICON_BUTTON("icon-button"); diff --git a/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageList.java b/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageList.java index 0f426506dff..e31d0edbb0d 100644 --- a/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageList.java +++ b/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageList.java @@ -50,6 +50,7 @@ * can be configured with {@link #setItems(Collection)}. * * @author Vaadin Ltd. + * @since 14.7 */ @Tag("vaadin-message-list") @JsModule("./messageListConnector.js") @@ -111,7 +112,7 @@ public MessageList(MessageListItem... items) { * @param itemsSignal * the signal to bind the items to, not {@code null} * @see #bindItems(Signal) - * @since 25.1 + * @since 25.2 */ public <S extends Signal<MessageListItem>> MessageList( Signal<List<S>> itemsSignal) { @@ -157,6 +158,7 @@ public void setItems(MessageListItem... items) { * * @param item * the item to add, not {@code null} + * @since 24.8 */ public void addItem(MessageListItem item) { SignalBindingUtil.throwIfBindingActive(this, ITEMS_BINDING); @@ -195,7 +197,7 @@ public List<MessageListItem> getItems() { * the type of signal holding individual items * @param itemsSignal * the signal to bind the items to, not {@code null} - * @since 25.1 + * @since 25.2 */ public <S extends Signal<MessageListItem>> SignalBinding<List<S>> bindItems( Signal<List<S>> itemsSignal) { @@ -345,6 +347,7 @@ public void localeChange(LocaleChangeEvent event) { * * @param markdown * {@code true} if the message text is parsed as Markdown. + * @since 24.8 */ public void setMarkdown(boolean markdown) { getElement().setProperty("markdown", markdown); @@ -354,6 +357,7 @@ public void setMarkdown(boolean markdown) { * Returns whether the messages are parsed as markdown. * * @return {@code true} if the message text is parsed as Markdown. + * @since 24.8 */ public boolean isMarkdown() { return getElement().getProperty("markdown", false); @@ -367,6 +371,7 @@ public boolean isMarkdown() { * @param announceMessages * {@code true} if new messages should be announced to assistive * technologies. + * @since 24.8 */ public void setAnnounceMessages(boolean announceMessages) { getElement().setProperty("announceMessages", announceMessages); @@ -377,6 +382,7 @@ public void setAnnounceMessages(boolean announceMessages) { * * @return {@code true} if new messages are announced to assistive * technologies. + * @since 24.8 */ public boolean isAnnounceMessages() { return getElement().getProperty("announceMessages", false); @@ -388,6 +394,7 @@ public boolean isAnnounceMessages() { * @param listener * the listener to add * @return a registration that can be used to remove the listener + * @since 25.1 */ public Registration addAttachmentClickListener( ComponentEventListener<AttachmentClickEvent> listener) { @@ -400,6 +407,8 @@ public Registration addAttachmentClickListener( * Note: This event listens to the {@code attachment-click-flow} event * dispatched by the connector, which enriches the web component's * {@code attachment-click} event with item and attachment indexes. + * + * @since 25.1 */ @DomEvent("attachment-click-flow") public static class AttachmentClickEvent diff --git a/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageListItem.java b/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageListItem.java index 8aad3234f71..53287a982bc 100644 --- a/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageListItem.java +++ b/vaadin-messages-flow-parent/vaadin-messages-flow/src/main/java/com/vaadin/flow/component/messages/MessageListItem.java @@ -52,6 +52,7 @@ * * @author Vaadin Ltd. * @see MessageList#setItems(Collection) + * @since 14.7 */ public class MessageListItem implements Serializable { @@ -108,6 +109,7 @@ public MessageListItem(String text) { * the user name of the message sender * @see #setText(String) * @see #setUserName(String) + * @since 24.8 */ public MessageListItem(String text, String userName) { this(text); @@ -193,6 +195,7 @@ public void setText(String text) { * * @param text * the text to append to the message's text content + * @since 24.8 */ public void appendText(String text) { if (text == null) { @@ -346,6 +349,7 @@ public void setUserColorIndex(Integer userColorIndex) { * * @param themeNames * the theme name or theme names to be added to the message + * @since 21.0 */ public void addThemeNames(String... themeNames) { this.themeNames.addAll(Arrays.asList(themeNames)); @@ -358,6 +362,7 @@ public void addThemeNames(String... themeNames) { * * @param themeNames * the theme name or theme names to be removed from the message + * @since 21.0 */ public void removeThemeNames(String... themeNames) { this.themeNames.removeAll(Arrays.asList(themeNames)); @@ -371,6 +376,7 @@ public void removeThemeNames(String... themeNames) { * the theme name to check for * @return <code>true</code> if the message has the given theme name, * <code>false</code> otherwise + * @since 21.0 */ public boolean hasThemeName(String themeName) { return themeNames.contains(themeName); @@ -392,6 +398,7 @@ private String getTheme() { * * @param classNames * the class name or class names to be added to the item + * @since 24.3 */ public void addClassNames(String... classNames) { this.classNames.addAll(Arrays.asList(classNames)); @@ -404,6 +411,7 @@ public void addClassNames(String... classNames) { * * @param classNames * the class name or class names to be removed from the item + * @since 24.3 */ public void removeClassNames(String... classNames) { this.classNames.removeAll(Arrays.asList(classNames)); @@ -417,6 +425,7 @@ public void removeClassNames(String... classNames) { * the class name to check for * @return <code>true</code> if the message has the given class name, * <code>false</code> otherwise + * @since 24.3 */ public boolean hasClassName(String className) { return classNames.contains(className); @@ -459,6 +468,7 @@ public AbstractStreamResource getUserImageResource() { * download handler for the image resource, or {@code null} to * remove the resource * @see MessageListItem#setUserImage(String) + * @since 24.8 */ public void setUserImageHandler(DownloadHandler downloadHandler) { if (downloadHandler == null) { @@ -619,6 +629,7 @@ MessageList getHost() { * Gets the attachments of this message. * * @return an unmodifiable list of attachments, never {@code null} + * @since 25.1 */ public List<Attachment> getAttachments() { return Collections.unmodifiableList(attachments); @@ -630,6 +641,7 @@ public List<Attachment> getAttachments() { * * @param attachments * the attachments to set, or an empty list to clear attachments + * @since 25.1 */ public void setAttachments(List<Attachment> attachments) { Objects.requireNonNull(attachments, @@ -643,6 +655,7 @@ public void setAttachments(List<Attachment> attachments) { * * @param attachment * the attachment to add, not {@code null} + * @since 25.1 */ public void addAttachment(Attachment attachment) { Objects.requireNonNull(attachment, "Attachment cannot be null"); @@ -665,6 +678,7 @@ public void addAttachment(Attachment attachment) { * @param mimeType * the MIME type of the attachment (e.g., "application/pdf", * "image/png"). Serialized as "type" in JSON. + * @since 25.1 */ public record Attachment(String name, String url, @JsonProperty("type") String mimeType) implements Serializable { diff --git a/vaadin-notification-flow-parent/vaadin-notification-flow/src/main/java/com/vaadin/flow/component/notification/Notification.java b/vaadin-notification-flow-parent/vaadin-notification-flow/src/main/java/com/vaadin/flow/component/notification/Notification.java index 6093ede2363..6ad06bf2472 100644 --- a/vaadin-notification-flow-parent/vaadin-notification-flow/src/main/java/com/vaadin/flow/component/notification/Notification.java +++ b/vaadin-notification-flow-parent/vaadin-notification-flow/src/main/java/com/vaadin/flow/component/notification/Notification.java @@ -54,6 +54,7 @@ * information about activities, processes, and events in the application. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-notification") @NpmPackage(value = "@vaadin/notification", version = "25.2.0") @@ -221,6 +222,7 @@ public Notification(String text, int duration, Position position) { * @param assertive * whether the notification should have {@code aria-live} * attribute set to {@code assertive} or {@code polite} + * @since 24.6 */ public Notification(String text, int duration, Position position, boolean assertive) { @@ -276,6 +278,7 @@ private void initBaseElementsAndListeners() { * whether the notification should have {@code aria-live} * attribute set to {@code assertive} or {@code polite} * @return the notification + * @since 24.6 */ public static Notification show(String text, int duration, Position position, boolean assertive) { @@ -419,6 +422,7 @@ public void close() { * * @param components * the components to add + * @since 24.0 */ @Override public void add(Collection<Component> components) { @@ -443,6 +447,7 @@ public void add(Collection<Component> components) { * the index, where the component will be added. * @param component * the component to add + * @since 1.1 */ @Override public void addComponentAtIndex(int index, Component component) { @@ -487,6 +492,8 @@ public boolean isOpened() { /** * {@code opened-changed} event is sent when the notification opened state * changes. + * + * @since 23.3 */ public static class OpenedChangeEvent extends ComponentEvent<Notification> { private final boolean opened; @@ -547,6 +554,7 @@ public int getDuration() { * * @param assertive * the value to set + * @since 24.6 */ public void setAssertive(boolean assertive) { getElement().setProperty("assertive", assertive); @@ -558,6 +566,7 @@ public void setAssertive(boolean assertive) { * announce the notification content immediately when it appears. * * @return the {@code assertive} property from the webcomponent + * @since 24.6 */ public boolean isAssertive() { return getElement().getProperty("assertive", false); @@ -676,6 +685,7 @@ protected void onDetach(DetachEvent detachEvent) { * @param className * a space-separated string of class names to set, or * <code>null</code> to remove all class names + * @since 24.0 */ @Override public void setClassName(String className) { @@ -693,6 +703,7 @@ public ClassList getClassNames() { /** * @throws UnsupportedOperationException * Notification does not support adding styles to card element + * @since 23.1 */ @Override public Style getStyle() { @@ -720,6 +731,7 @@ public Style getStyle() { * @throws UnsupportedOperationException * always thrown, as Notification does not support binding * children directly + * @since 25.1 */ @Override public <T, S extends Signal<T>> void bindChildren(Signal<List<S>> list, diff --git a/vaadin-notification-flow-parent/vaadin-notification-flow/src/main/java/com/vaadin/flow/component/notification/NotificationVariant.java b/vaadin-notification-flow-parent/vaadin-notification-flow/src/main/java/com/vaadin/flow/component/notification/NotificationVariant.java index 6012fdd7316..fccac128329 100644 --- a/vaadin-notification-flow-parent/vaadin-notification-flow/src/main/java/com/vaadin/flow/component/notification/NotificationVariant.java +++ b/vaadin-notification-flow-parent/vaadin-notification-flow/src/main/java/com/vaadin/flow/component/notification/NotificationVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-notification} component. + * + * @since 2.0 */ public enum NotificationVariant implements ThemeVariant { LUMO_PRIMARY("primary"), diff --git a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/BoxSizing.java b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/BoxSizing.java index 348c8899b7f..c1febdc2f1a 100644 --- a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/BoxSizing.java +++ b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/BoxSizing.java @@ -24,6 +24,7 @@ * "https://developer.mozilla.org/en-US/docs/Web/CSS/box-sizing">MDN page * about box-sizing</a> * + * @since 1.0 */ public enum BoxSizing { diff --git a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/FlexComponent.java b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/FlexComponent.java index 81ed77c06d8..6caa0dc37d8 100644 --- a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/FlexComponent.java +++ b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/FlexComponent.java @@ -25,6 +25,8 @@ /** * A component which implements Flexbox. + * + * @since 1.0 */ public interface FlexComponent extends HasOrderedComponents, HasStyle, HasSize { @@ -294,6 +296,7 @@ default public double getFlexGrow(HasElement component) { * components * @param components * the components to apply the flex shrink property + * @since 24.0 */ default public void setFlexShrink(double flexShrink, HasElement... components) { @@ -315,6 +318,7 @@ default public void setFlexShrink(double flexShrink, * @param component * the component to read the flex shrink property from * @return the flex shrink property, or 1 if none was set + * @since 24.0 */ default public double getFlexShrink(HasElement component) { String ratio = component.getElement().getStyle() diff --git a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/FlexLayout.java b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/FlexLayout.java index 6a5566a8524..4702effc949 100644 --- a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/FlexLayout.java +++ b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/FlexLayout.java @@ -31,6 +31,7 @@ * @see <a href= * "https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Flexible_Box_Layout/Using_CSS_flexible_boxes">Using * CSS Flexible boxes on MDN</a> + * @since 1.0 */ @Tag(Tag.DIV) public class FlexLayout extends Component @@ -39,6 +40,8 @@ public class FlexLayout extends Component /** * Enum with the possible values for the component alignment inside the * layout. It correlates to the <code>align-items</code> CSS property. + * + * @since 3.1 */ public enum ContentAlignment { @@ -95,6 +98,8 @@ static ContentAlignment toAlignment(String flexValue, /** * Possible values for the {@code flex-direction} CSS property, which * determines how the elements are placed inside the layout. + * + * @since 3.1 */ public enum FlexDirection { @@ -141,6 +146,8 @@ static FlexDirection toFlexDirection(String flexValue, * Possible values for the {@code flex-wrap} CSS property, which determines * how the elements inside the layout should behave when they don't fit * inside the layout. + * + * @since 3.1 */ public enum FlexWrap { @@ -208,6 +215,7 @@ public FlexLayout(Component... children) { * * @param flexWrap * the flex wrap of the layout, never <code>null</code> + * @since 3.1 */ public void setFlexWrap(FlexWrap flexWrap) { if (flexWrap == null) { @@ -224,6 +232,7 @@ public void setFlexWrap(FlexWrap flexWrap) { * The default flex wrap is {@link FlexWrap#NOWRAP}. * * @return the flex wrap used by the layout, never <code>null</code> + * @since 3.1 */ public FlexWrap getFlexWrap() { return FlexWrap.toFlexWrap(getElement().getStyle() @@ -241,6 +250,7 @@ public FlexWrap getFlexWrap() { * @param alignment * the alignment to apply to the components. Setting * <code>null</code> will reset the alignment to its default + * @since 3.1 */ public void setAlignContent(ContentAlignment alignment) { if (alignment == null) { @@ -256,6 +266,7 @@ public void setAlignContent(ContentAlignment alignment) { * * @return the align content property, or {@link ContentAlignment#STRETCH} * if none was set + * @since 3.1 */ public ContentAlignment getAlignContent() { return ContentAlignment.toAlignment( @@ -273,6 +284,7 @@ public ContentAlignment getAlignContent() { * remove the flex basis property * @param components * the components to apply the flex basis property + * @since 3.1 */ public void setFlexBasis(String width, HasElement... components) { if (width == null) { @@ -294,6 +306,7 @@ public void setFlexBasis(String width, HasElement... components) { * @param component * the component to read the flex basis property from * @return the flex grow property + * @since 3.1 */ public String getFlexBasis(HasElement component) { return component.getElement().getStyle() @@ -310,6 +323,7 @@ public String getFlexBasis(HasElement component) { * @param flexDirection * the direction for the components. Setting <code>null</code> * will remove the flex direction property + * @since 3.1 */ public void setFlexDirection(FlexDirection flexDirection) { if (flexDirection == null) { @@ -327,6 +341,7 @@ public void setFlexDirection(FlexDirection flexDirection) { * * @return the flex direction property, or {@link FlexDirection#ROW} if none * was set + * @since 23.3 */ public FlexDirection getFlexDirection() { return FlexDirection.toFlexDirection( @@ -347,6 +362,7 @@ public FlexDirection getFlexDirection() { * the order for the component * @param component * the component to apply the order property + * @since 3.1 */ public void setOrder(int order, HasElement component) { if (order == 0) { @@ -363,6 +379,7 @@ public void setOrder(int order, HasElement component) { * @param component * the component to read the order property from * @return the order property, or 0 if none was set + * @since 3.1 */ public int getOrder(HasElement component) { String order = component.getElement().getStyle() diff --git a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/HorizontalLayout.java b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/HorizontalLayout.java index 23b13472c19..a09db2e66de 100644 --- a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/HorizontalLayout.java +++ b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/HorizontalLayout.java @@ -39,6 +39,8 @@ * Horizontal Layout places components side-by-side in a row. By default, it has * undefined width and height, meaning its size is determined by the components * it contains. + * + * @since 1.0 */ @Tag("vaadin-horizontal-layout") @NpmPackage(value = "@vaadin/horizontal-layout", version = "25.2.0") @@ -78,6 +80,7 @@ public HorizontalLayout(Component... children) { * * @see #add(Component...) * @see #setJustifyContentMode(JustifyContentMode) + * @since 24.1 */ public HorizontalLayout(JustifyContentMode justifyContentMode, Component... children) { @@ -96,6 +99,7 @@ public HorizontalLayout(JustifyContentMode justifyContentMode, * * @see #add(Component...) * @see #setDefaultVerticalComponentAlignment(Alignment) + * @since 24.1 */ public HorizontalLayout(Alignment alignment, Component... children) { this(children); @@ -267,6 +271,7 @@ public Alignment getAlignSelf(HasElement component) { * * @param components * the components to set, not <code>null</code> + * @since 2.0 */ public void addAndExpand(Component... components) { add(components); @@ -307,6 +312,8 @@ public void replace(Component oldComponent, Component newComponent) { * {@inheritDoc} * <p> * This method only adds components to the start slot. + * + * @since 24.7 */ @Override public void add(Collection<Component> components) { @@ -317,6 +324,8 @@ public void add(Collection<Component> components) { * {@inheritDoc} * <p> * This method only adds components to the start slot. + * + * @since 24.7 */ @Override public void add(Component... components) { @@ -357,6 +366,7 @@ public void addComponentAtIndex(int index, Component component) { * @throws NullPointerException * if any of the components is null or if the components array * is null. + * @since 24.7 */ public void addToStart(Component... components) { Objects.requireNonNull(components, "Components should not be null"); @@ -372,6 +382,7 @@ public void addToStart(Component... components) { * @throws NullPointerException * if any of the components is null or if the components array * is null. + * @since 24.7 */ public void addToStart(Collection<Component> components) { var idx = getChildren().filter((child) -> { @@ -402,6 +413,7 @@ public void addToStart(Collection<Component> components) { * @throws NullPointerException * if any of the components is null or if the components array * is null. + * @since 24.7 */ public void addToMiddle(Component... components) { Objects.requireNonNull(components, "Components should not be null"); @@ -417,6 +429,7 @@ public void addToMiddle(Component... components) { * @throws NullPointerException * if any of the components is null or if the components array * is null. + * @since 24.7 */ public void addToMiddle(Collection<Component> components) { Objects.requireNonNull(components, "Components should not be null"); @@ -459,6 +472,7 @@ public void addToMiddle(Collection<Component> components) { * @throws NullPointerException * if any of the components is null or if the components array * is null. + * @since 24.7 */ public void addToEnd(Component... components) { Objects.requireNonNull(components, "Components should not be null"); @@ -474,6 +488,7 @@ public void addToEnd(Component... components) { * @throws NullPointerException * if any of the components is null or if the components array * is null. + * @since 24.7 */ public void addToEnd(Collection<Component> components) { Objects.requireNonNull(components, "Components should not be null"); diff --git a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/HorizontalLayoutVariant.java b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/HorizontalLayoutVariant.java index 58dfbc51e5a..4f6d17a1ff1 100644 --- a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/HorizontalLayoutVariant.java +++ b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/HorizontalLayoutVariant.java @@ -20,6 +20,8 @@ /** * Set of theme variants applicable for {@code vaadin-horizontal-layout} * component. + * + * @since 25.0 */ public enum HorizontalLayoutVariant implements ThemeVariant { LUMO_MARGIN("margin"), diff --git a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/Scroller.java b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/Scroller.java index 8d34324302d..e0ec4acc4ce 100644 --- a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/Scroller.java +++ b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/Scroller.java @@ -34,6 +34,8 @@ * * Scroll direction can be configured with * {@link #setScrollDirection(ScrollDirection)} + * + * @since 3.1 */ @Tag("vaadin-scroller") @NpmPackage(value = "@vaadin/scroller", version = "25.2.0") @@ -176,6 +178,8 @@ private static ScrollDirection fromWebComponentValue( /** * Scrolls the scroller to the top. + * + * @since 24.5 */ public void scrollToTop() { getElement().executeJs("this.scrollTop = 0"); @@ -183,6 +187,8 @@ public void scrollToTop() { /** * Scrolls the scroller to the bottom. + * + * @since 24.5 */ public void scrollToBottom() { diff --git a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/ScrollerVariant.java b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/ScrollerVariant.java index ea84dfd161e..92f1deea243 100644 --- a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/ScrollerVariant.java +++ b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/ScrollerVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-scroller} component. + * + * @since 24.0 */ public enum ScrollerVariant implements ThemeVariant { LUMO_OVERFLOW_INDICATORS("overflow-indicators"), diff --git a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/ThemableLayout.java b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/ThemableLayout.java index bb75f1bada4..46954cd5878 100644 --- a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/ThemableLayout.java +++ b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/ThemableLayout.java @@ -30,6 +30,7 @@ * component theme supports it. * * @author Vaadin Ltd. + * @since 1.0 */ public interface ThemableLayout extends HasElement { /** @@ -118,6 +119,7 @@ default boolean isSpacing() { * the spacing between the components. The value must be a valid * CSS length, i.e. must provide a unit (e.g. "1px", "1rem", * "1%") for values other than 0. + * @since 24.7 */ default void setSpacing(String spacing) { getElement().getStyle().set("gap", spacing); @@ -130,6 +132,7 @@ default void setSpacing(String spacing) { * the spacing between the components * @param unit * the unit of the spacing value + * @since 24.7 */ default void setSpacing(float spacing, Unit unit) { if (spacing < 0) { @@ -148,6 +151,7 @@ default void setSpacing(float spacing, Unit unit) { * this case, use {@link #isSpacing()} instead. * * @return the spacing between the components + * @since 24.7 */ default String getSpacing() { return getElement().getStyle().get("gap"); @@ -164,6 +168,7 @@ default String getSpacing() { * @param wrap * true to enable wrapping, false to force items into a single * row/column + * @since 24.6 */ default void setWrap(boolean wrap) { getThemeList().set("wrap", wrap); @@ -180,6 +185,7 @@ default void setWrap(boolean wrap) { * @return true if wrapping is enabled, false if items are forced into a * single row/column * @see #setWrap(boolean) + * @since 24.6 */ default boolean isWrap() { return getThemeList().contains("wrap"); diff --git a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/VerticalLayout.java b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/VerticalLayout.java index 7fb86f8e38e..fafef8c7126 100644 --- a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/VerticalLayout.java +++ b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/VerticalLayout.java @@ -27,6 +27,8 @@ * Vertical Layout places components top-to-bottom in a column. By default, it * has 100% width and undefined height, meaning its width is constrained by its * parent component and its height is determined by the components it contains. + * + * @since 1.0 */ @Tag("vaadin-vertical-layout") @NpmPackage(value = "@vaadin/vertical-layout", version = "25.2.0") @@ -68,6 +70,7 @@ public VerticalLayout(Component... children) { * * @see #add(Component...) * @see #setJustifyContentMode(JustifyContentMode) + * @since 24.1 */ public VerticalLayout(JustifyContentMode justifyContentMode, Component... children) { @@ -86,6 +89,7 @@ public VerticalLayout(JustifyContentMode justifyContentMode, * * @see #add(Component...) * @see #setDefaultHorizontalComponentAlignment(Alignment) + * @since 24.1 */ public VerticalLayout(Alignment alignment, Component... children) { this(children); @@ -265,6 +269,7 @@ public Alignment getAlignSelf(HasElement component) { * * @param components * the components to set, not <code>null</code> + * @since 2.0 */ public void addAndExpand(Component... components) { add(components); diff --git a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/VerticalLayoutVariant.java b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/VerticalLayoutVariant.java index f8a97b5c3d7..cbaff3d0764 100644 --- a/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/VerticalLayoutVariant.java +++ b/vaadin-ordered-layout-flow-parent/vaadin-ordered-layout-flow/src/main/java/com/vaadin/flow/component/orderedlayout/VerticalLayoutVariant.java @@ -20,6 +20,8 @@ /** * Set of theme variants applicable for {@code vaadin-vertical-layout} * component. + * + * @since 25.0 */ public enum VerticalLayoutVariant implements ThemeVariant { LUMO_MARGIN("margin"), diff --git a/vaadin-popover-flow-parent/vaadin-popover-flow/src/main/java/com/vaadin/flow/component/popover/Popover.java b/vaadin-popover-flow-parent/vaadin-popover-flow/src/main/java/com/vaadin/flow/component/popover/Popover.java index 3a2361d6f82..076d0dd7993 100644 --- a/vaadin-popover-flow-parent/vaadin-popover-flow/src/main/java/com/vaadin/flow/component/popover/Popover.java +++ b/vaadin-popover-flow-parent/vaadin-popover-flow/src/main/java/com/vaadin/flow/component/popover/Popover.java @@ -45,6 +45,7 @@ * specified component (target). * * @author Vaadin Ltd. + * @since 24.5 */ @Tag("vaadin-popover") @NpmPackage(value = "@vaadin/popover", version = "25.2.0") @@ -354,6 +355,7 @@ public boolean isAutofocus() { * * @return {@code true} if tab focus into the popover is enabled, * {@code false} otherwise + * @since 25.2 */ public boolean isTabFocusEnabled() { return !getElement().getProperty("noTabFocus", false); @@ -374,6 +376,7 @@ public boolean isTabFocusEnabled() { * @param tabFocusEnabled * {@code true} to allow tab focus into the popover, * {@code false} to skip the popover in tab order + * @since 25.2 */ public void setTabFocusEnabled(boolean tabFocusEnabled) { getElement().setProperty("noTabFocus", !tabFocusEnabled); @@ -384,6 +387,7 @@ public void setTabFocusEnabled(boolean tabFocusEnabled) { * * @param role * the role to set + * @since 25.0 */ public void setRole(String role) { Objects.requireNonNull(role, "Role cannot be null"); @@ -410,6 +414,7 @@ public void setOverlayRole(String role) { * Defaults to {@code dialog}. * * @return the role + * @since 25.0 */ public String getRole() { return getElement().getProperty("role"); diff --git a/vaadin-popover-flow-parent/vaadin-popover-flow/src/main/java/com/vaadin/flow/component/popover/PopoverPosition.java b/vaadin-popover-flow-parent/vaadin-popover-flow/src/main/java/com/vaadin/flow/component/popover/PopoverPosition.java index 89d2c86ddb1..b615019f11f 100644 --- a/vaadin-popover-flow-parent/vaadin-popover-flow/src/main/java/com/vaadin/flow/component/popover/PopoverPosition.java +++ b/vaadin-popover-flow-parent/vaadin-popover-flow/src/main/java/com/vaadin/flow/component/popover/PopoverPosition.java @@ -17,6 +17,8 @@ /** * Popover position in relation to the target element. + * + * @since 24.5 */ public enum PopoverPosition { TOP_START("top-start"), diff --git a/vaadin-popover-flow-parent/vaadin-popover-flow/src/main/java/com/vaadin/flow/component/popover/PopoverVariant.java b/vaadin-popover-flow-parent/vaadin-popover-flow/src/main/java/com/vaadin/flow/component/popover/PopoverVariant.java index e2f761718d6..dd2472bd608 100644 --- a/vaadin-popover-flow-parent/vaadin-popover-flow/src/main/java/com/vaadin/flow/component/popover/PopoverVariant.java +++ b/vaadin-popover-flow-parent/vaadin-popover-flow/src/main/java/com/vaadin/flow/component/popover/PopoverVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for the {@link Popover} component. + * + * @since 24.5 */ public enum PopoverVariant implements ThemeVariant { LUMO_NO_PADDING("no-padding"), diff --git a/vaadin-progress-bar-flow-parent/vaadin-progress-bar-flow/src/main/java/com/vaadin/flow/component/progressbar/ProgressBar.java b/vaadin-progress-bar-flow-parent/vaadin-progress-bar-flow/src/main/java/com/vaadin/flow/component/progressbar/ProgressBar.java index f2d831dbd16..7472ecf1b24 100644 --- a/vaadin-progress-bar-flow-parent/vaadin-progress-bar-flow/src/main/java/com/vaadin/flow/component/progressbar/ProgressBar.java +++ b/vaadin-progress-bar-flow-parent/vaadin-progress-bar-flow/src/main/java/com/vaadin/flow/component/progressbar/ProgressBar.java @@ -32,6 +32,7 @@ * process that takes a noticeable time to finish. * * @author Vaadin Ltd. + * @since 1.0 */ @Tag("vaadin-progress-bar") @NpmPackage(value = "@vaadin/progress-bar", version = "25.2.0") diff --git a/vaadin-progress-bar-flow-parent/vaadin-progress-bar-flow/src/main/java/com/vaadin/flow/component/progressbar/ProgressBarVariant.java b/vaadin-progress-bar-flow-parent/vaadin-progress-bar-flow/src/main/java/com/vaadin/flow/component/progressbar/ProgressBarVariant.java index e84fb1f3733..3e9baca5dba 100644 --- a/vaadin-progress-bar-flow-parent/vaadin-progress-bar-flow/src/main/java/com/vaadin/flow/component/progressbar/ProgressBarVariant.java +++ b/vaadin-progress-bar-flow-parent/vaadin-progress-bar-flow/src/main/java/com/vaadin/flow/component/progressbar/ProgressBarVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-progress-bar} component. + * + * @since 1.1 */ public enum ProgressBarVariant implements ThemeVariant { LUMO_CONTRAST("contrast"), diff --git a/vaadin-radio-button-flow-parent/vaadin-radio-button-flow/src/main/java/com/vaadin/flow/component/radiobutton/RadioButtonGroup.java b/vaadin-radio-button-flow-parent/vaadin-radio-button-flow/src/main/java/com/vaadin/flow/component/radiobutton/RadioButtonGroup.java index 023427e0bf2..0f0e42fefba 100755 --- a/vaadin-radio-button-flow-parent/vaadin-radio-button-flow/src/main/java/com/vaadin/flow/component/radiobutton/RadioButtonGroup.java +++ b/vaadin-radio-button-flow-parent/vaadin-radio-button-flow/src/main/java/com/vaadin/flow/component/radiobutton/RadioButtonGroup.java @@ -101,6 +101,7 @@ * {@link #setInvalid(boolean)} and {@link #setErrorMessage(String)} API. * * @author Vaadin Ltd. + * @since 1.0 */ @Tag("vaadin-radio-group") @NpmPackage(value = "@vaadin/radio-group", version = "25.2.0") @@ -199,6 +200,7 @@ public RadioButtonGroup() { * @param label * the label describing the radio button group * @see #setLabel(String) + * @since 23.1 */ public RadioButtonGroup(String label) { this(); @@ -215,6 +217,7 @@ public RadioButtonGroup(String label) { * the items to be shown in the list of the radio button group * @see #setLabel(String) * @see #setItems(Collection) + * @since 23.1 */ public RadioButtonGroup(String label, Collection<T> items) { this(label); @@ -231,6 +234,7 @@ public RadioButtonGroup(String label, Collection<T> items) { * the items to be shown in the list of the radio button group * @see #setLabel(String) * @see #setItems(Object...) + * @since 23.1 */ @SafeVarargs public RadioButtonGroup(String label, T... items) { @@ -244,6 +248,7 @@ public RadioButtonGroup(String label, T... items) { * @param listener * the value change listener to add * @see #addValueChangeListener(ValueChangeListener) + * @since 23.1 */ public RadioButtonGroup( ValueChangeListener<ComponentValueChangeEvent<RadioButtonGroup<T>, T>> listener) { @@ -261,6 +266,7 @@ public RadioButtonGroup( * the value change listener to add * @see #setLabel(String) * @see #addValueChangeListener(ValueChangeListener) + * @since 23.1 */ public RadioButtonGroup(String label, ValueChangeListener<ComponentValueChangeEvent<RadioButtonGroup<T>, T>> listener) { @@ -281,6 +287,7 @@ public RadioButtonGroup(String label, * @see #setLabel(String) * @see #addValueChangeListener(ValueChangeListener) * @see #setItems(Object...) + * @since 23.1 */ @SafeVarargs public RadioButtonGroup(String label, @@ -335,6 +342,7 @@ public RadioButtonGroupListDataView<T> setItems( * * @return the list data view that provides access to the data bound to the * RadioButtonGroup + * @since 18.0 */ @Override public RadioButtonGroupListDataView<T> getListDataView() { @@ -350,6 +358,7 @@ public RadioButtonGroupListDataView<T> getListDataView() { * * @return the generic DataView instance implementing * {@link RadioButtonGroupDataView} + * @since 18.0 */ @Override public RadioButtonGroupDataView<T> getGenericDataView() { @@ -377,6 +386,7 @@ protected boolean hasValidValue() { * * @param dataProvider * DataProvider instance to use, not <code>null</code> + * @since 24.2 */ public void setDataProvider(DataProvider<T, ?> dataProvider) { this.dataProvider.set(dataProvider); @@ -406,6 +416,7 @@ private void setupDataProviderListener(DataProvider<T, ?> dataProvider) { * * @param itemLabelGenerator * the item label provider to use, not null + * @since 23.0 */ public void setItemLabelGenerator( ItemLabelGenerator<T> itemLabelGenerator) { @@ -420,6 +431,7 @@ public void setItemLabelGenerator( * in the radio button group for each item. * * @return the item label generator used, not null + * @since 23.0 */ public ItemLabelGenerator<T> getItemLabelGenerator() { return itemLabelGenerator; @@ -463,6 +475,7 @@ protected void onDetach(DetachEvent detachEvent) { * instead. * * @return the data provider used by this RadioButtonGroup + * @since 24.2 */ public DataProvider<T, ?> getDataProvider() { return Optional.ofNullable(dataProvider).map(AtomicReference::get) @@ -550,6 +563,7 @@ public SignalBinding<Boolean> bindReadOnly(Signal<Boolean> readOnlySignal) { * {@code true} to make the field required, {@code false} * otherwise * @see RadioButtonGroupI18n#setRequiredErrorMessage(String) + * @since 24.5 */ @Override public void setRequiredIndicatorVisible(boolean required) { @@ -561,6 +575,7 @@ public void setRequiredIndicatorVisible(boolean required) { * * @return {@code true} if the field is required, {@code false} otherwise * @see #setRequiredIndicatorVisible(boolean) + * @since 24.5 */ @Override public boolean isRequiredIndicatorVisible() { @@ -571,6 +586,7 @@ public boolean isRequiredIndicatorVisible() { * Alias for {@link #isRequiredIndicatorVisible()} * * @return {@code true} if the field is required, {@code false} otherwise + * @since 1.1 */ public boolean isRequired() { return isRequiredIndicatorVisible(); @@ -582,6 +598,7 @@ public boolean isRequired() { * @param required * {@code true} to make the field required, {@code false} * otherwise + * @since 1.1 */ public void setRequired(boolean required) { setRequiredIndicatorVisible(required); @@ -592,6 +609,7 @@ public void setRequired(boolean required) { * * @param label * value for the {@code label} property in the webcomponent + * @since 1.1 */ public void setLabel(String label) { getElement().setProperty("label", label == null ? "" : label); @@ -601,6 +619,7 @@ public void setLabel(String label) { * String used for the label element. * * @return the {@code label} property from the webcomponent + * @since 1.1 */ public String getLabel() { return getElement().getProperty("label"); @@ -616,6 +635,7 @@ public String getLabel() { * the selection preservation mode to switch to, not {@code null} * * @see SelectionPreservationMode + * @since 24.4 */ public void setSelectionPreservationMode( SelectionPreservationMode selectionPreservationMode) { @@ -629,6 +649,7 @@ public void setSelectionPreservationMode( * @return the selection preservation mode * * @see #setSelectionPreservationMode(SelectionPreservationMode) + * @since 24.4 */ public SelectionPreservationMode getSelectionPreservationMode() { return selectionPreservationHandler.getSelectionPreservationMode(); @@ -776,6 +797,7 @@ private void updateButton(RadioButton<T> button) { * the second instance * @return <code>true</code> if the instances are equal; otherwise * <code>false</code> + * @since 18.0 */ @Override protected boolean valueEquals(T value1, T value2) { @@ -890,6 +912,8 @@ public Validator<T> getDefaultValidator() { * message defined in the i18n object is used. * <p> * The method does nothing if the manual validation mode is enabled. + * + * @since 24.0 */ protected void validate() { validationController.validate(getValue()); @@ -903,6 +927,7 @@ protected void validate() { * {@link #setI18n(RadioButtonGroupI18n)} * * @return the i18n object or {@code null} if no i18n object has been set + * @since 24.5 */ public RadioButtonGroupI18n getI18n() { return i18n; @@ -913,6 +938,7 @@ public RadioButtonGroupI18n getI18n() { * * @param i18n * the i18n object, not {@code null} + * @since 24.5 */ public void setI18n(RadioButtonGroupI18n i18n) { this.i18n = Objects.requireNonNull(i18n, @@ -926,6 +952,8 @@ private String getI18nErrorMessage( /** * The internationalization properties for {@link RadioButtonGroup}. + * + * @since 24.5 */ public static class RadioButtonGroupI18n implements Serializable { diff --git a/vaadin-radio-button-flow-parent/vaadin-radio-button-flow/src/main/java/com/vaadin/flow/component/radiobutton/RadioGroupVariant.java b/vaadin-radio-button-flow-parent/vaadin-radio-button-flow/src/main/java/com/vaadin/flow/component/radiobutton/RadioGroupVariant.java index 4b817b029c2..eb008643d14 100644 --- a/vaadin-radio-button-flow-parent/vaadin-radio-button-flow/src/main/java/com/vaadin/flow/component/radiobutton/RadioGroupVariant.java +++ b/vaadin-radio-button-flow-parent/vaadin-radio-button-flow/src/main/java/com/vaadin/flow/component/radiobutton/RadioGroupVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-radio-group} component. + * + * @since 1.1 */ public enum RadioGroupVariant implements ThemeVariant { LUMO_VERTICAL("vertical"), diff --git a/vaadin-radio-button-flow-parent/vaadin-radio-button-flow/src/main/java/com/vaadin/flow/component/radiobutton/dataview/RadioButtonGroupDataView.java b/vaadin-radio-button-flow-parent/vaadin-radio-button-flow/src/main/java/com/vaadin/flow/component/radiobutton/dataview/RadioButtonGroupDataView.java index 9d94711a075..a427c93dc44 100644 --- a/vaadin-radio-button-flow-parent/vaadin-radio-button-flow/src/main/java/com/vaadin/flow/component/radiobutton/dataview/RadioButtonGroupDataView.java +++ b/vaadin-radio-button-flow-parent/vaadin-radio-button-flow/src/main/java/com/vaadin/flow/component/radiobutton/dataview/RadioButtonGroupDataView.java @@ -28,7 +28,7 @@ * * @param <T> * the item type - * @since + * @since 18.0 */ public class RadioButtonGroupDataView<T> extends AbstractDataView<T> { diff --git a/vaadin-radio-button-flow-parent/vaadin-radio-button-flow/src/main/java/com/vaadin/flow/component/radiobutton/dataview/RadioButtonGroupListDataView.java b/vaadin-radio-button-flow-parent/vaadin-radio-button-flow/src/main/java/com/vaadin/flow/component/radiobutton/dataview/RadioButtonGroupListDataView.java index 79905b79ebe..62f5851d6fa 100644 --- a/vaadin-radio-button-flow-parent/vaadin-radio-button-flow/src/main/java/com/vaadin/flow/component/radiobutton/dataview/RadioButtonGroupListDataView.java +++ b/vaadin-radio-button-flow-parent/vaadin-radio-button-flow/src/main/java/com/vaadin/flow/component/radiobutton/dataview/RadioButtonGroupListDataView.java @@ -31,7 +31,7 @@ * * @param <T> * data type - * @since + * @since 18.0 */ public class RadioButtonGroupListDataView<T> extends AbstractListDataView<T> { diff --git a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/BasicRenderer.java b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/BasicRenderer.java index 32ebf6380ac..705c6e536de 100644 --- a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/BasicRenderer.java +++ b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/BasicRenderer.java @@ -43,6 +43,7 @@ * the type of the item used inside the renderer * @param <TARGET> * the type of the output object, such as Number or LocalDate + * @since 22.0 */ public abstract class BasicRenderer<SOURCE, TARGET> extends ComponentRenderer<Component, SOURCE> { diff --git a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/ClickableRenderer.java b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/ClickableRenderer.java index 745789f081f..0efc9f61185 100644 --- a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/ClickableRenderer.java +++ b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/ClickableRenderer.java @@ -27,6 +27,7 @@ * * @param <SOURCE> * the type of the item received in the click listeners + * @since 22.0 */ public interface ClickableRenderer<SOURCE> extends Serializable { diff --git a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/ComponentDataGenerator.java b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/ComponentDataGenerator.java index 452e541b7d3..ebd52b00e49 100644 --- a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/ComponentDataGenerator.java +++ b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/ComponentDataGenerator.java @@ -39,6 +39,7 @@ * * @param <T> * the date type + * @since 22.0 */ public class ComponentDataGenerator<T> extends AbstractComponentDataGenerator<T> { diff --git a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/ComponentRenderer.java b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/ComponentRenderer.java index 5f8b6e2fcfc..304b28be6f1 100644 --- a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/ComponentRenderer.java +++ b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/ComponentRenderer.java @@ -43,6 +43,7 @@ * the type of the output component * @param <SOURCE> * the type of the input model object + * @since 22.0 */ @JsModule("./flow-component-renderer.js") public class ComponentRenderer<COMPONENT extends Component, SOURCE> diff --git a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/IconRenderer.java b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/IconRenderer.java index c29a13d5547..860096fb906 100644 --- a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/IconRenderer.java +++ b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/IconRenderer.java @@ -32,6 +32,7 @@ * the type of the input object that can be used by the rendered * component * + * @since 22.0 */ public class IconRenderer<ITEM> extends ComponentRenderer<Component, ITEM> { diff --git a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/LitRenderer.java b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/LitRenderer.java index b9e0e346872..5a7a075c6b2 100644 --- a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/LitRenderer.java +++ b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/LitRenderer.java @@ -174,6 +174,7 @@ private void setElementRenderer(Element container, String rendererName, * Returns the Lit template expression used to render items. * * @return the template expression + * @since 24.0 */ protected String getTemplateExpression() { return templateExpression; @@ -397,6 +398,7 @@ public LitRenderer<SOURCE> withFunction(String functionName, * returned map is immutable. * * @return the mapped properties, never <code>null</code> + * @since 23.0.10 */ public Map<String, ValueProvider<SOURCE, ?>> getValueProviders() { return Collections.unmodifiableMap(valueProviders); diff --git a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/LocalDateRenderer.java b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/LocalDateRenderer.java index 2e712e23b84..7cf1b5d85df 100644 --- a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/LocalDateRenderer.java +++ b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/LocalDateRenderer.java @@ -31,6 +31,7 @@ * @param <SOURCE> * the type of the input item, from which the {@link LocalDate} is * extracted + * @since 22.0 */ public class LocalDateRenderer<SOURCE> extends BasicRenderer<SOURCE, LocalDate> { @@ -154,6 +155,7 @@ public LocalDateRenderer(ValueProvider<SOURCE, LocalDate> valueProvider, * not <code>null</code> * @param formatter * the formatter to use, not <code>null</code> + * @since 23.2 */ public LocalDateRenderer(ValueProvider<SOURCE, LocalDate> valueProvider, SerializableSupplier<DateTimeFormatter> formatter) { @@ -173,6 +175,7 @@ public LocalDateRenderer(ValueProvider<SOURCE, LocalDate> valueProvider, * @param nullRepresentation * the textual representation of the <code>null</code> value * + * @since 23.2 */ public LocalDateRenderer(ValueProvider<SOURCE, LocalDate> valueProvider, SerializableSupplier<DateTimeFormatter> formatter, diff --git a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/LocalDateTimeRenderer.java b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/LocalDateTimeRenderer.java index d28dc283fce..b54ff22463a 100644 --- a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/LocalDateTimeRenderer.java +++ b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/LocalDateTimeRenderer.java @@ -32,6 +32,7 @@ * @param <SOURCE> * the type of the input item, from which the {@link LocalDateTime} * is extracted + * @since 22.0 */ public class LocalDateTimeRenderer<SOURCE> extends BasicRenderer<SOURCE, LocalDateTime> { @@ -74,6 +75,7 @@ public LocalDateTimeRenderer( * renderer, not <code>null</code> * @param formatter * the formatter to use, not <code>null</code> + * @since 23.2 */ public LocalDateTimeRenderer( ValueProvider<SOURCE, LocalDateTime> valueProvider, @@ -93,6 +95,7 @@ public LocalDateTimeRenderer( * the formatter to use, not <code>null</code> * @param nullRepresentation * the textual representation of the <code>null</code> value + * @since 23.2 */ public LocalDateTimeRenderer( ValueProvider<SOURCE, LocalDateTime> valueProvider, diff --git a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/NativeButtonRenderer.java b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/NativeButtonRenderer.java index d33093d4f54..900b2f9a7bc 100644 --- a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/NativeButtonRenderer.java +++ b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/NativeButtonRenderer.java @@ -38,6 +38,7 @@ * * @param <SOURCE> * the type of the item to be received in the click listeners + * @since 22.0 */ public class NativeButtonRenderer<SOURCE> extends BasicRenderer<SOURCE, String> implements ClickableRenderer<SOURCE> { diff --git a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/NumberRenderer.java b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/NumberRenderer.java index 4b9fd665123..b7d2f16b0bc 100644 --- a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/NumberRenderer.java +++ b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/NumberRenderer.java @@ -29,6 +29,7 @@ * @param <SOURCE> * the type of the input item, from which the number is extracted * + * @since 22.0 */ public class NumberRenderer<SOURCE> extends BasicRenderer<SOURCE, Number> { diff --git a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/Renderer.java b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/Renderer.java index e43ee3cbf69..a4287624714 100644 --- a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/Renderer.java +++ b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/Renderer.java @@ -33,6 +33,7 @@ * @see ValueProvider * @see ComponentRenderer * @see LitRenderer + * @since 22.0 */ public abstract class Renderer<SOURCE> implements Serializable { @@ -71,6 +72,7 @@ public Rendering<SOURCE> render(Element container, * name of the renderer function the container element accepts * @return the context of the rendering, that can be used by the components * to provide extra customization + * @since 24.0 */ public abstract Rendering<SOURCE> render(Element container, DataKeyMapper<SOURCE> keyMapper, String rendererName); diff --git a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/Rendering.java b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/Rendering.java index ff5b8b0ae7b..1d11f5621b6 100644 --- a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/Rendering.java +++ b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/Rendering.java @@ -33,6 +33,7 @@ * the type of the object model * * @see Renderer#render(Element, com.vaadin.flow.data.provider.DataKeyMapper) + * @since 22.0 */ public interface Rendering<SOURCE> extends Serializable { diff --git a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/TextRenderer.java b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/TextRenderer.java index c7bf8c23aef..62e3e64ce07 100644 --- a/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/TextRenderer.java +++ b/vaadin-renderer-flow-parent/vaadin-renderer-flow/src/main/java/com/vaadin/flow/data/renderer/TextRenderer.java @@ -30,6 +30,7 @@ * the type of the input object that can be used by the rendered * component * + * @since 22.0 */ public class TextRenderer<ITEM> extends BasicRenderer<ITEM, ITEM> { diff --git a/vaadin-rich-text-editor-flow-parent/vaadin-rich-text-editor-flow/src/main/java/com/vaadin/flow/component/richtexteditor/RichTextEditor.java b/vaadin-rich-text-editor-flow-parent/vaadin-rich-text-editor-flow/src/main/java/com/vaadin/flow/component/richtexteditor/RichTextEditor.java index 01f99295f27..971a78afb71 100644 --- a/vaadin-rich-text-editor-flow-parent/vaadin-rich-text-editor-flow/src/main/java/com/vaadin/flow/component/richtexteditor/RichTextEditor.java +++ b/vaadin-rich-text-editor-flow-parent/vaadin-rich-text-editor-flow/src/main/java/com/vaadin/flow/component/richtexteditor/RichTextEditor.java @@ -59,6 +59,7 @@ * * @author Vaadin Ltd * + * @since 1.0 */ @Tag("vaadin-rich-text-editor") @NpmPackage(value = "@vaadin/rich-text-editor", version = "25.2.0") @@ -248,6 +249,7 @@ private static String modelToPresentation(String htmlValue) { * is not considered as content. * * @return {@code true} if considered empty; {@code false} if not + * @since 24.6.6 */ @Override public boolean isEmpty() { @@ -574,6 +576,7 @@ public RichTextEditorI18n setH3(String h3) { * Gets the translated word for {@code color} * * @return the translated word for color + * @since 24.5 */ public String getColor() { return color; @@ -585,6 +588,7 @@ public String getColor() { * @param color * the translated word for color * @return this instance for method chaining + * @since 24.5 */ public RichTextEditorI18n setColor(String color) { this.color = color; @@ -595,6 +599,7 @@ public RichTextEditorI18n setColor(String color) { * Gets the translated word for {@code background} * * @return the translated word for background + * @since 24.5 */ public String getBackground() { return background; @@ -606,6 +611,7 @@ public String getBackground() { * @param background * the translated word for background * @return this instance for method chaining + * @since 24.5 */ public RichTextEditorI18n setBackground(String background) { this.background = background; @@ -690,6 +696,7 @@ public String getListBullet() { * @param outdent * the translated word for outdent * @return this instance for method chaining + * @since 25.0 */ public RichTextEditorI18n setOutdent(String outdent) { this.outdent = outdent; @@ -700,6 +707,7 @@ public RichTextEditorI18n setOutdent(String outdent) { * Gets the translated word for {@code outdent} * * @return the translated word for outdent + * @since 25.0 */ public String getOutdent() { return outdent; @@ -711,6 +719,7 @@ public String getOutdent() { * @param indent * the translated word for indent * @return this instance for method chaining + * @since 25.0 */ public RichTextEditorI18n setIndent(String indent) { this.indent = indent; @@ -721,6 +730,7 @@ public RichTextEditorI18n setIndent(String indent) { * Gets the translated word for {@code indent} * * @return the translated word for indent + * @since 25.0 */ public String getIndent() { return indent; @@ -937,6 +947,7 @@ public String toString() { * {@link #setValue(String)}. * * @return an instance of {@code HasValue} + * @since 2.1 */ public HasValue<ValueChangeEvent<String>, String> asHtml() { if (asHtml == null) { @@ -951,6 +962,7 @@ public HasValue<ValueChangeEvent<String>, String> asHtml() { * used for binding the value with {@link Binder}. * * @return an instance of {@code HasValue} + * @since 23.3 */ public HasValue<ValueChangeEvent<String>, String> asDelta() { if (asDelta == null) { diff --git a/vaadin-rich-text-editor-flow-parent/vaadin-rich-text-editor-flow/src/main/java/com/vaadin/flow/component/richtexteditor/RichTextEditorVariant.java b/vaadin-rich-text-editor-flow-parent/vaadin-rich-text-editor-flow/src/main/java/com/vaadin/flow/component/richtexteditor/RichTextEditorVariant.java index 8941b0c60b8..d3ccc491c97 100644 --- a/vaadin-rich-text-editor-flow-parent/vaadin-rich-text-editor-flow/src/main/java/com/vaadin/flow/component/richtexteditor/RichTextEditorVariant.java +++ b/vaadin-rich-text-editor-flow-parent/vaadin-rich-text-editor-flow/src/main/java/com/vaadin/flow/component/richtexteditor/RichTextEditorVariant.java @@ -13,6 +13,8 @@ /** * Set of theme variants applicable for {@code vaadin-rich-text-editor} * component. + * + * @since 1.0 */ public enum RichTextEditorVariant implements ThemeVariant { LUMO_NO_BORDER("no-border"), LUMO_COMPACT("compact"); diff --git a/vaadin-select-flow-parent/vaadin-select-flow/src/main/java/com/vaadin/flow/component/select/Select.java b/vaadin-select-flow-parent/vaadin-select-flow/src/main/java/com/vaadin/flow/component/select/Select.java index 233d8247081..329b5bbe10e 100644 --- a/vaadin-select-flow-parent/vaadin-select-flow/src/main/java/com/vaadin/flow/component/select/Select.java +++ b/vaadin-select-flow-parent/vaadin-select-flow/src/main/java/com/vaadin/flow/component/select/Select.java @@ -107,6 +107,7 @@ * @param <T> * the type of the items for the select * @author Vaadin Ltd. + * @since 1.0 */ @Tag("vaadin-select") @NpmPackage(value = "@vaadin/select", version = "25.2.0") @@ -203,6 +204,7 @@ public Select() { * @param label * the label describing the select * @see #setLabel(String) + * @since 25.0 */ public Select(String label) { this(); @@ -219,6 +221,7 @@ public Select(String label) { * the items to be shown in the list of the select * @see #setLabel(String) * @see #setItems(Collection) + * @since 25.0 */ public Select(String label, Collection<T> items) { this(); @@ -236,6 +239,7 @@ public Select(String label, Collection<T> items) { * the items to be shown in the list of the select * @see #setLabel(String) * @see #setItems(Object...) + * @since 25.0 */ @SafeVarargs public Select(String label, T... items) { @@ -250,6 +254,7 @@ public Select(String label, T... items) { * @param listener * the value change listener to add * @see #addValueChangeListener(ValueChangeListener) + * @since 23.1 */ public Select( ValueChangeListener<ComponentValueChangeEvent<Select<T>, T>> listener) { @@ -267,6 +272,7 @@ public Select( * the value change listener to add * @see #setLabel(String) * @see #addValueChangeListener(ValueChangeListener) + * @since 23.1 */ public Select(String label, ValueChangeListener<ComponentValueChangeEvent<Select<T>, T>> listener) { @@ -288,6 +294,7 @@ public Select(String label, * @see #setLabel(String) * @see #setItems(Object...) * @see #addValueChangeListener(ValueChangeListener) + * @since 23.1 */ @SafeVarargs public Select(String label, @@ -604,6 +611,7 @@ public boolean isAutofocus() { * * @param noVerticalOverlap * whether the overlay should overlap the input element + * @since 24.5 */ public void setNoVerticalOverlap(boolean noVerticalOverlap) { getElement().setProperty("noVerticalOverlap", noVerticalOverlap); @@ -614,6 +622,7 @@ public void setNoVerticalOverlap(boolean noVerticalOverlap) { * * @return {@code true} if the overlay should overlap the input element, * {@code false} otherwise + * @since 24.5 */ public boolean isNoVerticalOverlap() { return getElement().getProperty("noVerticalOverlap", false); @@ -628,6 +637,7 @@ public boolean isNoVerticalOverlap() { * * @param dataProvider * DataProvider instance to use, not <code>null</code> + * @since 24.2 */ public void setDataProvider(DataProvider<T, ?> dataProvider) { this.dataProvider.set(dataProvider); @@ -691,6 +701,7 @@ public SelectListDataView<T> setItems(ListDataProvider<T> dataProvider) { * underlying data provider. * * @return the generic DataView instance implementing {@link Select} + * @since 18.0 */ @Override public SelectDataView<T> getGenericDataView() { @@ -710,6 +721,7 @@ public SelectDataView<T> getGenericDataView() { * * @return the list data view that provides access to the data bound to the * {@link Select} + * @since 18.0 */ @Override public SelectListDataView<T> getListDataView() { @@ -880,6 +892,7 @@ public void removeAll() { * @param width * the new dropdown width. Pass in null to set the dropdown width * back to the default value. + * @since 24.5 */ public void setOverlayWidth(String width) { getStyle().set("--vaadin-select-overlay-width", width); @@ -893,6 +906,7 @@ public void setOverlayWidth(String width) { * the width of the dropdown. * @param unit * the unit used for the dropdown. + * @since 24.5 */ public void setOverlayWidth(float width, Unit unit) { Objects.requireNonNull(unit, "Unit can not be null"); @@ -904,6 +918,7 @@ public void setOverlayWidth(float width, Unit unit) { * * @param opened * the boolean value to set + * @since 24.0 */ protected void setOpened(boolean opened) { getElement().setProperty("opened", opened); @@ -913,6 +928,7 @@ protected void setOpened(boolean opened) { * Whether the dropdown is opened or not. * * @return {@code true} if the drop-down is opened, {@code false} otherwise + * @since 24.0 */ @Synchronize(property = "opened", value = "opened-changed") protected boolean isOpened() { @@ -955,6 +971,7 @@ protected void onAttach(AttachEvent attachEvent) { * the second instance * @return <code>true</code> if the instances are equal; otherwise * <code>false</code> + * @since 18.0 */ @Override protected boolean valueEquals(T value1, T value2) { @@ -1178,6 +1195,8 @@ public Validator<T> getDefaultValidator() { * message defined in the i18n object is used. * <p> * The method does nothing if the manual validation mode is enabled. + * + * @since 24.0 */ protected void validate() { validationController.validate(getValue()); @@ -1186,6 +1205,8 @@ protected void validate() { /** * {@code opened-changed} event is sent when the overlay opened state * changes. + * + * @since 24.0 */ public static class OpenedChangeEvent extends ComponentEvent<Select> { private final boolean opened; @@ -1207,6 +1228,7 @@ public boolean isOpened() { * @param listener * the listener * @return a {@link Registration} for removing the event listener + * @since 24.0 */ protected Registration addOpenedChangeListener( ComponentEventListener<OpenedChangeEvent> listener) { @@ -1215,6 +1237,8 @@ protected Registration addOpenedChangeListener( /** * {@code invalid-changed} event is sent when the invalid state changes. + * + * @since 24.0 */ public static class InvalidChangeEvent extends ComponentEvent<Select> { private final boolean invalid; @@ -1236,6 +1260,7 @@ public boolean isInvalid() { * @param listener * the listener * @return a {@link Registration} for removing the event listener + * @since 24.0 */ protected Registration addInvalidChangeListener( ComponentEventListener<InvalidChangeEvent> listener) { @@ -1249,6 +1274,7 @@ protected Registration addInvalidChangeListener( * update the component if not set again using {@link #setI18n(SelectI18n)} * * @return the i18n object or {@code null} if no i18n object has been set + * @since 24.5 */ public SelectI18n getI18n() { return i18n; @@ -1259,6 +1285,7 @@ public SelectI18n getI18n() { * * @param i18n * the i18n object, not {@code null} + * @since 24.5 */ public void setI18n(SelectI18n i18n) { this.i18n = Objects.requireNonNull(i18n, @@ -1271,6 +1298,8 @@ private String getI18nErrorMessage(Function<SelectI18n, String> getter) { /** * The internationalization properties for {@link Select}. + * + * @since 24.5 */ public static class SelectI18n implements Serializable { diff --git a/vaadin-select-flow-parent/vaadin-select-flow/src/main/java/com/vaadin/flow/component/select/SelectVariant.java b/vaadin-select-flow-parent/vaadin-select-flow/src/main/java/com/vaadin/flow/component/select/SelectVariant.java index f2ea45174b7..446c2688f47 100644 --- a/vaadin-select-flow-parent/vaadin-select-flow/src/main/java/com/vaadin/flow/component/select/SelectVariant.java +++ b/vaadin-select-flow-parent/vaadin-select-flow/src/main/java/com/vaadin/flow/component/select/SelectVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-select} component. + * + * @since 23.1 */ public enum SelectVariant implements ThemeVariant { LUMO_SMALL("small"), diff --git a/vaadin-select-flow-parent/vaadin-select-flow/src/main/java/com/vaadin/flow/component/select/data/SelectDataView.java b/vaadin-select-flow-parent/vaadin-select-flow/src/main/java/com/vaadin/flow/component/select/data/SelectDataView.java index 5918842824b..dd59cbf63bc 100644 --- a/vaadin-select-flow-parent/vaadin-select-flow/src/main/java/com/vaadin/flow/component/select/data/SelectDataView.java +++ b/vaadin-select-flow-parent/vaadin-select-flow/src/main/java/com/vaadin/flow/component/select/data/SelectDataView.java @@ -28,7 +28,7 @@ * * @param <T> * item type - * @since + * @since 18.0 */ public class SelectDataView<T> extends AbstractDataView<T> { diff --git a/vaadin-select-flow-parent/vaadin-select-flow/src/main/java/com/vaadin/flow/component/select/data/SelectListDataView.java b/vaadin-select-flow-parent/vaadin-select-flow/src/main/java/com/vaadin/flow/component/select/data/SelectListDataView.java index 7ceaff04739..433460896ee 100644 --- a/vaadin-select-flow-parent/vaadin-select-flow/src/main/java/com/vaadin/flow/component/select/data/SelectListDataView.java +++ b/vaadin-select-flow-parent/vaadin-select-flow/src/main/java/com/vaadin/flow/component/select/data/SelectListDataView.java @@ -31,6 +31,7 @@ * * @param <T> * item type + * @since 18.0 */ public class SelectListDataView<T> extends AbstractListDataView<T> { diff --git a/vaadin-side-nav-flow-parent/vaadin-side-nav-flow/src/main/java/com/vaadin/flow/component/sidenav/HasSideNavItems.java b/vaadin-side-nav-flow-parent/vaadin-side-nav-flow/src/main/java/com/vaadin/flow/component/sidenav/HasSideNavItems.java index 56698548259..0e80117dbf3 100644 --- a/vaadin-side-nav-flow-parent/vaadin-side-nav-flow/src/main/java/com/vaadin/flow/component/sidenav/HasSideNavItems.java +++ b/vaadin-side-nav-flow-parent/vaadin-side-nav-flow/src/main/java/com/vaadin/flow/component/sidenav/HasSideNavItems.java @@ -32,6 +32,7 @@ * @see SideNavItem * * @author Vaadin Ltd + * @since 24.8 */ public interface HasSideNavItems extends HasElement { diff --git a/vaadin-side-nav-flow-parent/vaadin-side-nav-flow/src/main/java/com/vaadin/flow/component/sidenav/SideNav.java b/vaadin-side-nav-flow-parent/vaadin-side-nav-flow/src/main/java/com/vaadin/flow/component/sidenav/SideNav.java index 3dcae552443..e67fe88ebb1 100644 --- a/vaadin-side-nav-flow-parent/vaadin-side-nav-flow/src/main/java/com/vaadin/flow/component/sidenav/SideNav.java +++ b/vaadin-side-nav-flow-parent/vaadin-side-nav-flow/src/main/java/com/vaadin/flow/component/sidenav/SideNav.java @@ -38,6 +38,7 @@ * {@link SideNavItem} instances. * * @author Vaadin Ltd + * @since 24.1 */ @Tag("vaadin-side-nav") @NpmPackage(value = "@vaadin/side-nav", version = "25.2.0") @@ -158,6 +159,7 @@ public void setExpanded(boolean expanded) { * expanded. * * @return true if parent items for the item should be expanded + * @since 25.0 */ public boolean isAutoExpand() { return !getElement().getProperty("noAutoExpand", false); @@ -171,6 +173,7 @@ public boolean isAutoExpand() { * @param autoExpand * true if parent items for the item should be expanded, false * otherwise + * @since 25.0 */ public void setAutoExpand(boolean autoExpand) { getElement().setProperty("noAutoExpand", !autoExpand); @@ -183,6 +186,7 @@ public void setAutoExpand(boolean autoExpand) { * update the component if not set again using {@link #setI18n(SideNavI18n)} * * @return the i18n object or {@code null} if no i18n object has been set + * @since 24.2 */ public SideNavI18n getI18n() { return i18n; @@ -195,6 +199,7 @@ public SideNavI18n getI18n() { * * @param i18n * the i18n object, not {@code null} + * @since 24.2 */ public void setI18n(SideNavI18n i18n) { Objects.requireNonNull(i18n, @@ -205,6 +210,8 @@ public void setI18n(SideNavI18n i18n) { /** * The internationalization properties for {@link SideNav}. + * + * @since 24.2 */ @JsonInclude(JsonInclude.Include.NON_NULL) public static class SideNavI18n implements Serializable { diff --git a/vaadin-side-nav-flow-parent/vaadin-side-nav-flow/src/main/java/com/vaadin/flow/component/sidenav/SideNavItem.java b/vaadin-side-nav-flow-parent/vaadin-side-nav-flow/src/main/java/com/vaadin/flow/component/sidenav/SideNavItem.java index d53636256a9..2dc9c821078 100644 --- a/vaadin-side-nav-flow-parent/vaadin-side-nav-flow/src/main/java/com/vaadin/flow/component/sidenav/SideNavItem.java +++ b/vaadin-side-nav-flow-parent/vaadin-side-nav-flow/src/main/java/com/vaadin/flow/component/sidenav/SideNavItem.java @@ -57,6 +57,7 @@ * {@link SideNavItem} instance via {@link #addItem(SideNavItem...)}. * * @author Vaadin Ltd + * @since 24.1 */ @Tag("vaadin-side-nav-item") @NpmPackage(value = "@vaadin/side-nav", version = "25.2.0") @@ -126,6 +127,7 @@ public SideNavItem(String label, Class<? extends Component> view) { * the type of the URL parameter * @param <C> * the type of the view + * @since 24.7 */ public <T, C extends Component & HasUrlParameter<T>> SideNavItem( String label, Class<? extends C> view, T parameter) { @@ -142,6 +144,7 @@ public <T, C extends Component & HasUrlParameter<T>> SideNavItem( * the route parameters * @param view * the view to link to + * @since 24.2 */ public SideNavItem(String label, Class<? extends Component> view, RouteParameters routeParameters) { @@ -201,6 +204,7 @@ public SideNavItem(String label, Class<? extends Component> view, * the route parameters * @param prefixComponent * the prefixComponent for the item (usually an icon) + * @since 24.2 */ public SideNavItem(String label, Class<? extends Component> view, RouteParameters routeParameters, Component prefixComponent) { @@ -284,6 +288,7 @@ public void setPath(String path) { * @param path * The path to link to. Set to null to disable navigation for * this item. + * @since 25.2 */ public void setUnsafePath(String path) { doSetPath(path); @@ -340,6 +345,7 @@ public void setPath(Class<? extends Component> view) { * the type of the URL parameter * @param <C> * the type of the view + * @since 24.7 */ public <T, C extends Component & HasUrlParameter<T>> void setPath( Class<? extends C> view, T parameter) { @@ -365,6 +371,7 @@ public <T, C extends Component & HasUrlParameter<T>> void setPath( * * @see SideNavItem#setPath(String) * @see SideNavItem#setPathAliases(Set) + * @since 24.2 */ public void setPath(Class<? extends Component> view, RouteParameters routeParameters) { @@ -398,6 +405,7 @@ public String getPath() { * @param queryParameters * the query parameters object, or {@code null} to remove * existing query parameters + * @since 24.2 */ public void setQueryParameters(QueryParameters queryParameters) { this.queryParameters = queryParameters; @@ -409,6 +417,7 @@ public void setQueryParameters(QueryParameters queryParameters) { * Gets the path aliases for this item. * * @return the path aliases for this item, empty if none + * @since 24.2 */ public Set<String> getPathAliases() { ArrayNode pathAliases = (ArrayNode) getElement() @@ -429,6 +438,7 @@ public Set<String> getPathAliases() { * * @param pathAliases * the path aliases to set to this item + * @since 24.2 */ public void setPathAliases(Set<String> pathAliases) { if (pathAliases == null || pathAliases.isEmpty()) { @@ -448,6 +458,7 @@ public void setPathAliases(Set<String> pathAliases) { * Gets the target of this item. * * @return the target of this item + * @since 24.4 */ public String getTarget() { return getElement().getProperty("target"); @@ -471,6 +482,7 @@ public String getTarget() { * * @param target * the target of this item + * @since 24.4 */ public void setTarget(String target) { if (target == null) { @@ -485,6 +497,7 @@ public void setTarget(String target) { * * @return true if this item also matches nested paths / routes, false * otherwise + * @since 24.5 */ public boolean isMatchNested() { return getElement().getProperty("matchNested", false); @@ -503,6 +516,7 @@ public boolean isMatchNested() { * * @param value * true to also match nested paths / routes, false otherwise + * @since 24.5 */ public void setMatchNested(boolean value) { getElement().setProperty("matchNested", value); @@ -511,6 +525,7 @@ public void setMatchNested(boolean value) { /** * @return true if this item should be ignored by the Vaadin router and * behave like a regular anchor. + * @since 24.4 */ public boolean isRouterIgnore() { return getElement().getProperty("routerIgnore", false); @@ -525,6 +540,7 @@ public boolean isRouterIgnore() { * @param ignore * true if this item should not be intercepted by the single-page * web application routing mechanism in Vaadin. + * @since 24.4 */ public void setRouterIgnore(boolean ignore) { getElement().setProperty("routerIgnore", ignore); @@ -540,6 +556,7 @@ public void setRouterIgnore(boolean ignore) { * @param openInNewBrowserTab * true if the target URL should be opened in a new browser tab, * false otherwise + * @since 24.4 */ public void setOpenInNewBrowserTab(boolean openInNewBrowserTab) { setTarget(openInNewBrowserTab ? "_blank" : null); @@ -550,6 +567,7 @@ public void setOpenInNewBrowserTab(boolean openInNewBrowserTab) { * * @return true if the target URL should be opened in a new browser tab, * false otherwise + * @since 24.4 */ public boolean isOpenInNewBrowserTab() { return "_blank".equals(getTarget()); diff --git a/vaadin-side-nav-flow-parent/vaadin-side-nav-flow/src/main/java/com/vaadin/flow/component/sidenav/SideNavVariant.java b/vaadin-side-nav-flow-parent/vaadin-side-nav-flow/src/main/java/com/vaadin/flow/component/sidenav/SideNavVariant.java index b5e7b4d8367..e5f085134a6 100644 --- a/vaadin-side-nav-flow-parent/vaadin-side-nav-flow/src/main/java/com/vaadin/flow/component/sidenav/SideNavVariant.java +++ b/vaadin-side-nav-flow-parent/vaadin-side-nav-flow/src/main/java/com/vaadin/flow/component/sidenav/SideNavVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-side-nav} component. + * + * @since 25.0 */ public enum SideNavVariant implements ThemeVariant { AURA_FILLED("filled"); diff --git a/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/DecimalRangeSlider.java b/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/DecimalRangeSlider.java index ce2fe25e17e..c0613e29c47 100644 --- a/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/DecimalRangeSlider.java +++ b/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/DecimalRangeSlider.java @@ -29,6 +29,7 @@ * that supports integer values. * * @author Vaadin Ltd. + * @since 25.2 */ @Tag("vaadin-range-slider") @NpmPackage(value = "@vaadin/slider", version = "25.2.0") diff --git a/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/DecimalRangeSliderValue.java b/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/DecimalRangeSliderValue.java index b7f40eec929..12db4f4f5fe 100644 --- a/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/DecimalRangeSliderValue.java +++ b/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/DecimalRangeSliderValue.java @@ -27,6 +27,7 @@ * the end value of the range * * @author Vaadin Ltd + * @since 25.2 */ public record DecimalRangeSliderValue(Double start, Double end) implements Range<Double> { diff --git a/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/DecimalSlider.java b/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/DecimalSlider.java index 3cb4d641c60..9345b4282d7 100644 --- a/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/DecimalSlider.java +++ b/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/DecimalSlider.java @@ -29,6 +29,7 @@ * values. * * @author Vaadin Ltd. + * @since 25.2 */ @Tag("vaadin-slider") @NpmPackage(value = "@vaadin/slider", version = "25.2.0") diff --git a/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/IntegerRangeSlider.java b/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/IntegerRangeSlider.java index 20d0b6afb6a..e4065ff9147 100644 --- a/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/IntegerRangeSlider.java +++ b/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/IntegerRangeSlider.java @@ -29,6 +29,7 @@ * that supports decimal values. * * @author Vaadin Ltd. + * @since 25.2 */ @Tag("vaadin-range-slider") @NpmPackage(value = "@vaadin/slider", version = "25.2.0") diff --git a/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/IntegerRangeSliderValue.java b/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/IntegerRangeSliderValue.java index 6fec0c96d0b..9fd3a106cce 100644 --- a/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/IntegerRangeSliderValue.java +++ b/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/IntegerRangeSliderValue.java @@ -27,6 +27,7 @@ * the end value of the range * * @author Vaadin Ltd + * @since 25.2 */ public record IntegerRangeSliderValue(Integer start, Integer end) implements Range<Integer> { diff --git a/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/IntegerSlider.java b/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/IntegerSlider.java index ad669183eff..18f7029c5dd 100644 --- a/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/IntegerSlider.java +++ b/vaadin-slider-flow-parent/vaadin-slider-flow/src/main/java/com/vaadin/flow/component/slider/IntegerSlider.java @@ -29,6 +29,7 @@ * values. * * @author Vaadin Ltd. + * @since 25.2 */ @Tag("vaadin-slider") @NpmPackage(value = "@vaadin/slider", version = "25.2.0") diff --git a/vaadin-split-layout-flow-parent/vaadin-split-layout-flow/src/main/java/com/vaadin/flow/component/splitlayout/SplitLayout.java b/vaadin-split-layout-flow-parent/vaadin-split-layout-flow/src/main/java/com/vaadin/flow/component/splitlayout/SplitLayout.java index 52157011453..b68d2380a17 100644 --- a/vaadin-split-layout-flow-parent/vaadin-split-layout-flow/src/main/java/com/vaadin/flow/component/splitlayout/SplitLayout.java +++ b/vaadin-split-layout-flow-parent/vaadin-split-layout-flow/src/main/java/com/vaadin/flow/component/splitlayout/SplitLayout.java @@ -41,6 +41,7 @@ * handle between them. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-split-layout") @NpmPackage(value = "@vaadin/split-layout", version = "25.2.0") @@ -73,6 +74,7 @@ public SplitLayout() { * * @param orientation * the orientation set to the layout + * @since 23.1 */ public SplitLayout(Orientation orientation) { setOrientation(orientation); @@ -113,6 +115,7 @@ public SplitLayout(Component primaryComponent, * the component set to the secondary split * @param orientation * the orientation set to the layout + * @since 23.1 */ public SplitLayout(Component primaryComponent, Component secondaryComponent, Orientation orientation) { @@ -213,6 +216,7 @@ public Component getSecondaryComponent() { * of the {@link SplitterDragEndEvent}. * * @return the splitter position, may be null + * @since 24.2 */ public Double getSplitterPosition() { return splitterPosition; @@ -338,6 +342,9 @@ public void removeAll() { secondaryComponent = null; } + /** + * @since 25.0 + */ @DomEvent("splitter-dragend") public static class SplitterDragEndEvent extends ComponentEvent<SplitLayout> { @@ -365,6 +372,7 @@ public SplitterDragEndEvent(SplitLayout source, boolean fromClient, * @param listener * the listener to add * @return a registration for removing the listener + * @since 25.0 */ public Registration addSplitterDragEndListener( ComponentEventListener<SplitterDragEndEvent> listener) { diff --git a/vaadin-split-layout-flow-parent/vaadin-split-layout-flow/src/main/java/com/vaadin/flow/component/splitlayout/SplitLayoutVariant.java b/vaadin-split-layout-flow-parent/vaadin-split-layout-flow/src/main/java/com/vaadin/flow/component/splitlayout/SplitLayoutVariant.java index 400f69aa2e3..af54fbab853 100644 --- a/vaadin-split-layout-flow-parent/vaadin-split-layout-flow/src/main/java/com/vaadin/flow/component/splitlayout/SplitLayoutVariant.java +++ b/vaadin-split-layout-flow-parent/vaadin-split-layout-flow/src/main/java/com/vaadin/flow/component/splitlayout/SplitLayoutVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-split-layout} component. + * + * @since 1.1 */ public enum SplitLayoutVariant implements ThemeVariant { LUMO_SMALL("small"), diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellSelectionManager.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellSelectionManager.java index e3126fdefcd..ed403e427fc 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellSelectionManager.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellSelectionManager.java @@ -31,6 +31,7 @@ * details of which cells are selected. * * @author Vaadin Ltd. + * @since 23.1 */ @SuppressWarnings("serial") public class CellSelectionManager implements Serializable { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellSelectionShifter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellSelectionShifter.java index 9c0bbec4fb6..dd47dc0d24f 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellSelectionShifter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellSelectionShifter.java @@ -37,6 +37,7 @@ * determined from the existing values. * * @author Vaadin Ltd. + * @since 23.1 */ @SuppressWarnings("serial") public class CellSelectionShifter implements Serializable { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellSet.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellSet.java index acd9f700c40..cd98af2eb44 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellSet.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellSet.java @@ -19,6 +19,8 @@ * <p> * <strong>Internal use only. May be renamed or removed in a future * release.</strong> + * + * @since 25.0 */ public class CellSet extends HashSet<CellReference> { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellValueFormatter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellValueFormatter.java index 3b28a4539f5..557d0bca0b5 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellValueFormatter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellValueFormatter.java @@ -17,6 +17,8 @@ /** * Utility class for formatting cell values + * + * @since 23.1 */ public class CellValueFormatter implements Serializable { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellValueManager.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellValueManager.java index 73de21ef02e..832d225afbb 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellValueManager.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/CellValueManager.java @@ -67,6 +67,7 @@ * values and formatting for individual cells. * * @author Vaadin Ltd. + * @since 23.1 */ @SuppressWarnings("serial") public class CellValueManager implements Serializable { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ChartCreator.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ChartCreator.java index c5b6cf9c6fa..d0a6b45575c 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ChartCreator.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ChartCreator.java @@ -14,6 +14,9 @@ import com.vaadin.flow.component.Component; +/** + * @since 23.1 + */ public interface ChartCreator extends Serializable { /** diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ColorConverter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ColorConverter.java index 47dc555a163..e202c1efbcd 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ColorConverter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ColorConverter.java @@ -21,6 +21,8 @@ * <p> * This interface has been created because the POI implementations differ quite * a lot. + * + * @since 23.1 */ public interface ColorConverter extends Serializable { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ColorConverterUtil.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ColorConverterUtil.java index 5c7770804c4..10fc42f9691 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ColorConverterUtil.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ColorConverterUtil.java @@ -10,6 +10,9 @@ import java.io.Serializable; +/** + * @since 23.1 + */ public class ColorConverterUtil implements Serializable { public static String toRGBA(byte[] argb) { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ConditionalFormatter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ConditionalFormatter.java index 9abfed3430a..f9ff244c310 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ConditionalFormatter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ConditionalFormatter.java @@ -70,6 +70,7 @@ * For now, only XSSF formatting rules are supported because of bugs in POI. * * @author Thomas Mattsson / Vaadin Ltd. + * @since 23.1 */ @SuppressWarnings("serial") public class ConditionalFormatter implements Serializable { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ContextMenuManager.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ContextMenuManager.java index a5928178fc0..c1906bbb364 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ContextMenuManager.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ContextMenuManager.java @@ -30,6 +30,7 @@ * tied to. * * @author Vaadin Ltd. + * @since 23.1 */ @SuppressWarnings("serial") public class ContextMenuManager implements Serializable { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/DefaultHyperlinkCellClickHandler.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/DefaultHyperlinkCellClickHandler.java index 1b9d80b9e55..08702a012d4 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/DefaultHyperlinkCellClickHandler.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/DefaultHyperlinkCellClickHandler.java @@ -28,7 +28,7 @@ * external URLs. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ @SuppressWarnings("serial") public class DefaultHyperlinkCellClickHandler diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/FormulaFormatter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/FormulaFormatter.java index 832d3f9b983..13f1f80ae18 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/FormulaFormatter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/FormulaFormatter.java @@ -24,6 +24,8 @@ * <p> * This is needed because internally POI only handles formulas with '.' as the * decimal separator, and ',' as the argument separator. + * + * @since 23.1 */ public class FormulaFormatter implements Serializable { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/HSSFColorConverter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/HSSFColorConverter.java index 64d9cd51898..c25917ea2e1 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/HSSFColorConverter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/HSSFColorConverter.java @@ -23,7 +23,7 @@ * POI terms). * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ @SuppressWarnings("serial") public class HSSFColorConverter implements ColorConverter { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ItemFilter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ItemFilter.java index 46fd9d5e39f..83e12520bef 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ItemFilter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/ItemFilter.java @@ -33,6 +33,8 @@ * <p> * Has a check box for selecting all items (cell values), and one check box per * unique cell value that can be found within the cells of the table column. + * + * @since 23.1 */ @SuppressWarnings("serial") public class ItemFilter extends Div implements SpreadsheetFilter { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/PopupButton.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/PopupButton.java index c7b995f3360..4a0caa9a4fb 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/PopupButton.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/PopupButton.java @@ -41,6 +41,7 @@ * parameter to one of the previously mentioned methods. * * @author Vaadin Ltd. + * @since 23.1 */ @SuppressWarnings("serial") @Tag("div") diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SheetChartWrapper.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SheetChartWrapper.java index 793bcc55605..fd53dab9158 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SheetChartWrapper.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SheetChartWrapper.java @@ -28,6 +28,7 @@ * state, position and size. * * @author Vaadin Ltd. + * @since 23.1 */ @SuppressWarnings("serial") public class SheetChartWrapper extends SheetOverlayWrapper diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SheetImageWrapper.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SheetImageWrapper.java index ff287076867..dff92954680 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SheetImageWrapper.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SheetImageWrapper.java @@ -24,6 +24,7 @@ * state, position and size. * * @author Vaadin Ltd. + * @since 23.1 */ @SuppressWarnings("serial") public class SheetImageWrapper extends SheetOverlayWrapper @@ -45,6 +46,7 @@ public SheetImageWrapper(ClientAnchor anchor, String MIMEType, * Gets the resource containing this image * * @return Image resource + * @since 24.8 */ @Override public DownloadHandler getResourceHandler() { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SheetOverlayWrapper.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SheetOverlayWrapper.java index 9cf348d1827..1b3276d4cab 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SheetOverlayWrapper.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SheetOverlayWrapper.java @@ -20,6 +20,9 @@ import com.vaadin.flow.component.spreadsheet.client.OverlayInfo; import com.vaadin.flow.server.streams.DownloadHandler; +/** + * @since 23.1 + */ @SuppressWarnings("serial") public abstract class SheetOverlayWrapper implements Serializable { @@ -281,6 +284,7 @@ public ClientAnchor getAnchor() { * Gets the handler serving this image * * @return Image resource + * @since 24.8 */ public DownloadHandler getResourceHandler() { return null; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/Spreadsheet.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/Spreadsheet.java index 20b1c9b9555..f6aff48f769 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/Spreadsheet.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/Spreadsheet.java @@ -116,6 +116,7 @@ * web browsers. * * @author Vaadin Ltd. + * @since 23.1 */ @Tag("vaadin-spreadsheet") @JsModule("./vaadin-spreadsheet/vaadin-spreadsheet.js") @@ -1247,6 +1248,7 @@ private void updateAppId() { * the default / previously set spreadsheet handler. * * @param spreadsheetHandler + * @since 24.9.2 */ public void setSpreadsheetHandler( SpreadsheetHandlerImpl spreadsheetHandler) { @@ -1261,6 +1263,7 @@ public void setSpreadsheetHandler( * Create the default Spreadsheet handler. * * @return SpreadsheetHandlerImpl + * @since 24.9.2 */ protected SpreadsheetHandlerImpl createDefaultHandler() { return new SpreadsheetHandlerImpl(this); @@ -1528,6 +1531,7 @@ public int getLastFrozenColumn() { * * @see #setChartsEnabled(boolean) * @return + * @since 24.0 */ public boolean isChartsEnabled() { return chartsEnabled; @@ -1538,6 +1542,7 @@ public boolean isChartsEnabled() { * the spreadsheet or not. * * @param chartsEnabled + * @since 24.0 */ public void setChartsEnabled(boolean chartsEnabled) { this.chartsEnabled = chartsEnabled; @@ -1564,6 +1569,7 @@ public boolean isRerenderPending() { * @param showCustomEditorOnFocus * a boolean indicating whether the custom editor should be * visible on focus (true) or not (false) + * @since 24.8 */ public void setShowCustomEditorOnFocus(boolean showCustomEditorOnFocus) { getElement().setProperty("showCustomEditorOnFocus", @@ -1575,6 +1581,7 @@ public void setShowCustomEditorOnFocus(boolean showCustomEditorOnFocus) { * * @return a boolean indicating whether the custom editor is visible on * focus (true) or not (false) + * @since 24.8 */ public boolean isShowCustomEditorOnFocus() { return getElement().getProperty("showCustomEditorOnFocus", false); @@ -3928,6 +3935,7 @@ public boolean isCellHidden(Cell cell) { * @param cellAddress * The address of the cell to check * @return true if the cell is locked, false otherwise + * @since 24.8.8 */ public boolean isCellLocked(CellAddress cellAddress) { // Locking cells only works if the sheet is protected @@ -4926,6 +4934,7 @@ && getElement().equals(element.getParent())) { * * @param customComponentFactory * The new component factory to use. + * @since 24.0 */ public void setSpreadsheetComponentFactory( SpreadsheetComponentFactory customComponentFactory) { @@ -6270,6 +6279,7 @@ public Registration addRowHeaderDoubleClickListener( * * @param theme * SpreadsheetTheme + * @since 24.5 */ public void setTheme(SpreadsheetTheme theme) { getElement().setAttribute("theme", theme.getThemeName()); @@ -6277,6 +6287,8 @@ public void setTheme(SpreadsheetTheme theme) { /** * Themes for the Spreadsheet. + * + * @since 24.5 */ public enum SpreadsheetTheme { LUMO("lumo"), VALO(""); diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetComponentFactory.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetComponentFactory.java index 9df40ce484c..f55611282a3 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetComponentFactory.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetComponentFactory.java @@ -47,6 +47,7 @@ * WARN level. A failing cell will not prevent other cells from loading. * * @author Vaadin Ltd. + * @since 24.0 */ public interface SpreadsheetComponentFactory extends Serializable { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetEventListener.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetEventListener.java index 2f35877040e..a8dbe6f6b0c 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetEventListener.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetEventListener.java @@ -18,6 +18,9 @@ import tools.jackson.databind.JsonNode; import tools.jackson.databind.node.ArrayNode; +/** + * @since 23.1 + */ @SuppressWarnings("serial") public class SpreadsheetEventListener implements ComponentEventListener<Spreadsheet.SpreadsheetEvent> { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetFactory.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetFactory.java index e680aff2b4b..37021d1eecd 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetFactory.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetFactory.java @@ -78,6 +78,7 @@ * data. * * @author Vaadin Ltd. + * @since 23.1 */ @SuppressWarnings("serial") public class SpreadsheetFactory implements Serializable { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetFilter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetFilter.java index bac72b35e24..0d1ffe53f07 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetFilter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetFilter.java @@ -25,6 +25,7 @@ * {@link SpreadsheetFilterTable#onFiltersUpdated()} should be called. * * @author Vaadin Ltd. + * @since 23.1 */ public interface SpreadsheetFilter extends Serializable { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetFilterTable.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetFilterTable.java index de772601a96..d4741c3a258 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetFilterTable.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetFilterTable.java @@ -40,6 +40,7 @@ * clears all the filters for that column (contained within the same pop-up). * * @author Vaadin Ltd. + * @since 23.1 */ @SuppressWarnings("serial") public class SpreadsheetFilterTable extends SpreadsheetTable { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetHandlerImpl.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetHandlerImpl.java index 86857e6bc8e..5493f2491e8 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetHandlerImpl.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetHandlerImpl.java @@ -37,6 +37,8 @@ /** * Implementation of the Spreadsheet Server RPC interface. + * + * @since 23.1 */ @SuppressWarnings("serial") public class SpreadsheetHandlerImpl implements SpreadsheetServerRpc { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetHistoryManager.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetHistoryManager.java index 0e10d6659de..92cc9c00bbf 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetHistoryManager.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetHistoryManager.java @@ -24,6 +24,7 @@ * to allow the user to undo and redo any action. * * @author Vaadin Ltd. + * @since 23.1 */ @SuppressWarnings("serial") public class SpreadsheetHistoryManager implements Serializable { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetStyleFactory.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetStyleFactory.java index e2446fecae1..14cea20cfdd 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetStyleFactory.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetStyleFactory.java @@ -45,6 +45,7 @@ * This class handles converting Apache POI CellStyles to CSS styles. * * @author Vaadin Ltd. + * @since 23.1 */ @SuppressWarnings("serial") public class SpreadsheetStyleFactory implements Serializable { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetTable.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetTable.java index 0e1eb9daaba..772fc90f899 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetTable.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetTable.java @@ -32,6 +32,7 @@ * cells refer to the cells on the first row of the region. * * @author Vaadin Ltd. + * @since 23.1 */ @SuppressWarnings("serial") public class SpreadsheetTable implements Serializable { @@ -92,6 +93,7 @@ public SpreadsheetTable(Spreadsheet spreadsheet, Sheet sheet, * XSSFSheet.getCTWorksheet().getAutoFilter() * @param xssfTable * Set this to not-null if this table is backed by a XSSFTable + * @since 24.3 */ public SpreadsheetTable(Spreadsheet spreadsheet, Sheet sheet, CellRangeAddress fullTableRegion, @@ -292,6 +294,7 @@ public Collection<PopupButton> getPopupButtons() { * * @param ctWorksheetAutoFilter * Referenced autofilter. + * @since 24.2.4 */ protected void setCtWorksheetAutoFilter( CTAutoFilter ctWorksheetAutoFilter) { @@ -302,6 +305,7 @@ protected void setCtWorksheetAutoFilter( * @return Returns the CTAutoFilter object that represents this table in the * underlying POI model. Can be null if this table is not backed by * a Worksheet CTAutoFilter. + * @since 24.2.4 */ public CTAutoFilter getCtWorksheetAutoFilter() { return ctWorksheetAutoFilter; @@ -313,6 +317,7 @@ public CTAutoFilter getCtWorksheetAutoFilter() { * * @param xssfTable * Referenced table. + * @since 24.2.4 */ protected void setXssfTable(XSSFTable xssfTable) { this.xssfTable = xssfTable; @@ -322,6 +327,7 @@ protected void setXssfTable(XSSFTable xssfTable) { * @return Returns the XSSFTable object that represents this table in the * underlying POI model. Can be null if this table is not backed by * a XSSFTable. + * @since 24.2.4 */ public XSSFTable getXssfTable() { return xssfTable; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetUtil.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetUtil.java index 07790e9eb83..dab3047ee0f 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetUtil.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/SpreadsheetUtil.java @@ -41,7 +41,7 @@ * Utility class for miscellaneous Spreadsheet operations. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ @SuppressWarnings("serial") public class SpreadsheetUtil implements Serializable { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/XSSFColorConverter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/XSSFColorConverter.java index 8b931a4889e..18079915fe5 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/XSSFColorConverter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/XSSFColorConverter.java @@ -37,7 +37,7 @@ * in POI terms). * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ @SuppressWarnings("serial") public class XSSFColorConverter implements ColorConverter { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/DeleteRowAction.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/DeleteRowAction.java index f7cc31485b3..227350c5d8e 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/DeleteRowAction.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/DeleteRowAction.java @@ -18,7 +18,7 @@ * Spreadsheet action for deleting a single row. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ @SuppressWarnings("serial") public class DeleteRowAction extends SpreadsheetAction { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/DeleteTableAction.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/DeleteTableAction.java index 59cfdda8741..2916487cd38 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/DeleteTableAction.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/DeleteTableAction.java @@ -22,7 +22,7 @@ * Spreadsheet action for deleting a SpreadsheetTable. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ @SuppressWarnings("serial") public class DeleteTableAction extends SpreadsheetAction { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/EditCellCommentAction.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/EditCellCommentAction.java index c97fab5399b..fccd4e79031 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/EditCellCommentAction.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/EditCellCommentAction.java @@ -20,7 +20,7 @@ * Spreadsheet action for inserting or deleting a comment to a cell. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ @SuppressWarnings("serial") public class EditCellCommentAction extends SpreadsheetAction { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/HideHeaderAction.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/HideHeaderAction.java index ec4d3cc562d..19d9a0fe9bf 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/HideHeaderAction.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/HideHeaderAction.java @@ -18,7 +18,7 @@ * Spreadsheet action for hiding a single row or column. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ @SuppressWarnings("serial") public class HideHeaderAction extends SpreadsheetAction { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/InsertDeleteCellCommentAction.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/InsertDeleteCellCommentAction.java index e006606bf63..55819a132ae 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/InsertDeleteCellCommentAction.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/InsertDeleteCellCommentAction.java @@ -27,7 +27,7 @@ * Spreadsheet action for inserting or deleting a comment to a cell. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ @SuppressWarnings("serial") public class InsertDeleteCellCommentAction extends SpreadsheetAction { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/InsertNewRowAction.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/InsertNewRowAction.java index 677aad8b52a..d7bb50b875b 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/InsertNewRowAction.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/InsertNewRowAction.java @@ -18,7 +18,7 @@ * Spreadsheet action for inserting a new row to the sheet. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ @SuppressWarnings("serial") public class InsertNewRowAction extends SpreadsheetAction { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/InsertTableAction.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/InsertTableAction.java index f1e10fc8a20..a9e1fea1cee 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/InsertTableAction.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/InsertTableAction.java @@ -22,7 +22,7 @@ * Spreadsheet action for inserting a new SpreadsheetTable. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 * */ @SuppressWarnings("serial") diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/MergeCellsAction.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/MergeCellsAction.java index 2b48909594a..2ea5d0b1e67 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/MergeCellsAction.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/MergeCellsAction.java @@ -21,7 +21,7 @@ * Spreadsheet action for merging two or more cells. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ @SuppressWarnings("serial") public class MergeCellsAction extends SpreadsheetAction { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/ShowHideCellCommentAction.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/ShowHideCellCommentAction.java index b0aedd91a39..6960f6eaab2 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/ShowHideCellCommentAction.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/ShowHideCellCommentAction.java @@ -23,7 +23,7 @@ * Spreadsheet action for showing or hiding a cell comment. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ @SuppressWarnings("serial") public class ShowHideCellCommentAction extends SpreadsheetAction { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/SpreadsheetAction.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/SpreadsheetAction.java index 7ba711a2b20..ebb8920bedb 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/SpreadsheetAction.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/SpreadsheetAction.java @@ -20,7 +20,7 @@ * Abstract base class for Spreadsheet actions. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ @SuppressWarnings("serial") public abstract class SpreadsheetAction extends Action { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/SpreadsheetDefaultActionHandler.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/SpreadsheetDefaultActionHandler.java index dcb6af2854b..b8982927eab 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/SpreadsheetDefaultActionHandler.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/SpreadsheetDefaultActionHandler.java @@ -22,7 +22,7 @@ * all available actions to the Spreadsheet. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 * */ @SuppressWarnings("serial") diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/UnHideHeadersAction.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/UnHideHeadersAction.java index aed4de58987..7aaba17af17 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/UnHideHeadersAction.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/UnHideHeadersAction.java @@ -18,7 +18,7 @@ * Spreadsheet action for showing hidden columns or rows. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ @SuppressWarnings("serial") public class UnHideHeadersAction extends SpreadsheetAction { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/UnMergeCellsAction.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/UnMergeCellsAction.java index 53913fd9d6a..dfeff2a533a 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/UnMergeCellsAction.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/action/UnMergeCellsAction.java @@ -20,7 +20,7 @@ * Spreadsheet action for breaking a merged cell into its constituents. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ @SuppressWarnings("serial") public class UnMergeCellsAction extends SpreadsheetAction { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/DefaultChartCreator.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/DefaultChartCreator.java index be042a17e35..b489c453a02 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/DefaultChartCreator.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/DefaultChartCreator.java @@ -21,6 +21,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.confwriter.SelectListeningDataSeries; import com.vaadin.flow.component.spreadsheet.charts.converter.xssfreader.XSSFChartReader; +/** + * @since 24.0 + */ public class DefaultChartCreator implements ChartCreator { private ChartDataToVaadinConfigWriter chartDataToVaadinConfigWriter; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/Utils.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/Utils.java index 8f19453a192..34f85ec852f 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/Utils.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/Utils.java @@ -24,6 +24,9 @@ import com.vaadin.flow.component.spreadsheet.Spreadsheet; +/** + * @since 24.0 + */ public class Utils { private static final Logger LOGGER = Logger .getLogger(Utils.class.getName()); diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/AbstractSeriesData.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/AbstractSeriesData.java index 7ebe7d7c254..340229fba3d 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/AbstractSeriesData.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/AbstractSeriesData.java @@ -13,6 +13,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.confwriter.AbstractSeriesDataWriter; +/** + * @since 24.0 + */ public abstract class AbstractSeriesData { public static class SeriesPoint { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/AreaSeriesData.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/AreaSeriesData.java index 67a675c9510..19d81b8d486 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/AreaSeriesData.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/AreaSeriesData.java @@ -11,6 +11,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.confwriter.AbstractSeriesDataWriter; import com.vaadin.flow.component.spreadsheet.charts.converter.confwriter.AreaSeriesDataWriter; +/** + * @since 24.0 + */ public class AreaSeriesData extends LineSeriesData { public Stacking stacking = Stacking.NONE; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/BarSeriesData.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/BarSeriesData.java index 357d38fd080..2688ddfb867 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/BarSeriesData.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/BarSeriesData.java @@ -11,6 +11,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.confwriter.AbstractSeriesDataWriter; import com.vaadin.flow.component.spreadsheet.charts.converter.confwriter.BarSeriesDataWriter; +/** + * @since 24.0 + */ public class BarSeriesData extends ColumnSeriesData { @Override diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/BubbleSeriesData.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/BubbleSeriesData.java index 45fe0d6bbed..831165d94d7 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/BubbleSeriesData.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/BubbleSeriesData.java @@ -14,6 +14,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.confwriter.AbstractSeriesDataWriter; import com.vaadin.flow.component.spreadsheet.charts.converter.confwriter.BubbleSeriesDataWriter; +/** + * @since 24.0 + */ public class BubbleSeriesData extends AbstractSeriesData { public List<Number> bubbleSizes; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/ChartData.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/ChartData.java index 3d396b8b52b..5a67edae026 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/ChartData.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/ChartData.java @@ -12,6 +12,9 @@ import java.util.SortedMap; import java.util.TreeMap; +/** + * @since 24.0 + */ public class ChartData { public String title; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/ColumnSeriesData.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/ColumnSeriesData.java index 1b40a184cc1..c243339ac56 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/ColumnSeriesData.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/ColumnSeriesData.java @@ -11,6 +11,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.confwriter.AbstractSeriesDataWriter; import com.vaadin.flow.component.spreadsheet.charts.converter.confwriter.ColumnSeriesDataWriter; +/** + * @since 24.0 + */ public class ColumnSeriesData extends AbstractSeriesData { public Stacking stacking = Stacking.NONE; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/LineSeriesData.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/LineSeriesData.java index 8f008785436..4de32dbc0d2 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/LineSeriesData.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/LineSeriesData.java @@ -11,6 +11,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.confwriter.AbstractSeriesDataWriter; import com.vaadin.flow.component.spreadsheet.charts.converter.confwriter.LineSeriesDataWriter; +/** + * @since 24.0 + */ public class LineSeriesData extends AbstractSeriesData { /* diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/PieSeriesData.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/PieSeriesData.java index ec779442d22..604f0cb6a32 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/PieSeriesData.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/PieSeriesData.java @@ -11,6 +11,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.confwriter.AbstractSeriesDataWriter; import com.vaadin.flow.component.spreadsheet.charts.converter.confwriter.PieSeriesDataWriter; +/** + * @since 24.0 + */ public class PieSeriesData extends AbstractSeriesData { public boolean isExploded; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/RadarSeriesData.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/RadarSeriesData.java index 5dd8d001c3e..36301b0c903 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/RadarSeriesData.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/RadarSeriesData.java @@ -11,6 +11,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.confwriter.AreaSeriesDataWriter; import com.vaadin.flow.component.spreadsheet.charts.converter.confwriter.RadarSeriesWriter; +/** + * @since 24.0 + */ public class RadarSeriesData extends AreaSeriesData { @Override diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/ScatterSeriesData.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/ScatterSeriesData.java index dfbab7128a8..5133d7aeb7d 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/ScatterSeriesData.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/ScatterSeriesData.java @@ -10,6 +10,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.confwriter.ScatterSeriesDataWriter; +/** + * @since 24.0 + */ public class ScatterSeriesData extends LineSeriesData { @Override diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/SplineSeriesData.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/SplineSeriesData.java index 2cfa96195b8..9fb8f0e090e 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/SplineSeriesData.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/SplineSeriesData.java @@ -10,6 +10,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.confwriter.SplineSeriesDataWriter; +/** + * @since 24.0 + */ public class SplineSeriesData extends LineSeriesData { @Override diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/Stacking.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/Stacking.java index e1a19301d9e..682c17da7ff 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/Stacking.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/chartdata/Stacking.java @@ -8,6 +8,9 @@ */ package com.vaadin.flow.component.spreadsheet.charts.converter.chartdata; +/** + * @since 24.0 + */ public enum Stacking { NONE, NORMAL, PERCENT; } diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/AbstractSeriesDataWriter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/AbstractSeriesDataWriter.java index 04fcd2a5ed2..0101f17a78e 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/AbstractSeriesDataWriter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/AbstractSeriesDataWriter.java @@ -18,6 +18,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.AbstractSeriesData.DataUpdateListener; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.AbstractSeriesData.SeriesPoint; +/** + * @since 24.0 + */ public abstract class AbstractSeriesDataWriter { private final AbstractSeriesData series; private AbstractPlotOptions plotOptions; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/AreaSeriesDataWriter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/AreaSeriesDataWriter.java index bf5ae858451..479ba9ce64c 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/AreaSeriesDataWriter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/AreaSeriesDataWriter.java @@ -15,6 +15,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.Utils; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.AreaSeriesData; +/** + * @since 24.0 + */ public class AreaSeriesDataWriter extends AbstractSeriesDataWriter { public AreaSeriesDataWriter(AreaSeriesData series) { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/BarSeriesDataWriter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/BarSeriesDataWriter.java index 9c6c8dddda7..df4140be03d 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/BarSeriesDataWriter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/BarSeriesDataWriter.java @@ -15,6 +15,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.Utils; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.BarSeriesData; +/** + * @since 24.0 + */ public class BarSeriesDataWriter extends AbstractSeriesDataWriter { public BarSeriesDataWriter(BarSeriesData series) { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/BubbleSeriesDataWriter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/BubbleSeriesDataWriter.java index 650b727690b..f4e224920ee 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/BubbleSeriesDataWriter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/BubbleSeriesDataWriter.java @@ -15,6 +15,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.AbstractSeriesData; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.AbstractSeriesData.SeriesPoint; +/** + * @since 24.0 + */ public class BubbleSeriesDataWriter extends AbstractSeriesDataWriter { public BubbleSeriesDataWriter(AbstractSeriesData series) { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/ChartDataToVaadinConfigWriter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/ChartDataToVaadinConfigWriter.java index 84398a0b83f..74b502a396a 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/ChartDataToVaadinConfigWriter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/ChartDataToVaadinConfigWriter.java @@ -44,6 +44,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.ChartData.TitleProperties; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.ChartData.View3dData; +/** + * @since 24.0 + */ @SuppressWarnings("serial") public class ChartDataToVaadinConfigWriter { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/ColumnSeriesDataWriter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/ColumnSeriesDataWriter.java index 8e860415e6d..4ee0a5671ad 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/ColumnSeriesDataWriter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/ColumnSeriesDataWriter.java @@ -15,6 +15,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.Utils; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.ColumnSeriesData; +/** + * @since 24.0 + */ public class ColumnSeriesDataWriter extends AbstractSeriesDataWriter { public ColumnSeriesDataWriter(ColumnSeriesData series) { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/LineSeriesDataWriter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/LineSeriesDataWriter.java index c1337654a43..f04ba61791e 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/LineSeriesDataWriter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/LineSeriesDataWriter.java @@ -13,6 +13,9 @@ import com.vaadin.flow.component.charts.model.PlotOptionsLine; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.LineSeriesData; +/** + * @since 24.0 + */ public class LineSeriesDataWriter extends AbstractSeriesDataWriter { public LineSeriesDataWriter(LineSeriesData series) { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/LineSeriesWriterUtils.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/LineSeriesWriterUtils.java index 19a3c3c1475..9934d77f323 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/LineSeriesWriterUtils.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/LineSeriesWriterUtils.java @@ -13,6 +13,9 @@ import com.vaadin.flow.component.charts.model.MarkerSymbolEnum; import com.vaadin.flow.component.spreadsheet.charts.converter.Utils; +/** + * @since 24.0 + */ public class LineSeriesWriterUtils { public static Marker getMarker(String markerSymbol) { if (markerSymbol.isEmpty()) diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/PieSeriesDataWriter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/PieSeriesDataWriter.java index 4c32aa759d1..f5f66310c7f 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/PieSeriesDataWriter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/PieSeriesDataWriter.java @@ -15,6 +15,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.AbstractSeriesData.SeriesPoint; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.PieSeriesData; +/** + * @since 24.0 + */ public class PieSeriesDataWriter extends AbstractSeriesDataWriter { public PieSeriesDataWriter(PieSeriesData series) { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/PieToDonutConverter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/PieToDonutConverter.java index 7e368d3c635..f87598f151f 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/PieToDonutConverter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/PieToDonutConverter.java @@ -15,6 +15,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.ChartData; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.PieSeriesData; +/** + * @since 24.0 + */ public class PieToDonutConverter { private static final double DONUT_GAP_BETWEEN_RINGS = 0.02; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/RadarSeriesWriter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/RadarSeriesWriter.java index c1d9cf198ff..d78a7dfc820 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/RadarSeriesWriter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/RadarSeriesWriter.java @@ -16,6 +16,9 @@ import com.vaadin.flow.component.charts.model.style.Style; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.RadarSeriesData; +/** + * @since 24.0 + */ public class RadarSeriesWriter extends AreaSeriesDataWriter { public RadarSeriesWriter(RadarSeriesData series) { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/ScatterSeriesDataWriter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/ScatterSeriesDataWriter.java index 5a4eb307512..ecf09fbb7f7 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/ScatterSeriesDataWriter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/ScatterSeriesDataWriter.java @@ -12,6 +12,9 @@ import com.vaadin.flow.component.charts.model.PlotOptionsScatter; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.ScatterSeriesData; +/** + * @since 24.0 + */ public class ScatterSeriesDataWriter extends AbstractSeriesDataWriter { private static final int SCATTER_LINE_WIDTH = 2; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/SelectListeningDataSeries.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/SelectListeningDataSeries.java index 25baa68a784..61d6c9d57e2 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/SelectListeningDataSeries.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/SelectListeningDataSeries.java @@ -10,6 +10,9 @@ import com.vaadin.flow.component.charts.model.DataSeries; +/** + * @since 24.0 + */ @SuppressWarnings("serial") public class SelectListeningDataSeries extends DataSeries { public static interface SelectListener { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/SplineSeriesDataWriter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/SplineSeriesDataWriter.java index 6b2cf71601d..49da9d4d902 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/SplineSeriesDataWriter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/confwriter/SplineSeriesDataWriter.java @@ -12,6 +12,9 @@ import com.vaadin.flow.component.charts.model.PlotOptionsSpline; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.SplineSeriesData; +/** + * @since 24.0 + */ public class SplineSeriesDataWriter extends AbstractSeriesDataWriter { public SplineSeriesDataWriter(SplineSeriesData series) { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/AbstractSeriesReader.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/AbstractSeriesReader.java index 1f26f064359..6a55558720f 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/AbstractSeriesReader.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/AbstractSeriesReader.java @@ -33,6 +33,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.AbstractSeriesData.DataSelectListener; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.AbstractSeriesData.SeriesPoint; +/** + * @since 24.0 + */ public abstract class AbstractSeriesReader<CT_SER_TYPE extends XmlObject, SERIES_DATA_TYPE extends AbstractSeriesData> { private final XmlObject ctChart; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/AreaSeriesReader.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/AreaSeriesReader.java index bd370029b51..729b00a0e09 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/AreaSeriesReader.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/AreaSeriesReader.java @@ -16,6 +16,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.AreaSeriesData; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.Stacking; +/** + * @since 24.0 + */ public class AreaSeriesReader extends AbstractSeriesReader<CTAreaSer, AreaSeriesData> { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/BarSeriesReader.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/BarSeriesReader.java index c60177b87a9..cfc68aa5ed1 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/BarSeriesReader.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/BarSeriesReader.java @@ -22,6 +22,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.ColumnSeriesData; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.Stacking; +/** + * @since 24.0 + */ public class BarSeriesReader extends AbstractSeriesReader<CTBarSer, ColumnSeriesData> { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/BubbleSeriesReader.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/BubbleSeriesReader.java index 604037f43e8..bee6c30e960 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/BubbleSeriesReader.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/BubbleSeriesReader.java @@ -23,6 +23,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.AbstractSeriesData.SeriesPoint; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.BubbleSeriesData; +/** + * @since 24.0 + */ public class BubbleSeriesReader extends AbstractSeriesReader<CTBubbleSer, BubbleSeriesData> { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/CTSerAdapter.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/CTSerAdapter.java index 75e93752ed5..ed137cf654c 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/CTSerAdapter.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/CTSerAdapter.java @@ -19,6 +19,8 @@ * This is an adapter for CT*Ser classes to use reflection to call some common * methods, as they don't declare implementing a common interface, although * share many methods. + * + * @since 24.0 */ public class CTSerAdapter { private XmlObject ctSer; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/GenericSeriesReader.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/GenericSeriesReader.java index b5ef00105f6..3fe0cd3e797 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/GenericSeriesReader.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/GenericSeriesReader.java @@ -19,6 +19,8 @@ /** * Can be used to test reading of a new chart type or as a temporary means to * see the data. + * + * @since 24.0 */ @SuppressWarnings("rawtypes") public class GenericSeriesReader extends AbstractSeriesReader { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/LineSeriesReader.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/LineSeriesReader.java index ac3d4ff3fab..2a0268e3796 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/LineSeriesReader.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/LineSeriesReader.java @@ -15,6 +15,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.LineSeriesData; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.SplineSeriesData; +/** + * @since 24.0 + */ public class LineSeriesReader extends AbstractSeriesReader<CTLineSer, LineSeriesData> { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/LineSeriesReaderUtils.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/LineSeriesReaderUtils.java index 66aa5e644c0..586c154f450 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/LineSeriesReaderUtils.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/LineSeriesReaderUtils.java @@ -18,6 +18,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.LineSeriesData; +/** + * @since 24.0 + */ public class LineSeriesReaderUtils { public static void setDashStyleForData(LineSeriesData seriesData, CTShapeProperties ctShapeProperties) { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/PieSeriesReader.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/PieSeriesReader.java index e643fc4d730..19e3b950e4c 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/PieSeriesReader.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/PieSeriesReader.java @@ -16,6 +16,9 @@ import com.vaadin.flow.component.spreadsheet.Spreadsheet; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.PieSeriesData; +/** + * @since 24.0 + */ public class PieSeriesReader extends AbstractSeriesReader<CTPieSer, PieSeriesData> { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/RadarSeriesReader.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/RadarSeriesReader.java index 9779b03b63b..892c6f1cbd0 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/RadarSeriesReader.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/RadarSeriesReader.java @@ -15,6 +15,9 @@ import com.vaadin.flow.component.spreadsheet.Spreadsheet; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.RadarSeriesData; +/** + * @since 24.0 + */ public class RadarSeriesReader extends AbstractSeriesReader<CTRadarSer, RadarSeriesData> { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/ScatterSeriesReader.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/ScatterSeriesReader.java index e16fd8789f4..5fdf3aeaa18 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/ScatterSeriesReader.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/ScatterSeriesReader.java @@ -23,6 +23,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.AbstractSeriesData.SeriesPoint; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.ScatterSeriesData; +/** + * @since 24.0 + */ public class ScatterSeriesReader extends AbstractSeriesReader<CTScatterSer, ScatterSeriesData> { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/XSSFChartReader.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/XSSFChartReader.java index a26333892bb..3aa5d34eaa3 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/XSSFChartReader.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/charts/converter/xssfreader/XSSFChartReader.java @@ -42,6 +42,9 @@ import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.ChartData.LegendPosition; import com.vaadin.flow.component.spreadsheet.charts.converter.chartdata.ChartData.LegendProperties; +/** + * @since 24.0 + */ @SuppressWarnings("serial") public class XSSFChartReader { private final XSSFChart xssfChart; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/CellData.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/CellData.java index ddb12b3bc7c..b44ca0538c2 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/CellData.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/CellData.java @@ -12,6 +12,9 @@ import com.fasterxml.jackson.annotation.JsonInclude; +/** + * @since 23.1 + */ @SuppressWarnings("serial") public class CellData implements Serializable { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/GroupingHandler.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/GroupingHandler.java index e52e5e12b69..103580a3034 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/GroupingHandler.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/GroupingHandler.java @@ -8,6 +8,9 @@ */ package com.vaadin.flow.component.spreadsheet.client; +/** + * @since 23.1 + */ public interface GroupingHandler { void setGroupingCollapsed(boolean cols, int colIndex, boolean collapsed); diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/MergedRegion.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/MergedRegion.java index 0416fe5264e..9b2d6b820b5 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/MergedRegion.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/MergedRegion.java @@ -10,6 +10,9 @@ import java.io.Serializable; +/** + * @since 23.1 + */ @SuppressWarnings("serial") public class MergedRegion implements Serializable { public int id; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/MergedRegionUtil.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/MergedRegionUtil.java index 28c485b6c15..50ef836d60f 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/MergedRegionUtil.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/MergedRegionUtil.java @@ -10,6 +10,9 @@ import java.io.Serializable; +/** + * @since 23.1 + */ public class MergedRegionUtil { public interface MergedRegionContainer extends Serializable { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/OverlayInfo.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/OverlayInfo.java index f8e31f052ca..bbd83f521e2 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/OverlayInfo.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/OverlayInfo.java @@ -10,6 +10,9 @@ import java.io.Serializable; +/** + * @since 23.1 + */ @SuppressWarnings("serial") public class OverlayInfo implements Serializable { public enum Type { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/SpreadsheetActionDetails.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/SpreadsheetActionDetails.java index 56ffca981e7..b60dd1788f8 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/SpreadsheetActionDetails.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/SpreadsheetActionDetails.java @@ -10,6 +10,9 @@ import java.io.Serializable; +/** + * @since 23.1 + */ @SuppressWarnings("serial") public class SpreadsheetActionDetails implements Serializable { public String caption; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/SpreadsheetHandler.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/SpreadsheetHandler.java index 373f120c222..eb8231d629d 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/SpreadsheetHandler.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/client/SpreadsheetHandler.java @@ -11,6 +11,9 @@ import java.util.HashMap; import java.util.Map; +/** + * @since 23.1 + */ public interface SpreadsheetHandler extends GroupingHandler { /** diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/CellShiftValuesCommand.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/CellShiftValuesCommand.java index 23fbc50459e..c5539047346 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/CellShiftValuesCommand.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/CellShiftValuesCommand.java @@ -19,7 +19,7 @@ * Command for shifting the value(s) of one or more cells. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ public class CellShiftValuesCommand extends CellValueCommand { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/CellValueCommand.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/CellValueCommand.java index 3d125008f92..a2388dbbc95 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/CellValueCommand.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/CellValueCommand.java @@ -26,7 +26,7 @@ * Command for changing the value of one or more cells. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ @SuppressWarnings("serial") public class CellValueCommand extends SpreadsheetCommand diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/Command.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/Command.java index 9178e886107..789a8d835af 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/Command.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/Command.java @@ -17,7 +17,7 @@ * Common interface for all Spreadsheet commands. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ public interface Command extends Serializable { /** diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/RowInsertOrDeleteCommand.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/RowInsertOrDeleteCommand.java index 70a1d89d0b5..bcc1946d9f3 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/RowInsertOrDeleteCommand.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/RowInsertOrDeleteCommand.java @@ -19,6 +19,8 @@ /** * Command to insert or delete a row + * + * @since 23.1 */ public class RowInsertOrDeleteCommand extends SpreadsheetCommand { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/SizeChangeCommand.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/SizeChangeCommand.java index d317e0fd635..c0d89d6d219 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/SizeChangeCommand.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/SizeChangeCommand.java @@ -18,7 +18,7 @@ * Command for changing the height of row(s) or the width of column(s). * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ public class SizeChangeCommand extends SpreadsheetCommand { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/SpreadsheetCommand.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/SpreadsheetCommand.java index 4c1cd344731..1ccb1c40f70 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/SpreadsheetCommand.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/SpreadsheetCommand.java @@ -16,7 +16,7 @@ * Abstract base class for Spreadsheet commands. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ public abstract class SpreadsheetCommand implements Command { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/ValueChangeCommand.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/ValueChangeCommand.java index 2a3ddb15763..6c4bafcce58 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/ValueChangeCommand.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/command/ValueChangeCommand.java @@ -16,7 +16,7 @@ * Common interface for all Spreadsheet commands that change cell values. * * @author Vaadin Ltd. - * @since 1.0 + * @since 23.1 */ public interface ValueChangeCommand extends Command { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/framework/Action.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/framework/Action.java index b7612f5d418..91f26943501 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/framework/Action.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/framework/Action.java @@ -20,7 +20,7 @@ * unregistration. * * @author Vaadin Ltd. - * @since 3.0 + * @since 23.1 */ @SuppressWarnings("serial") public class Action implements Serializable { @@ -108,7 +108,6 @@ public interface ShortcutNotifier extends Serializable { * @param shortcut * listener to add * @return registration for unregistering the listener - * @since 8.0 */ public Registration addShortcutListener(ShortcutEventListener shortcut); } @@ -117,7 +116,6 @@ public interface ShortcutNotifier extends Serializable { * Interface implemented by classes who wish to handle actions. * * @author Vaadin Ltd. - * @since 3.0 */ public interface Handler extends Serializable { @@ -158,7 +156,6 @@ public interface Handler extends Serializable { * action. * * @author Vaadin Ltd. - * @since 3.0 */ public interface Container extends Serializable { @@ -195,6 +192,7 @@ public void setCaption(String caption) { * * @param icon * the icon to set. + * @since 25.1 */ public void setIcon(Icon icon) { this.icon = icon; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/framework/ReflectTools.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/framework/ReflectTools.java index a08f6c55db2..b988a654f17 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/framework/ReflectTools.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/framework/ReflectTools.java @@ -21,7 +21,7 @@ * Vaadin and should not be used by application developers. Subject to change at * any time. * - * @since 6.2 + * @since 23.1 */ public class ReflectTools implements Serializable { @@ -189,7 +189,6 @@ public static void setJavaFieldValue(Object object, Field field, } /** - * @since 7.4 */ public static Class<?> convertPrimitiveType(Class<?> type) { // Gets the return type from get method @@ -226,8 +225,6 @@ private ReflectTools() { * @param b * another class to get the base type for, not <code>null</code> * @return the most specific base class, not <code>null</code> - * - * @since 8.0 */ public static Class<?> findCommonBaseType(Class<?> a, Class<?> b) { if (a.isInterface()) { @@ -261,7 +258,6 @@ public static Class<?> findCommonBaseType(Class<?> a, Class<?> b) { * @param cls * the class to instantiate * @return an instance of the class - * @since 8.1.1 */ public static <T> T createInstance(Class<T> cls) { checkClassAccessibility(cls); @@ -326,7 +322,6 @@ private static void checkClassAccessibility(Class<?> cls) { * @return the first non-synthetic method * @throws IllegalStateException * if the specified class does not have found method - * @since 8.2 */ public static Method getMethod(Class<?> listenerClass) { for (Method m : listenerClass.getDeclaredMethods()) { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/rpc/PopupButtonClientRpc.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/rpc/PopupButtonClientRpc.java index d559ec26b04..77b76133fbc 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/rpc/PopupButtonClientRpc.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/rpc/PopupButtonClientRpc.java @@ -8,6 +8,9 @@ */ package com.vaadin.flow.component.spreadsheet.rpc; +/** + * @since 23.1 + */ public interface PopupButtonClientRpc { /** diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/rpc/PopupButtonServerRpc.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/rpc/PopupButtonServerRpc.java index 13e77838e6f..997915d8403 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/rpc/PopupButtonServerRpc.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/rpc/PopupButtonServerRpc.java @@ -8,6 +8,9 @@ */ package com.vaadin.flow.component.spreadsheet.rpc; +/** + * @since 23.1 + */ public interface PopupButtonServerRpc { /** diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/rpc/SpreadsheetClientRpc.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/rpc/SpreadsheetClientRpc.java index 8788683a80b..5482d25967b 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/rpc/SpreadsheetClientRpc.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/rpc/SpreadsheetClientRpc.java @@ -13,6 +13,9 @@ import com.vaadin.flow.component.spreadsheet.client.CellData; import com.vaadin.flow.component.spreadsheet.client.SpreadsheetActionDetails; +/** + * @since 23.1 + */ public interface SpreadsheetClientRpc { void updateBottomRightCellValues(ArrayList<CellData> cellData); diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/rpc/SpreadsheetServerRpc.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/rpc/SpreadsheetServerRpc.java index e145ed10690..2eb176611e9 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/rpc/SpreadsheetServerRpc.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/rpc/SpreadsheetServerRpc.java @@ -10,6 +10,9 @@ import com.vaadin.flow.component.spreadsheet.client.SpreadsheetHandler; +/** + * @since 23.1 + */ public interface SpreadsheetServerRpc extends SpreadsheetHandler { /** @@ -74,6 +77,8 @@ public interface SpreadsheetServerRpc extends SpreadsheetHandler { /** * Context menu was closed. + * + * @since 24.9.7 */ void contextMenuClosed(); } diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/ContentMode.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/ContentMode.java index 564f02da363..3d6bf0a2af4 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/ContentMode.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/ContentMode.java @@ -11,7 +11,7 @@ /** * Defines how the client should interpret textual values. * - * @since 8.0 + * @since 23.1 */ public enum ContentMode { /** diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/ErrorLevel.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/ErrorLevel.java index 5265bff16f9..24b77f696e2 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/ErrorLevel.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/ErrorLevel.java @@ -12,7 +12,7 @@ * Represents the error levels displayed on components. * * @author Vaadin Ltd - * @since 8.2 + * @since 23.1 */ public enum ErrorLevel { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/GroupingData.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/GroupingData.java index 0f237b376de..8f98b87cddd 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/GroupingData.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/GroupingData.java @@ -12,6 +12,8 @@ /** * Shared state for the grouping feature + * + * @since 23.1 */ public class GroupingData implements Serializable { public int startIndex; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/PopupButtonState.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/PopupButtonState.java index d6c5cbd173f..bdd083adc58 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/PopupButtonState.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/PopupButtonState.java @@ -8,6 +8,9 @@ */ package com.vaadin.flow.component.spreadsheet.shared; +/** + * @since 23.1 + */ @SuppressWarnings("serial") public class PopupButtonState { diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/SpreadsheetState.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/SpreadsheetState.java index 42c9e13febb..caa10f69e07 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/SpreadsheetState.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/SpreadsheetState.java @@ -17,6 +17,9 @@ import com.vaadin.flow.component.spreadsheet.client.MergedRegion; import com.vaadin.flow.component.spreadsheet.client.OverlayInfo; +/** + * @since 23.1 + */ @SuppressWarnings("serial") public class SpreadsheetState { @@ -42,8 +45,6 @@ public class SpreadsheetState { /** * Level of error. - * - * @since 8.2 */ public ErrorLevel errorLevel = null; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/URLReference.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/URLReference.java index e45bb9ab11e..86516c473d2 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/URLReference.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/com/vaadin/flow/component/spreadsheet/shared/URLReference.java @@ -10,6 +10,9 @@ import java.io.Serializable; +/** + * @since 23.1 + */ public class URLReference implements Serializable { private String url; diff --git a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/org/apache/poi/ss/formula/WorkbookEvaluatorUtil.java b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/org/apache/poi/ss/formula/WorkbookEvaluatorUtil.java index dc5604bf882..645ad8e2de9 100644 --- a/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/org/apache/poi/ss/formula/WorkbookEvaluatorUtil.java +++ b/vaadin-spreadsheet-flow-parent/vaadin-spreadsheet-flow/src/main/java/org/apache/poi/ss/formula/WorkbookEvaluatorUtil.java @@ -20,6 +20,8 @@ /** * Helper to evaluate POI values that are package scoped, like formula Ptg[] * arrays. + * + * @since 23.1 */ public class WorkbookEvaluatorUtil { diff --git a/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/Tab.java b/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/Tab.java index 5c3709279b3..2daa2191703 100644 --- a/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/Tab.java +++ b/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/Tab.java @@ -30,6 +30,7 @@ * {@link Tabs} component. * * @author Vaadin Ltd. + * @since 1.0 */ @Tag("vaadin-tab") @JsModule("@vaadin/tabs/src/vaadin-tab.js") diff --git a/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/TabSheet.java b/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/TabSheet.java index 3c2eabe4df1..94f007bfbb2 100644 --- a/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/TabSheet.java +++ b/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/TabSheet.java @@ -51,6 +51,7 @@ * {@code VerticalLayout}, instead of adding them directly to the TabSheet. * * @author Vaadin Ltd. + * @since 23.3 */ @Tag("vaadin-tabsheet") @NpmPackage(value = "@vaadin/tabsheet", version = "25.2.0") @@ -260,6 +261,7 @@ public void setSelectedTab(Tab selectedTab) { * Gets the number of tabs. * * @return the number of tabs + * @since 24.5 */ public int getTabCount() { return tabs.getTabCount(); @@ -299,6 +301,7 @@ public int getIndexOf(Tab tab) { * @return The tab instance associated with the given component, or * <code>null</code> if the {@link TabSheet} does not contain the * component. + * @since 24.1 */ public Tab getTab(Component content) { Objects.requireNonNull(content, @@ -317,6 +320,7 @@ public Tab getTab(Component content) { * @return The component instance associated with the given tab, or * <code>null</code> if the {@link TabSheet} does not contain the * tab. + * @since 24.1 */ public Component getComponent(Tab tab) { Objects.requireNonNull(tab, diff --git a/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/TabSheetVariant.java b/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/TabSheetVariant.java index f469f4b2eee..8aa21683537 100644 --- a/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/TabSheetVariant.java +++ b/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/TabSheetVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-tabsheet} component. + * + * @since 23.3 */ public enum TabSheetVariant implements ThemeVariant { LUMO_TABS_CENTERED("centered"), diff --git a/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/TabVariant.java b/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/TabVariant.java index bf7b7447650..093717eec5d 100644 --- a/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/TabVariant.java +++ b/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/TabVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-tab} component. + * + * @since 1.1 */ public enum TabVariant implements ThemeVariant { LUMO_ICON_ON_TOP("icon-on-top"); diff --git a/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/Tabs.java b/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/Tabs.java index 8d0d5c617ad..f2b80443351 100644 --- a/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/Tabs.java +++ b/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/Tabs.java @@ -63,6 +63,7 @@ * unexpectedly. * * @author Vaadin Ltd. + * @since 1.0 */ @Tag("vaadin-tabs") @JsModule("@vaadin/tabs/src/vaadin-tabs.js") @@ -133,6 +134,7 @@ public Tabs(Tab... tabs) { * {@code false} to leave tabs unselected * @param tabs * the tabs to enclose + * @since 2.0 */ public Tabs(boolean autoselect, Tab... tabs) { this(); @@ -152,6 +154,7 @@ public Tabs(boolean autoselect, Tab... tabs) { * @param components * the tabs to enclose * @deprecated since 24.0, use {@link #add(Tab...)} instead. + * @since 1.0.4 */ @Deprecated public void add(Component... components) { @@ -211,6 +214,7 @@ public void add(Tab... tabs) { * next available tab if autoselect is true, otherwise no tab * will be selected. * @deprecated since 24.0, use {@link #remove(Tab...)} instead. + * @since 1.0.4 */ @Deprecated public void remove(Component... components) { @@ -240,6 +244,7 @@ public void remove(Component... components) { * the selected tab. Removing the selected tab will select the * next available tab if autoselect is true, otherwise no tab * will be selected. + * @since 24.0 */ public void remove(Tab... tabs) { int selectedIndex = getSelectedIndex(); @@ -297,6 +302,8 @@ private void doRemoveTabs(Tab... tabs) { * were added only at the client-side. * <p> * This will reset the {@link #getSelectedIndex() selected index} to zero. + * + * @since 1.0.4 */ public void removeAll() { getElement().removeAllChildren(); @@ -323,6 +330,7 @@ public void removeAll() { * the {@link #getSelectedIndex() selected index} to avoid * changing the selected tab. * @deprecated since 24.0, use {@link #addTabAtIndex(int, Tab)} instead. + * @since 1.1 */ @Deprecated public void addComponentAtIndex(int index, Component component) { @@ -349,6 +357,7 @@ public void addComponentAtIndex(int index, Component component) { * Adding a tab before the currently selected tab will increment * the {@link #getSelectedIndex() selected index} to avoid * changing the selected tab. + * @since 24.0 */ public void addTabAtIndex(int index, Tab tab) { Objects.requireNonNull(tab, "Tab should not be null"); @@ -389,6 +398,7 @@ public void addTabAtIndex(int index, Tab tab) { * Replacing the currently selected tab will make the new tab * selected. * @deprecated since 24.0, use {@link #replace(Tab, Tab)} instead. + * @since 1.0.4 */ @Deprecated public void replace(Component oldComponent, Component newComponent) { @@ -423,6 +433,7 @@ public void replace(Component oldComponent, Component newComponent) { * <p> * Replacing the currently selected tab will make the new tab * selected. + * @since 24.0 */ public void replace(Tab oldTab, Tab newTab) { if (oldTab == null && newTab == null) { @@ -469,6 +480,7 @@ public static class SelectedChangeEvent extends ComponentEvent<Tabs> { * @param fromClient * <code>true</code> for client-side events, * <code>false</code> otherwise. + * @since 2.0 */ public SelectedChangeEvent(Tabs source, Tab previousTab, boolean fromClient) { @@ -484,6 +496,7 @@ public SelectedChangeEvent(Tabs source, Tab previousTab, * is set to false. * * @return the selected tab for this event + * @since 2.0 */ public Tab getSelectedTab() { return this.selectedTab; @@ -494,6 +507,7 @@ public Tab getSelectedTab() { * autoselect is set to false. * * @return the selected tab for this event + * @since 2.0 */ public Tab getPreviousTab() { return this.previousTab; @@ -504,6 +518,7 @@ public Tab getPreviousTab() { * * @return <code>true</code> if the event is initial tabs selection, * <code>false</code> otherwise + * @since 2.0 */ public boolean isInitialSelection() { return this.initialSelection; @@ -648,6 +663,7 @@ public void setFlexGrowForEnclosedTabs(double flexGrow) { * * @param autoselect * {@code true} to autoselect tab, {@code false} to not. + * @since 2.0 */ public void setAutoselect(boolean autoselect) { this.autoselect = autoselect; @@ -660,6 +676,7 @@ public void setAutoselect(boolean autoselect) { * @return <code>true</code> if autoselect is active, <code>false</code> * otherwise * @see #setAutoselect(boolean) + * @since 2.0 */ public boolean isAutoselect() { return this.autoselect; @@ -703,6 +720,7 @@ private void updateSelectedTab(boolean changedFromClient) { * the tab to look up, can not be <code>null</code> * @return the index of the tab or -1 if the tab is not a child * @deprecated since 24.0, use {@link #indexOf(Tab)} instead. + * @since 24.0 */ @Deprecated public int indexOf(Component component) { @@ -720,6 +738,7 @@ public int indexOf(Component component) { * @param tab * the tab to look up, can not be <code>null</code> * @return the index of the tab or -1 if the tab is not a child + * @since 24.0 */ public int indexOf(Tab tab) { if (tab == null) { @@ -743,6 +762,7 @@ public int indexOf(Tab tab) { * * @return the number of tabs * @deprecated since 24.5, use {@link #getTabCount} instead. + * @since 24.0 */ @Deprecated public int getComponentCount() { @@ -753,6 +773,7 @@ public int getComponentCount() { * Gets the number of tabs. * * @return the number of tabs + * @since 24.5 */ public int getTabCount() { return (int) getChildren().count(); @@ -769,6 +790,7 @@ public int getTabCount() { * if the index is less than 0 or greater than or equals to the * number of children tabs * @deprecated since 24.0, use {@link #getTabAt(int)} instead. + * @since 24.0 */ @Deprecated public Component getComponentAt(int index) { @@ -785,6 +807,7 @@ public Component getComponentAt(int index) { * @throws IllegalArgumentException * if the index is less than 0 or greater than or equals to the * number of children tabs + * @since 24.0 */ public Tab getTabAt(int index) { if (index < 0) { @@ -807,6 +830,7 @@ public Tab getTabAt(int index) { * @param component * the tab to add, value should not be null * @deprecated since 24.0, use {@link #addTabAsFirst(Tab)} instead. + * @since 24.0 */ @Deprecated public void addComponentAsFirst(Component component) { @@ -826,6 +850,7 @@ public void addComponentAsFirst(Component component) { * * @param tab * the tab to add, value should not be null + * @since 24.0 */ public void addTabAsFirst(Tab tab) { addTabAtIndex(0, tab); diff --git a/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/TabsVariant.java b/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/TabsVariant.java index e468ea437d9..b69bfd02e75 100644 --- a/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/TabsVariant.java +++ b/vaadin-tabs-flow-parent/vaadin-tabs-flow/src/main/java/com/vaadin/flow/component/tabs/TabsVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-tabs} component. + * + * @since 1.1 */ public enum TabsVariant implements ThemeVariant { LUMO_CENTERED("centered"), diff --git a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/AbstractNumberField.java b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/AbstractNumberField.java index c3c48f0fdde..e72727dc657 100644 --- a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/AbstractNumberField.java +++ b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/AbstractNumberField.java @@ -40,6 +40,7 @@ * element and its subclasses. * * @author Vaadin Ltd. + * @since 2.1 */ public abstract class AbstractNumberField<C extends AbstractNumberField<C, T>, T extends Number> extends TextFieldBase<C, T> { @@ -213,6 +214,7 @@ void applyChangeTimeout() { * @param stepButtonsVisible * {@code true} if control buttons should be visible; * {@code false} if those should be hidden + * @since 23.3 */ public void setStepButtonsVisible(boolean stepButtonsVisible) { getElement().setProperty("stepButtonsVisible", stepButtonsVisible); @@ -224,6 +226,7 @@ public void setStepButtonsVisible(boolean stepButtonsVisible) { * @see #setStep(double) * * @return {@code true} if buttons are visible, {@code false} otherwise + * @since 23.3 */ public boolean isStepButtonsVisible() { return getElement().getProperty("stepButtonsVisible", false); @@ -349,6 +352,7 @@ protected double getMaxDouble() { * @return a {@link SignalBinding} that can be used to register * {@link SignalBinding#onChange(com.vaadin.flow.function.SerializableConsumer) * onChange} callbacks + * @since 25.1 */ protected final SignalBinding<Double> bindMinInternal( Signal<Double> signal) { @@ -361,6 +365,7 @@ protected final SignalBinding<Double> bindMinInternal( * @return a {@link SignalBinding} that can be used to register * {@link SignalBinding#onChange(com.vaadin.flow.function.SerializableConsumer) * onChange} callbacks + * @since 25.1 */ protected final SignalBinding<Double> bindMaxInternal( Signal<Double> signal) { @@ -467,6 +472,7 @@ private boolean isValidByStep(T value) { * {@link #setI18n(AbstractNumberFieldI18n)} * * @return the i18n object or {@code null} if no i18n object has been set + * @since 24.5 */ protected AbstractNumberFieldI18n getI18n() { return i18n; @@ -477,6 +483,7 @@ protected AbstractNumberFieldI18n getI18n() { * * @param i18n * the i18n object, not {@code null} + * @since 24.5 */ protected void setI18n(AbstractNumberFieldI18n i18n) { this.i18n = Objects.requireNonNull(i18n, diff --git a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/AbstractNumberFieldI18n.java b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/AbstractNumberFieldI18n.java index fe767a4569d..ff8cadec613 100644 --- a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/AbstractNumberFieldI18n.java +++ b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/AbstractNumberFieldI18n.java @@ -19,6 +19,8 @@ /** * The internationalization properties for {@link AbstractNumberField}. + * + * @since 24.5 */ public interface AbstractNumberFieldI18n extends Serializable { /** diff --git a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/Autocapitalize.java b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/Autocapitalize.java index d94a0b459a8..bd3d4f31377 100644 --- a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/Autocapitalize.java +++ b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/Autocapitalize.java @@ -17,6 +17,8 @@ /** * Capitalization options for the {@code autocapitalize} attribute. + * + * @since 1.0 */ public enum Autocapitalize { diff --git a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/Autocomplete.java b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/Autocomplete.java index 613ef960d12..eb3a9c41852 100644 --- a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/Autocomplete.java +++ b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/Autocomplete.java @@ -17,6 +17,8 @@ /** * Values for the {@code autocomplete} attribute. + * + * @since 1.0 */ public enum Autocomplete { diff --git a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/BigDecimalField.java b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/BigDecimalField.java index 017906ae27c..79c43734a21 100644 --- a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/BigDecimalField.java +++ b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/BigDecimalField.java @@ -82,6 +82,7 @@ * {@link #setInvalid(boolean)} and {@link #setErrorMessage(String)} API. * * @author Vaadin Ltd. + * @since 2.1 */ @Tag("vaadin-big-decimal-field") @JsModule("./vaadin-big-decimal-field.js") @@ -266,6 +267,8 @@ public BigDecimalField(String label, BigDecimal initialValue, * respective properties. However, note that the error message set with * {@link #setErrorMessage(String)} will take priority and override any i18n * error messages if both are set. + * + * @since 24.5 */ @Override public void setErrorMessage(String errorMessage) { @@ -274,6 +277,7 @@ public void setErrorMessage(String errorMessage) { /** * @see BigDecimalFieldI18n#setRequiredErrorMessage(String) + * @since 24.5 */ @Override public void setRequiredIndicatorVisible(boolean required) { @@ -456,6 +460,7 @@ private char getDecimalSeparator() { * {@link #setI18n(BigDecimalFieldI18n)} * * @return the i18n object or {@code null} if no i18n object has been set + * @since 24.5 */ public BigDecimalFieldI18n getI18n() { return i18n; @@ -466,6 +471,7 @@ public BigDecimalFieldI18n getI18n() { * * @param i18n * the i18n object, not {@code null} + * @since 24.5 */ public void setI18n(BigDecimalFieldI18n i18n) { this.i18n = Objects.requireNonNull(i18n, @@ -479,6 +485,8 @@ private String getI18nErrorMessage( /** * The internationalization properties for {@link BigDecimalField}. + * + * @since 24.5 */ public static class BigDecimalFieldI18n implements Serializable { diff --git a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/EmailField.java b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/EmailField.java index b9bb9e7b99a..ec31e6fecd2 100644 --- a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/EmailField.java +++ b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/EmailField.java @@ -86,6 +86,7 @@ * {@link #setInvalid(boolean)} and {@link #setErrorMessage(String)} API. * * @author Vaadin Ltd. + * @since 1.3 */ @Tag("vaadin-email-field") @NpmPackage(value = "@vaadin/email-field", version = "25.2.0") @@ -250,6 +251,8 @@ public EmailField(String label, String initialValue, * properties. However, note that the error message set with * {@link #setErrorMessage(String)} will take priority and override any i18n * error messages if both are set. + * + * @since 24.5 */ @Override public void setErrorMessage(String errorMessage) { @@ -409,6 +412,8 @@ public void setManualValidation(boolean enabled) { * message defined in the i18n object is used. * <p> * The method does nothing if the manual validation mode is enabled. + * + * @since 2.0.8 */ protected void validate() { validationController.validate(getValue()); @@ -422,6 +427,7 @@ protected void validate() { * {@link #setI18n(EmailFieldI18n)} * * @return the i18n object or {@code null} if no i18n object has been set + * @since 24.5 */ public EmailFieldI18n getI18n() { return i18n; @@ -432,6 +438,7 @@ public EmailFieldI18n getI18n() { * * @param i18n * the i18n object, not {@code null} + * @since 24.5 */ public void setI18n(EmailFieldI18n i18n) { this.i18n = Objects.requireNonNull(i18n, @@ -445,6 +452,8 @@ private String getI18nErrorMessage( /** * The internationalization properties for {@link EmailField}. + * + * @since 24.5 */ public static class EmailFieldI18n implements Serializable { diff --git a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/HasAutocapitalize.java b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/HasAutocapitalize.java index 1ddd79dc92b..6835e3ae236 100644 --- a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/HasAutocapitalize.java +++ b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/HasAutocapitalize.java @@ -19,6 +19,8 @@ /** * Mixin interface for fields with {@code autocapitalize} attribute. + * + * @since 1.0 */ public interface HasAutocapitalize extends HasElement { diff --git a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/HasAutocomplete.java b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/HasAutocomplete.java index ad689059307..5f4c97bcaaa 100644 --- a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/HasAutocomplete.java +++ b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/HasAutocomplete.java @@ -19,6 +19,8 @@ /** * Mixin interface for fields with {@code autocomplete} attribute. + * + * @since 1.0 */ public interface HasAutocomplete extends HasElement { diff --git a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/HasAutocorrect.java b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/HasAutocorrect.java index 791891b2850..75f2085e351 100644 --- a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/HasAutocorrect.java +++ b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/HasAutocorrect.java @@ -19,6 +19,8 @@ /** * Mixin interface for fields with {@code autocorrect} attribute. + * + * @since 1.0 */ public interface HasAutocorrect extends HasElement { diff --git a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/IntegerField.java b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/IntegerField.java index 50263193a36..10f4af0d009 100644 --- a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/IntegerField.java +++ b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/IntegerField.java @@ -68,6 +68,7 @@ * {@link #setInvalid(boolean)} and {@link #setErrorMessage(String)} API. * * @author Vaadin Ltd. + * @since 2.1 */ @Tag("vaadin-integer-field") @NpmPackage(value = "@vaadin/integer-field", version = "25.2.0") @@ -184,6 +185,8 @@ public IntegerField(String label, Integer initialValue, * respective properties. However, note that the error message set with * {@link #setErrorMessage(String)} will take priority and override any i18n * error messages if both are set. + * + * @since 24.5 */ @Override public void setErrorMessage(String errorMessage) { @@ -192,6 +195,7 @@ public void setErrorMessage(String errorMessage) { /** * @see IntegerFieldI18n#setRequiredErrorMessage(String) + * @since 24.5 */ @Override public void setRequiredIndicatorVisible(boolean required) { @@ -339,6 +343,7 @@ public SignalBinding<Double> bindMax(Signal<Integer> signal) { * {@link #setI18n(IntegerFieldI18n)} * * @return the i18n object or {@code null} if no i18n object has been set + * @since 24.5 */ @Override public IntegerFieldI18n getI18n() { @@ -350,6 +355,7 @@ public IntegerFieldI18n getI18n() { * * @param i18n * the i18n object, not {@code null} + * @since 24.5 */ public void setI18n(IntegerFieldI18n i18n) { super.setI18n(i18n); @@ -357,6 +363,8 @@ public void setI18n(IntegerFieldI18n i18n) { /** * The internationalization properties for {@link IntegerField}. + * + * @since 24.5 */ public static class IntegerFieldI18n implements AbstractNumberFieldI18n { private String requiredErrorMessage; diff --git a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/NumberField.java b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/NumberField.java index 2bc4a914364..aa8a407bf8d 100644 --- a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/NumberField.java +++ b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/NumberField.java @@ -75,6 +75,7 @@ * {@link #setInvalid(boolean)} and {@link #setErrorMessage(String)} API. * * @author Vaadin Ltd. + * @since 1.3 */ @Tag("vaadin-number-field") @NpmPackage(value = "@vaadin/number-field", version = "25.2.0") @@ -187,6 +188,8 @@ private NumberField(Formatter formatter) { * respective properties. However, note that the error message set with * {@link #setErrorMessage(String)} will take priority and override any i18n * error messages if both are set. + * + * @since 24.5 */ @Override public void setErrorMessage(String errorMessage) { @@ -195,6 +198,7 @@ public void setErrorMessage(String errorMessage) { /** * @see NumberFieldI18n#setRequiredErrorMessage(String) + * @since 24.5 */ @Override public void setRequiredIndicatorVisible(boolean required) { @@ -342,6 +346,7 @@ public SignalBinding<Double> bindMax(Signal<Double> signal) { * {@link #setI18n(NumberFieldI18n)} * * @return the i18n object or {@code null} if no i18n object has been set + * @since 24.5 */ @Override public NumberFieldI18n getI18n() { @@ -353,6 +358,7 @@ public NumberFieldI18n getI18n() { * * @param i18n * the i18n object, not {@code null} + * @since 24.5 */ public void setI18n(NumberFieldI18n i18n) { super.setI18n(i18n); @@ -360,6 +366,8 @@ public void setI18n(NumberFieldI18n i18n) { /** * The internationalization properties for {@link NumberField}. + * + * @since 24.5 */ public static class NumberFieldI18n implements AbstractNumberFieldI18n { private String requiredErrorMessage; diff --git a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/PasswordField.java b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/PasswordField.java index edaf185584e..26d02ab6b76 100644 --- a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/PasswordField.java +++ b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/PasswordField.java @@ -82,6 +82,7 @@ * {@link #setInvalid(boolean)} and {@link #setErrorMessage(String)} API. * * @author Vaadin Ltd. + * @since 1.0 */ @Tag("vaadin-password-field") @NpmPackage(value = "@vaadin/password-field", version = "25.2.0") @@ -262,6 +263,8 @@ public PasswordField(String label, String initialValue, * However, note that the error message set with * {@link #setErrorMessage(String)} will take priority and override any i18n * error messages if both are set. + * + * @since 24.5 */ @Override public void setErrorMessage(String errorMessage) { @@ -403,6 +406,7 @@ public String getEmptyValue() { * * @param value * the new value, not {@code null} + * @since 1.0.4 */ @Override public void setValue(String value) { @@ -414,6 +418,7 @@ public void setValue(String value) { * password field will return an empty string. * * @return the current value. + * @since 1.0.4 */ @Override public String getValue() { @@ -438,6 +443,8 @@ public void setManualValidation(boolean enabled) { * message defined in the i18n object is used. * <p> * The method does nothing if the manual validation mode is enabled. + * + * @since 2.0.8 */ protected void validate() { validationController.validate(getValue()); @@ -451,6 +458,7 @@ protected void validate() { * {@link #setI18n(PasswordFieldI18n)} * * @return the i18n object or {@code null} if no i18n object has been set + * @since 24.5 */ public PasswordFieldI18n getI18n() { return i18n; @@ -461,6 +469,7 @@ public PasswordFieldI18n getI18n() { * * @param i18n * the i18n object, not {@code null} + * @since 24.5 */ public void setI18n(PasswordFieldI18n i18n) { this.i18n = Objects.requireNonNull(i18n, @@ -474,6 +483,8 @@ private String getI18nErrorMessage( /** * The internationalization properties for {@link PasswordField}. + * + * @since 24.5 */ public static class PasswordFieldI18n implements Serializable { diff --git a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextArea.java b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextArea.java index 25fff87159d..ca4a6d1d04a 100644 --- a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextArea.java +++ b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextArea.java @@ -82,6 +82,7 @@ * {@link #setInvalid(boolean)} and {@link #setErrorMessage(String)} API. * * @author Vaadin Ltd. + * @since 1.0 */ @Tag("vaadin-text-area") @NpmPackage(value = "@vaadin/text-area", version = "25.2.0") @@ -275,6 +276,8 @@ public TextArea(String label, String initialValue, /** * Scrolls the textarea to the start if it has a vertical scrollbar. + * + * @since 24.4 */ public void scrollToStart() { getElement().callJsFunction("scrollToStart"); @@ -282,6 +285,8 @@ public void scrollToStart() { /** * Scrolls the textarea to the end if it has a vertical scrollbar. + * + * @since 24.4 */ public void scrollToEnd() { getElement().callJsFunction("scrollToEnd"); @@ -295,6 +300,8 @@ public void scrollToEnd() { * However, note that the error message set with * {@link #setErrorMessage(String)} will take priority and override any i18n * error messages if both are set. + * + * @since 24.5 */ @Override public void setErrorMessage(String errorMessage) { @@ -382,6 +389,7 @@ public int getMinLength() { * @see <a href= * "https://html.spec.whatwg.org/multipage/input.html#attr-input-pattern"> * https://html.spec.whatwg.org/multipage/input.html#attr-input-pattern</> + * @since 23.0 */ public void setPattern(String pattern) { getElement().setProperty("pattern", pattern == null ? "" : pattern); @@ -392,6 +400,7 @@ public void setPattern(String pattern) { * * @return the pattern or {@code null} if not set * @see #setPattern(String) + * @since 23.0 */ public String getPattern() { return getElement().getProperty("pattern"); @@ -401,6 +410,7 @@ public String getPattern() { * The minimum number of rows to show. * * @return the minimum number of rows + * @since 24.6 */ public int getMinRows() { return getElement().getProperty("minRows", 2); @@ -411,6 +421,7 @@ public int getMinRows() { * * @param minRows * the minimum number of rows to show + * @since 24.6 */ public void setMinRows(int minRows) { getElement().setProperty("minRows", minRows); @@ -422,6 +433,7 @@ public void setMinRows(int minRows) { * * @return the maximum number of rows, or {@code null} if the maximum has * not been set + * @since 24.6 */ public Integer getMaxRows() { String maxRows = getElement().getProperty("maxRows"); @@ -441,6 +453,7 @@ public Integer getMaxRows() { * @param maxRows * the maximum number of rows, or {@code null} to remove the * maximum + * @since 24.6 */ public void setMaxRows(Integer maxRows) { if (maxRows != null) { @@ -465,6 +478,7 @@ public String getEmptyValue() { * * @param value * the new value, not {@code null} + * @since 1.0.4 */ @Override public void setValue(String value) { @@ -476,6 +490,7 @@ public void setValue(String value) { * area will return an empty string. * * @return the current value. + * @since 1.0.4 */ @Override public String getValue() { @@ -500,6 +515,8 @@ public void setManualValidation(boolean enabled) { * message defined in the i18n object is used. * <p> * The method does nothing if the manual validation mode is enabled. + * + * @since 2.0.8 */ protected void validate() { validationController.validate(getValue()); @@ -513,6 +530,7 @@ protected void validate() { * {@link #setI18n(TextAreaI18n)} * * @return the i18n object or {@code null} if no i18n object has been set + * @since 24.5 */ public TextAreaI18n getI18n() { return i18n; @@ -523,6 +541,7 @@ public TextAreaI18n getI18n() { * * @param i18n * the i18n object, not {@code null} + * @since 24.5 */ public void setI18n(TextAreaI18n i18n) { this.i18n = Objects.requireNonNull(i18n, @@ -535,6 +554,8 @@ private String getI18nErrorMessage(Function<TextAreaI18n, String> getter) { /** * The internationalization properties for {@link TextArea}. + * + * @since 24.5 */ public static class TextAreaI18n implements Serializable { diff --git a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextAreaVariant.java b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextAreaVariant.java index 684e84eae23..1c5b0aeef56 100644 --- a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextAreaVariant.java +++ b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextAreaVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-text-area} component. + * + * @since 1.1 */ public enum TextAreaVariant implements ThemeVariant { LUMO_SMALL("small"), diff --git a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextField.java b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextField.java index 2368f3130b9..9b24f2c9f25 100644 --- a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextField.java +++ b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextField.java @@ -81,6 +81,7 @@ * {@link #setInvalid(boolean)} and {@link #setErrorMessage(String)} API. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-text-field") @NpmPackage(value = "@vaadin/text-field", version = "25.2.0") @@ -280,6 +281,8 @@ public TextField(String label, String initialValue, * However, note that the error message set with * {@link #setErrorMessage(String)} will take priority and override any i18n * error messages if both are set. + * + * @since 24.5 */ @Override public void setErrorMessage(String errorMessage) { @@ -398,6 +401,7 @@ public String getEmptyValue() { * * @param value * the new value, not {@code null} + * @since 1.0.4 */ @Override public void setValue(String value) { @@ -409,6 +413,7 @@ public void setValue(String value) { * field will return an empty string. * * @return the current value. + * @since 1.0.4 */ @Override public String getValue() { @@ -433,6 +438,8 @@ public void setManualValidation(boolean enabled) { * message defined in the i18n object is used. * <p> * The method does nothing if the manual validation mode is enabled. + * + * @since 2.0.8 */ protected void validate() { validationController.validate(getValue()); @@ -446,6 +453,7 @@ protected void validate() { * {@link #setI18n(TextFieldI18n)} * * @return the i18n object or {@code null} if no i18n object has been set + * @since 24.5 */ public TextFieldI18n getI18n() { return i18n; @@ -456,6 +464,7 @@ public TextFieldI18n getI18n() { * * @param i18n * the i18n object, not {@code null} + * @since 24.5 */ public void setI18n(TextFieldI18n i18n) { this.i18n = Objects.requireNonNull(i18n, @@ -468,6 +477,8 @@ private String getI18nErrorMessage(Function<TextFieldI18n, String> getter) { /** * The internationalization properties for {@link TextField}. + * + * @since 24.5 */ public static class TextFieldI18n implements Serializable { diff --git a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextFieldBase.java b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextFieldBase.java index 1a4b15397c8..32310b65b20 100644 --- a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextFieldBase.java +++ b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextFieldBase.java @@ -46,6 +46,7 @@ * Type of the component that extends from this class * @param <TValue> * Type of the value of the extending component + * @since 24.0 */ public abstract class TextFieldBase<TComponent extends TextFieldBase<TComponent, TValue>, TValue> extends AbstractSinglePropertyField<TComponent, TValue> @@ -168,6 +169,7 @@ public void setAutoselect(boolean autoselect) { * @param required * {@code true} to make the field required, {@code false} * otherwise + * @since 24.5 */ @Override public void setRequiredIndicatorVisible(boolean required) { @@ -179,6 +181,7 @@ public void setRequiredIndicatorVisible(boolean required) { * * @return {@code true} if the field is required, {@code false} otherwise * @see #setRequiredIndicatorVisible(boolean) + * @since 24.5 */ @Override public boolean isRequiredIndicatorVisible() { diff --git a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextFieldVariant.java b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextFieldVariant.java index 142be1a0470..00deb63e64a 100644 --- a/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextFieldVariant.java +++ b/vaadin-text-field-flow-parent/vaadin-text-field-flow/src/main/java/com/vaadin/flow/component/textfield/TextFieldVariant.java @@ -20,6 +20,8 @@ /** * Set of theme variants applicable for the {@link TextField} component, as well * as other components based on it. + * + * @since 1.1 */ public enum TextFieldVariant implements ThemeVariant { LUMO_SMALL("small"), diff --git a/vaadin-time-picker-flow-parent/vaadin-time-picker-flow/src/main/java/com/vaadin/flow/component/timepicker/StepsUtil.java b/vaadin-time-picker-flow-parent/vaadin-time-picker-flow/src/main/java/com/vaadin/flow/component/timepicker/StepsUtil.java index 26795b14228..fe1429dc34d 100644 --- a/vaadin-time-picker-flow-parent/vaadin-time-picker-flow/src/main/java/com/vaadin/flow/component/timepicker/StepsUtil.java +++ b/vaadin-time-picker-flow-parent/vaadin-time-picker-flow/src/main/java/com/vaadin/flow/component/timepicker/StepsUtil.java @@ -24,6 +24,8 @@ * <p> * NOTE: This class is not part of the public API surface and for internal use * only + * + * @since 21.0.2 */ public class StepsUtil { private static final long MILLISECONDS_IN_A_DAY = 86400000L; diff --git a/vaadin-time-picker-flow-parent/vaadin-time-picker-flow/src/main/java/com/vaadin/flow/component/timepicker/TimePicker.java b/vaadin-time-picker-flow-parent/vaadin-time-picker-flow/src/main/java/com/vaadin/flow/component/timepicker/TimePicker.java index 65bd0b99b4e..21b0f1f9b9d 100644 --- a/vaadin-time-picker-flow-parent/vaadin-time-picker-flow/src/main/java/com/vaadin/flow/component/timepicker/TimePicker.java +++ b/vaadin-time-picker-flow-parent/vaadin-time-picker-flow/src/main/java/com/vaadin/flow/component/timepicker/TimePicker.java @@ -109,6 +109,7 @@ * {@link #setInvalid(boolean)} and {@link #setErrorMessage(String)} API. * * @author Vaadin Ltd + * @since 1.0 */ @Tag("vaadin-time-picker") @NpmPackage(value = "@vaadin/time-picker", version = "25.2.0") @@ -295,6 +296,7 @@ public TimePicker( * @param listener * the listener to receive value change events * @see #addValueChangeListener(HasValue.ValueChangeListener) + * @since 23.1 */ public TimePicker(LocalTime time, ValueChangeListener<ComponentValueChangeEvent<TimePicker, LocalTime>> listener) { @@ -314,6 +316,7 @@ public TimePicker(LocalTime time, * the listener to receive value change events * @see #setLabel(String) * @see #addValueChangeListener(HasValue.ValueChangeListener) + * @since 23.1 */ public TimePicker(String label, LocalTime time, ValueChangeListener<ComponentValueChangeEvent<TimePicker, LocalTime>> listener) { @@ -330,6 +333,8 @@ public TimePicker(String label, LocalTime time, * respective properties. However, note that the error message set with * {@link #setErrorMessage(String)} will take priority and override any i18n * error messages if both are set. + * + * @since 24.5 */ @Override public void setErrorMessage(String errorMessage) { @@ -358,6 +363,7 @@ public void setLabel(String label) { * * @param value * the LocalTime instance representing the selected time, or null + * @since 1.1.1 */ @Override public void setValue(LocalTime value) { @@ -480,6 +486,7 @@ private void fireValidationStatusChangeEvent() { * @return <code>true</code> if the input element's value is populated, * <code>false</code> otherwise * @deprecated Since v24.8 + * @since 24.0 */ @Deprecated(since = "24.8") protected boolean isInputValuePresent() { @@ -493,6 +500,7 @@ protected boolean isInputValuePresent() { * * @return <code>true</code> if the input element's value is populated and * unparsable, <code>false</code> otherwise + * @since 24.8 */ protected final boolean isInputUnparsable() { return unparsableValue != null; @@ -535,6 +543,7 @@ private void setInputElementValue(String value) { * {@code true} to make the field required, {@code false} * otherwise * @see TimePickerI18n#setRequiredErrorMessage(String) + * @since 2.0.2 */ @Override public void setRequiredIndicatorVisible(boolean required) { @@ -546,6 +555,7 @@ public void setRequiredIndicatorVisible(boolean required) { * * @return {@code true} if the field is required, {@code false} otherwise * @see #setRequiredIndicatorVisible(boolean) + * @since 24.5 */ @Override public boolean isRequiredIndicatorVisible() { @@ -624,6 +634,8 @@ public Duration getStep() { /** * {@code invalid-changed} event is sent when the invalid state changes. + * + * @since 23.3 */ public static class InvalidChangeEvent extends ComponentEvent<TimePicker> { private final boolean invalid; @@ -664,6 +676,8 @@ public void setManualValidation(boolean enabled) { * message defined in the i18n object is used. * <p> * The method does nothing if the manual validation mode is enabled. + * + * @since 2.0.3 */ protected void validate() { validationController.validate(getValue()); @@ -775,6 +789,7 @@ private void executeLocaleUpdate() { * @param min * the minimum time, or {@code null} to remove this constraint * @see TimePickerI18n#setMinErrorMessage(String) + * @since 22.0 */ public void setMin(LocalTime min) { getElement().setProperty("min", FORMATTER.apply(min)); @@ -785,6 +800,7 @@ public void setMin(LocalTime min) { * * @return the minimum time, or {@code null} if no minimum is set * @see #setMax(LocalTime) + * @since 2.0 */ public LocalTime getMin() { return PARSER.apply(getElement().getProperty("min")); @@ -800,6 +816,7 @@ public LocalTime getMin() { * @param max * the maximum time, or {@code null} to remove this constraint * @see TimePickerI18n#setMaxErrorMessage(String) + * @since 22.0 */ public void setMax(LocalTime max) { getElement().setProperty("max", FORMATTER.apply(max)); @@ -810,6 +827,7 @@ public void setMax(LocalTime max) { * * @return the maximum time, or {@code null} if no maximum is set * @see #setMin(LocalTime) + * @since 2.0 */ public LocalTime getMax() { return PARSER.apply(getElement().getProperty("max")); @@ -905,6 +923,7 @@ public static Stream<Locale> getSupportedAvailableLocales() { * {@link #setI18n(TimePickerI18n)} * * @return the i18n object or {@code null} if no i18n object has been set + * @since 24.5 */ public TimePickerI18n getI18n() { return i18n; @@ -915,6 +934,7 @@ public TimePickerI18n getI18n() { * * @param i18n * the i18n object, not {@code null} + * @since 24.5 */ public void setI18n(TimePickerI18n i18n) { this.i18n = Objects.requireNonNull(i18n, @@ -928,6 +948,8 @@ private String getI18nErrorMessage( /** * The internationalization properties for {@link TimePicker}. + * + * @since 24.5 */ public static class TimePickerI18n implements Serializable { diff --git a/vaadin-time-picker-flow-parent/vaadin-time-picker-flow/src/main/java/com/vaadin/flow/component/timepicker/TimePickerVariant.java b/vaadin-time-picker-flow-parent/vaadin-time-picker-flow/src/main/java/com/vaadin/flow/component/timepicker/TimePickerVariant.java index eae7edec3b2..afd12fa576a 100644 --- a/vaadin-time-picker-flow-parent/vaadin-time-picker-flow/src/main/java/com/vaadin/flow/component/timepicker/TimePickerVariant.java +++ b/vaadin-time-picker-flow-parent/vaadin-time-picker-flow/src/main/java/com/vaadin/flow/component/timepicker/TimePickerVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-time-picker} component. + * + * @since 23.1 */ public enum TimePickerVariant implements ThemeVariant { LUMO_SMALL("small"), diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/AllFinishedEvent.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/AllFinishedEvent.java index c7f5bd106b3..572b6baa821 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/AllFinishedEvent.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/AllFinishedEvent.java @@ -23,6 +23,7 @@ * not. * * @author Vaadin Ltd. + * @since 2.1 */ public class AllFinishedEvent extends ComponentEvent<Upload> { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/FailedEvent.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/FailedEvent.java index 6365c12dc5e..aa6a13f90f2 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/FailedEvent.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/FailedEvent.java @@ -20,6 +20,7 @@ * interrupted for some reason. * * @author Vaadin Ltd. + * @since 1.0 */ public class FailedEvent extends FinishedEvent { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/FileRejectedEvent.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/FileRejectedEvent.java index 7705849f252..b3547090922 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/FileRejectedEvent.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/FileRejectedEvent.java @@ -22,6 +22,7 @@ * on {@link Upload} * * @author Vaadin Ltd. + * @since 2.1 */ public class FileRejectedEvent extends ComponentEvent<Upload> { @@ -56,6 +57,7 @@ public FileRejectedEvent(Upload source, String errorMessage) { * the error message * @param fileName * the rejected file name + * @since 24.4 */ public FileRejectedEvent(Upload source, String errorMessage, String fileName) { @@ -77,6 +79,7 @@ public String getErrorMessage() { * Get the file name. * * @return file name + * @since 24.4 */ public String getFileName() { return fileName; diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/FileRemovedEvent.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/FileRemovedEvent.java index f53ee3ca0bd..a36932e12e7 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/FileRemovedEvent.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/FileRemovedEvent.java @@ -21,6 +21,7 @@ * Sent when a file selected for upload is removed. * * @author Vaadin Ltd. + * @since 24.4 */ public class FileRemovedEvent extends ComponentEvent<Upload> { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/FinishedEvent.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/FinishedEvent.java index 8ca1c24beb6..6b63f516ae4 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/FinishedEvent.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/FinishedEvent.java @@ -24,6 +24,7 @@ * subclasses of the FinishedEvent. * * @author Vaadin Ltd. + * @since 1.0 */ public class FinishedEvent extends ComponentEvent<Upload> { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/MultiFileReceiver.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/MultiFileReceiver.java index 4fb2dd1599a..33d32e1e3ff 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/MultiFileReceiver.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/MultiFileReceiver.java @@ -22,6 +22,7 @@ * Informs the upload component that multi file upload is supported. * * @author Vaadin Ltd. + * @since 1.0 */ @FunctionalInterface public interface MultiFileReceiver extends Receiver { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/NoInputStreamEvent.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/NoInputStreamEvent.java index b7d61265c60..e4d30ec7894 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/NoInputStreamEvent.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/NoInputStreamEvent.java @@ -17,6 +17,8 @@ /** * FailedEvent that indicates that an input stream could not be obtained. + * + * @since 1.0 */ public class NoInputStreamEvent extends FailedEvent { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/NoOutputStreamEvent.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/NoOutputStreamEvent.java index 27526a25a7a..f48e4d7549e 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/NoOutputStreamEvent.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/NoOutputStreamEvent.java @@ -17,6 +17,8 @@ /** * FailedEvent that indicates that an output stream could not be obtained. + * + * @since 1.0 */ public class NoOutputStreamEvent extends FailedEvent { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/ProgressListener.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/ProgressListener.java index 34bea07bb19..6d6b0fb060e 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/ProgressListener.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/ProgressListener.java @@ -19,6 +19,8 @@ /** * ProgressListener receives events to track progress of upload. + * + * @since 1.0 */ @FunctionalInterface public interface ProgressListener extends Serializable { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/ProgressUpdateEvent.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/ProgressUpdateEvent.java index 470dd0f12ca..b8a874732f5 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/ProgressUpdateEvent.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/ProgressUpdateEvent.java @@ -21,6 +21,7 @@ * ProgressUpdateEvent is sent to track progress of upload. * * @author Vaadin Ltd. + * @since 1.0 */ public class ProgressUpdateEvent extends ComponentEvent<Upload> { @@ -69,6 +70,7 @@ public ProgressUpdateEvent(Upload source, long readBytes, * total size of file currently being uploaded, -1 if unknown * @param fileName * name of file currently being uploaded + * @since 24.4 */ public ProgressUpdateEvent(Upload source, long readBytes, long contentLength, String fileName) { @@ -109,6 +111,7 @@ public long getContentLength() { * Get the file name. * * @return file name + * @since 24.4 */ public String getFileName() { return fileName; diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/Receiver.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/Receiver.java index b3acdd0c3d9..d3264412186 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/Receiver.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/Receiver.java @@ -24,6 +24,7 @@ * * @author Vaadin Ltd. * @deprecated Use {@link com.vaadin.flow.server.streams.UploadHandler} instead + * @since 1.0 */ @Deprecated(since = "24.8", forRemoval = true) @FunctionalInterface diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/StartedEvent.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/StartedEvent.java index 1568074b4ec..677a7c4ae41 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/StartedEvent.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/StartedEvent.java @@ -21,6 +21,7 @@ * StartedEvent event is sent when the upload is started to received. * * @author Vaadin Ltd. + * @since 1.0 */ public class StartedEvent extends ComponentEvent<Upload> { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/SucceededEvent.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/SucceededEvent.java index b9bb49af8e4..60d576767a8 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/SucceededEvent.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/SucceededEvent.java @@ -19,6 +19,7 @@ * SucceededEvent event is sent when the upload is received successfully. * * @author Vaadin Ltd. + * @since 1.0 */ public class SucceededEvent extends FinishedEvent { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/Upload.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/Upload.java index 255a3a70e2a..72647c1f176 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/Upload.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/Upload.java @@ -57,6 +57,7 @@ * button or via drag and drop. * * @author Vaadin Ltd. + * @since 1.0 */ @Tag("vaadin-upload") @NpmPackage(value = "@vaadin/upload", version = "25.2.0") @@ -187,6 +188,7 @@ public Upload(Receiver receiver) { * * @param handler * upload handler that handles the upload, not {@code null} + * @since 24.8 */ public Upload(UploadHandler handler) { this(); @@ -203,6 +205,7 @@ public Upload(UploadHandler handler) { * the endpoint name (single path segment), used as the last path * segment of the dynamically generated upload URL; must not be * blank + * @since 25.0 */ public Upload(UploadHandler handler, String targetName) { this(); @@ -215,6 +218,7 @@ public Upload(UploadHandler handler, String targetName) { * @param listener * all finished listener to add * @return a {@link Registration} for removing the event listener + * @since 2.1 */ public Registration addAllFinishedListener( ComponentEventListener<AllFinishedEvent> listener) { @@ -245,6 +249,7 @@ public void setMaxFiles(int maxFiles) { * * @param type * the format type + * @since 25.1 */ public void setUploadFormat(UploadFormat type) { getElement().setAttribute("upload-format", type.name().toLowerCase()); @@ -368,6 +373,7 @@ public boolean isDropAllowed() { * if a {@link Receiver} is currently set, or if * {@link #setAcceptedFileTypes(String...)} is configured, as * mixing the deprecated and new APIs is not supported + * @since 25.2 */ public void setAcceptedMimeTypes(String... mimeTypes) { if (mimeTypes != null && mimeTypes.length > 0) { @@ -400,6 +406,7 @@ public void setAcceptedMimeTypes(String... mimeTypes) { * @throws IllegalStateException * if {@link #setAcceptedFileTypes(String...)} is configured, as * mixing the deprecated and new APIs is not supported + * @since 25.2 */ public List<String> getAcceptedMimeTypes() { checkNoDeprecatedFileTypes("getAcceptedMimeTypes"); @@ -435,6 +442,7 @@ public List<String> getAcceptedMimeTypes() { * if a {@link Receiver} is currently set, or if * {@link #setAcceptedFileTypes(String...)} is configured, as * mixing the deprecated and new APIs is not supported + * @since 25.2 */ public void setAcceptedFileExtensions(String... extensions) { if (extensions != null && extensions.length > 0) { @@ -466,6 +474,7 @@ public void setAcceptedFileExtensions(String... extensions) { * @throws IllegalStateException * if {@link #setAcceptedFileTypes(String...)} is configured, as * mixing the deprecated and new APIs is not supported + * @since 25.2 */ public List<String> getAcceptedFileExtensions() { checkNoDeprecatedFileTypes("getAcceptedFileExtensions"); @@ -750,6 +759,7 @@ protected void fireUpdateProgress(long totalBytes, long contentLength) { * actual size of the file being uploaded, if known * @param fileName * name of the file being uploaded + * @since 24.4 */ protected void fireUpdateProgress(long totalBytes, long contentLength, String fileName) { @@ -860,6 +870,7 @@ public Registration addSucceededListener( * @param listener * the listener * @return a {@link Registration} for removing the event listener + * @since 2.1 */ public Registration addFileRejectedListener( ComponentEventListener<FileRejectedEvent> listener) { @@ -872,6 +883,7 @@ public Registration addFileRejectedListener( * @param listener * the listener * @return a {@link Registration} for removing the event listener + * @since 24.4 */ public Registration addFileRemovedListener( ComponentEventListener<FileRemovedEvent> listener) { @@ -951,6 +963,7 @@ public void setReceiver(Receiver receiver) { * * @param handler * upload handler to use for file receptions, not {@code null} + * @since 24.8 */ public void setUploadHandler(UploadHandler handler) { setUploadHandler(handler, "upload"); @@ -969,6 +982,7 @@ public void setUploadHandler(UploadHandler handler) { * the endpoint name (single path segment), used as the last path * segment of the dynamically generated upload URL; must not be * blank + * @since 25.0 */ public void setUploadHandler(UploadHandler handler, String targetName) { Objects.requireNonNull(handler, "UploadHandler cannot be null"); @@ -1056,6 +1070,8 @@ public UploadI18N getI18n() { /** * Clear the list of files being processed, or already uploaded. + * + * @since 23.0 */ public void clearFileList() { getElement().executeJs("this.files = [];"); diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadButton.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadButton.java index dc65b97ce92..cde7659a39c 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadButton.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadButton.java @@ -36,6 +36,7 @@ * * @author Vaadin Ltd. * @see UploadManager + * @since 25.1 */ @Tag("vaadin-upload-button") @NpmPackage(value = "@vaadin/upload", version = "25.2.0") diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadDropZone.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadDropZone.java index 7b61655b7f3..6c1281ebfa6 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadDropZone.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadDropZone.java @@ -42,6 +42,7 @@ * * @author Vaadin Ltd. * @see UploadManager + * @since 25.1 */ @Tag("vaadin-upload-drop-zone") @NpmPackage(value = "@vaadin/upload", version = "25.2.0") diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadFileList.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadFileList.java index fbcb8e86c92..ddf4134f89b 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadFileList.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadFileList.java @@ -44,6 +44,7 @@ * * @author Vaadin Ltd. * @see UploadManager + * @since 25.1 */ @Tag("vaadin-upload-file-list") @NpmPackage(value = "@vaadin/upload", version = "25.2.0") diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadFileListI18N.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadFileListI18N.java index 325a8cd0c66..c1a2c85fb5a 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadFileListI18N.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadFileListI18N.java @@ -33,6 +33,8 @@ * errors</li> * <li>{@code units} - File size units</li> * </ul> + * + * @since 25.1 */ @JsonInclude(JsonInclude.Include.NON_NULL) public class UploadFileListI18N implements Serializable { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadFileListVariant.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadFileListVariant.java index ff7de6eb837..7d9248d06f4 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadFileListVariant.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadFileListVariant.java @@ -20,6 +20,8 @@ /** * Set of theme variants applicable for {@code vaadin-upload-file-list} * component. + * + * @since 25.1 */ public enum UploadFileListVariant implements ThemeVariant { THUMBNAILS("thumbnails"); diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadFormat.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadFormat.java index cbc099a4db6..1dab1bb9253 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadFormat.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadFormat.java @@ -17,6 +17,8 @@ /** * Specifies the upload format to use when sending files to the server. + * + * @since 25.1 */ public enum UploadFormat { /** diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadHelper.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadHelper.java index 93909d11529..0d937e1fb63 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadHelper.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadHelper.java @@ -29,6 +29,8 @@ * Utility methods for Upload and UploadManager components. * <p> * Intended only for internal use and can be removed or changed in the future. + * + * @since 25.1 */ public class UploadHelper implements Serializable { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadI18N.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadI18N.java index f784bd14095..ee644670736 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadI18N.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadI18N.java @@ -23,6 +23,8 @@ /** * The I18N helper file for the upload component. + * + * @since 1.0 */ @JsonInclude(JsonInclude.Include.NON_NULL) public class UploadI18N implements Serializable { @@ -428,6 +430,7 @@ public Error setForbidden(String forbidden) { * returns HTTP 413 (Payload Too Large). * * @return translation string + * @since 25.1 */ public String getFileTooLarge() { return fileTooLarge; @@ -440,6 +443,7 @@ public String getFileTooLarge() { * @param fileTooLarge * translation string * @return this instance for chaining + * @since 25.1 */ public Error setFileTooLarge(String fileTooLarge) { this.fileTooLarge = fileTooLarge; @@ -450,6 +454,8 @@ public Error setFileTooLarge(String fileTooLarge) { /** * unit translations. + * + * @since 1.2 */ @JsonInclude(JsonInclude.Include.NON_NULL) public static class Units implements Serializable { @@ -482,6 +488,7 @@ public Units(List<String> size) { * list of unit translations * @param sizeBase * units size base + * @since 24.5 */ public Units(List<String> size, Integer sizeBase) { this.size = size; @@ -513,6 +520,7 @@ public Units setSize(List<String> size) { * Gets the units size base. * * @return the units size base + * @since 24.5 */ public Integer getSizeBase() { return sizeBase; @@ -524,6 +532,7 @@ public Integer getSizeBase() { * @param sizeBase * units size base * @return units + * @since 24.5 */ public Units setSizeBase(Integer sizeBase) { this.sizeBase = sizeBase; @@ -533,6 +542,8 @@ public Units setSizeBase(Integer sizeBase) { /** * file translations. + * + * @since 23.3 */ @JsonInclude(JsonInclude.Include.NON_NULL) public static class File implements Serializable { @@ -696,6 +707,7 @@ public UploadI18N setAddFiles(AddFiles addFiles) { * Get file translations. * * @return file translations + * @since 23.3 */ public File getFile() { return file; @@ -707,6 +719,7 @@ public File getFile() { * @param file * file translations * @return i18n translations + * @since 23.3 */ public UploadI18N setFile(File file) { this.file = file; @@ -772,6 +785,7 @@ public Units getUnits() { * @param sizeBase * units size base * @return i18n translations + * @since 24.5 */ public UploadI18N setUnits(List<String> units, int sizeBase) { this.units = new Units(units, sizeBase); @@ -803,6 +817,7 @@ public UploadI18N setUnits(List<String> units) { * @param units * unit translations object. * @return unit translations. + * @since 1.2 */ public UploadI18N setUnits(Units units) { this.units = units; diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadManager.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadManager.java index 0c07ae06952..5cd54aeb41d 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadManager.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadManager.java @@ -70,6 +70,7 @@ * </pre> * * @author Vaadin Ltd. + * @since 25.1 */ public class UploadManager implements Serializable { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadVariant.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadVariant.java index 1836c8c4354..c9772c07590 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadVariant.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/UploadVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-upload} component. + * + * @since 25.0 */ public enum UploadVariant implements ThemeVariant { AURA_NO_BORDER("no-border"); diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/AbstractFileBuffer.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/AbstractFileBuffer.java index be1067c97e5..f448299499e 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/AbstractFileBuffer.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/AbstractFileBuffer.java @@ -26,6 +26,7 @@ * Abstract class for common file receiver buffers. * * @deprecated Use {@link com.vaadin.flow.server.streams.UploadHandler} instead + * @since 1.0 */ @Deprecated(since = "24.8", forRemoval = true) public abstract class AbstractFileBuffer implements Serializable { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/FileBuffer.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/FileBuffer.java index ea5003d5bec..9096b223dec 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/FileBuffer.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/FileBuffer.java @@ -36,6 +36,7 @@ * should be used. * * @deprecated Use {@link com.vaadin.flow.server.streams.UploadHandler} instead + * @since 1.0 */ @Deprecated(since = "24.8", forRemoval = true) public class FileBuffer extends AbstractFileBuffer implements Receiver { @@ -47,6 +48,8 @@ public class FileBuffer extends AbstractFileBuffer implements Receiver { * <p> * Files will be created using {@link File#createTempFile(String, String)} * and have that build 'upload_tmpfile_{FILENAME}_{currentTimeMillis}' + * + * @since 22.0 */ public FileBuffer() { super(); @@ -58,6 +61,7 @@ public FileBuffer() { * * @param factory * file factory for file buffer + * @since 22.0 */ public FileBuffer(FileFactory factory) { super(factory); diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/FileData.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/FileData.java index c224a4c2105..8904061412c 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/FileData.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/FileData.java @@ -21,6 +21,8 @@ /** * Class containing file information for upload. + * + * @since 1.0 */ @Deprecated(since = "24.8", forRemoval = true) public class FileData implements Serializable { @@ -78,6 +80,7 @@ public OutputStream getOutputBuffer() { * if outputBuffer is null * @throws UnsupportedOperationException * if outputBuffer is not an {@link UploadOutputStream} + * @since 19.0 */ public File getFile() { if (outputBuffer == null) { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/FileFactory.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/FileFactory.java index 3da80b2f6c1..9986732fb03 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/FileFactory.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/FileFactory.java @@ -23,6 +23,7 @@ * File factory interface for generating file to store the uploaded data into. * * @deprecated Use {@link com.vaadin.flow.server.streams.FileFactory} instead + * @since 1.0 */ @Deprecated(since = "24.8", forRemoval = true) public interface FileFactory extends Serializable { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/MemoryBuffer.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/MemoryBuffer.java index fd7df307dd1..f6046471589 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/MemoryBuffer.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/MemoryBuffer.java @@ -26,6 +26,7 @@ * Basic in memory file receiver implementation. * * @deprecated Use {@link com.vaadin.flow.server.streams.UploadHandler} instead + * @since 1.0 */ @Deprecated(since = "24.8", forRemoval = true) public class MemoryBuffer implements Receiver { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/MultiFileBuffer.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/MultiFileBuffer.java index e7eb9207cb1..e6c607d72d9 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/MultiFileBuffer.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/MultiFileBuffer.java @@ -39,6 +39,7 @@ * should be used. * * @deprecated Use {@link com.vaadin.flow.server.streams.UploadHandler} instead + * @since 1.0 */ @Deprecated(since = "24.8", forRemoval = true) public class MultiFileBuffer extends AbstractFileBuffer @@ -51,6 +52,8 @@ public class MultiFileBuffer extends AbstractFileBuffer * <p> * Files will be created using {@link File#createTempFile(String, String)} * and have that build 'upload_tmpfile_{FILENAME}_{currentTimeMillis}' + * + * @since 22.0 */ public MultiFileBuffer() { super(); @@ -62,6 +65,7 @@ public MultiFileBuffer() { * * @param factory * file factory for file buffer + * @since 22.0 */ public MultiFileBuffer(FileFactory factory) { super(factory); diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/MultiFileMemoryBuffer.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/MultiFileMemoryBuffer.java index f48892d24ba..4e6fa6ad1d4 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/MultiFileMemoryBuffer.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/MultiFileMemoryBuffer.java @@ -29,6 +29,7 @@ * Basic multi file in memory file receiver implementation. * * @deprecated Use {@link com.vaadin.flow.server.streams.UploadHandler} instead + * @since 1.0 */ @Deprecated(since = "24.8", forRemoval = true) public class MultiFileMemoryBuffer implements MultiFileReceiver { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/TempDirectory.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/TempDirectory.java index 394f975e579..2b8251f85ad 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/TempDirectory.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/TempDirectory.java @@ -21,6 +21,9 @@ import java.util.logging.Level; import java.util.logging.Logger; +/** + * @since 21.0.4 + */ @Deprecated(since = "24.8", forRemoval = true) public final class TempDirectory { private final Path path; diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/TemporaryFileFactory.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/TemporaryFileFactory.java index eed1fdb7f0e..144d44267a6 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/TemporaryFileFactory.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/TemporaryFileFactory.java @@ -20,6 +20,9 @@ import java.nio.file.Files; import java.nio.file.Path; +/** + * @since 21.0.4 + */ @Deprecated(since = "24.8", forRemoval = true) public class TemporaryFileFactory implements FileFactory { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/UploadOutputStream.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/UploadOutputStream.java index ebb98748ea1..e0fe62e5f28 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/UploadOutputStream.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/UploadOutputStream.java @@ -22,6 +22,8 @@ /** * FileOutputStream with a reference to the output file. + * + * @since 19.0 */ @Deprecated(since = "24.8", forRemoval = true) public class UploadOutputStream extends FileOutputStream diff --git a/vaadin-virtual-list-flow-parent/vaadin-virtual-list-flow/src/main/java/com/vaadin/flow/component/virtuallist/VirtualList.java b/vaadin-virtual-list-flow-parent/vaadin-virtual-list-flow/src/main/java/com/vaadin/flow/component/virtuallist/VirtualList.java index b9ccbc443ba..228a06f6efd 100644 --- a/vaadin-virtual-list-flow-parent/vaadin-virtual-list-flow/src/main/java/com/vaadin/flow/component/virtuallist/VirtualList.java +++ b/vaadin-virtual-list-flow-parent/vaadin-virtual-list-flow/src/main/java/com/vaadin/flow/component/virtuallist/VirtualList.java @@ -68,6 +68,7 @@ * * @param <T> * the type of the items supported by the list + * @since 21.0 */ @Tag("vaadin-virtual-list") @NpmPackage(value = "@vaadin/virtual-list", version = "25.2.0") @@ -318,6 +319,7 @@ private void setViewportRange(int start, int length) { * * @param rowIndex * zero based index of the item to scroll to in the current view. + * @since 24.3 */ public void scrollToIndex(int rowIndex) { getElement().getNode().runWhenAttached( @@ -327,6 +329,8 @@ public void scrollToIndex(int rowIndex) { /** * Scrolls to the first element. + * + * @since 24.3 */ public void scrollToStart() { scrollToIndex(0); @@ -334,6 +338,8 @@ public void scrollToStart() { /** * Scrolls to the last element of the list. + * + * @since 24.3 */ public void scrollToEnd() { scrollToIndex(Integer.MAX_VALUE); @@ -349,6 +355,7 @@ public void scrollToEnd() { * the item accessible name generator to set, not {@code null} * @throws NullPointerException * if {@code itemAccessibleNameGenerator} is {@code null} + * @since 24.7 */ public void setItemAccessibleNameGenerator( SerializableFunction<T, String> itemAccessibleNameGenerator) { @@ -362,6 +369,7 @@ public void setItemAccessibleNameGenerator( * Gets the function that generates accessible names for virtual list items. * * @return the item accessible name generator + * @since 24.7 */ public SerializableFunction<T, String> getItemAccessibleNameGenerator() { return itemAccessibleNameGenerator; diff --git a/vaadin-virtual-list-flow-parent/vaadin-virtual-list-flow/src/main/java/com/vaadin/flow/component/virtuallist/VirtualListVariant.java b/vaadin-virtual-list-flow-parent/vaadin-virtual-list-flow/src/main/java/com/vaadin/flow/component/virtuallist/VirtualListVariant.java index 140337dcdb6..3356bbae691 100644 --- a/vaadin-virtual-list-flow-parent/vaadin-virtual-list-flow/src/main/java/com/vaadin/flow/component/virtuallist/VirtualListVariant.java +++ b/vaadin-virtual-list-flow-parent/vaadin-virtual-list-flow/src/main/java/com/vaadin/flow/component/virtuallist/VirtualListVariant.java @@ -19,6 +19,8 @@ /** * Set of theme variants applicable for {@code vaadin-virtual-list} component. + * + * @since 25.0 */ public enum VirtualListVariant implements ThemeVariant { LUMO_OVERFLOW_INDICATORS("overflow-indicators"), diff --git a/vaadin-virtual-list-flow-parent/vaadin-virtual-list-flow/src/main/java/com/vaadin/flow/component/virtuallist/paging/PagelessDataCommunicator.java b/vaadin-virtual-list-flow-parent/vaadin-virtual-list-flow/src/main/java/com/vaadin/flow/component/virtuallist/paging/PagelessDataCommunicator.java index f2ae3d175a7..02ffe0cf1c9 100644 --- a/vaadin-virtual-list-flow-parent/vaadin-virtual-list-flow/src/main/java/com/vaadin/flow/component/virtuallist/paging/PagelessDataCommunicator.java +++ b/vaadin-virtual-list-flow-parent/vaadin-virtual-list-flow/src/main/java/com/vaadin/flow/component/virtuallist/paging/PagelessDataCommunicator.java @@ -29,6 +29,7 @@ * * @param <T> * item type + * @since 21.0 */ public class PagelessDataCommunicator<T> extends DataCommunicator<T> { From 5ed090fafc84db648f3d831d570710dc05cf82c0 Mon Sep 17 00:00:00 2001 From: Artur Signell <artur@vaadin.com> Date: Fri, 26 Jun 2026 15:21:48 +0300 Subject: [PATCH 2/2] Remove invalid default constructor -> no arg constructor since tags --- .../java/com/vaadin/flow/component/accordion/Accordion.java | 2 -- .../com/vaadin/flow/component/upload/receivers/FileBuffer.java | 2 -- .../vaadin/flow/component/upload/receivers/MultiFileBuffer.java | 2 -- 3 files changed, 6 deletions(-) diff --git a/vaadin-accordion-flow-parent/vaadin-accordion-flow/src/main/java/com/vaadin/flow/component/accordion/Accordion.java b/vaadin-accordion-flow-parent/vaadin-accordion-flow/src/main/java/com/vaadin/flow/component/accordion/Accordion.java index 6958ab89a8e..131c9114d2f 100644 --- a/vaadin-accordion-flow-parent/vaadin-accordion-flow/src/main/java/com/vaadin/flow/component/accordion/Accordion.java +++ b/vaadin-accordion-flow-parent/vaadin-accordion-flow/src/main/java/com/vaadin/flow/component/accordion/Accordion.java @@ -59,8 +59,6 @@ public class Accordion extends Component implements HasSize, HasStyle { /** * Initializes a new Accordion component. - * - * @since 25.1.7 */ public Accordion() { if (getElement().getPropertyRaw(OPENED_PROPERTY) == null) { diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/FileBuffer.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/FileBuffer.java index 9096b223dec..dd9c8c2d4fc 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/FileBuffer.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/FileBuffer.java @@ -48,8 +48,6 @@ public class FileBuffer extends AbstractFileBuffer implements Receiver { * <p> * Files will be created using {@link File#createTempFile(String, String)} * and have that build 'upload_tmpfile_{FILENAME}_{currentTimeMillis}' - * - * @since 22.0 */ public FileBuffer() { super(); diff --git a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/MultiFileBuffer.java b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/MultiFileBuffer.java index e6c607d72d9..1c374fcb4e1 100644 --- a/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/MultiFileBuffer.java +++ b/vaadin-upload-flow-parent/vaadin-upload-flow/src/main/java/com/vaadin/flow/component/upload/receivers/MultiFileBuffer.java @@ -52,8 +52,6 @@ public class MultiFileBuffer extends AbstractFileBuffer * <p> * Files will be created using {@link File#createTempFile(String, String)} * and have that build 'upload_tmpfile_{FILENAME}_{currentTimeMillis}' - * - * @since 22.0 */ public MultiFileBuffer() { super();