diff options
author | Pekka Hyvönen <pekka@vaadin.com> | 2017-03-17 09:38:09 +0200 |
---|---|---|
committer | Henri Sara <henri.sara@gmail.com> | 2017-03-17 09:38:09 +0200 |
commit | ea2d386f3b49c0c67f6e9685b7e4d7868bdadc8e (patch) | |
tree | 8e2a18ddea05f271488e2d95695a44918653997c /all/src/main/templates | |
parent | af6d13a22b9ed7ec04b731cab2cdeda23ac44fd4 (diff) | |
download | vaadin-framework-ea2d386f3b49c0c67f6e9685b7e4d7868bdadc8e.tar.gz vaadin-framework-ea2d386f3b49c0c67f6e9685b7e4d7868bdadc8e.zip |
Update release notes for 8.1.0.alpha1 (#8863)
Diffstat (limited to 'all/src/main/templates')
-rw-r--r-- | all/src/main/templates/release-notes.html | 162 |
1 files changed, 15 insertions, 147 deletions
diff --git a/all/src/main/templates/release-notes.html b/all/src/main/templates/release-notes.html index 36ce1e4804..95d1c37acc 100644 --- a/all/src/main/templates/release-notes.html +++ b/all/src/main/templates/release-notes.html @@ -64,13 +64,8 @@ a number of new features and bug fixes, as listed in the <a href="#enhancements">list of enhancements</a> and <a href="#changelog">change log</a> below. - This beta release contains breaking changes based on your feedback on the previous beta version, - and we may change things on future beta versions based on your feedback if necessary. + The API in this alpha version is not considered final and will change based on your feedback. </p> - <p> Special note for add-on developers: please test your add-on against - Framework 8.0 and update your add-on as needed. - - </p> <!-- ================================================================ --> <h3 id="changelog">Change Log for Vaadin Framework @version@</h3> @@ -87,154 +82,29 @@ enhancements. Below is a list of the most notable changes:</p> <ul> - <li>New, simpler data binding API</li> - <li>Vaadin Framework is now based on Java 8</li> - <li>Vaadin Framework is using GWT 2.8, allowing client side code to use Java 8</li> - <li>Other Framework dependencies including Atmosphere have been upgraded</li> - <li>Easier to integrate web components using HTML imports (<tt>@HtmlImport</tt>), custom tag name support for <tt>AbstractJavaScriptComponent</tt> and more efficient transmission of shared state changes for JavaScript components</li> - <li>Context click events are now generated on iOS devices (<a href="https://github.com/vaadin/framework/issues/7387">#7387</a>)</li> - <li>Add-ons can use <tt>META-INF/services/com.vaadin.server.VaadinServiceInitListener</tt> to automatically hook into the initialization sequence of the framework</li> + <li>Components In Grid</li> + <li>HTML5 Drag and Drop support</li> + <li>TreeGrid and HierarchicalDataProvider</li> </ul> - <p> - The new data binding API replaces the old <tt>Container</tt>, <tt>Item</tt>, <tt>Property</tt>, <tt>FieldGroup</tt>, - <tt>Validator</tt>, <tt>Converter</tt> and related classes with new mechanisms. - Also components using those are replaced with updated implementations using the - new API, and the old data binding API and components have been moved to separate - compatibility packages for ease of migration. - For more details, see <a href="#incompatible">the list of incompatible changes</a> and <a href="#migrating">how to migrate - to Vaadin Framework 8</a>. </p> <p> - For enhancements introduced in Vaadin Framework 7.7, see the <a - href="http://vaadin.com/download/release/7.7/7.7.0/release-notes.html">Release - Notes for Vaadin Framework 7.7.0</a>. + For enhancements introduced in Vaadin Framework 8.0, see the <a + href="http://vaadin.com/download/release/8.0/8.0.0/release-notes.html">Release + Notes for Vaadin Framework 8.0.0</a>. + For migrating from previous framework versions, see <a href="#incompatible">the list of incompatible changes</a> and <a href="#migrating">how to migrate + to Vaadin Framework 8</a>. </p> <h2 id="incompatible">Incompatible or Behavior-altering Changes in @version@</h2> - <ul><h4>Compatibility and requirements</h4> - <li>Vaadin Framework now requires Java 8 or later and Servlet 3.0 or later</li> - <li>Support for older browsers (including Microsoft IE 8-10) and Windows Phone has been dropped</li> - <li>Support for Google App Engine has been dropped</li> - <li><a href="#supportedservers">Supported servers</a></li> - </ul> - <ul><h4>New Data Binding API related changes</h4> - <li>Components using <tt>Property</tt>, <tt>Item</tt> or <tt>Container</tt> API have been reimplemented for the new API, except <tt>Tree</tt>, <tt>Table</tt>, <tt>TreeTable</tt> and <tt>Calendar</tt></li> - <li>Framework 7 versions of the components available in the v7 compatibility package for easier migration, <a href="#legacycomponents">see list of legacy components</a></li> - <li><tt>Binder</tt> is the replacement of <tt>FieldGroup</tt> and <tt>BeanFieldGroup</tt></li> - <li>Converters and Validators have been moved from Components to <tt>Binder</tt></li> - <li><tt>DataProvider</tt> is the replacement of <tt>Container</tt></li> - <ul> - <li><tt>ListDataProvider</tt> is the default in-memory data provider replacing <tt>IndexedContainer</tt>, <tt>BeanItemContainer</tt>, and <tt>BeanContainer</tt></li> - <li><tt>BackEndDataProvider</tt> is the basis for a lazy data provider</li> - <li><tt>SQLContainer</tt> is deprecated in v7 compatibility package and not directly replaced</li> - <li><tt>HierarchicalContainer</tt> is deprecated in v7 compatibility package and a replacement is planned for 8.1</li> - </ul> - <li>All components that list data are based on <tt>AbstractListing</tt></li> - <li>All <tt>AbstractListing</tt> components have been typed with the type of items they are listing</li> - <li><tt>HasValue</tt> replaces the <tt>Field</tt> interface as the basis for all field components</li> - <li>Field components based on <tt>HasValue</tt> may or may not accept null values, depending on each component. There is no <tt>setNullRepresentation</tt> anymore</li> - <li><tt>AbstractField::setRequired(boolean)</tt> has been replaced with: - <ul> - <li><tt>HasValue::setRequiredIndicatorVisible(boolean)</tt> which only makes the <tt>*</tt> required indicator visible for the component</li> - <li><tt>BindingBuilder::setRequired(String)</tt> adds a "not-empty" validator when used in <tt>Binder</tt> and makes the <tt>*</tt> required indicator visible</li> - </ul> - <li><tt>setItemCaptionGenerator</tt> in <tt>AbstractListing</tt> replaces <tt>setItemCaption</tt>, <tt>setItemCaptionMode</tt> and <tt>setItemCaptionPropertyId</tt> from <tt>AbstractSelect</tt></li> - <li><tt>setItemIconGenerator</tt> in <tt>AbstractListing</tt> replaces <tt>setItemIcon</tt> and <tt>setItemIconPropertyId</tt> from <tt>AbstractSelect</tt></li> - </ul> - <ul><h4>General API changes</h4> - <li>All listeners and most single method interfaces have been marked as <tt>@FunctionalInterface</tt></li> - <li>All components are now immediate, and <tt>AbstractComponent::setImmediate(boolean immediate)</tt> has been removed.</li> - <li>Read-only is now a feature for field components and has been moved from <tt>AbstractComponent</tt> to <tt>HasValue</tt> </li> - <li>Some deprecated/obsolete parts of API have been removed</li> - <li>All addListener/removeListener methods have been removed - replaced with the Java 8 friendly <tt>addClickListener()</tt>, <tt>addValueChangeListener()</tt> etc. instead</li> - <li>All new listeners are unregistered using a <tt>Registration</tt> object returned by <tt>addXyzListener()</tt> rather than with a separate <tt>removeXyzListener()</tt></li> - <li>Input prompts have been replaced with placeholders utilizing the related browser functionality, API is now <tt>setPlaceHolder</tt> instead of <tt>setInputPrompt</tt></li> - <li>Valo is the default theme, instead of Reindeer</li> - <li>Valo is the only included theme, all other themes have been moved to the <tt>compatiblity-themes</tt> package and are available as a separate dependency</li> - <li><tt>SharedState</tt> and the getter methods for it have been added to each component, regardless of whether those are used for anything or not</li> - <li>The old liferay theme (Liferay 6.0 look) has been removed</li> - <li>FontAwesome icon constants have been deprecated, and will not be updated. It is replaced with <a href="https://vaadin.com/icons">Vaadin Icons</a> that are included in the Framework</li> - <li>It is no longer possible to configure a <tt>CurrentInstance</tt> to be automatically inherited into spawned threads.</li> - </ul> - <ul><h4>Component specific API changes</h4> - <li><tt>setDescription(String)</tt> now renders tooltip as inner text by default, instead of HTML. HTML can be still used by using <tt>setDescription(String, ContentMode)</tt></li> - <li><tt>com.vaadin.shared.ui.label.ContentMode</tt> has been moved into <tt>com.vaadin.shared.ui</tt></li> - <li><tt>DateField</tt> replaces old <tt>PopupDateField</tt></li> - <li><tt>DateField</tt> and <tt>InlineDateField</tt> are now based on Java 8 <tt>LocalDate</tt> instead of <tt>Date</tt></li> - <li><tt>DateTimeField</tt> and <tt>InlineDateTimeField</tt> based on Java 8 <tt>LocalDateTime</tt> are introduced for time selecting time (hour / minute / second) </li> - <ul><li><tt>DateField</tt> and <tt>InlineDateField</tt> don't support time anymore, meaning the highest resolution for those is <tt>DateResolution.DAY</tt></li> - <li><tt>Resolution</tt> for <tt>DateField</tt> and <tt>InlineDateField</tt> is replaced by <tt>DateResolution</tt> and <tt>DateTimeResolution</tt></li></ul> - <li><tt>OptionGroup</tt> has been removed and replaced by:</li> - <ul> - <li><tt>CheckBoxGroup</tt> replaces <tt>OptionGroup</tt> in multiselect mode</li> - <li><tt>RadioButtonGroup</tt> replaces <tt>OptionGroup</tt> in single select mode</li> - <ul><tt>OptionGroup::setItemEnabled(Object, boolean)</tt> has been replaced by <tt>setItemEnabledProvider</tt> that accepts a predicate</ul> - </ul> - <li><tt>TwinColSelect</tt> is always in multiselect mode</li> - <li><tt>ListSelect</tt> is always in multiselect mode</li> - <li><tt>Upload</tt> has a separate immediate mode <tt>setImmediateMode(boolean)</tt> replacing <tt>setImmediate</tt> and is now by default in immediate mode</li> - <li><tt>RichTextArea</tt> no longer receives a special "v-richtextarea-readonly" class when readonly, only the standard "v-readonly" class</li> - <li><tt>Grid</tt> has been typed to the bean type it is using and its columns are specified with a value provider callback instead of "propertyId"</li> - <li><tt>Grid</tt> Editor now uses <tt>Binder</tt> instead of <tt>FieldGroup</tt>, and doesn't support a <tt>FieldFactory</tt></li> - <li><tt>Grid</tt> selection API has been removed from component level to <tt>GridSelectionModel</tt> which is available via <tt>Grid::getSelectionModel()</tt></li> - <li><tt>Grid::setSelectionModel(GridSelectionModel)</tt> visibility has been changed from <tt>public</tt> to <tt>protected</tt> to reduce confusion with <tt>Grid::setSelectionMode</tt></li> - </ul> - <ul><h4>Client side widget specific API changes</h4> - <li><tt>VTextualDate</tt></li> widget class is removed and replaced by abstract <tt>VAbstractTextualDate</tt> class which is supposed to be inherited by concrete date field implementation widgets - </ul> - <ul><h4>Component specific visual changes</h4> - <li>The default width of <tt>Label</tt> is now undefined, matching other components</li> - <li>The default width for <tt>ComboBox</tt> pop-up is now 100 % (previously undefined)</li> - <li><tt>VerticalLayout</tt> has by default <tt>spacing = true</tt> and <tt>margin = true</tt></li> - <li><tt>HorizontalLayout</tt> has by default <tt>spacing = true</tt> and <tt>margin = false</tt></li> - </ul> - <ul><h4>Component specific declarative syntax changes</h4> - <li>Components in the compatibility packages now use the prefix <tt>vaadin7-"</tt> in declarative design files</li> - <li><tt>required-indicator-visible</tt> attribute replaces the <tt>required</tt> attribute</li> - <li><tt>placeholder</tt> attribute replaces the <tt>input-prompt</tt> attribute for input components</li> - <li><tt>multi-select</tt> attribute is no longer used for select components</li> - <li><tt>vaadin-option-group</tt> with attribute <tt>multi-select=true</tt> is replaced by <tt>v-check-box-group</tt></li> - <li><tt>vaadin-option-group</tt> with attribute <tt>multi-select=false</tt> is replaced by <tt>v-radio-button-group</tt></li> - <li><tt>immediate</tt> attribute is not used for any component</li> - <li><tt>read-only</tt> attribute is now only used for field components instead of all components</li> - <li><tt>vaadin-upload</tt> has a new attribute <tt>immediate-mode</tt> that replaces the removed <tt>immediate</tt> attribue</li> - <li><tt>vaadin-grid</tt> column elements don't have <tt>property-id</tt> attribute anymore. Columns aren't addressed by a property anymore but they have an id. So there is <tt>column-id</tt> attribute instead</li> - <li><tt>vaadin-grid</tt> doesn't have <tt>readonly</tt> attribute anymore. It is replaced by <tt>selection-allowed</tt> attribute which has special meaning for a <tt>Grid</tt></li> - </ul> - <ul id="legacycomponents"><h4>Legacy components in the v7 compatiblity package <tt>com.vaadin.v7.ui</tt> available as a separate dependency</h4> - <li><tt>Calendar</tt> - no replacement in 8</li> - <li><tt>CheckBox</tt></li> - <li><tt>ColorPicker</tt></li> - <li><tt>ColorPickerArea</tt></li> - <li><tt>ComboBox</tt></li> - <li><tt>CustomField</tt></li> - <li><tt>DateField</tt> - replaced in 8 by <tt>DateField</tt> and <tt>DateTimeField</tt></li> - <li><tt>Form</tt> - no replacement in 8</li> - <li><tt>Grid</tt> (and renderers)</li> - <li><tt>HorizontalLayout</tt></li> - <li><tt>InlineDateField</tt> - replaced in 8 by <tt>InlineDateField</tt> and <tt>InlineDateTimeField</tt></li> - <li><tt>Label</tt></li> - <li><tt>ListSelect</tt></li> - <li><tt>NativeSelect</tt></li> - <li><tt>OptionGroup</tt> - replaced by <tt>CheckBoxGroup</tt> (multiselection) and <tt>RadioButtonGroup</tt> (single selection)</li> - <li><tt>PasswordField</tt></li> - <li><tt>PopupDateField</tt> - replaced in 8 by <tt>DateField</tt> and <tt>DateTimeField</tt></li> - <li><tt>ProgressBar</tt></li> - <li><tt>ProgressIndicator</tt></li> - <li><tt>RichTextArea</tt></li> - <li><tt>Select</tt> - removed, use <tt>ComboBox</tt> for single selection and <tt>ListSelect</tt> for multiselection</li> - <li><tt>Table</tt> - no replacement in 8.0, use Grid.</li> - <li><tt>TextArea</tt></li> - <li><tt>TextField</tt></li> - <li><tt>Tree</tt> - no replacement in 8.0, planned for 8.1</li> - <li><tt>TreeTable</tt> - no replacement in 8.0, TreeGrid planned for 8.1</li> - <li><tt>TwinColSelect</tt></li> - <li><tt>VerticalLayout</tt></li> - <li><tt>Upload</tt></li> - </ul> + <li>The <tt>TreeGrid</tt> component replaces both <tt>TreeTable</tt> and <tt>Tree</tt> component</li> + <li>The <tt>HierarchicalDataProvider</tt> interface replaces <tt>Container.Hierarchical</tt> and <<tt>InMemoryHierarchicalDataProvider</tt> replaces <tt>HierarchicalContainer</tt></li> + <li>The <tt>DragSourceExtension</tt> and <tt>DropTargetExtension</tt> extensions replace the old DnD features</li> + + <h2>For incompatible or behaviour-altering changes in 8.0, please see <a href="https://vaadin.com/download/release/8.0/8.0.0/release-notes.html#incompatible">8.0 release notes</a></h2> + <h3 id="knownissues">Known Issues and Limitations</h3> <ul> @@ -262,8 +132,6 @@ </li> </ul> </li> - <li>Grid does not support adding components to cells. Instead light-weight Renderers can be - used to present and edit data.</li> <li>The Maven GWT compilation for <tt>Vaadin7WidgetSet</tt> requires at least 1G of memory, when using the <tt>vaadin-client-compability</tt> package. If compiled inside Eclipse, possibly even more.</li> </ul> |