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

在 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，Slider 。

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

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

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

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

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

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

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

定义容器内的组件是否可以按照组件放置的方向延展占用位置至所有可用的空间。

对于垂直布局的容器，这个属性会设置组件的高度（height）到 100%；对于水平布局的容器，则是 100%宽度（width）。还有，重新设置容器的大小也会影响到自动延展的组件。

参考 box.expandRatio。

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

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

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

定义是否开启在组件内容（caption，description，contextHelpText 属性）做 HTML 清理。如果设置为 true，且开启 HTML 功能的属性（captionAsHtml，descriptionAsHtml，contextHelpTextHtmlEnabled）也设置为 true，此时，caption，description 和 contextHelpText 属性的内容会被清理。

htmlSanitizerEnabled 会覆盖全局的 cuba.web.htmlSanitizerEnabled 配置。

设置组件的图标

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

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

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

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

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

设置组件的标识符。

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

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

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

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

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

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

如果没有声明式的定义 dataContainer 和 datasource 属性，则用 metaClass 定义表格组件的列类型。在 XML 中定义 metaClass 属性与设置 DataGrid，GroupTable，Table，TreeDataGrid 或 TreeTable 为空表格的效果一样，因此需要在界面控制器用编程的方式设置表格内容。

选择 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。

showOrphans 属性用来控制是否在树形组件中显示孤儿记录，孤儿记录是指那些父节点并不在当前数据集中的记录。 如果 showOrphans 属性设置为 false，则组件不会显示孤儿记录。否则，组件与之前的行为一样，会以顶层根节点的方式显示孤儿记录。

默认值为 true。

在使用 过滤器 时，隐藏孤儿记录更符合人们的习惯。但是，这样会导致分页有问题，某些页可能是空的或者只有一半数据，所以在使用树形组件时，如果想隐藏孤儿记录应该关闭分页功能：

此属性可以在 Tree，TreeDataGrid，TreeTable 组件使用。

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

可选值：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 的时候，组件的宽度会使用默认值。对于容器来说，默认的宽度是由内容定义的，也就是所有嵌入组件的宽度之和。