@UIAnnotation 属性说明文档
注解概述
@UIAnnotation
是一个运行时注解,作用于方法、字段、构造函数和类型,用于配置UI组件的各种属性。该注解具有RUNTIME
保留策略,并通过@BeanClass
与CustomUIBean
类关联。
属性详情表
属性名 | 类型 | 默认值 | 描述 |
---|---|---|---|
dock | Dock | none | 组件停靠方式,可选值包括none、top、bottom、left、right、center、middle、origin、width、height、fill、cover |
visibility | VisibilityType | visible | 组件可见性,可选值为visible(可见)、hidden(隐藏但保留空间)、collapse(隐藏且不保留空间) |
display | String | 组件显示方式 | |
selectable | boolean | false | 是否可选择 |
renderer | String | 渲染器类名 | |
imageClass | String | 图标类名 | |
left | String | 左边距,支持px、%等单位 | |
right | String | 右边距,支持px、%等单位 | |
top | String | 上边距,支持px、%等单位 | |
bottom | String | 下边距,支持px、%等单位 | |
dynLoad | boolean | false | 是否动态加载 |
shadows | boolean | false | 是否显示阴影 |
zindex | int | 0 | 组件层级 |
width | String | 宽度,支持px、%等单位 | |
height | String | 高度,支持px、%等单位 | |
position | String | 定位方式,如absolute、relative等 |
关联枚举说明
Dock枚举
定义组件的停靠和对齐方式,包含以下值:
- none: 无停靠
- top: 顶部停靠
- bottom: 底部停靠
- left: 左侧停靠
- right: 右侧停靠
- center: 水平居中
- middle: 垂直居中
- origin: 原点对齐
- width: 宽度填充
- height: 高度填充
- fill: 完全填充
- cover: 覆盖父容器
VisibilityType枚举
定义组件的可见性状态:
- visible: 可见
- hidden: 隐藏但保留空间
- collapse: 隐藏且不保留空间
使用示例
类级别使用
@UIAnnotation(dock = Dock.top, visibility = VisibilityType.visible, width = "100%", height = "50px")
public class CustomTitleBar extends CustomUIBean {
// 类实现
}
字段级别使用
public class UserProfilePanel {
@UIAnnotation(dock = Dock.left, width = "80px", height = "80px", imageClass = "UserAvatarIcon")
private ImageView avatar;
@UIAnnotation(dock = Dock.right, visibility = VisibilityType.hidden)
private Button editButton;
}
注意事项
- 定位属性(left、right、top、bottom)和尺寸属性(width、height)支持CSS单位(px、%等)
- zindex值越大,组件层级越高,可能覆盖其他组件
- dynLoad=true时,组件将在需要时才加载,可提高初始渲染性能
- imageClass需指定实现IconEnumstype接口的类