material-components-android

覆盖的组件（18 大类）

按钮类

组件	说明
MaterialButton	替代原生 Button，自动应用 M3 样式，支持图标、边框、圆角、涟漪等
MaterialButtonToggleGroup	一组可切换的按钮，支持单选/多选模式
FloatingActionButton (FAB)	悬浮操作按钮，M3 风格的圆形/迷你/扩展尺寸
ExtendedFloatingActionButton	带文字和图标的扩展悬浮按钮

文本输入类

组件	说明
TextInputLayout	容器组件，包裹 EditText 提供浮动标签、错误提示、字符计数、前缀/后缀等功能
TextInputEditText	专为 TextInputLayout 设计的 EditText 子类
MaterialAutoCompleteTextView	下拉自动补全输入框，配合 ExposedDropdownMenu 样式使用

三种输入框变体：

• OutlinedBox — 轮廓样式（默认）
• FilledBox — 填充样式
• ExposedDropdownMenu — 下拉菜单样式

卡片类

组件	说明
MaterialCardView	M3 卡片视图，支持升起/填充/轮廓三种样式，可选中和涟漪效果

导航类

组件	说明
NavigationView	抽屉导航（侧滑菜单），支持 menu 和 headerLayout
BottomNavigationView	底部导航栏，支持 Badge（红点角标）
NavigationRailView	导航轨（平板/折叠屏专用）
TabLayout	顶部标签栏，可与 ViewPager2 联动

弹出层类

组件	说明
BottomSheetDialog	Modal 底部弹出层，可拖拽展开/收起
BottomSheetBehavior	嵌入式底部弹出层 Behavior，附加到任意 View
MaterialAlertDialog	M3 风格对话框，支持基础/单选/多选列表

反馈类

组件	说明
Snackbar	底部轻量提示条，支持操作按钮和滑动消除

选择控件类

组件	说明
MaterialCheckBox	M3 复选框
MaterialRadioButton	M3 单选按钮
MaterialSwitch	M3 开关（替代 SwitchCompat）
Slider	滑块选择器，支持单滑块和范围滑块（RangeSlider）

标签类

组件	说明
Chip	标签芯片，四种类型：Assist / Filter / Input / Suggestion
ChipGroup	Chip 容器，支持流式布局和单选/多选

应用栏类

组件	说明
MaterialToolbar	M3 工具栏，替代原生 Toolbar
AppBarLayout	应用栏容器，支持滚动行为
CollapsingToolbarLayout	折叠式标题栏，支持 Medium / Large 折叠样式

选择器类

组件	说明
MaterialDatePicker	M3 日期选择器，支持单选和日期范围选择
MaterialTimePicker	M3 时间选择器，支持 12H / 24H 格式

进度指示器类

组件	说明
CircularProgressIndicator	圆形进度指示器
LinearProgressIndicator	线性进度指示器
LoadingIndicator	M3 Expressive 加载指示器（新增）

其他组件

组件	说明
MaterialDivider	M3 分隔线，支持内边距和粗细
BadgeDrawable	角标/红点，可附加到导航项、Tab 等
Carousel	M3 Expressive 轮播布局，配合 RecyclerView
ShapeableImageView	可定制形状（圆角、圆形等）的 ImageView

每个组件包含的内容

每个组件在 SKILL.md 中提供：

1. XML 布局示例 — 可直接复制使用的完整 XML 代码
2. 关键属性表 — 所有 app: 自定义属性及其说明、默认值
3. Java 代码示例 — 常用 API 调用（初始化、设置数据、监听事件等）
4. 样式变体 — 如卡片的 Elevated / Filled / Outlined 三种样式
5. 常见组合用法 — 如 TabLayout + ViewPager2 联动、TextInputLayout + 错误验证等

M3 主题系统

技能还包含完整的 Material Design 3 主题配置指南。