Управление изображениями в HTML на C#
Добавляйте, обновляйте, удаляйте, изменяйте размер и извлекайте изображения через HTML DOM и API ресурсов.
API управления изображениями HTML для .NET
Aspose.HTML for .NET
предоставляет DOM API и API ресурсов для работы с изображениями, на которые ссылаются HTML-документы. Приложение C# может создать или обновить
HTMLImageElement
, найти элементы изображений с помощью CSS-селекторов, удалить их из DOM, разрешить ссылки на ресурсы и сохранить изменённый HTML.
Выбор сценария работы с изображениями HTML
- Добавление изображений в HTML
. Создайте элемент
<img>, задайте источник, альтернативный текст, размеры и дополнительные современные атрибуты, затем вставьте его в нужное место DOM. - Извлечение изображений из HTML . Найдите ссылки на изображения, преобразуйте относительные URL с учётом базового адреса документа и сохраните поддерживаемые локальные, удалённые или встроенные ресурсы.
- Удаление изображений из HTML
. Удалите выбранные элементы
<img>из DOM и учитывайте различие между удалением разметки, физических файлов и фоновых изображений CSS. - Изменение размера изображений в HTML . Задайте исходные размеры и адаптивные CSS-правила для отображаемых изображений без изменения пикселей связанного файла.
Обновление существующего изображения HTML на C#
Пример загружает HTML-файл, выбирает существующее изображение по ID, изменяет связанный ресурс и альтернативный текст, задаёт исходные размеры и сохраняет обновлённый документ. Файл изображения должен оставаться доступным по пути, указанному в свойстве Src.
Код C# для обновления элемента изображения
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");
Основные шаги управления изображениями в HTML
- Загрузите исходный файл, URL, строку или поток с помощью конструктора
HTMLDocumentи укажите правильный базовый адрес, если необходимо разрешать относительные ссылки на ресурсы. - Найдите одно изображение методом
QuerySelector()или получите несколько совпадений с помощьюQuerySelectorAll(). - Создайте, обновите, удалите или проанализируйте выбранные элементы изображений в соответствии с требуемым сценарием.
- Обрабатывайте связанные ресурсы отдельно, если файлы нужно скопировать, скачать, встроить, оптимизировать или удалить.
- Вызовите
Save(), чтобы записать изменения разметки, либо перейдите к преобразованию, если HTML необходимо отрисовать в PDF или графический формат.
Элементы, источники и ресурсы изображений HTML
- Атрибуты изображения. Читайте или изменяйте
src,alt,width,height,loading,decoding,srcset,sizesи другие атрибуты, поддерживаемые целевой разметкой. - Положение в DOM. Добавляйте изображение в тело документа или выбранный контейнер, перемещайте его к другому родителю, заменяйте или удаляйте из дерева документа.
- Расположение ресурсов. Работайте с относительными путями, абсолютными HTTP- и HTTPS-адресами, файловыми URL и встроенными data URI с учётом базового адреса документа.
- Выбор элементов. Используйте ID, классы, селекторы атрибутов, структурные селекторы, XPath или обход DOM для выбора одного изображения или коллекции.
- Отображаемые размеры. Сочетайте исходные значения
widthиheightс CSS для фиксированного или адаптивного макета. - Изображения вне
<img>. Фоновые изображения CSS, содержимое SVG, источники<picture>, фавиконы и элементы<input type="image">используют другую разметку или правила стилей и требуют отдельной логики выбора. - API вывода. Передайте подготовленный документ в API преобразования, если всю отрисованную страницу требуется сохранить в PNG, JPEG, TIFF или другом поддерживаемом формате.
Документация и справочник API для изображений HTML
В руководстве
How to Add Image to HTML
рассмотрены элементы <img>, встроенные данные и фоновые изображения CSS. Раздел
Working with HTML Documents
описывает загрузку, редактирование, сохранение документов и обработку ресурсов. Свойства изображений и унаследованные методы DOM перечислены в справочнике
HTMLImageElement
.
Установка Aspose.HTML for .NET
Установите Aspose.HTML for .NET из NuGet с помощью .NET CLI:
dotnet add package Aspose.HTML
Также можно использовать интерфейс диспетчера пакетов NuGet или выполнить Install-Package Aspose.HTML в консоли диспетчера пакетов. Подробные инструкции приведены в
руководстве по установке
. Чтобы протестировать API без ограничений ознакомительной версии, запросите
временную лицензию
.
Частые вопросы об управлении изображениями HTML
1. Изменяет ли Aspose.HTML пиксели в файлах PNG или JPEG?
Нет. Операции управления изображениями изменяют HTML-элементы, атрибуты, стили и ссылки на ресурсы. Для масштабирования, обрезки, сжатия и других изменений на уровне пикселей требуется отдельный этап обработки изображения.
2. Как разрешаются относительные пути к изображениям при обработке HTML?
Относительные значения src разрешаются относительно базового адреса документа, который обычно определяется расположением загруженного файла или URL. При создании HTML из строки или потока укажите базовый URL, если приложение должно правильно разрешать относительные пути к ресурсам.
3. Извлечение изображений из HTML и преобразование HTML в изображение – это одно и то же?
Нет. При извлечении сохраняются ресурсы, на которые ссылаются элементы или стили, например файл JPEG из элемента <img>. При
преобразовании HTML в изображение
весь макет страницы отрисовывается в новый растровый файл.
Другие возможности Aspose.HTML for .NET
Перейдите к генерации элементов изображений, редактированию HTML, преобразованию или проверке доступности.