Applications de style Xamarin.Forms à l’aide de feuilles de style en cascade (CSS)

Xamarin.Forms prend en charge le style d’éléments visuels à l’aide de feuilles de style en cascade (CSS).

Xamarin.Forms les applications peuvent être styleées à l’aide de CSS. Une feuille de style se compose d’une liste de règles, avec chaque règle composée d’un ou plusieurs sélecteurs et d’un bloc de déclaration. Un bloc de déclaration se compose d’une liste de déclarations dans les accolades, avec chaque déclaration composée d’une propriété, d’un signe deux-points et d’une valeur. Lorsqu’il existe plusieurs déclarations dans un bloc, un point-virgule est inséré en tant que séparateur. L’exemple de code suivant montre un Xamarin.Forms css conforme :

navigationpage {
    -xf-bar-background-color: lightgray;
}

^contentpage {
    background-color: lightgray;
}

#listView {
    background-color: lightgray;
}

stacklayout {
    margin: 20;
}

.mainPageTitle {
    font-style: bold;
    font-size: medium;
}

.mainPageSubtitle {
    margin-top: 15;
}

.detailPageTitle {
    font-style: bold;
    font-size: medium;
    text-align: center;
}

.detailPageSubtitle {
    text-align: center;
    font-style: italic;
}

listview image {
    height: 60;
    width: 60;
}

stacklayout>image {
    height: 200;
    width: 200;
}

Dans Xamarin.Forms, les feuilles de style CSS sont analysées et évaluées au moment de l’exécution, plutôt que le temps de compilation, et les feuilles de style sont réévaluées lors de l’utilisation.

L’exemple illustre l’utilisation de CSS pour mettre en forme une application simple et s’affiche dans les captures d’écran suivantes :

Utilisation d’une feuille de style

Le processus d’ajout d’une feuille de style à une solution est le suivant :

1. Ajoutez un fichier CSS vide à votre projet de bibliothèque .NET Standard.
2. Définissez l’action de génération du fichier CSS sur EmbeddedResource.

Chargement d’une feuille de style

Il existe plusieurs approches qui peuvent être utilisées pour charger une feuille de style.

XAML

Une feuille de style peut être chargée et analysée avec la StyleSheet classe avant d’être ajoutée à un ResourceDictionary:

<Application ...>
    <Application.Resources>
        <StyleSheet Source="/Assets/styles.css" />
    </Application.Resources>
</Application>

La StyleSheet.Source propriété spécifie la feuille de style en tant qu’URI par rapport à l’emplacement du fichier XAML englobant, ou par rapport à la racine du projet si l’URI commence par un /.

Vous pouvez également charger et analyser une feuille de style avec la StyleSheet classe, avant d’être ajoutée à un ResourceDictionary, en l’inlinant dans une CDATA section :

<ContentPage ...>
    <ContentPage.Resources>
        <StyleSheet>
            <![CDATA[
            ^contentpage {
                background-color: lightgray;
            }
            ]]>
        </StyleSheet>
    </ContentPage.Resources>
    ...
</ContentPage>

Pour plus d’informations sur les dictionnaires de ressources, consultez Dictionnaires de ressources.

C#

En C#, une feuille de style peut être chargée à partir d’un StringReader et ajoutée à un ResourceDictionary:

public partial class MyPage : ContentPage
{
    public MyPage()
    {
        InitializeComponent();

        using (var reader = new StringReader("^contentpage { background-color: lightgray; }"))
        {
            this.Resources.Add(StyleSheet.FromReader(reader));
        }
    }
}

L’argument de la StyleSheet.FromReader méthode est celui TextReader qui a lu la feuille de style.

Sélection d’éléments et application de propriétés

CSS utilise des sélecteurs pour déterminer les éléments à cibler. Les styles avec sélecteurs correspondants sont appliqués consécutivement, dans l’ordre de définition. Les styles définis sur un élément spécifique sont toujours appliqués en dernier. Pour plus d’informations sur les sélecteurs pris en charge, consultez Référence du sélecteur.

CSS utilise des propriétés pour styler un élément sélectionné. Chaque propriété a un ensemble de valeurs possibles et certaines propriétés peuvent affecter n’importe quel type d’élément, tandis que d’autres s’appliquent aux groupes d’éléments. Pour plus d’informations sur les propriétés prises en charge, consultez Informations de référence sur les propriétés.

Les feuilles de style enfants remplacent toujours les feuilles de style parentes si elles définissent les mêmes propriétés. Par conséquent, les règles de précédence suivantes sont suivies lors de l’application de styles qui définissent les mêmes propriétés :

