WebView2 dans les applications WinUI 2 (UWP)
Les considérations suivantes s’appliquent à WebView2 dans les applications WinUI 2 (UWP). Le contrôle WebView2 WinUI 2 (UWP) est en cours de développement.
Interface utilisateur de remplissage automatique
L’interface utilisateur de remplissage automatique n’est pas encore implémentée pour WebView2 pour les applications UWP.
Voir aussi :
- Remplissage automatique dans Vue d’ensemble des API WebView2.
Imprimer au format PDF
L’impression au format PDF nécessite que l’application ait accès à un emplacement accessible en écriture dans UWP, tel qu’un dossier local. Pour obtenir la liste complète des chemins d’accès UWP, consultez Autorisations d’accès aux fichiers.
Voir aussi :
- Impression dans Vue d’ensemble des API WebView2.
Impression par défaut
L’impression par défaut est désactivée pour WebView2 pour les applications UWP. Toutefois, vous pouvez capturer et imprimer la fenêtre d’affichage actuelle en appelant CapturePreview
.
Voir aussi :
- Capture d’image dans Vue d’ensemble des API WebView2.
SmartScreen
WebView2 envoie les URL auxquelles vous accédez dans votre application au service SmartScreen pour garantir la sécurité de vos clients. Si vous souhaitez désactiver cette navigation, vous pouvez le faire via une variable d’environnement :
Environment.SetEnvironmentVariable("WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS", "--disable-features=msSmartScreenProtection");
Cette variable d’environnement doit être définie avant CoreWebView2
la création, ce qui se produit lorsque la propriété WebView2.Source est initialement définie ou que la méthode WebView2.EnsureCoreWebView2Async est initialement appelée.
Téléchargement de fichiers
Il existe quelques limitations connues pour le comportement actuel des téléchargements pour WebView2 dans UWP.
Enregistrer sous
L’enregistrement de fichiers via Enregistrer sous fonctionne et est activé pour WebView2 pour les applications UWP. Les fichiers seront enregistrés dans le dossier sélectionné par l’utilisateur.
Dossier dans lequel les fichiers sont téléchargés
Si l’hôte ne modifie pas le ResultFilePath
du fichier téléchargé, les fichiers téléchargés sont téléchargés dans un sous-dossier avec le nom du package d’application dans le Downloads
dossier.
Si l’hôte modifie le ResultFilePath
du fichier téléchargé, le fichier est téléchargé uniquement si l’application a accès à ce chemin d’accès par défaut. Si vous souhaitez utiliser un emplacement de fichier auquel l’application n’a pas accès par défaut, vous devez définir la fonctionnalité correspondante. Consultez Déclarations des fonctionnalités d’application dans la documentation UWP.
Hub téléchargements
L’ouverture de fichiers et de dossiers à partir du hub téléchargements est désactivée. Le fait de cliquer sur l’icône de fichier ou de dossier n’ouvre pas le fichier/dossier respectif.
Voir aussi :
- Téléchargements dans Vue d’ensemble des API WebView2.
Limitation XAML
La prise en charge de XAML Island nécessite un travail supplémentaire et peut être envisagée pour les versions ultérieures.
Définition de DefaultBackgroundColor
Sur WinUI 2, la DefaultBackgroundColor
propriété n’est pas exposée directement. Vous pouvez définir la couleur d’arrière-plan par défaut en définissant une variable d’environnement, comme suit :
Environment.SetEnvironmentVariable("WEBVIEW2_DEFAULT_BACKGROUND_COLOR", "FF000000");
Voir aussi :
- .NET : WebView2.DefaultBackgroundColor, propriété
- Win32 : Propriété ICoreWebView2Controller2 ::D efaultBackgroundColor (get, put)
Définition de la transparence
Sur WinUI 2, la transparence est obtenue en définissant la couleur sur 00FFFFFF
.
Curseurs CSS
Sur WinUI 2 (UWP), les curseurs CSS présentent les limitations suivantes.
URL d’image
Le curseur CSS ne peut pas être une URL d’image, telle que cursor: url(https://contoso.com/cursor.png), pointer;
. Consultez CSS : le curseur chargé à partir de l’URL ne fonctionne pas.
Curseurs CSS prédéfinis
Sur WinUI 2 (UWP), certains curseurs CSS prédéfinis ne sont pas pris en charge. Vous pouvez utiliser des curseurs CSS pour remplacer le curseur par certains des curseurs prédéfinis, tels que cursor: wait;
ou cursor: crosshair;
, mais pas par d’autres, tels que cursor: progress
ou cursor: none
.
Mot clé | Pris en charge ? |
---|---|
Général | |
auto | ✔️ |
Valeur par défaut. | ✔️ |
none | ❌ |
Liens & status | |
menu contextuel | ✔️ |
Aide | ✔️ |
pointeur | ✔️ |
progress | ❌ |
attendre | ✔️ |
Selection | |
cellule | ❌ |
Croix | ✔️ |
text | ✔️ |
texte vertical | ❌ |
Faire glisser & déplacer | |
alias | ❌ |
copier | ❌ |
move | ✔️ |
no-drop | ✔️ |
non autorisé | ✔️ |
saisir | ❌ |
accaparement | ❌ |
Redimensionnement & défilement | |
tous les défilements | ✔️ |
redimensionnement de col | ❌ |
redimensionnement de ligne | ❌ |
n-resize | ✔️ |
Redimensionnement électronique | ✔️ |
redimensionnement s | ✔️ |
w-resize | ✔️ |
ne-resize | ✔️ |
nw-resize | ✔️ |
se-resize | ✔️ |
sw-resize | ✔️ |
ew-resize | ✔️ |
ns-resize | ✔️ |
nesw-resize | ✔️ |
nwse-resize | ✔️ |
Zoom | |
zoom avant | ❌ |
zoom arrière | ❌ |
Voir aussi :
- Curseurs CSS : la section Valeurs décrit les valeurs mot clé ci-dessus.
Outils de développement Microsoft Edge
Sur WinUI 2, Microsoft Edge DevTools ne peut pas être lancé dans une application WebView2 WinUI 2 (UWP) signée par le Store. Toutefois, vous pouvez contourner ce problème à l’aide du débogage à distance. Consultez Débogage à distance des applications WebView2 WinUI 2 (UWP).
Limitations de l’API
Les classes suivantes ne sont pas accessibles dans WinUI 2 :
CoreWebView2EnvironmentOptions
CoreWebView2ControllerOptions
Voir aussi
- Remplissage automatique dans Vue d’ensemble des API WebView2.
- Impression dans Vue d’ensemble des API WebView2.
- Capture d’image dans Vue d’ensemble des API WebView2.
- Téléchargements dans Vue d’ensemble des API WebView2.
- Débogage à distance des applications WebView2 WinUI 2 (UWP)
Informations de référence sur l’API :
- .NET : WebView2.DefaultBackgroundColor, propriété
- Win32 : ICoreWebView2Controller2 ::_getDefaultBackgroundColor
- Win32 : ICoreWebView2Controller2 ::_putDefaultBackgroundColor
Documentation Windows :
- SmartScreen
- Propriété WebView2.Source
- Méthode WebView2.EnsureCoreWebView2Async
- Déclarations de fonctionnalité d’application
MDN :
- Valeurs dans la propriété CSS du curseur sur MDN.
Référentiel WebView2Feedback :