跳到内容
CrossFly 是 100% 开源在 GitHub 关注我们
CrossFlyCrossFly
开始使用

本文档目前提供葡萄牙语版本。其他语言的翻译正在准备中。

UI — 构建界面

组件目录

CrossFly 可视组件目录:按钮、输入框、选择器、弹窗与各类 picker,每个都附带可运行的示例。

参考
ActionSheet

锚定在屏幕底部的 iOS 风格操作表,用于让用户从若干动作中选择一个。

参考
Alert

模态对话框,包含标题、消息正文和一到多个操作按钮,会阻断当前交互。

参考
BarcodePicker

通过设备摄像头读取条形码与二维码的抽象类,由各平台提供具体实现。

参考
Button

可点击的按钮,显示文本和/或图标,带按下状态和 onAction。

参考
Charts (ChartView)

图表——折线、面积、柱状、堆叠柱状/面积、饼图、环形图和组合图——共享一个渲染核心。

参考
ColorPicker

通过色相×饱和度矩阵加亮度滑块选择颜色,并回传所选的色值。

参考
DatePicker

在月历视图中选择日期,支持限定可选范围,并回传选中的那一天。

参考
Dropdown

ComboBox —— 带箭头的按钮,点击后展开列表以进行单选。

参考
间距(Gap)

如何在不使用 Spacer 的情况下为组件设置间距 —— 使用 Gap、ingap/outgap 和布局分数。

参考
FilePicker

预留组件——2026 API 中的空骨架,目前不会产生任何结果,仅占位。

参考
Group

使 Options/Switches 互斥(单选按钮)的逻辑注册表。

参考
Hint

非模态的短暂通知,用来替代 Toast 与 ToolTip,显示后会自行消失。

参考
ImageView

显示 Image,可配置缩放模式(ImageSize)和对齐方式。

参考
Keypad

数字键盘与计算器窗口,会锚定到当前获得焦点的 TextField 上方。

参考
Label

用于显示文本(带自动换行)和/或只读图标的非交互式组件。

参考
LabelItem 和 CheckLabelItem

现成的列表项卡片 —— 仅标签(SINGLE)或复选框 + 标签(MULTIPLE)。

参考
ListView

可滚动、可嵌入其他布局的文本项列表,支持单选与多选两种模式。

参考
ListViewWindow

将 ListView 包裹在 Window 中的模态弹窗,用于在浮动窗口中进行选择。

参考
LocationPicker

在带 GPS 的地图上选择地理坐标,并把经纬度回传给调用方。

参考
LocationView

以文本形式显示 GPS 坐标(纬度、经度、定位时间、速度、方向),并周期性更新。

参考
Option

带交叉淡入淡出动画的复选框/单选框 —— 单独使用时为复选框,在 Group 中为单选框。

参考
PagedDataAdapter

面向 VirtualListView 的分页 DataAdapter,带页面 LRU 缓存和异步加载。

参考
PhotoPicker

调用设备摄像头拍摄照片或录制视频,并返回生成文件的路径。

参考
Picker(基类)

所有 picker 的基类 —— getAnswer() + show(onAnswer) 模式。

参考
Progress

进度指示器:可显示确定百分比的进度条、无限循环动画或旋转图标。

参考
Slider

在给定区间内选择一个 float 值,可以连续滑动,也可以按固定步进取值。

参考
Switch

开关切换器,带动画滑轨和可选的文字标签,用于表达开启或关闭两种状态。

参考
TabBar

标签栏,带动画指示器,内容可水平滚动并按页对齐吸附。

参考
TextArea

多行文本字段,支持自动换行、垂直滚动、按行图标和可滚动的只读模式。

参考
TextField

单行文本字段,支持掩码、EditMode、密码模式、可点击图标和浮动 caption。

参考
TextInput

文本输入的抽象基类 —— 光标、选择、剪贴板、焦点和键盘,为 TextField 和 TextArea 所共有。

参考
TimePicker

通过模拟时钟表盘或数字网格选择小时与分钟,并回传选中的时间。

参考
VirtualListView

高性能虚拟化列表,回收利用组件,风格类似 RecyclerView。

参考
WebContainer

在 UI 中嵌入原生 webview(HTML/JS)—— 通过 IWebView 接口,依赖于平台。

参考
Whiteboard

自由手绘表面,笔迹经过平滑处理,颜色与粗细均可配置,适合签名场景。