Mashup Builder > 小组件 > 标准小组件 > 属性显示小组件 (可应用主题)
属性显示小组件 (可应用主题)
您可以使用“属性显示”小组件在混搭中显示键值对的结构化组。
* 
“属性显示”小组件可在平台中用作标准小组件，也可用作 web 组件 (可从 SDK 导入)。
数据格式
要在小组件中显示属性，就必须绑定根据以下数据格式返回信息表的数据服务：
列 1
...
列 N
...
使用
定义小组件的属性名称。
...
为每个附加列定义属性名称。
信息表中的每一行均表示对应于已定义列的一组值。小组件会成对显示行值和列名称。信息表中的每一行均是如此。运行时，将根据数据形状中每个信息表列的基本类型自动设置小组件格式。
可使用 GroupNameField 属性在常用标签下对属性进行分组。
对属性进行分组
默认情况下，会根据绑定信息表的格式显示所列属性，除非您使用配置对话框对特定列进行了隐藏或重命名操作。运行时，所有属性均显示于同一级别。可通过启用分组来组织属于单个项的属性。启用分组后，源自绑定信息表的数据列将用于为小组件中的每组属性指定标签。
例如，请考虑以下返回两个列出项属性的信息表：
名称
最高速度
最大航程
最大飞行高度
重型飞机
250 kn
3800 nmi
28000 ft
轻型飞机
150 kn
700 nmi
12000 ft
运行时，重型飞机在名称下显示为属性值。
要将名称列的值用作属性的组标签，请设置 GroupNameField 小组件属性：
1. 选择属性显示小组件，然后打开“属性”面板。随即将列出小组件属性。
2. 通过选择具有 STRING 基本类型的信息表列作为属性标签来设置 GroupNameField 属性。
* 
不能在未将信息表绑定至 Data 属性的情况下设置此属性。
3. 单击“保存”，然后查看混搭。
运行时，所选列的值将用于对每个行中的所有属性进行分组。下图显示了使用名称列中所包含值分组属性的前一个示例。
根据您的实施和设计，您可使用信息表中的任何其他内容进行属性分组。这样便可对属性进行组织和排序。
配置属性列表
每一行的属性列表均根据信息表中的列顺序进行排序。列名称由绑定信息表数据形状中的字段定义确定。可使用列配置对话框覆盖默认的属性顺序。
在工作区中选择小组件，然后使用以下方式之一打开小组件配置对话框：
• 在工作区中，单击小组件左上角的 向下箭头，然后单击“配置栅格列”。
• 单击“属性”面板上的 。
小组件配置对话框随即打开。
• 要重新排序属性，请在左侧窗格中拖动列，以根据需要更改顺序。您可在列表中上下移动各个列。运行时，属性顺序会相应地从左变到右。
• 要更改属性名称，请在左侧窗格中选择其中一列，然后输入要为该属性显示的新标签。要选择本地化标记，请单击 本地化标记，然后从列表中选取某一标记。
• 要在运行时隐藏特定属性，请清除“显示”下的复选框。
* 
• 当为 GroupNameField 属性选择某一列时，该列不但不会列出，而且还会忽略所有现有配置。
单击“完成”以应用更改并关闭对话框。
小组件属性
下表列出了小组件属性：
属性名称
说明
基本类型
默认值
是否可绑定? (Y/N)
是否可本地化? (Y/N)
VerticalMode
沿垂直轴对齐数据。如果未选择，则会水平显示。
BOOLEAN
False
Y
N
HideGroupTitles
隐藏组标题标签。
BOOLEAN
False
Y
N
ModalWidth
为模态窗口设置固定宽度。
* 
设置固定宽度对于图像的模态窗口不适用。根据图像尺寸自动调整窗口大小。
NUMBER
不可用
Y
N
ModalHeight
为模态窗口设置固定高度。
* 
设置固定高度对于图像的模态窗口不适用。根据图像尺寸自动调整窗口大小。
NUMBER
不可用
Y
N
CustomClass
定义 CSS 以应用于小组件顶层 div。输入多个类时，请以空格分隔每个类。
STRING
不可用
Y
N
DisclosureControl
指定当完整值超出小组件的设定尺寸时如何显示完整值。完整值的显示方式取决于所选的内容：
• “显示信息按钮”- 在模态窗口中。
• “使用“显示更多...”链接”- 使用“显示更多”链接。
• “显示省略号 (...)”- 使用省略号。
* 
• 默认情况下，图像始终在模态窗口中打开。
• 如果选择“显示省略号 (...)”，ValueMaxHeight 属性将限制完整值并将其截断。
STRING
显示信息按钮
N
N
MultiLine
允许文本在超出指定宽度时换行。
BOOLEAN
False
TextIfNoValue
设置在小组件数据源不包含值时显示的文本。
STRING
不可用
Y
Y
Disabled
禁用混搭中的小组件。小组件随即显示，但不可用。
BOOLEAN
False
Y
N
TabSequence
设置按 TAB 键时突出显示小组件的顺序。
NUMBER
不可用
N
N
Data
属性显示的数据源。
* 
• 信息表中的每一行分别对应于属性显示中的一个键值对。
• 信息表行中的每个字段都会在通过行创建的键值对中生成一个带有标签和值的条目。
每个条目的标签均衍生自信息表数据形状所定义的字段名称。
• 如果此字段的友好名称已在数据形状定义中定义，则使用此名称。
• 如果字段没有在数据形状定义中定义的友好名称，则会从当前本地化表中选择字段名称。
• 如果以上两种方案均不可行，则可将字段名称本身用作标签。
每个字段的值均用作条目值。此值的类型由数据形状中定义的字段类型自动确定。无需对其进行配置。例如，将类型为 IMAGE 的字段显示为图像。
INFOTABLE
不可用
Y
N
GroupNameField
指定用于对属性进行分组的信息表字段。
* 
信息表字段必须为 STRING 基础类型。
此属性用于选择信息表中要用作组标题的字段之一。如果设置了此属性，则此字段的值将用作组标题，并且此字段不会显示在其他属性中。如果没有为 GroupNameField 选择任何字段，则属性显示小组件会显示所有字段，而组则不会获得标题。
INFOTABLE
不适用
N
N
Label
显示“属性显示”小组件的标签文本。
STRING
不可用
Y
Y
LabelAlignment
将标签沿水平轴“左”、“右”或“居中”对齐。
STRING
左
N
N
LabelType
将标签类型设置为“标题”、“子标题”、“标签”或“正文”。
STRING
标签
N
N
HideLabel
隐藏混搭中的标签。
BOOLEAN
False
N
N
GroupTitleAlignment
将组标签沿水平轴“左”、“右”或“居中”对齐。
STRING
左
N
N
GroupTitleType
将组标题的类型设置为“标题”、“子标题”、“标签”或“正文”
STRING
标签
N
N
ValueMaxWidth
设置值的最大宽度。
* 
仅当选择了 MultiLine 和 VerticalMode 时，此属性才可用。
NUMBER
不可用
Y
N
ValueMaxHeight
设置值的最大高度。
* 
仅当选择了 MultiLine 和 VerticalMode 时，此属性才可用。
NUMBER
不可用
Y
N
这对您有帮助吗?