Modèles et composants

Sous Android 8.0, le menu "Paramètres" comporte plusieurs composants et widgets couvrant les utilisations courantes. Les fabricants d'appareils et les développeurs sont encouragés à utiliser les composants communs lors de l'extension de l'application Paramètres afin que les nouvelles interfaces utilisateur restent cohérentes avec l'UI Paramètres existante.

Voici un résumé des améliorations:

• Modification du comportement des séparateurs dans le framework de préférences de la bibliothèque d'assistance. Un séparateur est désormais ajouté entre les catégories.
• Changement de thème de l'ActionBar. L'ActionBar utilise désormais un thème de couleur claire, avec un texte de couleur d'accentuation.
• Nouvelle mise en page des préférences L'espace réservé aux icônes reste inchangé, même si une préférence n'a pas d'icône.

Nouveaux widgets:

• Widget d'en-tête pour les informations sur l'application. Affiche l'icône de l'application, son libellé et d'autres informations.
• Bouton "Développer" sur certaines pages. La page peut commencer sous forme réduite et masquer les éléments moins importants jusqu'à ce que l'utilisateur clique sur le bouton d'expansion.
• Interface utilisateur du sélecteur d'applications par défaut :
  • UI permettant de choisir le navigateur par défaut, l'application de téléphone par défaut, etc.
  • Auparavant, il s'agissait d'une boîte de dialogue, mais il s'agit désormais d'une interface utilisateur basée sur des boutons radio en plein écran.
• Préférence de style "MasterSwitch". Il s'agit d'une préférence avec deux cibles de clic. La cible de gauche mène à un fragment ou à un intent de sous-ensemble. La cible de droite est un bouton d'activation/de désactivation qui contrôle l'activation/la désactivation de l'ensemble de la page.

Exemples et source

• Comportement du séparateur
  • Toutes les pages des paramètres sont modifiées pour utiliser le nouveau comportement du séparateur.
  • Le comportement du séparateur est défini comme un ThemeOverlay dans:
    packages/apps/Settings/res/values/styles_preference.xml
• Modification du thème de l'ActionBar
  • Toutes les pages de "Paramètres" sont modifiées pour utiliser le nouveau thème ActionBar.
  • Le thème est défini dans Theme.DeviceDefault.Settings.
• Nouvelle mise en page des préférences
  • De nombreuses pages des paramètres utilisent désormais la nouvelle mise en page des préférences.
  • Vous trouverez le code dans:
    packages/apps/Settings/res/values/styles_preference.xml
• Widget d'en-tête de l'application
  • La plupart des pages d'informations sur les applications dans les paramètres implémentent déjà le nouvel en-tête d'application.
  • Vous trouverez des exemples et du code sur les pages suivantes:
    packages/apps/Settings/src/com/android/settings/applications/AppHeaderController.java
• Bouton "Développer"
  • Vous trouverez des exemples et du code sur les pages suivantes:
    packages/apps/Settings/src/com/android/settings/dashboard/ProgressiveDisclosureMixin.java

    Remarque:Ce composant doit être utilisé avec DashboardFragment. (Pour en savoir plus sur DashboardFragment, consultez la section Nouvelle architecture de l'information.)

• Sélecteur d'application par défaut
  • Vous trouverez le code de la classe de base dans:
    packages/apps/Settings/src/com/android/settings/applications/defaultapps/DefaultAppPickerFragment.java
  • Il existe plusieurs sous-classes de DefaultAppPickerFragment, chacune implémentant un sélecteur pour un intent différent.
• Préférence de style MasterSwitch
  • Le code se trouve à l'adresse : https://cs.android.com/android/platform/superproject/main/+/main:packages/apps/Settings/src/com/android/settings/wifi/WifiPrimarySwitchPreferenceController.java
  • Un exemple de cas d'utilisation est le commutateur principal Wi-Fi. Vous trouverez un exemple à l'adresse : packages/apps/Settings/src/com/android/settings/wifi/WifiMasterSwitchPreferenceController.java

Implémentation

Les fabricants d'appareils peuvent commencer à utiliser tous les nouveaux composants dès la sortie de la boîte. Si les OEM décident d'implémenter une nouvelle préférence de style "MasterSwitch" ou un sélecteur d'application par défaut, ils doivent suivre les exemples de ce document et les fichiers de référence (Javadoc) écrits avec chaque composant pour en savoir plus.

Personnaliser le menu des paramètres

• Comportement du séparateur. Pour modifier la façon dont le séparateur est dessiné, modifiez le style des séparateurs de paramètres et modifiez la valeur des éléments suivants :
  • allowDividerAbove
  • allowDividerBelow
  • allowDividerAfterLastItem
• Couleur du thème de l'ActionBar. Les activités doivent utiliser Theme.DeviceDefault.Settings comme thème ou créer un thème personnalisé avec Theme.DeviceDefault.Settings comme parent.
• Widget d'en-tête de l'application. Utilisez des sétteurs dans AppHeaderController pour personnaliser chaque champ et appeler build() une fois tous les champs définis.
• Bouton "Développer" :
  • Pour désactiver complètement la fonctionnalité, remplacez le constructeur de ProgressiveDisclosureMixin et définissez keepExpanded sur "true".
  • Pour personnaliser le nombre d'éléments à afficher initialement, appelez la méthode ProgressiveDisclosureMixin.setTileLimit() lors de la méthode onAttach(Context) du fragment.