定义组件跟父容器的相对位置，可选值有：

在 vbox 和 hbox 容器中，组件放置在预定义的槽段里。box.expandRatio 属性指定每个槽段的延展比率。比率必须大于等于 0。

如果我们为一个组件设置 box.expandRatio=1，并且它的高或宽是 100% （依据布局样式），该组件会被延展至使用组件放置方向的所有可用空间。

默认情况下，所有放置组件的槽段有相等的宽度或高度（即，box.expandRatio = 1）。如果至少有一个组件的该属性设置成别的值，则会忽略所有的隐式值，只考虑设置了的显式值。

也可参阅 expand 属性。

设置组件的标题

这个属性的值可以是一段文本，或者消息包里的一个消息键名。如果是用的消息键名，那么这个值需要以 msg:// 前缀开头。

有两种方式设置键名：

定义是否在组件的标题中启用 HTML。如果设置为 true，标题在浏览器中按照 HTML 做渲染，开发者需要保证没有使用有害的 HTML。如果设置为 false，内容将会按照普通文本显示。

可选值 − true 、 false。默认值 false。

定义组件显示的实体属性的名称。captionProperty 只能用在关联了数据源的实体（比如，LookupField 组件的关联 optionsDatasource 数据源的属性）。

如果 captionProperty 没定义 ，组件会显示实体的实例名称。

设置组件应占用的网格（grid columns）列数，默认是 1

这个属性可以给任何在 GridLayout 容器中的组件定义列宽。

设置内容提示文字，如果设置了，那么一个特别的 ? 图标会添加在组件里。如果组件有外部的标题，比如设置了 caption 或者 icon 属性，那么这个内容提示的图标会显示在标题旁边，否则会显示在这个控件本身的旁边：

在 web 客户端当用户光标悬浮到内容提示的 ? 图标时，会显示内容提示。

定义内容提示是否可以通过 HTML 格式显示。

可选值： true 、 false.

为 UI 组件提供声明式的方式来设置 CSS 属性。这个属性可以跟 stylename 属性一起使用，参阅下面的例子。

在界面的 XML 描述中的 data 部分定义一个数据容器。

当为组件设置 dataContainer 属性的时候，property 属性也需要同时设置。

设置数据加载器，为界面 XML 描述的 data 部分定义一个数据容器。

在 XML 描述的 dsContext 段定义一个数据源。

当给实现了 DatasourceComponent 接口的组件设置 datasource 属性的时候，property 属性也需要同时设置。

如果控件不与实体属性相关联（比如没有设置数据容器和属性名称），则需要设置数据类型。该属性的值可以是注册在应用程序元数据中的一个数据类型 - 参考 数据类型接口。

这些组件可以使用该属性： TextField, DateField, DatePicker, TimeField 。

定义是否在组件的描述中启用 HTML。如果设置为 true，描述在浏览器中使用 HTML 做渲染，开发者需要保证没有使用有害的 HTML。如果设置为 false，内容将会按照普通文本显示。

可选值 − true 、false。默认值 false。

标明这个组件的内容是否可编辑（不要跟 enable 混淆）

可选值： true 、 false。默认值 true。

是否能编辑绑定数据的组件（继承了 DatasourceComponent 或者 ListComponent）的内容也收到 security subsystem 的影响。如果安全子系统示意这个组件不能编辑，那么 editable 属性的值会被忽略。

定义组件的启用/禁用状态。

如果一个组件被禁用，那么这个组件将不能操作。禁用一个容器会禁用容器内的所有组件。可选值： true 、 false。默认所有组件都是启用的。

设置组件的高度。可以用像素（pixels）或者父容器的高度的百分比。比如 100px 、 100% 、 50。如果数字没有单位，默认是用像素。

按照 % 来设置值表示组件会占用父容器可用空间的相应比例的高度。

当设置成 AUTO 或者 -1px 的时候，组件的高度会使用默认值。对于容器来说，默认的高度是由内容定义的，也就是所有嵌入组件的高度之和。

设置组件的图标

这个属性的值需要指定一个图标的路径，这个路径相对于主题文件夹。

或者图标集里面的图标名称:

如果希望根据用户的语言显示不同的图标，可以在消息包里面配置图标的路径，然后在 icon 属性指定这个消息的键名，比如：

在用了 Halo 主题 （或者继承了这个主题）的 web 客户端，可以用 Font Awesome 来替代图标文件。在 icon 属性中定义所需要的图标名称，名称可以从 com.vaadin.server.FontAwesome 类的常量中找到，然后用 font-icon: 前缀来设置，比如：

参阅 图标 章节了解使用图标的更多细节。

设置组件的标识符。

推荐使用 Java 标识符的规则和驼峰命名法来给组件创建标识符，比如：userGrid 、 filterPanel。任何组件都可以使用 id 属性，但是需要保证在一个界面中每个组件的标识符是唯一的。

定义当组件的值是 null 的时候在这个组件显示的文字。

这个属性只能在 TextField 、LookupField 、 LookupPickerField 、 SearchPickerField 、 SuggestionPickerField 这些组件中使用，并且只支持 web 客户端。

定义组件的外边框和容器内容之间的留白。

可以有两种形式的值设置：

默认情况下没有边距设置。

选择 nullName 属性定义的名称相当于设置组件的值为 null。换言之，nullName 就是组件 null 选项的显示名称。

这个属性可以在 LookupField 、 LookupPickerField 和 SearchPickerField 组件使用。

在 XML 描述内设置这个属性的值：

在控制器中设置这个属性的值：

定义一个界面要以什么方式打开。对应 WindowManager.OpenType 枚举类型的值： NEW_TAB 、 THIS_TAB 、 NEW_WINDOW 、 DIALOG ` 。默认是 `THIS_TAB.

设置一个数据容器的名称，这个容器包含一个选项列表。

captionProperty 属性可以跟 optionsContainer 一起使用。

设置包含一个选项列表的数据源。

captionProperty 属性可以跟 optionsDatasource 一起使用。

设置一个含有选项列表的枚举类名称，一个枚举值就是一个选项。

设置实体属性的名称，这个属性会在这个组件用来编辑和显示。

property 属性总是和数据源属性一起使用。

表示是这个字段必须要有值。

可选值： true 、 false。默认是 false。

可以和 requiredMessage 属性一起使用。

总是跟 required 一起使用。这个属性设置一个消息，当组件没有值的时候会弹出这个消息提示。

这个属性也可以用消息包的键名，比如： requiredMessage="msg://infoTextField.requiredMessage"

设置组件是否可以根据可用的空间的大小自动适应。可以通过 styles 来定制自适应的方式。

可选值：true 、 false。默认值 false。

设置组件占据的网格行数（grid lines），默认是 1。

这个属性可以给直接放在在 GridLayout 容器内的任何组件使用。

定义用户是否可以保存/恢复对组件的设置。只有组件有 id，才能保存组件的设置。

可选值：true 、 false。默认值 true。

设置容器内组件之间是否留白。

可选值：true 、 false。默认值 false。

在 halo 主题中，有一些为组件预定义的 CSS 类名称：

定义标签的标题是否可以用 HTML。如果设置成 true，标题在浏览器里会以 HTML 的方式渲染，开发者需要保证没有使用有害的 HTML。如果设置成 false，内容会按照纯文本来渲染。

可选值：true 、 false。默认值 false。

定义组件是否可以获得焦点，同时也可以设置组件在界面上所有可获得焦点组件内部的顺序值。

可以使用正负整数：

设置在标签页面板中是否显示标签选择部分。

可选值：true 、 false。默认值 true。

定义在表格单元格中是否能选择文本。

可选值：true 、 false。默认值 false。

设置组件是否可见。

如果容器被设置成不可见，那么他里面的所有组件也不可见。默认所有组件都是可见。

可选值：true 、 false。默认值 true。

定义组件的宽度

可以用像素（pixels）或者父容器的宽度的百分比。比如 100px 、 100% 、 50。如果数字没有单位，默认是用像素。

按照 % 来设置值表示组件会占用父容器可用空间的相应比例的宽度。

当设置成 AUTO 或者 -1px 的时候，组件的宽度会使用默认值。对于容器来说，默认的宽度是由内容定义的，也就是所有嵌入组件的宽度之和。