QMUI UI库 控件 弹窗 列表 工具类 MD

Markdown版本笔记	我的GitHub首页	我的博客	我的微信	我的邮箱
MyAndroidBlogs	baiqiantao	baiqiantao	bqt20094	baiqiantao@sina.com

QMUI UI库 控件 弹窗 列表 工具类

---

目录

目录
简介
使用步骤
基本组成
弹窗相关组件
列表相关
顶部栏相关
TextView相关
Span相关
其他
工具类
演示案例
QMUIDialog
QMUIBottomSheet 和 QMUITipDialog 和 QMUIPopup
QMUITabSegment

简介

学习Demo
官网
GitHub
功能列表

Android UI 解决方案

QMUI Android 的设计目的是用于辅助快速搭建一个具备基本设计还原效果的 Android 项目，同时利用自身提供的丰富控件及兼容处理，让开发者能专注于业务需求而无需耗费精力在基础代码的设计上。

不管是新项目的创建，或是已有项目的维护，均可使开发效率和项目质量得到大幅度提升。

特点

• 全局 UI 配置：只需要修改一份配置表就可以调整 App 的全局样式，包括组件颜色、导航栏、对话框、列表等。一处修改，全局生效。
• 丰富的 UI 控件：提供丰富常用的 UI 控件，例如 BottomSheet、Tab、圆角ImageView、下拉刷新等，使用方便灵活，并且支持自定义控件的样式。
• 高效的工具方法：提供高效的工具方法，包括设备信息、屏幕信息、键盘管理、状态栏管理等，可以解决各种常见场景并大幅度提升开发效率。

使用步骤

引入库
最新的库会上传到 JCenter 仓库上，请确保配置了 JCenter 仓库源，然后直接引用：

compile 'com.qmuiteam:qmui:1.0.6'

配置主题
把项目的 theme 的 parent 指向 QMUI.Compat 或 QMUI，至此，QMUI 可以正常工作。

覆盖组件的默认表现
你可以通过在项目中的 theme 中用 <item name="(name)">(value)</item> 的形式来覆盖 QMUI 组件的默认表现。具体可指定的属性名请参考 @style/QMUI.Compat 或 @style/QMUI 中的属性。

基本组成

弹窗相关组件

QMUIDialog
提供了一系列常用的对话框，解决了使用系统默认对话框时在不同 Android 版本上的表现不一致的问题。使用不同的 Builder 来构建不同类型的对话框，这些 Builder 都拥有设置 title 和添加底部按钮的功能，不同的 Builder 特有的作用如下：

• MessageDialogBuilder：消息类型的对话框 Builder。通过它可以生成一个带标题、文本消息、按钮的对话框。
• ConfirmMessageDialogBuilder：带 Checkbox 的消息确认框 Builder。
• EditTextDialogBuilder：带输入框的对话框 Builder。
• MenuDialogBuilder：菜单对话框 Builder。
• CheckableDialogBuilder：单选类型的对话框 Builder。
• MultiCheckableDialogBuilder：多选类型的对话框 Builder。
• CustomDialogBuilder：自定义对话框内容区域的 Builder。
• AutoResizeDialogBuilder：随键盘升降自动调整 Dialog 高度的 Builder

QMUITipDialog
提供一个浮层展示在屏幕中间，提供了以下两种样式：

• 使用 QMUITipDialog.Builder 生成，提供了一个图标和一行文字的样式, 其中图标有 Loading、成功、失败等类型可选。
• 使用 QMUITipDialog.CustomBuilder 生成，支持传入自定义的 layoutResId。

QMUIBottomSheet
在 Dialog 的基础上重新定制了 show() 和 hide() 时的动画效果, 使 Dialog 在界面底部升起和降下。提供了以下两个面板样式：

• 列表样式：使用 QMUIBottomSheet.BottomListSheetBuilder 生成。
• 宫格类型：使用 QMUIBottomSheet.BottomGridSheetBuilder 生成。

QMUIPopup
提供一个浮层，支持自定义浮层的内容，支持在指定 View 的任一方向旁边展示该浮层，支持自定义浮层出现/消失的动画。

