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 completos.
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 básicos do .NET 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 do 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:Staticapoiado porStaticExtensionx:Referenceapoiado porReferenceExtensionx:Typeapoiado porTypeExtensionx:Nullapoiado porNullExtensionx:Arrayapoiado porArrayExtension
Essas quatro extensões de marcação XAML têm suporte em muitas implementações de XAML, incluindo Xamarin.Forms:
StaticResourceapoiado porStaticResourceExtensionDynamicResourceapoiado porDynamicResourceExtensionBindingapoiado porBindingExtension—discutido no Capítulo 16. Vinculação de dadosTemplateBindingapoiado porTemplateBindingExtension— não abordado no livro
Uma extensão de marcação XAML adicional está incluída 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 como 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 o nome do membro entre 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 nesse 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 ResourceSharing . Você pode usar um StaticResourceExtension elemento ou StaticResource dentro de chaves:
Não confunda a extensão de x:Static marcação e a extensão de StaticResource marcação.
Uma árvore de dicionários
Quando o analisador XAML encontra um StaticResource, ele começa a pesquisar na árvore visual uma chave correspondente e, em seguida, procura na ResourceDictionary classe do App aplicativo. Isso permite que os itens em um dicionário de recursos mais profundo 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 para StaticResource é DynamicResource, que mantém um link para a chave do 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 extensão de x:Null marcação para definir uma propriedade como null.
Use a extensão de x:Type marcação para definir uma propriedade como um objeto .NET Type .
Use x:Array para definir uma matriz. Especifique o tipo dos 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 satisfaz esses requisitos. Ele cria um valor de tipo Color com base em valores de propriedades chamadas H, S, Le 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 referenciar essa biblioteca e usar a extensão de marcação personalizada.