Skip to content

一套简单易用让前端开发快速上手的鸿蒙UI库,支持定制主题,参考vant实现,更贴近Web端开发习惯。

License

Notifications You must be signed in to change notification settings

ibestservices/ibest-ui

Repository files navigation

IBest-UI

简介

IBest-UI是一个轻量、简单易用、可定制主题、支持深色模式和浅色模式的鸿蒙开源UI组件库。

QQ群

QQ群

下载安装

ohpm install @ibestservices/ibest-ui

OpenHarmony ohpm 环境配置等更多内容,请参考如何安装 OpenHarmony ohpm 包

组件介绍

基础组件

组件 介绍
Button 按钮 按钮用于触发一个操作,如提交表单。 文档
Cell 单元格 单元格为列表中的单个展示项。 文档
Icon 图标 基于字体的图标集,可以通过 IBestIcon 组件使用。 文档
Popup 弹出层 弹出层容器,用于展示弹窗、信息提示等内容,支持多个弹出层叠加展示。 文档
Toast 轻提示 在页面中间弹出黑色半透明提示,用于消息通知、加载提示、操作结果提示等场景。 文档

表单组件

组件 介绍
Calendar 日历 日历用于选择单个、多个日期或日期范围。 文档
Cascader 级联选择器 级联选择框,用于多层级数据的选择,典型场景为省市区选择。 文档
Checkbox 复选框 在一组备选项中进行多选。 文档
DatePicker 日期选择 日期选择器,用于选择年、月、日,通常与弹出层组件配合使用。 文档
Field 输入框 用户可以在文本框内输入或编辑文字。 文档
Form 表单 用于数据录入、校验,支持输入框、单选框、复选框、文件上传等类型,需要与 Field 输入框 组件搭配使用。 文档
NumberKeyboard 数字键盘 虚拟数字键盘,可以配合密码输入框组件或自定义的输入框组件使用。 文档
PasswordInput 密码输入框 带网格的输入框组件,可以用于输入密码、短信验证码等场景,通常与数字键盘组件配合使用。 文档
Picker 选择器 提供多个选项集合供用户选择,支持单列选择、多列选择和级联选择,通常与弹出层组件配合使用。 文档
PickerGroup 选择器组 用于结合多个 Picker 选择器组件,在一次交互中完成多个值的选择。 文档
Radio 单选框 在一组备选项中进行单选。 文档
Rate 评分 用于对事物进行评级操作。 文档
Search 搜索 用于搜索场景的输入框组件。 文档
Slider 滑块 滑动输入条,用于在给定的范围内选择一个值。 文档
Signature 签名 用于签名场景的组件,基于 Canvas 实现。 文档
Stepper 步进器 步进器由增加按钮、减少按钮和输入框组成,用于在一定范围内输入、调整数字。 文档
Switch 开关 用于在打开和关闭状态之间进行切换。 文档
TimePicker 时间选择 日期选择器,用于选择年、月、日,通常与弹出层组件配合使用。 文档
Uploader 文件上传 用于将本地的图片或文件上传至服务器,并在上传过程中展示预览图和上传状态。目前 Uploader 组件不包含将文件上传至服务器的接口逻辑,该步骤需要自行实现。 文档

反馈组件

组件 介绍
ActionSheet 动作面板 底部弹起的模态面板,包含与当前情境相关的多个选项。 文档
Dialog 弹出框 弹出模态框,常用于消息提示、消息确认,或在当前页面内完成特定的交互操作。支持组件调用和函数调用两种方式。 文档
Loading 加载 加载图标,用于表示加载中的过渡状态。 文档
Notify 消息提示 在页面顶部展示消息提示。 文档
PullRefresh 下拉刷新 轻量级, 用于提供下拉刷新的交互操作。 文档
SwipeCell 滑动单元格 可以左右滑动来展示操作按钮的单元格组件。 文档

展示组件

组件 介绍
Badge 徽标 在右上角展示徽标数字或小红点。 文档
CircleProgress 环形进度条 圆环形的进度条组件。 文档
Collapse 折叠面板 将一组内容放置在多个折叠面板中,点击面板的标题可以展开或收缩其内容。 文档
CountDown 倒计时 用于实时展示倒计时数值,支持毫秒精度。 文档
Divider 分割线 用于将内容分隔为多个区域。 文档
Empty 空状态 空状态时的占位提示。 文档
ImagePreview 图片预览 图片放大预览。 文档
NoticeBar 通知栏 用于循环播放展示一组消息通知。 文档
Popover 气泡弹出框 弹出式的气泡菜单。 文档
Progress 进度条 用于展示操作的当前进度。 文档
Tag 标签 用于标记关键词和概括主要内容。 文档
TextEllipsis 文本省略 对长文本进行省略,支持展开/收起。 文档
Watermark 水印 在页面上添加特定的文字或图案作为水印,可用于防止信息盗用。 文档

导航组件

组件 介绍
NavBar 导航栏 为页面提供导航功能,常用于页面顶部。 文档
SideBar 侧边导航 垂直展示的导航栏,用于在不同的内容区域之间进行切换。 文档
Tab 标签页 选项卡组件,用于在不同的内容区域之间进行切换。 文档

需要权限

文档地址

https://ibestui.ibestservices.com/

仓库地址

https://gitee.com/ibestservices/ibest-ui

https://github.com/ibestservices/ibest-ui

IBest-UI 交流QQ群

953492584

QQ群

微信群

先进QQ群,拉你进微信群

约束与限制

在下述版本验证通过:

DevEco Studio 5.0.1 Release
Build #DS-233.14475.28.36.505310
构建版本:5.0.5.310, built on December 11, 2024
Runtime version: 17.0.12+1-b1087.25 x86_64
VM: OpenJDK 64-Bit Server VM by JetBrains s.r.o.
macOS 15.2
GC: G1 Young Generation, G1 Old Generation
Memory: 2048M
Cores: 12
Metal Rendering is ON
Registry:
  idea.plugins.compatible.build=IC-233.14475.28
Non-Bundled Plugins:
  com.alibabacloud.intellij.cosy (1.4.14)
  com.huawei.deveco.intelligent-assistant (2.1.0.1)

开源协议

本项目基于 Apache License 2.0,请自由地享受和参与开源。

贡献者

感谢以下同学对IBest-UI做的贡献:

About

一套简单易用让前端开发快速上手的鸿蒙UI库,支持定制主题,参考vant实现,更贴近Web端开发习惯。

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •