Resumo do Capítulo 10. Extensões de marcação XAML
Observação
Este livro foi publicado na primavera de 2016, e não foi atualizado desde então. Há muito no livro que permanece valioso, mas parte do material está desatualizado, e alguns tópicos não estão mais totalmente corretos ou concluídos.
Normalmente, o analisador XAML converte qualquer conjunto de cadeias de caracteres como um valor de atributo para o tipo da propriedade com base em conversões padrão para os tipos de dados .NET básicos ou um TypeConverter
derivado anexado à propriedade ou seu tipo com um TypeConverterAttribute
.
Mas, às vezes, é conveniente definir um atributo de uma fonte diferente, por exemplo, um item em um dicionário ou o valor de uma propriedade ou campo estático ou de um cálculo de algum tipo.
Esse é o trabalho de uma extensão de marcação XAML. Apesar do nome, as extensões de marcação XAML não são uma extensão para XML. XAML é sempre XML legal.
A infraestrutura de código
Uma extensão de marcação XAML é uma classe que implementa a IMarkupExtension
interface . Essa classe geralmente tem a palavra Extension
no final de seu nome, mas geralmente aparece em XAML sem esse sufixo.
As seguintes extensões de marcação XAML têm suporte em todas as implementações de XAML:
x:Static
com suporte porStaticExtension
x:Reference
com suporte porReferenceExtension
x:Type
com suporte porTypeExtension
x:Null
com suporte porNullExtension
x:Array
com suporte porArrayExtension
Essas quatro extensões de marcação XAML têm suporte em muitas implementações de XAML, incluindo Xamarin.Forms:
StaticResource
com suporte porStaticResourceExtension
DynamicResource
com suporte porDynamicResourceExtension
Binding
com suporte deBindingExtension
— discutido no Capítulo 16. Associação de dadosTemplateBinding
com suporte porTemplateBindingExtension
— não abordado no livro
Uma extensão de marcação XAML adicional está incluída em em Xamarin.Forms conexão com RelativeLayout
:
ConstraintExpression
— não abordado no livro
Acessando membros estáticos
Use o x:Static
elemento para definir um atributo para o valor de uma propriedade estática pública, campo ou membro de enumeração. Defina a Member
propriedade como o membro estático. Geralmente é mais fácil especificar x:Static
e o nome do membro em chaves. O nome da Member
propriedade não precisa ser incluído, apenas o próprio membro. Essa sintaxe comum é mostrada no exemplo SharedStatics . Os próprios campos estáticos são definidos na AppConstants
classe . Essa técnica permite estabelecer constantes usadas por meio de um programa.
Com uma declaração de namespace XML adicional, você pode fazer referência a propriedades estáticas públicas, campos ou membros de enumeração definidos no .NET Framework, conforme demonstrado no exemplo SystemStatics .
Dicionários de recurso
A VisualElement
classe define uma propriedade chamada Resources
que você pode definir como um objeto do tipo ResourceDictionary
. No XAML, você pode armazenar itens neste dicionário e identificá-los com o x:Key
atributo . Os itens armazenados no dicionário de recursos são compartilhados entre todas as referências ao item.
StaticResource para a maioria das finalidades
Na maioria dos casos, você usará a StaticResource
extensão de marcação para fazer referência a um item do dicionário de recursos, conforme demonstrado pelo exemplo de ResourceSharing . Você pode usar um StaticResourceExtension
elemento ou StaticResource
em chaves:
Não confunda a x:Static
extensão de marcação e a StaticResource
extensão de marcação.
Uma árvore de dicionários
Quando o analisador XAML encontra um StaticResource
, ele começa a pesquisar uma chave correspondente na árvore visual e, em seguida, procura na ResourceDictionary
classe do App
aplicativo. Isso permite que os itens em um dicionário de recursos mais profundos na árvore visual substituam um dicionário de recursos mais alto na árvore visual. Isso é demonstrado no exemplo ResourceTrees .
DynamicResource para fins especiais
A StaticResource
extensão de marcação faz com que um item seja recuperado do dicionário quando uma árvore visual é criada durante a InitializeComponent
chamada. Uma alternativa a StaticResource
é DynamicResource
, que mantém um link para a chave de dicionário e atualiza o destino quando o item referenciado pela chave é alterado.
A diferença entre StaticResource
e DynamicResource
é demonstrada no exemplo DynamicVsStatic .
Uma propriedade definida por DynamicResource
deve ser apoiada por uma propriedade associável, conforme discutido no Capítulo 11, a infraestrutura associável.
Extensões de marcação menos usadas
Use a x:Null
extensão de marcação para definir uma propriedade como null
.
Use a x:Type
extensão de marcação para definir uma propriedade como um objeto .NET Type
.
Use x:Array
para definir uma matriz. Especifique o tipo de membros da matriz definindo a propriedade [Type
] como uma x:Type
extensão de marcação.
Uma extensão de marcação personalizada
Você pode criar suas próprias extensões de marcação XAML escrevendo uma classe que implementa a IMarkupExtension
interface com um ProvideValue
método .
A HslColorExtension
classe atende a esses requisitos. Ele cria um valor do tipo Color
com base nos valores das propriedades denominadas H
, S
, L
e A
. Essa classe é o primeiro item em uma Xamarin.Forms biblioteca chamada Xamarin.FormsBook.Toolkit que é criada e usada ao longo deste livro.
O exemplo CustomExtensionDemo demonstra como fazer referência a essa biblioteca e usar a extensão de marcação personalizada.