[[layout]]
== Managing Layout

////
TODO The intro text below is now completely hidden, as this text is
not visible in web edition and all the text is web-conditional.
////

ifdef::web[]
Ever since the ancient xeroxians invented graphical user interfaces, programmers
have wanted to make GUI programming ever easier for themselves. Solutions
started simple. When GUIs appeared on PC desktops, practically all screens were
of the VGA type and fixed into 640x480 size. Mac or X Window System on UNIX were
not much different. Everyone was so happy with such awesome graphics resolutions
that they never thought that an application would have to work on a radically
different screen size. At worst, screens could only grow, they thought, giving
more space for more windows. In the 80s, the idea of having a computer screen in
your pocket was simply not realistic. Hence, the GUI APIs allowed placing UI
components using screen coordinates. Visual Basic and some other systems
provided an easy way for the designer to drag and drop components on a
fixed-sized window. One would have thought that at least translators would have
complained about the awkwardness of such a solution, but apparently they were
not, as non-engineers, heard or at least cared about. At best, engineers could
throw at them a resource editor that would allow them to resize the UI
components by hand. Such was the spirit back then.
endif::web[]

ifdef::web[]
After the web was born, layout design was doomed to change for ever. At first,
layout didn't matter much, as everyone was happy with plain headings,
paragraphs, and a few hyperlinks here and there. Designers of HTML wanted the
pages to run on any screen size. The screen size was actually not pixels but
rows and columns of characters, as the baby web was really just hyper __text__,
not graphics. That was soon to be changed. The first GUI-based browser, NCSA
Mosaic, launched a revolution that culminated in Netscape Navigator. Suddenly,
people who had previously been doing advertisement brochures started writing
HTML. This meant that layout design had to be easy not just for programmers, but
also allow the graphics designer to do his or her job without having to know a
thing about programming. The W3C committee designing web standards came up with
the CSS (Cascading Style Sheet) specification, which allowed trivial separation
of appearance from content. Later versions of HTML followed, XHTML and HTML 5
appeared, as did countless other standards.
endif::web[]

ifdef::web[]
Page description and markup languages are a wonderful solution for static
presentations, such as books and most web pages. Real applications, however,
need to have more control. They need to be able to change the state of user
interface components and even their layout on the run. This creates a need to
separate the presentation from content on exactly the right
level.

////
Vaadin provides a solution for this, using themes and CSS, but let us first look
at what Java did for UI programming.
////

////
Changing the layout steps right on the feet of the graphics designers, so we
have a conflict. We will discuss this conflict later, but let us first look at
what Java did for UI programming.
////
endif::web[]

ifdef::web[]
Thanks to the attack of graphics designers, desktop applications were, when it
comes to appearance, far behind web design. Sun Microsystems had come in 1995
with a new programming language, Java, for writing cross-platform desktop
applications. Java's original graphical user interface toolkit, AWT (Abstract
Windowing Toolkit), was designed to work on multiple operating systems as well
as embedded in web browsers. One of the special aspects of AWT was the layout
manager, which allowed user interface components to be flexible, growing and
shrinking as needed. This made it possible for the user to resize the windows of
an application flexibly and also served the needs of localization, as text
strings were not limited to some fixed size in pixels. It became even possible
to resize the pixel size of fonts, and the rest of the layout adapted to the new
size.
endif::web[]

Layout management of Vaadin is a direct successor of the web-based concept for
separation of content and appearance and of the Java AWT solution for binding
the layout and user interface components into objects in programs. Vaadin layout
components allow you to position your UI components on the screen in a
hierarchical fashion, much like in conventional Java UI toolkits such as AWT,
Swing, or SWT. In addition, you can approach the layout from the direction of
the web with the [classname]#CustomLayout# component, which you can use to write
your layout as a template in HTML that provides locations of any contained
components. The [classname]#AbsoluteLayout# allows the old-style pixel-position
based layouting, but it also supports percentual values, which makes it usable
for scalable layouts. It is also useful as an area on which the user can
position items with drag and drop.

ifdef::web[]
The moral of the story is that, because Vaadin is intended for web applications,
appearance is of high importance. The solutions have to be the best of both
worlds and satisfy artists of both kind: code and graphics. On the API side, the
layout is controlled by UI components, particularly the layout components. On
the visual side, it is controlled by themes. Themes can contain any HTML, Sass,
CSS, and JavaScript that you or your web artists create to make people feel good
about your software.
endif::web[]


