Directory

SO Components - Vaadin Add-on Directory

A set of Vaadin Flow Components and Abstractions SO Components - Vaadin Add-on Directory
# SO Components A set of Vaadin Flow Components and Abstractions (Sample screenshots are from a commercial application under development that uses this add-on) ## Dependencies https://vaadin.com/directory/component/so-helper Ver 3.0.0 or later (helper classes) https://vaadin.com/directory/component/textfield-formatter Ver 5.4.0 or later (for field formatting features). https://xmlgraphics.apache.org/batik Ver 1.11 (for SVG image manipulation). ## Use Cases There are 2 different ways of using this add-on. ### Normal Use It can be used to utilize the components (especially "fields" and "forms") available in this add-on. The "form" concept here supports a mechanism that doesn't require direct use of Vaadin's "Binder" classes to create data entry forms. A hidden binder does all the tricks. Also, there are two notable classes: DataGrid and TreeDataGrid. These classes are enhanced versions of Vaadin's Grid and TreeGrid respectively. Two layout classes are worth mentioning: ButtonLayout and GridLayout. A Dashboard class is also available. ### Single-Page Application This is the 2nd use case. Single-page applications typically use an "application layout" with a "menu area" and "content area". The content area displays the current "view". A view may be any sort of information displayed in the content area. It could be a "data entry screen", some sort of chart or a dashboard. This add-on contains certain classes to create different "views" including "data entry screens". Please see the documentation of the Application class to get an idea of how to create a single-page application. ## Documentation Most classes are documented with some explanation about its usage. Please see the API documentation: https://storedobject.com/api/com/storedobject/vaadin/package-summary.html ## Source Code Available at https://github.com/syampillai/SOComponents ## Sample Starter Application Available at https://github.com/syampillai/SOSample
View on GitHub
Sample Starter Application
API
Online Demo

SO Components version 0.9.6
Revamped version, please read the overview.

SO Components version 0.10.0
API additions to in DataGrid and DataTreeGrid (New methods for creating HTML columns. Also, DataTreeGrid now supports HTML in the hierarchy column). Bug fixes. This version requires Vaadin Flow 13+. Use version 0.9.6 for Vaadin Flow 12+ .

SO Components version 1.2.3
Vaadin 14+ stable release in NPM mode

SO Components version 1.3.2
Vaadin 14+ NPM mode Minor improvements

SO Components version 1.4.0
Vaadin 14+ NPM mode API change: Clickable class constructor now takes ClickHandler as a parameter instead of ComponentEventListener

SO Components version 1.4.1
Vaadin 14+ NPM mode Minor enhancements

SO Components version 1.5.0
Vaadin 14+ NPM mode New component: Tabs

SO Components version 1.6.0
Vaadin 14+ NPM mode Enhancements

SO Components version 1.6.1
Updated for Vaadin 14.0.7 (NPM mode). Bug fixed in ObjectForm's addField(String) method.

SO Components version 1.7.0
Vaadin 14.0.7+ (NPM mode) Added new class TokensField

SO Components version 1.8.0
Vaadin 14.0.7+ (NPM mode) Added DetailComponent.

SO Components version 1.9.0
Vaadin version 14.0.8+ NPM mode Newly added: HomeView, Image, ImageView, ResourcedComponent, ResourceSupport. Bug fixes. Other minor enhancements.

SO Components version 1.9.1
Vaadin 14.0.8+ NPM mode Minor enhancements and bug fixes

SO Components version 2.0.0
Vaadin 14.0.9+ NPM mode. Addition of new classes and APIs. Enhancements.

SO Components version 2.1.0
Vaadin version 14.0.12 NPM mode Bug fixes and minor enhancements New components: VideoCapture, AudioCapture

SO Components version 3.0.0
Vaadin 14.0.2, NPM mode This version has API changes (AbstractForm class introduced) but most of it are internal. So, existing code will not be affected.

SO Components version 3.0.1
Vaadin 14.0.12 NPM mode Bug fixed in NumericField. Addition of API methods in ChoiceField and ListField. New classes RubikCube, YouTube.

SO Components version 3.0.2
Vaadin 14.0.13 (NPM mode) Bug fixed in the internal binder for Forms/Data Views. Validations were not working after the recent internal changes.