• Un style défini dans les ressources d’application est remplacé par un style défini dans les ressources de page, s’ils définissent les mêmes propriétés.
• Un style défini dans les ressources de page est remplacé par un style défini dans les ressources de contrôle, s’ils définissent les mêmes propriétés.
• Un style défini dans les ressources d’application est remplacé par un style défini dans les ressources de contrôle, s’ils définissent les mêmes propriétés.

Sélection d’éléments par type

Les éléments de l’arborescence visuelle peuvent être sélectionnés par type avec le sélecteur ne respectant element pas la casse :

stacklayout {
    margin: 20;
}

Ce sélecteur identifie tous les StackLayout éléments sur les pages qui consomment la feuille de style et définit leurs marges sur une épaisseur uniforme de 20.

Sélection d’éléments par classe de base

Les éléments de l’arborescence visuelle peuvent être sélectionnés par classe de base avec le sélecteur ne respectant ^base pas la casse :

^contentpage {
    background-color: lightgray;
}

Ce sélecteur identifie tous les ContentPage éléments qui consomment la feuille de style et définit leur couleur lightgrayd’arrière-plan sur .

Sélection d’un élément par nom

Les éléments individuels de l’arborescence visuelle peuvent être sélectionnés avec le sélecteur sensible à #id la casse :

#listView {
    background-color: lightgray;
}

Ce sélecteur identifie l’élément dont StyleId la propriété est définie listViewsur . Toutefois, si la StyleId propriété n’est pas définie, le sélecteur revient à utiliser l’élément x:Name . Par conséquent, dans l’exemple XAML suivant, le #listView sélecteur identifie l’attribut dont x:Name l’attribut ListView est défini listViewsur , et définit sa couleur lightgrayd’arrière-plan sur .

<ContentPage ...>
    <ContentPage.Resources>
        <StyleSheet Source="/Assets/styles.css" />
    </ContentPage.Resources>
    <StackLayout>
        <ListView x:Name="listView" ...>
            ...
        </ListView>
    </StackLayout>
</ContentPage>

Sélection d’éléments avec un attribut de classe spécifique

Les éléments avec un attribut de classe spécifique peuvent être sélectionnés avec le sélecteur sensible à .class la casse :

.detailPageTitle {
    font-style: bold;
    font-size: medium;
    text-align: center;
}

.detailPageSubtitle {
    text-align: center;
    font-style: italic;
}

Une classe CSS peut être affectée à un élément XAML en définissant la StyleClass propriété de l’élément sur le nom de la classe CSS. Par conséquent, dans l’exemple XAML suivant, les styles définis par la .detailPageTitle classe sont attribués au premier Label, tandis que les styles définis par la .detailPageSubtitle classe sont affectés au deuxième Label.

<ContentPage ...>
    <ContentPage.Resources>
        <StyleSheet Source="/Assets/styles.css" />
    </ContentPage.Resources>
    <ScrollView>
        <StackLayout>
            <Label ... StyleClass="detailPageTitle" />
            <Label ... StyleClass="detailPageSubtitle"/>
            ...
        </StackLayout>
    </ScrollView>
</ContentPage>

Sélection d’éléments enfants

Les éléments enfants de l’arborescence visuelle peuvent être sélectionnés avec le sélecteur ne respectant element element pas la casse :

listview image {
    height: 60;
    width: 60;
}

Ce sélecteur identifie tous les Image éléments qui sont des enfants d’éléments ListView et définit leur hauteur et leur largeur sur 60. Par conséquent, dans l’exemple XAML suivant, le listview image sélecteur identifie l’enfant Image du ListViewfichier et définit sa hauteur et sa largeur sur 60.

<ContentPage ...>
    <ContentPage.Resources>
        <StyleSheet Source="/Assets/styles.css" />
    </ContentPage.Resources>
    <StackLayout>
        <ListView ...>
            <ListView.ItemTemplate>
                <DataTemplate>
                    <ViewCell>
                        <Grid>
                            ...
                            <Image ... />
                            ...
                        </Grid>
                    </ViewCell>
                </DataTemplate>
            </ListView.ItemTemplate>
        </ListView>
    </StackLayout>
</ContentPage>

Sélection d’éléments enfants directs

Les éléments enfants directs dans l’arborescence visuelle peuvent être sélectionnés avec le sélecteur ne respectant pas element>element la casse :

stacklayout>image {
    height: 200;
    width: 200;
}

Ce sélecteur identifie tous les Image éléments qui sont des enfants directs d’éléments StackLayout et définit leur hauteur et leur largeur sur 200. Par conséquent, dans l’exemple XAML suivant, le stacklayout>image sélecteur identifie l’enfant Image direct du StackLayoutcode et définit sa hauteur et sa largeur sur 200.

