Pular para o conteúdo

App bar

The App bar displays information and actions relating to the current screen.

The top App bar provides content and actions related to the current screen. Ela é utilizada para a identidade visual, títulos de tela, navegação e ações.

Ela pode se transformar em uma barra de ações contextual ou ser utilizada como uma barra de navegação.

Barra de Aplicativos Simples

News

Barra de aplicativos com menu

Photos

App bar with responsive menu

LOGO
LOGO

App bar with search field

Uma barra de pesquisa lateral

MUI

Responsive App bar with Drawer

App bar with a primary search field

A primary searchbar.

MUI

Dense (desktop only)

Photos
Press Enter to start editing

Prominent

A prominent app bar.

MUI

Bottom App bar

Fixed placement

When you render the app bar position fixed, the dimension of the element doesn't impact the rest of the page. This can cause some part of your content to be invisible, behind the app bar. Here are 3 possible solutions:

  1. Você pode usar position="sticky" ao invés de fixed. ⚠️ sticky não é suportado pelo IE11.
  2. Você pode renderizar um segundo componente <Toolbar />:
function App() {
  return (
    <React.Fragment>
      <AppBar position="fixed">
        <Toolbar>{/* content */}</Toolbar>
      </AppBar>
      <Toolbar />
    </React.Fragment>
  );
}
  1. Você pode usar o CSS theme.mixins.toolbar:
const Offset = styled('div')(({ theme }) => theme.mixins.toolbar);

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

Scrolling

You can use the useScrollTrigger() hook to respond to user scroll actions.

Hide App bar

The app bar hides on scroll down to leave more space for reading.

Elevate App bar

The app bar elevates on scroll to communicate that the user is not at the top of the page.

Voltar ao topo

A floating action buttons appears on scroll to make it easy to get back to the top of the page.

useScrollTrigger([options]) => trigger

Argumentos

  1. options (object [opcional]):

    • options.disableHysteresis (bool [opcional]): Padrão false. Desabilita a histerese. Ignora a direção de rolagem ao determinar o valor de trigger.
    • options.target (Node [opcional]): Padrão window.
    • options.threshold (number [opcional]): Padrão 100. Modifica o valor limite que aciona a trigger quando a barra de rolagem vertical cruzar ou chegar a este limite.

Retornos

trigger: Does the scroll position match the criteria?

Exemplos

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

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

Enable color on dark

Following the Material Design guidelines, the color prop has no effect on the appearance of the app bar in dark mode. You can override this behavior by setting the enableColorOnDark prop to true.

enableColorOnDark
default
Press Enter to start editing

API

See the documentation below for a complete reference to all of the props and classes available to the components mentioned here.