SO Components version 3.0.3
Vaadin 14.0.15+ NPM mode. Added new class TokenChoicesField. Other minor enhancements.

SO Components version 3.0.4
Vaadin 14.1.1+ NPM mode

SO Components version 3.0.5
Vaadin 14.1.1+ NPM mode Bug fixed: Error when adding non-visual HasValues to Form. Added a couple of new join methods in GridRow class.

SO Components version 3.0.6
Vaadin 14.1.3 NPM mode Small enhancements

SO Components version 3.1.0
Vaadin 14.1.4 NPM mode CustomField's width issue of is fixed by Vaadin. So, few Fields (including TranslatedField) that are extended from CustomField now expand to full width in FormLayout. Other minor enhancements.

SO Components version 3.2.0
Vaadin 14.1.5 NPM mode. CSSGrid is introduced as the base class for GridLayout and Dashboard. scrollTo(...) method is removed from HasColumns.

SO Components version 3.3.0
Vaadin 14.1.16 NPM mode New class: Popup. PDFViewer now uses just "object" tag. Minor enhancements.

SO Components version 3.4.0
Vaadin 14.1.17 NPM mode New interface: InvisibleComponent New class: ContentWithHeaderButtons

SO Components version 3.5.0
Vaadin version 14.1.17 NPM mode Minor enhancements (contain additional methods) and bug fixes.

SO Components version 3.5.1
Vaadin version 14.1.18 NPM mode Minor enhancements

SO Components version 3.5.2
Vaadin 14.1.20+ NPM mode Minor enhancements

SO Components version 3.6.0
Vaadin 14.1.20 NPM mode New sorting related enhancements in DataGrid Bug fixed in StyledText Other minor enhancements

SO Components version 3.6.1
Vaadin 14.1.21 NPM mode Minor enhancements and bug fixes.

SO Components version 4.0.0
Vaadin 15.0.3+ First release for Vaadin 15+

SO Components version 4.0.1
Vaadin 15.0.3+ Added getColumnSorter() method in HasColumns

SO Components version 4.1.0
Vaadin 15.0.4+ Added setMaskValue(int) in ChoicesField and TokenChoicesField.

SO Components version 4.2.0
Vaadin 15.0.5+ Added new interface NoField Added new class Breadcrumbs

SO Components version 5.0.1
Vaadin Version 15.0.5+ Default ApplicationLayout now uses Vaadin's AppLayout.

SO Components version 6.0.0
Vaadin 15.0.6+ There are few API changes and additional classes. Requires Java 11+

SO Components version 6.0.1
Vaadin 15.0.6+ Requires Java 11+ Minor enhancements.

SO Components version 6.0.3
Vaadin 15.0.6+ Requires Java 11 Minor enhancements & bug fixes Additional methods in HasColumns (Version 6.0.2 withdrawn due to a bug)

SO Components version 7.0.0
Vaadin 16.0.0+ Requires Java 11+

SO Components version 7.0.1
Vaadin 16.0.0+ Requires Java 11+ Minor enhancements

SO Components version 7.1.0
Vaadin 16.0.2+ Requires Java 11+ Added ToggleButton (works like CheckBox)

SO Components version 7.1.1
Vaadin version 16.0.2 Requires Java 11+ Minor enhancements in the ComboField and the BooleanField. Minor bug fix in the Application class.

SO Components version 7.2.0
Vaadin version 16.0.2+ Requires Java 11+ Added FieldCustomizer interface (used in Forms). New method getViewComponent in HasColumns. Views may now be embedded in other Views. New method in the ViewOpenedListener.

SO Components version 7.2.1
Vaadin version > 14, < 17 Requires Java 11+ Added setData, getData methods in Application. Fixed column ordering issue in HasColumns.

SO Components version 8.0.0
Requires Vaadin version 17.0.0+ Requires Java 11+ Slight API changes in ListField due to API changes in Vaadin 17 release.

SO Components version 8.0.1
Requires Vaadin version 17.0.0+ Requires Java 11+ Complied with Vaadin 17.0.2 and Java 11. Added new class: MapComboField.

SO Components version 8.0.2
Requires Vaadin version 17.0.0+ Requires Java 11+ Complied with Vaadin 17.0.2 and Java 11. Added new methods in MapComboField and DataEditor.

