Skip to content

组件库 ​

开发者参考

本页面描述了 FFFFinance 中使用的可复用界面组件。它主要对开发者和贡献者有用。如果你正在寻找应用使用帮助,请参阅面板文档。

FFFFinance 在整个应用中使用一套一致的界面构建模块。每个按钮、输入框和搜索框都遵循相同的设计规则,无论你在哪个面板中,体验都是统一的。

按钮 ​

按钮有四种样式和三种大小。

样式 ​

样式使用场景
主要主要操作,如"保存"、"连接"、"同步"
次要不太突出的标准操作
幽灵工具栏和标题中的微妙操作
危险破坏性操作,如"删除"或"断开连接"

所有按钮响应你当前的主题——颜色、边框和悬停效果自动适应。

大小 ​

大小使用场景
小紧凑工具栏、行内操作
中应用中大多数按钮
大突出的独立操作

按钮可以在标签旁包含图标,或者仅图标(方形)用于工具栏操作。仅图标按钮始终有屏幕阅读器标签以确保无障碍性。

加载状态 ​

当按钮触发需要时间的操作(如同步数据)时,它会显示加载动画并临时禁用,以防止意外双击。

文本输入框 ​

输入框用于在整个应用中输入文本、数字、日期和 API 密钥。

功能 ​

功能描述
标签字段上方的可选标签文本
图标字段内的可选图标(左侧或右侧)
错误状态验证失败时的红色边框
禁用状态灰色显示且不可交互

输入框适应你的主题,并使用与应用其余部分相同的字体。

搜索 ​

搜索输入是一个预配置的带放大镜图标的文本输入框。它出现在交易、日志等需要过滤内容的面板中。

功能 ​

  • 放大镜图标自动匹配输入框大小
  • 清除按钮用于重置搜索
  • 提供小、中、大三种大小

一致的设计 ​

所有组件共享这些特质:

  • 主题感知 —— 颜色适应你选择的任何主题
  • 键盘可访问 —— 使用键盘导航时有可见的聚焦环
  • 一致的大小 —— 所有组件类型提供小、中、大选项
  • 响应式 —— 在任何大小的面板中都能良好运作