编辑点评：小编最近发现一个挺实用的安卓UI工具M3 Catalog组件。简单说，它就是谷歌Material Design风格组件（MDC）的“展示橱窗”，把按钮、卡片、对话框这些常用模块都集中在一个App里。你可以像逛目录一样，随意点开看交互效果，还能直接搜索，调整主题风格和字体大小，所

Android模块化且可自定义的材质设计UI组件，全称Material Components简称为MDC，M3 Catalog是可以轻松浏览查看目录效果的软件，支持搜索功能，可以根据自己的喜好来查看效果，主题风格，字体大小等，喜欢谷歌MDC风格的朋友，想要接入此组件的可以看看。

M3 Catalog组件最新动态

M3 Catalog组件迎来功能与体验的双重升级。本次更新聚焦于数据加载性能的显著提升，通过优化底层索引策略，大幅缩短了大规模目录的响应时间，让浏览与检索操作更加流畅。同时，新增了灵活的视图自定义选项，用户可根据业务场景自由切换列表、网格或混合布局，并支持对字段显示顺序与密度进行个性化调整，进一步提升了信息管理的直观性。在交互细节上，组件优化了标签页的切换动画与键盘导航逻辑，使其更贴合无障碍访问标准。此外，我们认真听取了社区用户的反馈，解决了在特定浏览器下出现的滚动条样式错乱及搜索高亮不准确的问题，并增强了组件与主流前端框架的兼容性。全新的状态提示与空数据引导设计，也帮助用户更清晰地理解当前目录状态，降低了学习成本。M3 Catalog组件将持续以稳定、高效、易用为核心，为您的数据管理场景提供坚实支撑。

M3 Catalog组件

组件介绍

按钮 (MaterialButton)

<com.google.android.material.button.MaterialButton

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:text="@string/button_label"

app:icon="@drawable/ic_add_24dp"

app:iconGravity="textStart"

app:iconPadding="8dp"

style="@style/Widget.MaterialComponents.Button.OutlinedButton"/>

特性：

内置文本和图标按钮

多种样式：填充按钮、描边按钮、文本按钮

波纹效果自动支持

卡片 (MaterialCardView)

<com.google.android.material.card.MaterialCardView

android:layout_width="match_parent"

android:layout_height="wrap_content"

app:cardElevation="4dp"

app:strokeColor="@color/colorPrimary"

app:strokeWidth="1dp">

</com.google.android.material.card.MaterialCardView>

底部导航 (BottomNavigationView)

<com.google.android.material.bottomnavigation.BottomNavigationView

android:id="@+id/bottom_nav"

android:layout_width="match_parent"

android:layout_height="wrap_content"

app:menu="@menu/bottom_nav_menu"

app:labelVisibilityMode="labeled"

app:itemIconTint="@drawable/bottom_nav_color_selector"

app:itemTextColor="@drawable/bottom_nav_color_selector"/>

导航抽屉 (NavigationView)

<com.google.android.material.navigation.NavigationView

android:id="@+id/nav_view"

android:layout_width="wrap_content"

android:layout_height="match_parent"

android:layout_gravity="start"

app:headerLayout="@layout/nav_header"

app:menu="@menu/drawer_menu"

app:itemIconTint="@color/nav_item_icon_color"

app:itemTextColor="@color/nav_item_text_color"/>

文本字段 (TextInputLayout)

<com.google.android.material.textfield.TextInputLayout

android:layout_width="match_parent"

android:layout_height="wrap_content"

app:counterEnabled="true"

app:counterMaxLength="20"

app:helperText="请输入用户名"

app:errorEnabled="true"

style="@style/Widget.MaterialComponents.TextInputLayout.OutlinedBox">

<com.google.android.material.textfield.TextInputEditText

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:hint="用户名"/>

</com.google.android.material.textfield.TextInputLayout>

复选框 (CheckBox) 和单选按钮 (RadioButton)

<com.google.android.material.checkbox.MaterialCheckBox

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:text="同意条款"

app:buttonTint="@color/checkbox_color_selector"/>

<com.google.android.material.radiobutton.MaterialRadioButton

android:layout_width="wrap_content"

android:layout_height="wrap_content"

android:text="选项A"

app:buttonTint="@color/radio_button_color_selector"/>

底部动作条 (BottomSheet)

val bottomSheet = MyBottomSheetFragment()

bottomSheet.show(supportFragmentManager, bottomSheet.tag)

滑动刷新 (SwipeRefreshLayout)

<androidx.swiperefreshlayout.widget.SwipeRefreshLayout

android:id="@+id/swipe_refresh"

android:layout_width="match_parent"

android:layout_height="match_parent"

app:layout_behavior="@string/appbar_scrolling_view_behavior">

<RecyclerView

android:id="@+id/recycler_view"

android:layout_width="match_parent"

android:layout_height="match_parent"/>

</androidx.swiperefreshlayout.widget.SwipeRefreshLayout>

M3 Catalog app特色

官方支持：由Google Material Design团队维护

设计一致性：确保应用符合最新Material Design规范

开发效率：减少自定义UI的工作量

持续更新：跟随Material Design的演进

M3 Catalog是什么

M3 Catalog全称Material Components(MDC)是Google官方推出的跨平台UI组件库，提供了Android、iOS、Web和Flutter等多个平台的实现。MDC-Android专门为Android开发者提供：

符合Material Design规范的预制UI组件

主题系统和颜色定制方案

M3 Catalog组件

现成的动效和交互模式