SO Components version 8.1.0
Requires Vaadin version 17.0.0+ Requires Java 11+ Complied with Vaadin 17.0.2 and Java 11. Added new methods in MapComboField and ListGrid. New class: DataList.

SO Components version 8.1.1
Requires Vaadin version 17.0.0+ Requires Java 11+ Complied with Vaadin 17.0.2 and Java 11. Added new methods in MapComboField and ListGrid. New class: DataList. Minor bug fix.

SO Components version 8.2.0
Requires Vaadin version 17.0.0+ Requires Java 11+ Complied with Vaadin 17.0.3 and Java 11. Form can now be used as a Component. Some enhancements and comments are updated.

SO Components version 8.2.1
Complied with Vaadin version 17.0.7 and Java 11 Removed temporary fix in TokensField due to the changes in Vaadin 17 Minor bug fixed in DataForm

SO Components version 8.2.2
Complied with Vaadin version 17.0.7 and Java 11. Minor bug fixed in setFieldEditable(HasValue... fields) of AbstractDataForm. Default ValueChangeMode of ActionTextField is now ValueChangeMode.TIMEOUT with 1 second delay. New methods in RubikCube, Application.

SO Components version 8.3.0
Complied with Vaadin version 17.0.7 and Java 11. Added new methods in HasColumns and AbstractDataForm. New interface ConstructedListener.

SO Components version 8.3.1
Complied with Vaadin version 17.0.7 and Java 11. Minor code refactoring. New default methods in ApplicationLayout and ApplicationMenuItem. New method in ApplicationFrame.

SO Components version 8.3.2
Complied with Vaadin version 17.0.9 and Java 11. New method in View. Minor bug fixed in Tabs, UploadField.

SO Components version 8.3.3
Complied with Vaadin version 17.0.10 and Java 11. New methods in AbstractDataForm. Fixed some typos.

SO Components version 8.3.4
Complied with Vaadin version 17.0.10 and Java 11. New methods in AbstractDataForm. Fixed some typos.

SO Components version 8.4.0
Complied with Vaadin version 17.0.11 and Java 11. Style changes in WindowDecorator, DataForm and SpeakerButton.

SO Components version 8.4.1
Complied with Vaadin version 17.0.11 and Java 11. View adds a 5px padding to its component but can be overridden in its decorateComponent method.

SO Components version 8.5.0
Complied with Vaadin version 17.0.11 and Java 11. Added new field: BooleanRadioField.

SO Components version 9.0.0
Complied with Vaadin version 18.0.2 and Java 11. Migrated all Polymer components to LitElement components.

SO Components version 9.0.1
Complied with Vaadin version 18.0.2 and Java 11 clearAlerts() in Application class was not working and is fixed.

SO Components version 9.1.0
Complied with Vaadin version 18.0.2 and Java 11 More style settings added. New method resizeContent() in ApplicationLayout class.

SO Components version 9.1.1
Complied with Vaadin version 18.0.3 and Java 11 Fixed a bug in HasColumns. Removed unwanted files from the jar.

SO Components version 9.1.2
Complied with Vaadin version 18.0.3 and Java 11 Bug fixed in styling of ToggleButton.

SO Components version 9.1.3
Complied with Vaadin version 18.0.3 and Java 11. A race condition in the internal view manager is fixed.

SO Components version 9.1.4
Complied with Vaadin version 18.0.3 and Java 11 A minor bug fix in the internal view manager.

SO Components version 9.2.0
Complied with Vaadin version 18.0.3 and Java 11 New Components: SelectGrid and MultiSelectGrid.

SO Components version 9.3.0
Compiled with Vaadin version 18.0.3 and Java 11 New interface: RequiredField

SO Components version 9.3.1
Complied with Vaadin version 18.0.3 and Java 11 Improvements in SelectGrid.

SO Components version 9.3.3
Complied with Vaadin version 18.0.3 and Java 11 Bug fixed in ObjectForm to ignore Caption attribute of the View while building fields.

SO Components version 9.3.4
Complied with Vaadin version 18.0.5 and Java 11 Bug fixed in GridRow to handle frozen columns.

SO Components version 9.4.0
Complied with Vaadin version 18.0.5 and Java 11 HasColumns has a new method getRelativeColumnWidth. PopupButton sets internal button widths to 100%.

