button 按钮

专为交互式 UI 元素设计的可自定义按钮。它支持悬停、聚焦和点击动画,并具有各种可配置的外观属性,包括背景颜色、阴影和边框样式。

示例

基础使用

1<button>
2    <label as_prop="slot" text="'Hello'"></label>
3</button>

自定义内部

1<button>
2    <view as_prop="slot">
3        <label text="'Hello'"></label>
4        <label text="'World'"></label>
5    </view>
6</button>

属性

名称说明类型
theme主题Themes
background_color背景颜色MakepadColor
background_visible背景是否可见bool
hover_color悬停颜色MakepadColor
focus_color聚焦颜色MakepadColor
shadow_color阴影颜色MakepadColor
spread_radius阴影扩展半径F32
blur_radius阴影模糊半径F32
shadow_offset阴影偏移Vec2
border_color边框颜色MakepadColor
border_width边框宽度F32
border_radius边框圆角半径F32
cursor鼠标指针MouseCursor
visible是否可见bool
grab_key_focus是否捕获键盘焦点bool
animation_key动画键bool
event_key事件键bool
abs_pos绝对位置DVec2
margin外边距Margin
width宽度Size
height高度Size
scroll滚动偏移DVec2
clip_x是否裁剪 X 轴bool
clip_y是否裁剪 Y 轴bool
padding内边距Padding
align对齐方式Align
flow流动方式Flow
spacing间距F64

事件回调

名称说明参数
hover_in鼠标进入事件GButtonHoverParam
hover_out鼠标离开事件GButtonHoverParam
clicked点击事件GButtonClickedParam
focus获取焦点事件GButtonFocusParam
focus_lost失去焦点事件GButtonFocusLostParam