Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Cuidado
O Microsoft Graph Toolkit foi preterido. O período de aposentadoria começa em 1º de setembro de 2025, com aposentadoria total planejada para 28 de agosto de 2026. Os desenvolvedores devem migrar para o uso dos SDKs do Microsoft Graph ou outras ferramentas do Microsoft Graph com suporte para criar experiências na Web. Para obter mais informações, consulte o anúncio de substituição.
O componente de alternância de tema permite que o usuário defina ou altere o tema do documento de claro para escuro usando um botão de alternância.
Um usuário pode usar o componente de alternância de tema para definir o tema padrão para light ou dark. Em seguida, o usuário pode alternar esses modos usando uma chave de alternância.
Exemplo
O exemplo a seguir mostra como o botão de alternância de tema define o modo claro ou escuro com base na preferência do usuário.
Propriedades
| Atributo | Propriedade | Descrição |
|---|---|---|
| modo | modo | Uma cadeia de caracteres para definir o modo padrão do tema. O padrão é light. |
O exemplo a seguir mostra a configuração do dark modo como padrão.
<mgt-theme-toggle mode="dark"></mgt-theme-toggle>
Variáveis CSS personalizadas
O componente de alternância de tema não possui variáveis CSS personalizadas.
Eventos
| Evento | Quando é emitido | Dados personalizados | Cancelável | Bolhas | Funciona com modelo personalizado |
|---|---|---|---|---|---|
darkmodechanged |
Acionado quando o modo escuro é acionado pela ação do usuário. |
boolean respectivo valor.
true Caso contrário, se estiver no Modo Escuro false |
Não | Não | Não |
Para obter mais informações sobre como lidar com eventos, consulte eventos.
Modelos
O componente de alternância de tema não tem modelos personalizados.
Permissões do Microsoft Graph
O componente de alternância de tema não precisa de nenhuma permissão do Microsoft Graph para funcionar.
Autenticação
O componente de alternância de tema não precisa de autenticação para funcionar.
Cache
O componente de alternância de tema não armazena dados em cache.
Localização
O controle expõe as variáveis a seguir que podem ser localizadas. Para obter detalhes sobre como configurar a localização, consulte Localizando componentes.
| Nome da cadeia de caracteres | Valor padrão |
|---|---|
| rótulo | Color mode: |
| on | Dark |
| desativado | Light |