SO Components version 9.4.2
Complied with Vaadin version 18.0.5 and Java 11 Additional addField methods in AbstractDataEditor Default alignment of CSSGrid children is Position.START

SO Components version 9.4.3
Complied with Vaadin version 18.0.5 and Java 11 New method getActiveViews() in Application.

SO Components version 9.4.4
Complied with Vaadin version 18.0.5 and Java 11 Minor bug fixed in StyledText.

SO Components version 9.5.0
Complied with Vaadin version 18.0.5 and Java 11 New default method in HasColumns.

SO Components version 9.5.1
Complied with Vaadin version 18.0.6 and Java 11 New class: FreeFormatField

SO Components version 9.5.2
Complied with Vaadin version 18.0.6 and Java 11 Additional constructor for FreeFormatField

SO Components version 9.5.3
Complied with Vaadin version 18.0.6 and Java 11 Bug fixed in FreeFormatField

SO Components version 9.6.0
Complied with Vaadin version 18.0.7 and Java 11 New class: WrappedView.

SO Components version 9.6.1
Complied with Vaadin version 18.0.7 and Java 11 Bug fixed in classes: WrappedView, Dashboard.

SO Components version 9.6.2
Complied with Vaadin version 18.0.7 and Java 11. Bug fixed in classes: WrappedView, Dashboard. so-helper updated to 2.1.0

SO Components version 9.6.3
Complied with Vaadin version 18.0.7 and Java 11 NumericField is right-aligned now.

SO Components version 9.6.4
Complied with Vaadin version 18.0.7 and Java 11 Bug fixed in MapComboField.

SO Components version 9.6.5
Complied with Vaadin version 18.0.7 and Java 11 New static method in Alert to set default position.

SO Components version 9.7.0
Complied with Vaadin version 19.0.2 and Java 11

SO Components version 9.7.1
Complied with Vaadin version 19.0.3 and Java 11 New interface: DisablePaste. TextField and CustomTextField implements it.

SO Components version 9.7.2
Complied with Vaadin version 19.0.5 and Java 11. setPlaceholder(String) method in ChoiceField.

SO Components version 9.7.3
Complied with Vaadin version 19.0.5 and Java 11. uppercase()/lowercase()/capitalize() methods in TextField.

SO Components version 9.7.4
Complied with Vaadin version 19.0.6 and Java 11. getDrawerToggle() method added to ApplicationFrame.

SO Components version 9.7.5
Complied with Vaadin version 19.0.6 and Java 11. New component: TimerComponent.

SO Components version 9.7.6
Complied with Vaadin version 19.0.6 and Java 11. Additional methods in TimerComponent.

SO Components version 9.7.7
Compiled with Vaadin version 19.0.6 and Java 11. Bug fixed in CustomTextField formatting. Multiple IncludeFields checker in AbstractDataForm/AbstractForm. setSpellCheck(boolean) method in TextField.

SO Components version 9.7.8
Compiled with Vaadin version 19.0.6 and Java 11. Bug fixed in CustomTextField formatting. Multiple IncludeFields checker in AbstractDataForm/AbstractForm. setSpellCheck(boolean) method in TextField.

SO Components version 9.7.9
Compiled with Vaadin version 19.0.6 and Java 11. New classes: CenteredLayout, Viewer.

SO Components version 9.8.0
Compiled with Vaadin version 19.0.6 and Java 11. New interface: SpellCheck.

SO Components version 9.8.1
Compiled with Vaadin version 19.0.6 and Java 11. Support for query parameters in Application class.

SO Components version 9.8.2
Compiled with Vaadin version 20.0.1 and Java 11. New features in DateField.

SO Components version 9.8.3
Compiled with Vaadin version 20.0.3 and Java 11. Internal bug fixed in Data class.

SO Components version 9.8.4
Compiled with Vaadin version 20.0.3 and Java 11. Internal bug fixed in AbstractForm and ObjectForm.

SO Components version 9.8.5
Compiled with Vaadin version 20.0.3 and Java 11. Bug fixed in the View.focus() method. It was ignoring the "first focus" set.

SO Components version 9.8.6
Compiled with Vaadin version 20.0.3 and Java 11. Application.access(..) now calls UI.push() automatically.

SO Components version 9.8.7
Compiled with Vaadin version 20.0.3 and Java 11. BooleanRadioField now supports null values.

