Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Concevez des widgets Android adaptables qui s'adaptent de manière fluide. Utilisez nos tailles par défaut recommandées comme point de départ et testez vos mises en page sur différentes dimensions pour garantir une lisibilité et une expérience utilisateur optimales.
Tailles par défaut
Proposez une expérience de widget soignée en optimisant votre mise en page pour au moins une de nos tailles recommandées. Assurez-vous d'un emplacement et d'une visibilité corrects dans le sélecteur de widgets en définissant les attributs targetCellWidth et targetCellHeight pour les appareils portables et les tablettes.
Ces valeurs sont basées sur les appareils Pixel. Utilisez ces tailles comme point de départ pour la conception de votre widget. Testez minutieusement votre widget à différentes tailles et sur différents appareils pour garantir une expérience utilisateur de qualité.
Caméra à la main
Tailles
Largeur minimale
Largeur maximale
Hauteur minimale
Hauteur maximale
2x1
109
306
56
130
2x2
109
306
115
276
2x3
109
306
185
422
4x1
245
624
56
130
4x2
245
624
115
276
4x3
245
624
185
422
Tablette
Tailles
Largeur minimale
Largeur maximale
Hauteur minimale
Hauteur maximale
2x1
180
304
64
120
2x2
180
304
184
304
2x3
180
304
304
488
3x1
328
488
64
120
3x2
298
488
184
304
3x3
298
488
304
488
3x4
298
488
424
672
Points d'arrêt
Les points d'arrêt sont essentiels pour créer des widgets redimensionnables, adaptables et conviviaux. En testant votre conception, vous pouvez identifier les seuils de taille pour lesquels des ajustements de mise en page sont nécessaires. Implémentez des points d'arrêt pour déclencher ces modifications, en vous assurant que votre widget conserve son attrait visuel et sa fonctionnalité quelle que soit sa taille.
Les points d'arrêt offrent également la possibilité d'inclure ou d'exclure de manière conditionnelle du contenu supplémentaire, ce qui optimise l'utilisation de l'espace en fonction des dimensions du widget.
Figure 1:Utilisez des points d'arrêt pour modifier la mise en page à différentes tailles.
Remplir les limites
L'une des principales raisons pour lesquelles les utilisateurs suppriment des widgets est un mauvais alignement avec d'autres éléments de l'écran d'accueil. Pour éviter cela, assurez-vous que votre widget remplit toujours complètement l'espace de grille alloué.
check_circle
À faire
Assurez-vous que le conteneur s'étend de bord à bord à toutes les tailles.
cancel
À éviter
Ajoutez une marge intérieure personnalisée. Votre widget doit s'étendre de bord à bord.
check_circle
À faire
Pour une cohérence visuelle, assurez-vous que votre forme non rectangulaire touche la grille sur l'axe vertical ou horizontal.
cancel
À éviter
Utilisez des formes carrées fixes. Utilisez plutôt des conteneurs rectangulaires responsifs qui s'adaptent à différentes dimensions de grille.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/27 (UTC)."],[],[],null,["# Sizing\n\nDesign adaptable Android widgets that scale seamlessly. Use our recommended\ndefault sizes as a starting point, and test your layouts across different\ndimensions to ensure optimal readability and user experience.\n\nDefault sizes\n-------------\n\nDeliver a polished widget experience by optimizing your layout for at least one\nof our recommended sizes. Ensure correct placement and visibility in the widget\npicker by defining `targetCellWidth` and `targetCellHeight` attributes for both\nhandheld and tablet devices.\n\nThese values are based off Pixel devices. Use these sizes as a starting point\nfor your widget design. Thoroughly test your widget at different sizes and on\nvarious devices to ensure a quality user experience. \n\n### Handheld\n\n\n| Sizes | Min width | Max width | Min height | Max height |\n|-------|-----------|-----------|------------|------------|\n| 2x1 | 109 | 306 | 56 | 130 |\n| 2x2 | 109 | 306 | 115 | 276 |\n| 2x3 | 109 | 306 | 185 | 422 |\n| 4x1 | 245 | 624 | 56 | 130 |\n| 4x2 | 245 | 624 | 115 | 276 |\n| 4x3 | 245 | 624 | 185 | 422 |\n\n\u003cbr /\u003e\n\n### Tablet\n\n\n| Sizes | Min width | Max width | Min height | Max height |\n|-------|-----------|-----------|------------|------------|\n| 2x1 | 180 | 304 | 64 | 120 |\n| 2x2 | 180 | 304 | 184 | 304 |\n| 2x3 | 180 | 304 | 304 | 488 |\n| 3x1 | 328 | 488 | 64 | 120 |\n| 3x2 | 298 | 488 | 184 | 304 |\n| 3x3 | 298 | 488 | 304 | 488 |\n| 3x4 | 298 | 488 | 424 | 672 |\n\n\u003cbr /\u003e\n\n| **Note:** Widget dimensions in the table encompass all device orientations, including landscape mode on phones, to ensure optimal functionality in a variety of scenarios.\n\nBreakpoints\n-----------\n\nBreakpoints are essential for crafting adaptable, user-friendly resizable\nwidgets. By testing your design, you can pinpoint size thresholds where layout\nadjustments are necessary. Implement breakpoints to trigger these changes,\nensuring your widget maintains visual appeal and functionality at any size.\n\nBreakpoints also offer the flexibility to conditionally include or exclude\nsupplemental content, optimizing space utilization based on the widget's\ndimensions.\n**Figure 1:** Use breakpoints to make layout changes at different sizes.\n\nFill the bounds\n---------------\n\nOne of the primary reasons users remove widgets is due to misalignment with\nother home screen elements. To prevent this, ensure your widget always fills its\nallocated grid space completely. \ncheck_circle\n\n### Do\n\nMake sure the container stretches edge-to-edge at all sizes. \ncancel\n\n### Don't\n\nAdd custom padding. Your widget should go seamlessly edge-to-edge. \ncheck_circle\n\n### Do\n\nEnsure your non-rectangular shape touches the grid on either the vertical or horizontal axis for visual consistency. \ncancel\n\n### Don't\n\nUse fixed square shapes. Instead, use responsive rectangular containers that adapt to various grid dimensions."]]
