OneCode 基础UI注解UIAnnotation 属性说明

@UIAnnotation 属性说明文档

注解概述

@UIAnnotation 是一个运行时注解,作用于方法、字段、构造函数和类型,用于配置UI组件的各种属性。该注解具有RUNTIME保留策略,并通过@BeanClassCustomUIBean类关联。

属性详情表

属性名类型默认值描述
dockDocknone组件停靠方式,可选值包括none、top、bottom、left、right、center、middle、origin、width、height、fill、cover
visibilityVisibilityTypevisible组件可见性,可选值为visible(可见)、hidden(隐藏但保留空间)、collapse(隐藏且不保留空间)
displayString组件显示方式
selectablebooleanfalse是否可选择
rendererString渲染器类名
imageClassString图标类名
leftString左边距,支持px、%等单位
rightString右边距,支持px、%等单位
topString上边距,支持px、%等单位
bottomString下边距,支持px、%等单位
dynLoadbooleanfalse是否动态加载
shadowsbooleanfalse是否显示阴影
zindexint0组件层级
widthString宽度,支持px、%等单位
heightString高度,支持px、%等单位
positionString定位方式,如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;
}

注意事项

  1. 定位属性(left、right、top、bottom)和尺寸属性(width、height)支持CSS单位(px、%等)
  2. zindex值越大,组件层级越高,可能覆盖其他组件
  3. dynLoad=true时,组件将在需要时才加载,可提高初始渲染性能
  4. imageClass需指定实现IconEnumstype接口的类
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值