@version@</a></li>
<li><a href="#enhancements">Enhancements in Vaadin
@version-minor@</a></li>
- <li><a href="#incompatible">Incompatible changes in
- @version-minor@</a></li>
- <li><a href="#behavioraltering">Behavior altering
- changes in @version-minor@</a></li>
+ <li><a href="#knownissues">Known issues in
- @version-minor@</a></li>
++ @version-minor@</a></li>
<li><a href="#limitations">Limitations in
@version-minor@</a></li>
<li><a href="#vaadin">Vaadin Installation</a></li>
href="http://vaadin.com/download/release/7.0/7.0.0/release-notes.html">Release
Notes for Vaadin 7.0.0</a>.
</p>
-
- <h3 id="incompatible">Incompatible changes</h3>
- <ul>
- <li>It is assumed that the UI will no longer be used after Page.setLocation
- is called. Do not use this to start downloads.</li>
- <li>The portlet requests class VaadinGateinRequest is now called
- VaadinGateInRequest</li>
- <li>The JSON library has been changed from org.json to the json implementation
- from the Android SDK. They are 99% compatible.</li>
- <li>StringToNumberConverter has been removed in favor of more specific
- converters such as StringToBigDecimalConverter.</li>
- <li>There is no longer support for "multiple variable bursts"
- in the UIDL communication.</li>
- </ul>
- <h3 id="behavioraltering">Behavior altering changes</h3>
+
+ <h2 id="valo">Valo theme</h2>
+
+ <p>Valo is a brand new built-in theme for Vaadin. It leverages
+ the <a href="http://www.sass-lang.com">Sass CSS preprocessor</a> heavily,
+ providing a variety of ways to customize the look and feel of your theme.
+ Read the introductory blog post describing the features for the
+ <a href="https://vaadin.com/blog/-/blogs/7-series">Vaadin 7.x series</a>.</p>
+
+ <h4>Using Valo</h4>
+
+ <p>The Java-based Sass compiler bundled with this Vaadin release
+ does not support all the features that Valo requires at the moment.
+ The compiler in the release version of Vaadin 7.3 will support Valo,
+ but for this alpha release, you need to use the original Ruby-based
+ compiler (or any other Sass 3.2 compatible Sass compiler). See
+ instructions below.</p>
+
<ul>
- <li>Default push fallback is now long-polling</li>
- <li>VerticalLayout and HorizontalLayout.replaceComponent now applies old
- component parameters (e.g. expand ratio) to the new component. This is
- now consistent between all layouts in the framework, where relevant
- properties are applied to the replacement.</li>
- <li>All GWT permutations are collapsed when using DefaultWidgetSet. To use
- separate permutations, inherit Vaadin instead of DefaultWidgetSet and
- add the needed entry-point.</li>
- <li>Requests to "/context;jsessionid=xyz" are redirected to
- "/context/;jsessionid=xyz" which is against specifications but based
- on how jsessionid is used</li>
- <li>Adding a ValueChangeListener to a component will make it immediate</li>
- <li>ComboBox is immediate by default</li>
+ <li>Install the command-line version of the Sass compiler by following
+ the instructions in <a href="http://sass-lang.com/install">http://sass-lang.com/install</a></li>
+ <li>Unpack the <code>VAADIN/themes/valo</code> folder from
+ <code>vaadin-themes-7.3.0.alpha1.jar</code> and place it under your
+ project's <code>VAADIN/themes</code> folder</li>
+ <li>In your project's custom theme, import Valo and do any modifications
+ you wish using the Sass API in Valo (i.e., variables, mixins, and functions),
+ and then include the main valo mixin<br>
+ <br>Example (in <code>my-theme-name.scss</code>):<br>
+ <pre>// Any variables you wish to override should be done before importing Valo
+
+// Modify the base color of the theme
+$v-app-background-color: hsl(200, 50%, 50%);
+
+@import "../valo/valo";
+
+.my-theme-name {
+ @include valo;
+}
+</pre>
+ </li>
+ <li>From the command-line, navigate to your project's
+ <code>VAADIN/themes/my-theme-name</code> folder and use the following command
+ to compile the theme:<br><br>
+ <code>$ sass styles.scss styles.css</code></li>
</ul>
+ <h3 id="knownissues">Known issues</h3>
+ <ul>
+ <li>Reconnecting a dropped push connection sometimes fails when using
+ Firefox and streaming or long polling.
+ (<a href="http://dev.vaadin.com/ticket/13578">#13578</a>)
+ </li>
+ <li>Drag'n'drop in a Table doesn't work on touch devices running
+ Internet Explorer (Windows Phone, Surface)
+ (<a href="http://dev.vaadin.com/ticket/13737">#13737</a>)
+ </li>
+ </ul>
+
<h3 id="limitations">Limitations</h3>
<ul>
- <li>It is currently not possible to specify <tt>font-size</tt>
+ <li><p>It is currently not possible to specify <tt>font-size</tt>
as <tt>em</tt> or <tt>%</tt>, or layout component sizes
with <tt>em</tt> (<a
- href="http://dev.vaadin.com/ticket/10634">#10634</a>)
+ href="http://dev.vaadin.com/ticket/10634">#10634</a>).</p><p>This
+ does not apply to Valo, but using em sizes to size layouts is discouraged,
+ because it results in fractional component sizes in many cases, which
+ might cause unwanted 1px gaps between components.</p>
</li>
<li>Push is currently not supported in portals (See <a
href="http://dev.vaadin.com/ticket/11493">#11493</a>)
--- /dev/null
++/*
++ * Copyright 2000-2014 Vaadin Ltd.
++ *
++ * Licensed under the Apache License, Version 2.0 (the "License"); you may not
++ * use this file except in compliance with the License. You may obtain a copy of
++ * the License at
++ *
++ * http://www.apache.org/licenses/LICENSE-2.0
++ *
++ * Unless required by applicable law or agreed to in writing, software
++ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
++ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
++ * License for the specific language governing permissions and limitations under
++ * the License.
++ */
+package com.vaadin.client.debug.internal.theme;
+
+import com.google.gwt.resources.client.ClientBundle;
+import com.google.gwt.resources.client.CssResource;
+import com.google.gwt.resources.client.CssResource.NotStrict;
+import com.google.gwt.resources.client.DataResource;
+import com.google.gwt.resources.client.DataResource.DoNotEmbed;
+
+public interface DebugWindowStyles extends ClientBundle {
+
+ @Source({ "debugwindow.css" })
+ @NotStrict
+ public CssResource css();
+
+ // Can't embed because IE8 doesn't support datauri for fonts (images only)
+ @Source("font.eot")
+ @DoNotEmbed
+ DataResource iconFontEot();
+
+ // Can't embed because GWT compiler doesn't know the mimetype for these
+ // (ends up as content/unknown)
+ @Source("font.ttf")
+ @DoNotEmbed
+ DataResource iconFontTtf();
+
+ @Source("font.woff")
+ @DoNotEmbed
+ DataResource iconFontWoff();
+
+ @Source("font.svg")
+ @DoNotEmbed
+ DataResource iconFontSvg();
+
+}