Gérer les images HTML en C#
Ajoutez, modifiez, supprimez, redimensionnez ou extrayez des images avec les API DOM et de ressources HTML.
API .NET de gestion des images HTML
Aspose.HTML for .NET
fournit des API DOM et de ressources pour traiter les images référencées par les documents HTML. Une application C# peut créer ou modifier un élément
HTMLImageElement
, rechercher des images à l’aide de sélecteurs CSS, les supprimer du DOM, résoudre les ressources référencées et enregistrer le HTML modifié.
Choisir une opération sur les images HTML
- Ajouter des images au HTML
. Créez un élément
<img>, définissez sa source, son texte alternatif, ses dimensions et ses attributs modernes facultatifs, puis insérez-le à l’emplacement requis dans le DOM. - Extraire des images du HTML . Recherchez les références d’images, résolvez les URL relatives par rapport à l’adresse de base du document et enregistrez les ressources locales, distantes ou incorporées prises en charge.
- Supprimer des images du HTML
. Supprimez les éléments
<img>sélectionnés du DOM en distinguant la suppression du balisage de celle des fichiers image physiques ou des arrière-plans CSS. - Redimensionner des images dans le HTML . Définissez les dimensions intrinsèques et le CSS adaptatif des images affichées sans rééchantillonner le fichier source référencé.
Modifier une image HTML existante en C#
Cet exemple charge un fichier HTML, sélectionne une image existante par son ID, modifie la ressource référencée et le texte alternatif, indique les dimensions intrinsèques, puis enregistre le document mis à jour. Le fichier image doit rester disponible au chemin affecté à Src.
Code C# pour modifier un élément image
using Aspose.Html;
// Load the source HTML file
using HTMLDocument document = new HTMLDocument("input.html");
// Select and update the existing image element
HTMLImageElement image = document.QuerySelector("#product-image") as HTMLImageElement;
if (image != null)
{
image.Src = "images/updated-product.webp";
image.Alt = "Updated product shown from the front";
image.SetAttribute("width", "960");
image.SetAttribute("height", "640");
}
// Save the modified HTML document
document.Save("output.html");
Étapes principales pour gérer les images HTML
- Chargez le fichier source, l’URL, la chaîne ou le flux avec un constructeur
HTMLDocumentet fournissez l’adresse de base correcte si des ressources relatives doivent être résolues. - Recherchez une image avec
QuerySelector()ou plusieurs correspondances avecQuerySelectorAll(). - Créez, modifiez, supprimez ou examinez les éléments image sélectionnés selon l’opération requise.
- Traitez séparément les ressources image référencées lorsque les fichiers doivent être copiés, téléchargés, incorporés, optimisés ou supprimés.
- Appelez
Save()pour enregistrer les modifications du balisage, ou poursuivez avec une conversion si le HTML doit être rendu au format PDF ou image.
Éléments, sources et ressources d'images HTML
- Attributs d’image. Lisez ou modifiez
src,alt,width,height,loading,decoding,srcset,sizeset les autres attributs pris en charge par le balisage cible. - Position dans le DOM. Ajoutez une image au corps du document ou à un conteneur sélectionné, déplacez-la vers un autre parent, remplacez-la ou supprimez-la de l’arborescence.
- Emplacement des ressources. Utilisez des chemins relatifs, des URL HTTP ou HTTPS absolues, des URL de fichiers et des URI de données incorporées en tenant compte de l’adresse de base du document.
- Sélection des éléments. Utilisez des ID, des classes, des sélecteurs d’attributs ou structurels, XPath ou la navigation dans le DOM pour cibler une image ou une collection.
- Dimensions affichées. Associez les valeurs intrinsèques
widthetheightau CSS pour une mise en page fixe ou adaptative. - Images hors éléments
img. Les arrière-plans CSS, le contenu SVG, les sources<picture>, les favicons et les boutons image utilisent d’autres éléments ou règles de style et nécessitent une logique de sélection distincte. - API de sortie. Transmettez le document préparé à une opération de conversion lorsque la page rendue complète doit être enregistrée au format PNG, JPEG, TIFF ou dans un autre format pris en charge.
Documentation et référence de l'API pour les images HTML
Consultez
How to Add Image to HTML
pour des exemples d’éléments <img>, de données incorporées et d’arrière-plans CSS. La section
Working with HTML Documents
explique le chargement, la modification, l’enregistrement et la gestion des ressources. La référence
HTMLImageElement
décrit les propriétés des images et les méthodes DOM héritées.
Installer Aspose.HTML for .NET
Installez Aspose.HTML for .NET depuis NuGet avec l’interface CLI .NET :
dotnet add package Aspose.HTML
Vous pouvez également utiliser l’interface du gestionnaire de packages NuGet ou exécuter Install-Package Aspose.HTML dans la console du gestionnaire de packages. Consultez le
guide d’installation
pour la configuration, ou demandez une
licence temporaire
afin d’évaluer l’API sans limitations.
FAQ sur la gestion des images HTML
1. Aspose.HTML modifie-t-il les pixels des fichiers PNG ou JPEG ?
Non. Les opérations de gestion des images modifient les éléments HTML, les attributs, les styles et les ressources référencées. Le rééchantillonnage, le recadrage, la compression et les modifications au niveau des pixels nécessitent une étape distincte de traitement d’image.
2. Comment les chemins relatifs des images sont-ils résolus lors du traitement du HTML ?
Les valeurs src relatives sont résolues par rapport à l’adresse de base du document, généralement déterminée par l’emplacement du fichier ou de l’URL chargé. Si le HTML provient d’une chaîne ou d’un flux, fournissez une URL de base afin de résoudre correctement les chemins relatifs.
3. Extraire des images du HTML revient-il à convertir du HTML en image ?
Non. L’extraction enregistre les ressources référencées par des éléments ou des styles, par exemple un fichier JPEG utilisé par un élément <img>. La
conversion de HTML en image
rend la mise en page complète dans une nouvelle image matricielle.
Découvrir d'autres fonctionnalités Aspose.HTML for .NET
Poursuivez avec la génération d'images, la modification du HTML, la conversion ou les tests d'accessibilité.