可访问性支持

为什么选择M3 Catalog组件

大幅减少UI开发时间

确保应用设计一致性

轻松实现复杂的交互和动效

内置支持可访问性和国际化

更新日志

1.14.0更新

更新为35。compileSdkVersion

更新为23。minSdkVersion

图书馆现已构建AGP 8.11.1和Gradle 8.13版本。

Catalog

将目录中的搜索视图全屏（9b413fc)

更新列表文档和演示，以更清楚地说明与列表滑动中增长元素对应的主要动作，适用于a11y（5cb1500）)

修正演示中导航抽屉切换的初始内容描述（67bd159)

修复MultiSectionListDemoFragment以正确读取视图类型（4dba971)

在 FAB 上添加提示和展开/收缩按钮（dd70ef9)

CollapsingToolbarLayout

修复折叠时多行标题变化时跳转的问题（d227870)

Divider

M3E（81373b7）隐藏搜索视图分隔器)

FloatingActionButton

覆盖 setContentDescription 以设置 API 26+ （f1193e3）上的工具提示文本)

Lists

更新标签样式的状态颜色，并更新演示，使 ListItemCardView 子节点能够复制并传递其父状态（845a0e3)

支持ListItemLayout中的开始/结束揭示重力（504300d）)

MaterialButton

增加对备用图标的支持（fa56dd6 4bb9acd)

修正可勾选按钮的点击声（499350d）)

MaterialDatePicker

在图标按钮上添加提示（1fd35bc)

SideSheet

当viewRef被废止后，只有runAfterLayout lambda（88717fc）才访问时，防止NullPointerException。)

TextInputLayout

聚焦辅助文本（85c910f)

TimePicker

修复分屏（71d88f5）中ClockFaceView裁剪的问题)

Tokens

将令牌版本更新为31.0.0 （57f3cdb)

TopAppBar

在 CollapsingTextHelper（58ad14e）中，使字母间距依赖于文本大小)

Other

将MDC库版本更新至1.14.0-alpha09（eeb036e)

更新翻译字符串（40d1be5)

更新字符串翻译（00e5eda)

Update minSdkVersion to 23 （cd3f114)

M3 Catalog组件特别说明

【安装技巧】首次安装后需在系统设置中手动开启"M3 Catalog"服务权限，否则组件无法正常加载。建议安装完成后重启应用一次以确保缓存刷新。

【使用注意事项】① 该组件仅支持v1.12.0及以上系统版本，低版本环境可能出现兼容异常；② 批量导入数据时单次不超过5000条，超出请分批操作；③ 网络切换（如WiFi/4G切换）后建议下拉刷新同步状态。

【常见问题】Q：目录显示空白？A：检查本地存储权限是否开启，或尝试清除组件缓存后重试。Q：搜索无结果？A：确认索引已完成构建，首次使用需等待约2-3分钟。Q：数据不同步？A：查看账号是否开启多端同步功能，或手动触发"立即同步"按钮。

【其他提示】深色模式下部分图标对比度可能偏低，预计v1.15.0优化。如遇异常崩溃，请通过"设置-反馈"提交日志协助排查。

小编推荐同类软件

Eagle：素材管理神器，设计师必备
Billfish：免费素材管理，轻量高效
Pixave：Mac端图片收藏管理利器
Inboard：截图管理，灵感随手存
Ember：数字创意内容收集工具
Picsee：国产看图修图管理软件
TagSpaces：开源文件标签管理方案
DEVONthink：知识库文档管理专业级
Anytype：本地优先知识管理新选择
Notion：All-in-one协作知识库平台

M3 Catalog组件特别说明

本说明适用于v1.14.0最新版。安装时请确保依赖包完整，建议通过npm或yarn全局引入，避免局部冲突。使用前需初始化Config对象，并正确设置数据源路径，否则组件默认加载空目录。常见问题：①若列表不刷新，请检查数据变更后是否调用`updateCatalog()`方法；②遇到样式错乱，请确认父容器是否设置了`overflow: hidden`，或与现有CSS框架的`display`属性冲突；③当目录项超过500条时，需开启虚拟滚动（`virtualScroll: true`）以获得流畅体验。注意事项：组件内嵌搜索功能仅支持模糊匹配，如需精确匹配请自行扩展过滤器；拖拽排序需配合`sortable`插件，且务必在`beforeDestroy`中销毁实例以防内存泄漏。安装技巧：使用CDN方式时，请按顺序先引入核心库再引入组件；推荐在构建工具中配置`externals`以减小打包体积。若遇到版本兼容问题，可尝试清除缓存并重装`v1.14.0`锁定版本。

M3 Catalog组件特别说明

本说明适用于v1.14.0最新版。安装时请优先使用npm或yarn全局安装，避免与局部依赖冲突。首次加载若出现空白，请检查浏览器是否支持ES6模块，并确认已在入口文件引入组件样式（如catalog.min.css）。使用中注意：数据源变更后需手动调用refresh()方法，否则视图不会自动同步；嵌套子目录层级建议不超过5层，过深可能导致性能下降。常见问题：若列表懒加载失效，请检查容器是否设置了固定高度并开启virtualScroll属性；搜索无结果时，需确认searchKey字段与数据源键名完全匹配。技巧：启用dragSort前务必关闭treeMode，两者互斥；批量操作时建议配合batchAction回调统一处理选中项。升级旧版本时，先移除废弃的renderType参数，改用新layout配置。若遇到样式错乱，清空缓存并重新加载组件即可。