QMUIListPopup
继承自 QMUIPopup，在 QMUIPopup 的基础上，支持显示一个列表。

QMUIProgressBar
一个进度条控件，通过颜色变化显示进度，支持环形和矩形两种形式，主要特性如下：

• 支持在进度条中以文字形式显示进度，支持修改文字的颜色和大小。
• 可以通过 xml 属性修改进度背景色，当前进度颜色，进度条尺寸。
• 支持限制进度的最大值。

列表相关

QMUIGroupListView
通用的列表，常用于 App 的设置界面，注意其父类不是 ListView 而是 LinearLayout，所以一般要配合 ScrollView 使用。提供了 Section 的概念，用来将列表分块。 配合 QMUIGroupListView.Section, QMUICommonListItemView 和 QMUIGroupListSectionHeaderFooterView 使用。

QMUIWrapContentListView
支持高度值为 wrap_content 的 ListView，解决原生 ListView 在设置高度为 wrap_content 时高度计算错误的 bug。

QMUIAnimationListView
使 ListView 支持添加/删除 Item 的动画，支持自定义动画效果。

QMUICommonListItemView
用作通用列表 QMUIGroupListView 里的 Item，也可单独使用。支持以下样式：

• 展示一行文字。
• 在右侧或下方增加一行说明文字。
• 在 item 右侧显示一个开关或箭头或自定义的View

QMUIGroupListSectionHeaderFooterView
用作通用列表 QMUIGroupListView 里每个 Section 的头部或尾部，也可单独使用。

QMUIItemViewsAdapter
一个带 cache 功能的“列表型数据-View”的适配器，适用于自定义 View 需要显示重复单元 ListView 的情景，cache 功能主要是保证在需要多次刷新数据或布局的情况下（ListView 或 RecycleView 的 itemView）复用已存在的 View。QMUI 用于 QMUITabSegment 中 Tab 与数据的适配。

QMUIPullRefreshLayout
下拉刷新控件。支持自定义 RefreshView（表示正在刷新的 View），触发刷新的位置等特性。

QMUIEmptyView
通用的空界面控件，支持显示 loading、主标题和副标题、图片。

QMUILoadingView
用于显示 Loading 的 View，支持颜色和大小的设置。

QMUIObservableScrollView
可以监听滚动事件的 ScrollView，并能在滚动回调中获取每次滚动前后的偏移量。

顶部栏相关

QMUITopBar
通用的顶部 Bar。提供了以下功能：

• 在左侧/右侧添加图片按钮/文字按钮/自定义View。
• 设置标题/副标题，且支持设置标题/副标题的水平对齐方式。

QMUITopBarLayout
对 QMUITopBar 的包裹类，并代理了 QMUITopBar 的方法。配合 QMUIWindowInsetLayout 使用，可使 QMUITopBar 在支持沉浸式状态栏的界面中顶部延伸到状态栏。

QMUIWindowInsetLayout
配合沉浸式状态栏使用，用于协调子 View 的 fitSystemWindows。

QMUITabSegment
用于横向多个 Tab 的布局，包含多个特性：

• 可以用 xml 或 QMUITabSegment 提供的 set 方法统一配置文字颜色、icon 位置、是否要下划线等。
• 每个 Tab 都可以非常灵活的配置，内容上支持文字和 icon 的显示，icon 支持选中态，支持内容的排版对齐方向设置，支持显示红点，支持插入自定义的 View，支持监听双击事件等。
• 可以通过 setupWithViewPager(ViewPager) 方法与 ViewPager 绑定。

TextView相关

QMUILinkTextView
使 TextView 能自动识别 URL、电话、邮箱地址，相比 TextView 有以下特点：

• 可以设置链接的样式。
• 可以设置链接的点击事件。

QMUIFontFitTextView
使 TextView 在宽度固定的情况下，文字多到一行放不下时能缩小文字大小来自适应。

QMUISpanTouchFixTextView
相比 TextView，修正了两个常见问题：

• 修正了 TextView 与 ClickableSpan 一起使用时，点击 ClickableSpan 也会触发 TextView 的事件的问题。
• 修正了 TextView 默认情况下如果添加了