SO Components version 9.8.8
Compiled with Vaadin version 20.0.4 and Java 11. Facility to set default padding for all the Views. Application's notification calls access() method to make sure that UI is locked appropriately.

SO Components version 9.9.0
Compiled with Vaadin version 20.0.4 and Java 11. Bug fixed in the handling of null values in ChoiceField and BooleanRadioField. Also, fixed the side effects on the BooleanField.

SO Components version 9.9.1
Compiled with Vaadin version 20.0.4 and Java 11. Application's access method silently ignores errors after UI is disconnected.

SO Components version 9.9.2
Compiled with Vaadin version 20.0.4 and Java 11. Minor internal bug fix.

SO Components version 9.9.3
Compiled with Vaadin version 20.0.5 and Java 11. Minor bug fix in MultiSelectGrid.

SO Components version 9.9.4
Compiled with Vaadin version 20.0.5 and Java 11. New component: BreadcrumbsTree.

SO Components version 9.9.5
Compiled with Vaadin version 20.0.6 and Java 11. In SPA mode, session is invalidated when application is closed.

SO Components version 9.9.7
Compiled with Vaadin version 20.0.7 and Java 11. NPE bug fixed in ChoiceField when null is set as the value for mandatory fields. New method AbstractDataEditor#setFixedValues.

SO Components version 9.9.8
Compiled with Vaadin version 21.0.1 and Java 11. Icon class is restructured.

SO Components version 9.9.9
Compiled with Vaadin version 21.0.1 and Java 11. Fixed NPE in HasColumns when interface instead of class is used.

SO Components version 10.0.0
Compiled with Vaadin version 21.0.4 and Java 11. New class: InformationMessage. Additional methods in ActionForm.

SO Components version 10.0.1
Compiled with Vaadin version 21.0.6 and Java 11. ListGrid now supports customized ListDataProviders.

SO Components version 10.0.2
Compiled with Vaadin version 22.0.2 and Java 11. Bug fixed in Icon. Implementation of TokensField changed.

SO Components version 10.0.3
Compiled with Vaadin version 22.0.2 and Java 11. Added setPlaceholder to TokensField.

SO Components version 10.0.5
Compiled with Vaadin version 22.0.2 and Java 11. Added is/setRequired to TokensField.

SO Components version 10.0.6
Compiled with Vaadin version 22.0.2 and Java 11. Added a couple of methods to TokensField. Changed: filter methods in ListGrid.

SO Components version 10.0.7
Compiled with Vaadin version 22.0.4 and Java 17. Added methods to ListField in line with ComboField. Added createComponentColumn(...) method to HasColumns.

SO Components version 10.0.8
Compiled with Vaadin version 22.0.4 and Java 17. Minor bug fixed in Application.ViewManager class.

SO Components version 10.0.9
Compiled with Vaadin version 22.0.4 and Java 17. New class: MenuBar (Wrapper for Vaadin's MenuBar)

SO Components version 10.1.1
Compiled with Vaadin version 22.0.4 and Java 17. New class: Minor bug fixed in TranslatedField

SO Components version 10.1.2
Compiled with Vaadin version 22.0.5 and Java 17. Fixed minor bug in TokensField. Added epoch handling in DateField and LegacyDateField.

SO Components version 10.1.3
Compiled with Vaadin version 22.0.5 and Java 17. Fixed minor bug in TokensField.

SO Components version 10.1.4
Compiled with Vaadin version 22.0.6 and Java 17. Added getCaption() method in Application and ApplicationLayout. ApplicationView now implements HasDynamicTitle.

SO Components version 10.1.6
Compiled with Vaadin version 22.0.6 and Java 17. Added centering feature to DataForm. Dependency update.

SO Components version 10.1.7
Compiled with Vaadin version 22.0.6 and Java 17. Removed support for Vaadin Icons in ButtonIcon. Vaadin Icons are no more Iron icons. Added new interface: HasVisibility.

SO Components version 10.1.8
Compiled with Vaadin version 22.0.7 and Java 17. Internal code refactoring. Added methods in: AbstractDataEditor, DataForm, ObjectForm, ApplicationView, Application.

SO Components version 10.1.9
Compiled with Vaadin version 22.0.7 and Java 17. Added new methods in: ActionTextField and SearchField.

SO Components version 10.2.0
Compiled with Vaadin version 22.0.13 and Java 17. Internal code refactoring. New methods in View class.

SO Components version 10.2.1
Compiled with Vaadin version 22.0.14 and Java 17. New class: GridColumnDetail.

SO Components version 11.0.0
Compiled with Vaadin version 23.0.9 and Java 17. Reimplemented TokensField. Enhancements in TextField and TextArea to support upper/lower-casing.

SO Components version 11.0.1
Compiled with Vaadin version 23.0.9 and Java 17 New class: AnchorButton Upgraded Lit

SO Components version 11.0.2
Compiled with Vaadin version 23.1.0 and Java 17. Support for disabling button icons. Minor code enhancements.

SO Components version 11.0.3
Compiled with Vaadin version 23.1.0 and Java 17. Added methods: DataForm.setCloseable, DataForm.sizeSet, WindowDecorator.setCloseable.

SO Components version 11.0.5
Compiled with Vaadin version 23.1.0 and Java 17. Support for full-screen mode in the View. New class: Clock.

SO Components version 11.0.6
Compiled with Vaadin version 23.1.0 and Java 17. Bug fixed in the implementation of full-screen mode in the View. New methods: Clock.showUTC, Application.isFullScreenMode, View.setFullScreen

SO Components version 11.0.7
Compiled with Vaadin version 23.1.1 and Java 17. Minor bug fixed in HasColumns to handle more flexible template captions.

SO Components version 11.0.8
Compiled with Vaadin version 23.1.1 and Java 17. Added method GridColumnDetail.setVisible.

SO Components version 11.0.9
Compiled with Vaadin version 23.1.1 and Java 17. New class: ViewGrid

SO Components version 11.1.0
Compiled with Vaadin version 23.1.1 and Java 17. StickyElement.sticky method doesn't set the background colour anymore.

SO Components version 11.1.1
Compiled with Vaadin version 23.1.2 and Java 17.

SO Components version 11.1.2
Compiled with Vaadin version 23.1.2 and Java 17. New interface: SupportWindowMode New methods: HasColumns.createDecoratedWindow, ButtonLayout.createFiller

SO Components version 11.1.3
Compiled with Vaadin version 23.2.0 and Java 17. NumericField is no more right-aligned by default (You may use CustomTextField.alignRight instead). TokensField re-implemented using Vaadin's multi-combo.

SO Components version 11.1.5
Compiled with Vaadin version 23.2.4 and Java 17. New method: Viewer.createWindowDecorator

SO Components version 11.1.6
Compiled with Vaadin version 23.2.6 and Java 17. Internal code improvement.

SO Components version 11.1.7
Compiled with Vaadin version 23.2.6 and Java 17. HasAutocomplete added to HasTextValue and CustomTextField.

SO Components version 11.1.8
Compiled with Vaadin version 23.2.6 and Java 17. Handling of run-time exceptions in DataForm's process() method.

SO Components version 11.1.9
Compiled with Vaadin version 23.2.7 and Java 17. Implementation changed: Application.setData and Application.removeData (Dependency on UI removed).

SO Components version 11.1.10
Compiled with Vaadin version 23.2.9 and Java 17.

SO Components version 11.1.11
Compiled with Vaadin version 23.2.11 and Java 17.

SO Components version 11.1.12
Compiled with Vaadin version 23.3.0 and Java 17. Added methods Application.getLocale. Removed some deprecated method usages.

SO Components version 11.1.13
Compiled with Vaadin version 23.3.2 and Java 17. Added new methods in RadioChoiceField and RadioField.

SO Components version 11.1.14
Compiled with Vaadin version 23.2.15 and Java 17. Rolled back Vaadin version due to issues related to 23.3.x versions.

SO Components version 11.1.15
Compiled with Vaadin version 23.2.16 and Java 17. Additional Null pointer checks in ApplicationFrame class.

SO Components version 11.1.16
Compiled with Vaadin version 23.2.16 and Java 17. Dependency update to resolve vulnerabilities in Apache XML graphics libs.

SO Components version 11.1.17
Compiled with Vaadin version 23.2.16 and Java 17. Workaround for the bug in the speech synthesizer of Chrome. New method: Application.isSpeaking.

SO Components version 11.1.21
Version 11.1.21 Minor code refactoring.