<ContentPage ...>
    <ContentPage.Resources>
        <StyleSheet Source="/Assets/styles.css" />
    </ContentPage.Resources>
    <ScrollView>
        <StackLayout>
            ...
            <Image ... />
            ...
        </StackLayout>
    </ScrollView>
</ContentPage>

Informations de référence sur le sélecteur

Les sélecteurs CSS suivants sont pris en charge par Xamarin.Forms:

Les styles avec sélecteurs correspondants sont appliqués consécutivement, dans l’ordre de définition. Les styles définis sur un élément spécifique sont toujours appliqués en dernier.

Les sélecteurs suivants ne sont actuellement pas pris en charge :

• [attribute]
• @media et @supports
• : et ::

Informations de référence sur les propriétés

Les propriétés CSS suivantes sont prises en charge Xamarin.Forms (dans la colonne Valeurs , les types sont italiques, tandis que les littéraux de chaîne sont ) gray:

Les propriétés suivantes ne sont actuellement pas prises en charge :

• all: initial.
• Propriétés de disposition (zone ou grille).
• Propriétés abrégées, telles que font, et border.

En outre, il n’existe aucune inherit valeur et l’héritage n’est donc pas pris en charge. Par conséquent, vous ne pouvez pas, par exemple, définir la font-size propriété sur une disposition et attendre que toutes les Label instances de la disposition héritent de la valeur. L’une des exceptions est la direction propriété, qui a une valeur par défaut .inherit

Les éléments de Span ciblage ont un problème connu empêchant la cible des styles CSS par élément et par nom (à l’aide du # symbole). L’élément Span dérive de GestureElement, qui n’a pas la propriété, de sorte que les étendues ne prennent pas en charge le StyleClass ciblage de classes CSS. Pour plus d’informations, consultez Impossible d’appliquer le style CSS au contrôle Span.

Xamarin.Forms propriétés spécifiques

Les propriétés CSS spécifiques suivantes Xamarin.Forms sont également prises en charge (dans la colonne Valeurs , les types sont italiques, tandis que les littéraux de chaîne sont gray) :

Xamarin.Forms Propriétés spécifiques de l’interpréteur de commandes

Les propriétés CSS spécifiques à l’interpréteur de commandes suivantes Xamarin.Forms sont également prises en charge (dans la colonne Valeurs , les types sont italiques, tandis que les littéraux de chaîne sont gray) :

Couleur

Les valeurs suivantes color sont prises en charge :

• X11couleurs, qui correspondent aux couleurs CSS, aux couleurs prédéfinies UWP et Xamarin.Forms aux couleurs. Notez que ces valeurs de couleur ne respectent pas la casse.
• couleurs hexadécimal : #rgb, #argb, #rrggbb, #aarrggbb
• couleurs rvb : rgb(255,0,0), rgb(100%,0%,0%). Les valeurs sont comprises entre 0 et 255, ou 0 %-100 %.
• couleurs rgba : rgba(255, 0, 0, 0.8), rgba(100%, 0%, 0%, 0.8). La valeur d’opacité se trouve dans la plage 0.0-1.0.
• couleurs hsl : hsl(120, 100%, 50%). La valeur h se trouve dans la plage 0-360, tandis que s et l se trouvent dans la plage 0%-100%.
• couleurs hsla : hsla(120, 100%, 50%, .8). La valeur d’opacité se trouve dans la plage 0.0-1.0.

Thickness

Une, deux, trois ou quatre thickness valeurs sont prises en charge, chacune séparée par un espace blanc :

• Une valeur unique indique une épaisseur uniforme.
• Deux valeurs indiquent une épaisseur verticale puis horizontale.
• Trois valeurs indiquent le haut, puis horizontal (gauche et droite), puis l’épaisseur inférieure.
• Quatre valeurs indiquent le haut, puis la droite, puis l’épaisseur inférieure, puis l’épaisseur gauche.

NamedSize

Les valeurs non sensibles à namedsize la casse suivantes sont prises en charge :

• default
• micro
• small
• medium
• large

La signification exacte de chaque valeur est dépendante de la namedsize plateforme et dépendante de la vue.

Functions

Les dégradés linéaires et radials peuvent être spécifiés à l’aide des linear-gradient()radial-gradient() fonctions CSS, respectivement. Le résultat de ces fonctions doit être affecté à la background propriété d’un contrôle.

CSS dans Xamarin.Forms Xamarin.University

Xamarin.Forms Vidéo CSS 3.0

Liens associés

• Dictionnaires de ressources
• Styles Xamarin.Forms d’applications à l’aide de styles XAML