搜索:规格
搜索允许用户输入关键词或短语,以查找相关信息。
变体
| 变体 | M3 | M3 Expressive |
|---|---|---|
| 搜索 | 可用 | 可用 |
配置
样式
搜索提供两种样式:
- 内嵌式:采用富有表现力的外观与交互体验,并使用实心容器将搜索栏与建议或结果的列表分隔开
- 分隔式(基线):未采用最新的视觉样式、动效或灵活布局特性


布局
搜索建议和结果会显示在可自定义的列表中,并提供两种布局选项:全屏和停靠式。了解有关搜索布局的更多信息




| 类别 | 配置 | M3 | M3 Expressive |
|---|---|---|---|
| 样式 | 内嵌式 | -- | 可用 |
| 分隔式 | 可用 | 不推荐,建议使用内嵌式。 | |
| 布局 | 停靠式、全屏 | 可用 | 可用 |
令牌和规格
使用表格中的菜单选择令牌集。搜索栏令牌集仅包含未聚焦搜索栏的令牌。搜索视图令牌集包含搜索交互过程中使用的所有其他令牌,涵盖所有样式和布局。了解有关设计令牌的更多信息
搜索:视图
| Token | 取值 |
|---|---|
| Search view container surface tint layer color | #6750A4 |
搜索栏
结构
搜索由搜索栏和用于显示建议与结果的容器组成。默认情况下,该容器为空。使用列表组件添加内容。在分隔式(基线)样式中,分隔线将搜索栏与结果分隔开。

- 搜索栏容器
- 前导图标
- 辅助文本
- 尾部图标和头像(可选)
- 输入文本
- 搜索建议或结果的容器
示例
- 带有头像
- 带有一个后置图标按钮
- 带有两个尾部图标按钮
- 带有尾部图标按钮和头像

颜色
颜色通过设计令牌实现。对设计师而言,这意味着使用与令牌对应的颜色值。在代码中,颜色值由引用具体值的令牌表示。
全屏布局

全屏搜索在浅色和深色主题中使用的颜色角色:
- 表面容器(低)
- 表面变体之上
- 表面变体之上
- 表面容器(高)
- 表面变体之上
- 表面之上
停靠式布局

停靠式搜索在浅色和深色主题中使用的颜色角色:
- 表面容器(高)
- 表面变体之上
- 表面变体之上
- 表面容器(高)
- 表面变体之上
- 表面之上
状态
状态是传达组件或交互元素当前状况的视觉表现。当搜索处于聚焦状态时,各元素会保留各自的交互状态。了解有关交互状态的更多信息
搜索栏

- 已启用
- 悬停
- 已聚焦
- 按下(波纹)
搜索建议和结果
搜索包含用于显示建议和结果的容器。默认情况下,该容器为空。使用列表组件添加内容。

- 已启用
- 悬停
- 已聚焦
- 按下(波纹)
尺寸规格
搜索栏


在 M3 Expressive 中,搜索栏获得焦点后会展开,外边距从 24dp 变为 12dp。


| 元素 | 属性 | 值 |
|---|---|---|
| 容器 | 宽度 | 最小 360dp,最大 720dp |
| 高度 | 56dp | |
| 标签对齐 | 起始端对齐 | |
| 前置内边距 | 未聚焦:24dp,已聚焦:12dp | |
| 后置内边距 | 未聚焦:24dp,已聚焦:12dp | |
| 前导图标和标签的内边距(相对于点按目标) | 4dp | |
| 标签和尾部图标的内边距(相对于点按目标) | 4dp | |
| 头像 | 大小 | 30dp |
聚焦搜索
内嵌式样式


| 元素 | 属性 | 值 |
|---|---|---|
| 全屏容器 | 宽度 | 占满全部宽度 |
| 高度 | 占满全部高度 | |
| 停靠式容器 | 宽度 | 最小 360dp,最大 720dp |
| 高度 | 最小 240dp,最大为屏幕高度的三分之二 | |
| 搜索栏容器 | 高度 | 56dp |
| 标签对齐 | 起始端对齐 | |
| 前置内边距 | 16dp | |
| 后置内边距 | 16dp | |
| 前导图标和标签的内边距(相对于点按目标) | 4dp | |
| 前导图标和标签的内边距(相对于点按目标) | 4dp |
分隔式样式

