跳转到内容

App Bar 应用栏

应用栏组件展示了与当前屏幕息息相关的信息和操作。

而顶部应用栏(App Bar)则提供与当前屏幕相关的内容和操作。 该组件常用于展示品牌、展示标题、提供导航和一些可操作的内容。

它既可以用作于转换为上下文相关的操作栏,又可以直接充当导航栏。

简单的应用栏

News

带有菜单的应用栏

Photos

带有响应式菜单的应用栏

LOGO
LOGO

带有搜索输入框的应用栏

侧边搜索栏。

MUI

带有主要搜索输入框的应用栏

主要搜索栏。

MUI

紧凑模式(仅限桌面模式)

Photos
<AppBar position="static">
  <Toolbar variant="dense">
    <IconButton edge="start" color="inherit" aria-label="menu" sx={{ mr: 2 }}>
      <MenuIcon />
    </IconButton>
    <Typography variant="h6" color="inherit" component="div">
      Photos
    </Typography>
  </Toolbar>
</AppBar>

Prominent

A prominent app bar.

MUI

底部应用栏

固定位置

当渲染一个固定位置的应用栏时,元素的尺寸不会影响页面的其余内容。 这可能导致部分内容会被挡在应用栏后面使其无法可见。 下面有 3 种解决方案:

  1. 使用 position =“ sticky” 代替 fixed。 ⚠️ sticky 不支持 IE11。
  2. 可以渲染第二个 <Toolbar /> 组件:
function App() {
  return (
    <React.Fragment>
      <AppBar position="fixed">
        <Toolbar>{/* 内容 */}</Toolbar>
      </AppBar>
      <Toolbar />
    </React.Fragment>
  );
}
  1. 也可以用 theme.mixins.toolbar 的 CSS:
const Offset = styled('div')(({ theme }) => theme.mixins.toolbar);

function App() {
  return (
    <React.Fragment>
      <AppBar position="fixed">
        <Toolbar>{/* 内容 */}</Toolbar>
      </AppBar>
      <Offset />
    </React.Fragment>
  );
}

滚动

您可以使用 useScrollTrigger() 这个 hook 来响应用户触发的滚动操作。

隐藏应用栏

向下滚动会隐藏应用栏,这样一来会留有更多的空间进行阅读。

变高的应用栏

应用栏阴影会在滚动时加深,以表明用户还未到页面的顶部。

回到顶部

在滚动的时候,会出现一个浮动操作按钮,这样以便于返回页面的顶部。

useScrollTrigger([options]) => trigger

参数

  1. options (object [optional]):

    • options.disableHysteresis (bool [optional]):默认值是 false。 禁用迟滞的效果。 在决定 trigger 的值时会忽略在滚动的方向。
    • options.target (Node [optional]):默认值是 window
    • options.threshold (number [optional]):默认值是 100。 当垂直滚动恰好超过(但不包括)此阈值时,会改变 trigger 的值。

返回结果

trigger :滚动位置是否与目标值匹配?

例子

import useScrollTrigger from '@mui/material/useScrollTrigger';

function HideOnScroll(props) {
  const trigger = useScrollTrigger();
  return (
    <Slide in={!trigger}>
      <div>Hello</div>
    </Slide>
  );
}

在深色模式上启用颜色

根据 Material Design 规范color 属性在深色模式下对应用栏的外观没有影响。 您可以通过设置 enableColorOnDark 属性为 true 来覆盖此行为。

enableColorOnDark
default
<ThemeProvider theme={darkTheme}>
  <AppBar position="static" color="primary" enableColorOnDark>
    {appBarLabel('enableColorOnDark')}
  </AppBar>
  <AppBar position="static" color="primary">
    {appBarLabel('default')}
  </AppBar>
</ThemeProvider>