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 Toolkit do Microsoft Graph foi preterido. O período de reforma começa a 1 de setembro de 2025, com a reforma completa prevista para 28 de agosto de 2026. Os programadores devem migrar para utilizar os SDKs do Microsoft Graph ou outras ferramentas suportadas do Microsoft Graph para criar experiências Web. Para obter mais informações, veja o anúncio de preterição.
O componente de alternar tema permite que o utilizador defina ou altere o tema do documento de claro para escuro utilizando um botão de alternar.
Um utilizador pode utilizar o componente de alternar tema para definir o tema predefinido como light ou dark. Em seguida, o utilizador pode ativar/desativar estes modos com um botão de alternar.
Exemplo
O exemplo seguinte mostra como o botão de alternar do tema define o modo claro ou escuro com base na preferência do utilizador.
Propriedades
| Atributo | Propriedade | Descrição |
|---|---|---|
| modo | modo | Uma cadeia para definir o modo predefinido do botão de alternar do tema. O padrão é light. |
O exemplo seguinte mostra a predefinição do dark modo.
<mgt-theme-toggle mode="dark"></mgt-theme-toggle>
Variáveis CSS personalizadas
O componente de alternar tema não tem variáveis CSS personalizadas.
Eventos
| Evento | Quando é emitido | Dados personalizados | Cancelável | Bolhas | Funciona com um modelo personalizado |
|---|---|---|---|---|---|
darkmodechanged |
É acionado quando o modo escuro é acionado pela ação do utilizador. |
boolean valor.
true caso contrário, se estiver no modo escuro false |
Não | Não | Não |
Para obter mais informações sobre o processamento de eventos, veja eventos.
Modelos
O componente de alternar tema não tem modelos personalizados.
Permissões do Microsoft Graph
O componente de alternar tema não precisa de permissões do Microsoft Graph para funcionar.
Autenticação
O componente de alternar tema não precisa de autenticação para funcionar.
Cache
O componente de alternar tema não coloca os dados em cache.
Localização
O controlo expõe as seguintes variáveis que podem ser localizadas. Para obter detalhes sobre como configurar a localização, veja Localizar componentes.
| Nome da cadeia | Valor padrão |
|---|---|
| rótulo | Color mode: |
| on | Dark |
| desativado | Light |