include::layout-overview.asciidoc[leveloffset=+2]

include::layout-root-layout.asciidoc[leveloffset=+2]

include::layout-orderedlayout.asciidoc[leveloffset=+2]

include::layout-gridlayout.asciidoc[leveloffset=+2]

include::layout-formlayout.asciidoc[leveloffset=+2]

include::layout-panel.asciidoc[leveloffset=+2]

include::layout-sub-window.asciidoc[leveloffset=+2]

include::layout-splitpanel.asciidoc[leveloffset=+2]

include::layout-tabsheet.asciidoc[leveloffset=+2]

include::layout-accordion.asciidoc[leveloffset=+2]

include::layout-absolutelayout.asciidoc[leveloffset=+2]

include::layout-csslayout.asciidoc[leveloffset=+2]

include::layout-settings.asciidoc[leveloffset=+2]

include::layout-customlayout.asciidoc[leveloffset=+2]
bs'><tr><td>
<a href='/vaadin-framework.git/about/?h=JS-RPC-docs-link-syntax'>about</a><a href='/vaadin-framework.git/?h=JS-RPC-docs-link-syntax'>summary</a><a href='/vaadin-framework.git/refs/?h=JS-RPC-docs-link-syntax&amp;id=6214afcd5ff1c82f62ac2d1c56ff455f0e15b3c4'>refs</a><a href='/vaadin-framework.git/log/documentation/gwt/gwt-overview.asciidoc?h=JS-RPC-docs-link-syntax'>log</a><a class='active' href='/vaadin-framework.git/tree/documentation/gwt/gwt-overview.asciidoc?h=JS-RPC-docs-link-syntax&amp;id=6214afcd5ff1c82f62ac2d1c56ff455f0e15b3c4'>tree</a><a href='/vaadin-framework.git/commit/documentation/gwt/gwt-overview.asciidoc?h=JS-RPC-docs-link-syntax&amp;id=6214afcd5ff1c82f62ac2d1c56ff455f0e15b3c4'>commit</a><a href='/vaadin-framework.git/diff/documentation/gwt/gwt-overview.asciidoc?h=JS-RPC-docs-link-syntax&amp;id=6214afcd5ff1c82f62ac2d1c56ff455f0e15b3c4'>diff</a><a href='/vaadin-framework.git/stats/documentation/gwt/gwt-overview.asciidoc?h=JS-RPC-docs-link-syntax'>stats</a></td><td class='form'><form class='right' method='get' action='/vaadin-framework.git/log/documentation/gwt/gwt-overview.asciidoc'>
<input type='hidden' name='h' value='JS-RPC-docs-link-syntax'/><input type='hidden' name='id' value='6214afcd5ff1c82f62ac2d1c56ff455f0e15b3c4'/><select name='qt'>
<option value='grep'>log msg</option>
<option value='author'>author</option>
<option value='committer'>committer</option>
<option value='range'>range</option>
</select>
<input class='txt' type='search' size='10' name='q' value=''/>
<input type='submit' value='search'/>
</form>
</td></tr></table>
<div class='path'>path: <a href='/vaadin-framework.git/tree/?h=JS-RPC-docs-link-syntax&amp;id=6214afcd5ff1c82f62ac2d1c56ff455f0e15b3c4'>root</a>/<a href='/vaadin-framework.git/tree/documentation?h=JS-RPC-docs-link-syntax&amp;id=6214afcd5ff1c82f62ac2d1c56ff455f0e15b3c4'>documentation</a>/<a href='/vaadin-framework.git/tree/documentation/gwt?h=JS-RPC-docs-link-syntax&amp;id=6214afcd5ff1c82f62ac2d1c56ff455f0e15b3c4'>gwt</a>/<a href='/vaadin-framework.git/tree/documentation/gwt/gwt-overview.asciidoc?h=JS-RPC-docs-link-syntax&amp;id=6214afcd5ff1c82f62ac2d1c56ff455f0e15b3c4'>gwt-overview.asciidoc</a></div><div class='content'>blob: 16841ab791864b7178687d543f062a76c7329a32 (<a href='/vaadin-framework.git/plain/documentation/gwt/gwt-overview.asciidoc?h=JS-RPC-docs-link-syntax&amp;id=6214afcd5ff1c82f62ac2d1c56ff455f0e15b3c4'>plain</a>)
<table summary='blob content' class='blob'>
<tr><td class='linenumbers'><pre><a id='n1' href='#n1'>1</a>
<a id='n2' href='#n2'>2</a>
<a id='n3' href='#n3'>3</a>
<a id='n4' href='#n4'>4</a>
<a id='n5' href='#n5'>5</a>
<a id='n6' href='#n6'>6</a>
<a id='n7' href='#n7'>7</a>
<a id='n8' href='#n8'>8</a>
<a id='n9' href='#n9'>9</a>
<a id='n10' href='#n10'>10</a>
<a id='n11' href='#n11'>11</a>
<a id='n12' href='#n12'>12</a>
<a id='n13' href='#n13'>13</a>
<a id='n14' href='#n14'>14</a>
<a id='n15' href='#n15'>15</a>
<a id='n16' href='#n16'>16</a>
<a id='n17' href='#n17'>17</a>
<a id='n18' href='#n18'>18</a>
<a id='n19' href='#n19'>19</a>
<a id='n20' href='#n20'>20</a>
<a id='n21' href='#n21'>21</a>
<a id='n22' href='#n22'>22</a>
<a id='n23' href='#n23'>23</a>
<a id='n24' href='#n24'>24</a>
<a id='n25' href='#n25'>25</a>
<a id='n26' href='#n26'>26</a>
<a id='n27' href='#n27'>27</a>
<a id='n28' href='#n28'>28</a>
<a id='n29' href='#n29'>29</a>
<a id='n30' href='#n30'>30</a>
<a id='n31' href='#n31'>31</a>
<a id='n32' href='#n32'>32</a>
<a id='n33' href='#n33'>33</a>
<a id='n34' href='#n34'>34</a>
<a id='n35' href='#n35'>35</a>
<a id='n36' href='#n36'>36</a>
<a id='n37' href='#n37'>37</a>
<a id='n38' href='#n38'>38</a>
<a id='n39' href='#n39'>39</a>
<a id='n40' href='#n40'>40</a>
<a id='n41' href='#n41'>41</a>
<a id='n42' href='#n42'>42</a>
<a id='n43' href='#n43'>43</a>
<a id='n44' href='#n44'>44</a>
<a id='n45' href='#n45'>45</a>
<a id='n46' href='#n46'>46</a>
<a id='n47' href='#n47'>47</a>
<a id='n48' href='#n48'>48</a>
<a id='n49' href='#n49'>49</a>
<a id='n50' href='#n50'>50</a>
<a id='n51' href='#n51'>51</a>
<a id='n52' href='#n52'>52</a>
<a id='n53' href='#n53'>53</a>
<a id='n54' href='#n54'>54</a>
<a id='n55' href='#n55'>55</a>
<a id='n56' href='#n56'>56</a>
<a id='n57' href='#n57'>57</a>
<a id='n58' href='#n58'>58</a>
<a id='n59' href='#n59'>59</a>
<a id='n60' href='#n60'>60</a>
<a id='n61' href='#n61'>61</a>
<a id='n62' href='#n62'>62</a>
<a id='n63' href='#n63'>63</a>
<a id='n64' href='#n64'>64</a>
<a id='n65' href='#n65'>65</a>
<a id='n66' href='#n66'>66</a>
<a id='n67' href='#n67'>67</a>
<a id='n68' href='#n68'>68</a>
<a id='n69' href='#n69'>69</a>
<a id='n70' href='#n70'>70</a>
<a id='n71' href='#n71'>71</a>
<a id='n72' href='#n72'>72</a>
<a id='n73' href='#n73'>73</a>
<a id='n74' href='#n74'>74</a>
<a id='n75' href='#n75'>75</a>
<a id='n76' href='#n76'>76</a>
<a id='n77' href='#n77'>77</a>
<a id='n78' href='#n78'>78</a>
<a id='n79' href='#n79'>79</a>
<a id='n80' href='#n80'>80</a>
<a id='n81' href='#n81'>81</a>
<a id='n82' href='#n82'>82</a>
<a id='n83' href='#n83'>83</a>
<a id='n84' href='#n84'>84</a>
<a id='n85' href='#n85'>85</a>
<a id='n86' href='#n86'>86</a>
</pre></td>
<td class='lines'><pre><code>