布局子控件属性
如何读懂本文档?
标题的含义
例如:"absolute(绝对布局)"表示的是"英文编程(中文编程)",布局代码如下
<!--英文编程-->
<ui>
<absolute>
<!--其他子控件-->
</absolute>
</ui>
<!--中文编程-->
<界面>
<绝对布局>
<!--其他子控件-->
</绝对布局>
</界面>
表格的含义
其实在本文档中,罗列的都是被布局包裹的子控件附加的属性,例如:
<ui>
<linear w="max" h="max">
<button w="100" />
</linear>
</ui>
这段界面xml代码中: linear标签上我写了w和h的属性,实际上不是linear的布局属性,而是被ui包裹了,由于ui节点本身就是一个linear因此被linear包裹后的linear就有了w和h属性。
再看button标签上有w属性,w属性的值为100,这表示button的宽度为100dp,其实w不是button的属性,而是被linear包裹了,由于linear的子控件支持w属性,因此button就有了w属性。
获取上面的代码里面比较难以理解的是ui下的linear标签,我用中文编程再次解释一下:
<界面>
<绝对布局 宽="最大" 高="最大">
<文本 宽="最大" />
</绝对布局>
</界面>
首先我们看绝对布局这个节点,它是被界面包裹的,意味着现在绝对布局就是界面的子控件,而* 界面节点的本质是线性布局*, 然后我们看下面的表格,找到线性布局子控件拥有的属性有宽、高等属性,因此界面的子控件绝对布局 就拥有宽、高这两个属性了。
再来看看文本是被绝对布局包裹的,意味着文本就是绝对布局的子控件,因此文本拥有绝对布局 子控件属性,其实宽属性并不是文本特有的,而是当文本被布局包裹后,宽属性是父控件( 绝对布局)赋予的能力。
absolute(绝对布局)
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
x | 横轴 | 整数 | 子视图相对于父布局左上角的 X 坐标(单位:dp)。 |
y | 纵轴 | 整数 | 子视图相对于父布局左上角的 Y 坐标(单位:dp)。 |
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
card(卡片/卡片布局)
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
dir | 布局方向 | 字符串 | 子视图的布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
layout_gravity | 布局重力 | 字符串 | 子视图在 "card(卡片)" 内的对齐方式。支持 Gravity 常量的英文或中文名称,可用 " |
margin | 外边距 | 整数/字符串 | 四边统一外边距(单位:dp),或用空格分隔的四个值(左 上 右 下)。 |
margin_left | 左外边距 | 整数 | 子视图左边距(单位:dp)。 |
margin_top | 上外边距 | 整数 | 子视图上边距(单位:dp)。 |
margin_right | 右外边距 | 整数 | 子视图右边距(单位:dp)。 |
margin_bottom | 下外边距 | 整数 | 子视图下边距(单位:dp)。 |
grid(网格布局)
注意: 当前实现未包含 columnSpec 和 rowSpec 属性。
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
dir | 布局方向 | 字符串 | 子视图的布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
margin | 外边距 | 整数/字符串 | 四边统一外边距(单位:dp),或用空格分隔的四个值(左 上 右 下)。 |
margin_left | 左外边距 | 整数 | 子视图左边距(单位:dp)。 |
margin_top | 上外边距 | 整数 | 子视图上边距(单位:dp)。 |
margin_right | 右外边距 | 整数 | 子视图右边距(单位:dp)。 |
margin_bottom | 下外边距 | 整数 | 子视图下边距(单位:dp)。 |
relative(相对布局)
注意: 当前实现未包含所有 addRule 相关的对齐规则属性。
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
alignWithParent | 与父对齐 | 布尔值 | 当子视图的锚点视图不存在时,是否与父视图对齐。 |
dir | 布局方向 | 字符串 | 子视图的布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
margin | 外边距 | 整数/字符串 | 四边统一外边距(单位:dp),或用空格分隔的四个值(左 上 右 下)。 |
margin_left | 左外边距 | 整数 | 子视图左边距(单位:dp)。 |
margin_top | 上外边距 | 整数 | 子视图上边距(单位:dp)。 |
margin_right | 右外边距 | 整数 | 子视图右边距(单位:dp)。 |
margin_bottom | 下外边距 | 整数 | 子视图下边距(单位:dp)。 |
tab(标签布局)
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
dir | 布局方向 | 字符串 | 子视图的布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
layout_gravity | 布局重力 | 字符串 | 子视图在 "tab(标签)" 内的对齐方式。支持 Gravity 常量的英文或中文名称,可用 " |
margin | 外边距 | 整数/字符串 | 四边统一外边距(单位:dp),或用空格分隔的四个值(左 上 右 下)。 |
margin_left | 左外边距 | 整数 | 子视图左边距(单位:dp)。 |
margin_top | 上外边距 | 整数 | 子视图上边距(单位:dp)。 |
margin_right | 右外边距 | 整数 | 子视图右边距(单位:dp)。 |
margin_bottom | 下外边距 | 整数 | 子视图下边距(单位:dp)。 |
flush(刷新布局/下拉刷新)
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
flow(流式布局)
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
chip-group(碎片组/小片组)
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
dir | 布局方向 | 字符串 | 子视图的布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
margin | 外边距 | 整数/字符串 | 四边统一外边距(单位:dp),或用空格分隔的四个值(左 上 右 下)。 |
margin_left | 左外边距 | 整数 | 子视图左边距(单位:dp)。 |
margin_top | 上外边距 | 整数 | 子视图上边距(单位:dp)。 |
margin_right | 右外边距 | 整数 | 子视图右边距(单位:dp)。 |
margin_bottom | 下外边距 | 整数 | 子视图下边距(单位:dp)。 |
radio-group(单选按钮组/单选框组)
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
dir | 布局方向 | 字符串 | 子视图的布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
layout_gravity | 布局重力 | 字符串 | 子视图在 "radio-group(单选按钮组)" 内的对齐方式。支持 Gravity 常量的英文或中文名称,可用 " |
margin | 外边距 | 整数/字符串 | 四边统一外边距(单位:dp),或用空格分隔的四个值(左 上 右 下)。 |
margin_left | 左外边距 | 整数 | 子视图左边距(单位:dp)。 |
margin_top | 上外边距 | 整数 | 子视图上边距(单位:dp)。 |
margin_right | 右外边距 | 整数 | 子视图右边距(单位:dp)。 |
margin_bottom | 下外边距 | 整数 | 子视图下边距(单位:dp)。 |
button-group(按钮组)
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
dir | 布局方向 | 字符串 | 子视图的布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
weight | 权重 | 小数 | 在 "button-group(按钮组)" 风格的布局中,子视图的权重。 |
layout_gravity | 布局重力 | 字符串 | 子视图在 "button-group(按钮组)" 内的对齐方式。支持 Gravity 常量的英文或中文名称,可用 " |
margin | 外边距 | 整数/字符串 | 四边统一外边距(单位:dp),或用空格分隔的四个值(左 上 右 下)。 |
margin_left | 左外边距 | 整数 | 子视图左边距(单位:dp)。 |
margin_top | 上外边距 | 整数 | 子视图上边距(单位:dp)。 |
margin_right | 右外边距 | 整数 | 子视图右边距(单位:dp)。 |
margin_bottom | 下外边距 | 整数 | 子视图下边距(单位:dp)。 |
input(输入框)
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
dir | 布局方向 | 字符串 | 子视图的布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
weight | 权重 | 小数 | 在 "linear(线性布局)" 风格的 "input(输入框)" 中,子视图的权重。 |
layout_gravity | 布局重力 | 字符串 | 子视图在 "input(输入框)" 内的对齐方式。支持 Gravity 常量的英文或中文名称,可用 " |
margin | 外边距 | 整数/字符串 | 四边统一外边距(单位:dp),或用空格分隔的四个值(左 上 右 下)。 |
margin_left | 左外边距 | 整数 | 子视图左边距(单位:dp)。 |
margin_top | 上外边距 | 整数 | 子视图上边距(单位:dp)。 |
margin_right | 右外边距 | 整数 | 子视图右边距(单位:dp)。 |
margin_bottom | 下外边距 | 整数 | 子视图下边距(单位:dp)。 |
linear(线性布局)
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
dir | 布局方向 | 字符串 | 子视图的布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
weight | 权重 | 小数 | 子视图在 "linear(线性布局)" 中的权重。 |
layout_gravity | 布局重力 | 字符串 | 子视图在 "linear(线性布局)" 内的对齐方式。支持 Gravity 常量的英文或中文名称,可用 " |
margin | 外边距 | 整数/字符串 | 四边统一外边距(单位:dp),或用空格分隔的四个值(左 上 右 下)。 |
margin_left | 左外边距 | 整数 | 子视图左边距(单位:dp)。 |
margin_top | 上外边距 | 整数 | 子视图上边距(单位:dp)。 |
margin_right | 右外边距 | 整数 | 子视图右边距(单位:dp)。 |
margin_bottom | 下外边距 | 整数 | 子视图下边距(单位:dp)。 |
frame(帧布局)
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
dir | 布局方向 | 字符串 | 子视图的布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
layout_gravity | 布局重力 | 字符串 | 子视图在 "frame(帧布局)" 内的对齐方式。支持 Gravity 常量的英文或中文名称,可用 " |
margin | 外边距 | 整数/字符串 | 四边统一外边距(单位:dp),或用空格分隔的四个值(左 上 右 下)。 |
margin_left | 左外边距 | 整数 | 子视图左边距(单位:dp)。 |
margin_top | 上外边距 | 整数 | 子视图上边距(单位:dp)。 |
margin_right | 右外边距 | 整数 | 子视图右边距(单位:dp)。 |
margin_bottom | 下外边距 | 整数 | 子视图下边距(单位:dp)。 |
scroll(滚动布局)
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
dir | 布局方向 | 字符串 | 子视图的布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
margin | 外边距 | 整数/字符串 | 四边统一外边距(单位:dp),或用空格分隔的四个值(左 上 右 下)。 |
margin_left | 左外边距 | 整数 | 子视图左边距(单位:dp)。 |
margin_top | 上外边距 | 整数 | 子视图上边距(单位:dp)。 |
margin_right | 右外边距 | 整数 | 子视图右边距(单位:dp)。 |
margin_bottom | 下外边距 | 整数 | 子视图下边距(单位:dp)。 |
drawer(抽屉布局)
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
dir | 布局方向 | 字符串 | 子视图的布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
layout_gravity | 布局重力 | 字符串 | 关键属性,用于指定抽屉的位置(如 "left", "right", "start", "end" 及其中文对应)。支持 Gravity 常量的英文或中文名称,可用 " |
margin | 外边距 | 整数/字符串 | 四边统一外边距(单位:dp),或用空格分隔的四个值(左 上 右 下)。 |
margin_left | 左外边距 | 整数 | 子视图左边距(单位:dp)。 |
margin_top | 上外边距 | 整数 | 子视图上边距(单位:dp)。 |
margin_right | 右外边距 | 整数 | 子视图右边距(单位:dp)。 |
margin_bottom | 下外边距 | 整数 | 子视图下边距(单位:dp)。 |
const(约束布局)
注意: 当前实现未包含所有约束(constraint)相关的属性。
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
verticalBias | 垂直偏移 | 小数 | 当视图在垂直方向上被拉伸时,控制其在约束范围内的位置(0.0 到 1.0)。 |
horizontalBias | 水平偏移 | 小数 | 当视图在水平方向上被拉伸时,控制其在约束范围内的位置(0.0 到 1.0)。 |
dir | 布局方向 | 字符串 | 子视图的布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
margin | 外边距 | 整数/字符串 | 四边统一外边距(单位:dp),或用空格分隔的四个值(左 上 右 下)。 |
margin_left | 左外边距 | 整数 | 子视图左边距(单位:dp)。 |
margin_top | 上外边距 | 整数 | 子视图上边距(单位:dp)。 |
margin_right | 右外边距 | 整数 | 子视图右边距(单位:dp)。 |
margin_bottom | 下外边距 | 整数 | 子视图下边距(单位:dp)。 |
nested(滑动布局)
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
dir | 布局方向 | 字符串 | 子视图的布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
layout_gravity | 布局重力 | 字符串 | 子视图在 "nested(滑动布局)" 内的对齐方式。支持 Gravity 常量的英文或中文名称,可用 " |
margin | 外边距 | 整数/字符串 | 四边统一外边距(单位:dp),或用空格分隔的四个值(左 上 右 下)。 |
margin_left | 左外边距 | 整数 | 子视图左边距(单位:dp)。 |
margin_top | 上外边距 | 整数 | 子视图上边距(单位:dp)。 |
margin_right | 右外边距 | 整数 | 子视图右边距(单位:dp)。 |
margin_bottom | 下外边距 | 整数 | 子视图下边距(单位:dp)。 |
appbar-layout(应用条布局)
注意: 当前实现未包含 collapseMode 属性。
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
dir | 布局方向 | 字符串 | 子视图的布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
scrollFlags | 滑动标识 | 字符串 | 控制子视图如何响应 appbar(应用条) 的滚动事件。可选值:"scroll"/"滑动", "enterAlways"/"进入时总是可见", "snap"/"滑动时总是可见", "exitUntilCollapsed"/"退出时总是可见", "enterAlwaysCollapsed"/"折叠后进入时总是可见"。可用 " |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
weight | 权重 | 小数 | 子视图在 appbar-layout(应用条布局)(如果其为 linear(线性布局) 风格)中的权重。 |
layout_gravity | 布局重力 | 字符串 | 子视图在 appbar-layout(应用条布局) 内的对齐方式。支持 Gravity 常量的英文或中文名称,可用 " |
margin | 外边距 | 整数/字符串 | 四边统一外边距(单位:dp),或用空格分隔的四个值(左 上 右 下)。 |
margin_left | 左外边距 | 整数 | 子视图左边距(单位:dp)。 |
margin_top | 上外边距 | 整数 | 子视图上边距(单位:dp)。 |
margin_right | 右外边距 | 整数 | 子视图右边距(单位:dp)。 |
margin_bottom | 下外边距 | 整数 | 子视图下边距(单位:dp)。 |
coord(锚点布局)
支持子控件的属性有:
英文编程 | 中文编程 | 类型 | 描述 |
---|---|---|---|
dir | 布局方向 | 字符串 | 子视图的布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
resolveDir | 解决方向 | 字符串 | 确定视图应遵循的实际布局方向。可选值:"rtl"/"右到左", "ltr"/"左到右"。 |
behavior | 行为 | 字符串 | 指定视图的行为。可选值:"appbar"/"应用条" (关联 AppBarLayout.ScrollingViewBehavior), "fab"/"悬浮按钮" (关联 ScrollAwareFabBehavior)。 |
keyline | 参考线 | 整数 | 定义参考线(单位:dp),帮助子视图根据这些参考线进行定位。 |
anchorId | 锚点ID | 字符串 | 用于 anchorGravity,指定此视图相对于哪个具有该 ID 的视图进行定位。 |
anchorGravity | 锚点重力 | 字符串 | 指定此视图相对于 anchorId 所指定视图的对齐方式。支持 Gravity 常量的英文或中文名称,可用 " |
dodgeInsetEdges | 避让插入边 | 字符串 | 指定视图在遇到系统窗口插入边(如状态栏、导航栏)时的避让行为。支持 Gravity 常量的英文或中文名称,可用 " |
insetEdge | 插入边缘 | 字符串 | 指定视图的哪一侧应该被视为系统窗口插入边的边界。支持 Gravity 常量的英文或中文名称,可用 " |
w | 宽 | 字符串/整数 | 子视图的宽度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体宽度(单位:dp)。 |
h | 高 | 字符串/整数 | 子视图的高度。特殊值:"auto"/"自动" (WRAP_CONTENT), "max"/"最大" (MATCH_PARENT)。其他值为具体高度(单位:dp)。 |
layout_gravity | 布局重力 | 字符串 | 子视图在 coord(锚点布局) 内的对齐方式。支持 Gravity 常量的英文或中文名称,可用 " |
margin | 外边距 | 整数/字符串 | 四边统一外边距(单位:dp),或用空格分隔的四个值(左 上 右 下)。 |
margin_left | 左外边距 | 整数 | 子视图左边距(单位:dp)。 |
margin_top | 上外边距 | 整数 | 子视图上边距(单位:dp)。 |
margin_right | 右外边距 | 整数 | 子视图右边距(单位:dp)。 |
margin_bottom | 下外边距 | 整数 | 子视图下边距(单位:dp)。 |
gravity(重力)属性可选值
支持的 Gravity 值 (英文编程/中文编程):
- fill / 填充
- fill_h, fill_horizontal / 水平填充, 横向填充
- fill_v, fill_vertical / 垂直填充, 竖向填充
- start / 开头, 开始, 头部
- end / 末尾, 结束, 尾部
- left / 左, 左边
- right / 右, 右边
- top / 上, 上边
- bottom / 下, 下边, 下面
- center / 中, 中心, 中间, 居中
- center_h, center_horizontal / 水平居中, 横向居中
- center_v, center_vertical / 垂直居中, 竖向居中
- display_h, display_horizontal / 水平显示裁剪, 横向显示裁剪
- display_v, display_vertical / 垂直显示裁剪, 竖向显示裁剪
- clip_h, clip_horizontal / 水平裁剪, 横向裁剪
- clip_v, clip_vertical / 垂直裁剪, 竖向裁剪
多个值可以用 | 符号连接,例如:"center|top" 或 "居中|上"。