CSS Baseline
Material UI oferece um componente CSS Base a fim de inciar uma elegante, consistente e simples base para construção de aplicativos.
A paleta com funções de estilo.
Reset global
Você já deve estar familiarizado com normalize.css, uma coleção de elementos HTML e normas de atributos de estilo.
import * as React from 'react';
import CssBaseline from '@mui/material/CssBaseline';
export default function MyApp() {
return (
<React. Fragment>
<CssBaseline />
{/* O resto da sua aplicação */}
</React. Fragment>
);
}
Escopando componentes filhos
No entanto, você pode estar migrando progressivamente um site para Material UI, usar um reset global pode não ser uma opção. É possível aplicar a baseline apenas aos filhos usando o componente ScopedCssBaseline
.
import * as React from 'react';
import ScopedCssBaseline from '@material-ui/core/ScopedCssBaseline';
import MyApp from './MyApp';
export default function MyApp() {
return (
<ScopedCssBaseline>
{/* O resto da sua aplicação */}
<MyApp />
</ScopedCssBaseline>
);
}
⚠️ Certifique-se de importar ScopedCssBaseline
primeiro para evitar conflitos de box-sizing, como no exemplo acima.
Abordagem
Página
Os elementos <html>
e <body>
são atualizados para fornecer melhores padrões para toda a página. Mais especificamente:
- A margem é removida em todos navegadores.
- A cor de fundo padrão do material design é aplicada. Isto usando
theme.palette.background.default
para dispositivos padrão e um fundo branco para dispositivos de impressão. - If
enableColorScheme
is provided toCssBaseline
, native components color will be set by applyingcolor-scheme
on<html>
. The value used is provided by the theme propertytheme.palette.mode
.
Leiaute
box-sizing
é definido globalmente no elemento<html>
paraborder-box
. Todos elementos—incluindo*::before
e*::after
são declarados para herdar essa propriedade, que garante que a largura declarada do elemento nunca seja excedida devido ao preenchimento da borda.
Barras de rolagem
This API is deprecated, consider using color-scheme instead.
The colors of the scrollbars can be customized to improve the contrast (especially on Windows). Add this code to your theme (for dark mode).
import darkScrollbar from '@mui/material/darkScrollbar';
const theme = createTheme({
components: {
MuiCssBaseline: {
styleOverrides: {
body: theme.palette.mode === 'dark' ? darkScrollbar() : null,
},
},
},
});
Be aware, however, that using this utility (and customizing -webkit-scrollbar
) forces MacOS to always show the scrollbar.
Tipografia
This API is introduced in @mui/material (v5.1.0) for switching between "light"
and "dark"
modes of native components such as scrollbar, using the color-scheme
CSS property. To enable it, you can set enableColorScheme=true
as follows:
<CssBaseline enableColorScheme />
// or
<ScopedCssBaseline enableColorScheme >
{/* The rest of your application using color-scheme*/}
</ScopedCssBaseline>
Typography
- Nenhum tamanho de fonte base é declarado no
<html>
, mas 16px é assumido (o padrão do navegador). Você pode aprender mais sobre as implicações da mudança do padrão de tamanho da fonte do<html>
na página de documentação do tema. - Define o estilo
theme.typography.body1
no elemento<body>
. - Define o font-weight para
theme.typography.fontWeightBold
em elementos<b>
e<strong>
. - Uma customização da suavização da fonte (font-smoothing) é ativada para melhor exibição da fonte Roboto.
Customização
Vá até a seção de customização global da documentação para alterar o comportamento desses componentes.