Orientação gerada a partir de informações públicas. Apenas para referência.
Um plugin Flutter para macOS que fornece acesso às cores internas dos elementos da interface do usuário do AppKit, permitindo uma aparência nativa consistente em aplicativos Flutter no macOS. Ele mapeia constantes de cor do sistema do framework AppKit da Apple, como fundo da janela, tom de controle e cores de texto, garantindo alinhamento com as diretrizes de design do macOS. Este pacote simplifica a personalização de temas ao oferecer acesso direto aos valores de cor específicos da plataforma sem configuração manual.
Casos de uso
Aestética do sistema UI do macOS correspondente
Criando aplicativos nativos com Flutter no macOS
Simplificando a implementação de temas para macOS
Garantir a consistência com os esquemas de cores do sistema
Desenvolvendo aplicativos multiplataforma com estilos específicos do macOS
Principais recursos
Acesso às cores nativas dos elementos da interface do AppKit
Integração contínua com aplicativos macOS Flutter
Sincronização automática com temas do sistema
Configuração mínima necessária
Suporta atualizações dinâmicas de cor
Indicado para
Desenvolvedores Flutter voltados para macOS
Aplicativos que exigem consistência visual nativa do macOS
Designers se concentraram na fidelidade da interface do usuário específica da plataforma
Projetos usando tematização específica do macOS
Considerações
Limitado à plataforma macOS apenas
Depende da disponibilidade do AppKit subjacente
Pode exigir manipulação adicional para transições de modo escuro
Não aplicável a plataformas não macOS
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
appkit_ui_element_colors
A Flutter plugin that exposes AppKit’s “UI Element Colors” to facilitate the
retrieval of standard color objects for use with windows, controls, labels, text,
selections and other content in your app.
Each color can be retrieved as a Color object using the AppkitUiElementColors.getColor method:
final darkWindowBackgroundColor = awaitAppkitUiElementColors.getColor(
uiElementColor: UiElementColor.windowBackgroundColor,
appearance: NSAppearanceName.darkAqua,
);
Alternatively, it can also be converted to any available NSColorSpace and retrieved as a map of requested NSColorComponents using AppkitUiElementColors.getColorComponents:
Certain events, such as the user changing their preferred accent color, can trigger system color changes. Such changes can be observed using the SystemColorObserver class. The AppkitUiElementColors class provides a global shared instance of SystemColorObserver that can be accessed as follows:
By default, UiElementColorBuilder uses a
SharedUiElementColorContainerInstanceProvider to provide a global
shared instance of UiElementColorContainer.
SharedUiElementColorContainerInstanceProvider uses an instance of
MediaQueryData derived from the current BuildContext and assumes it to
be the same across all UiElementBuilders which use it.
If your app contains surfaces with different MediaQueryData overrides,
use OwnedUiElementColorContainerInstanceProvider instead:
// A dark cupertino theme.CupertinoTheme(
data: constCupertinoThemeData(
brightness: Brightness.dark,
),
// Override the MediaQueryData so that platformBrightness is dark.
child: MediaQuery(
data: MediaQuery.of(context).copyWith(
platformBrightness: Brightness.dark,
),
child: UiElementColorBuilder(
// Since there may be surfaces within the app that do not override the// brightness, use an OwnedUiElementColorContainerInstanceProvider.
uiElementColorContainerInstanceProvider:
OwnedUiElementColorContainerInstanceProvider(),
builder: (context, colorContainer) => Container(
color: colorContainer.windowBackgroundColor,
),
),
),
);
Incorrect usage of SharedUiElementColorContainerInstanceProvider throws the following assertion error:
“Found conflicting MediaQueryData in SharedUiElementColorContainerInstanceProvider. If you are using UiElementColorBuilder within widget subtrees with differing MediaQueryData (such as different theme brightness or accessibility settings), please use OwnedUiElementColorContainerInstanceProvider instead.”