Преобразование Excel в HTML и отображение скрытых строк и столбцов в таблицах Java с помощью GroupDocs.Viewer

Вы сталкиваетесь с трудностями при преобразовании Excel в HTML и визуализации скрытых строк и столбцов в таблице при конвертации её в HTML с помощью Java? Вы не одиноки! Многие разработчики сталкиваются с этой проблемой, пытаясь сохранить целостность визуализации данных в разных форматах. Этот учебник покажет, как эффективно отображать скрытые строки и столбцы в таблицах с использованием GroupDocs.Viewer для Java, гарантируя, что важная информация не будет потеряна при конвертации.

Отображение скрытых строк и столбцов с помощью GroupDocs.Viewer для Java

Отображение скрытых строк и столбцов с помощью GroupDocs.Viewer для Java

Быстрые ответы

  • Может ли GroupDocs.Viewer преобразовать Excel в HTML? Да, он предоставляет готовую поддержку конвертации файлов XLSX в HTML.
  • Будут ли скрытые строки и столбцы видимы в HTML‑выводе? При включении соответствующих параметров скрытые данные отображаются так же, как и видимые ячейки.
  • Какой Maven‑артефакт требуется? com.groupdocs:groupdocs-viewer (рекомендуется последняя версия).
  • Нужна ли лицензия для использования в продакшене? Для продакшена требуется постоянная лицензия; для оценки доступна бесплатная пробная или временная лицензия.
  • Совместим ли этот подход с Java 8 и новее? Абсолютно — работает с JDK 8+.

Что такое «преобразование Excel в HTML»?

Преобразование Excel в HTML превращает рабочую книгу .xlsx в готовые к веб‑использованию HTML‑страницы, сохраняя оригинальное расположение, стили ячеек, формулы и данные. Полученный HTML может отображаться в любом современном браузере без необходимости установки Microsoft Office, что делает его идеальным для веб‑порталов, панелей отчетности и совместных платформ.

Почему отображать скрытые данные таблицы?

Отображение скрытых строк и столбцов гарантирует, что каждая часть информации, хранящаяся в рабочей книге, становится видимой в HTML‑выводе, что критически важно для аудита, анализа данных и образовательных сценариев. Раскрывая скрытые ячейки, вы избегаете случайной потери данных и обеспечиваете, что конечные пользователи видят полный набор данных точно так, как он присутствует в исходном файле.

Предварительные требования

Необходимые библиотеки и зависимости

Для реализации этой функции вам понадобится GroupDocs.Viewer для Java в виде Maven‑зависимости. Эта библиотека обрабатывает рендеринг документов в форматы HTML, PDF и изображения.

Требования к настройке окружения

  • Java Development Kit (JDK): Версия 8 или новее
  • Integrated Development Environment (IDE): IntelliJ IDEA, Eclipse или любой совместимый с Java IDE
  • Maven: Для управления зависимостями

Требования к знаниям

Твердое понимание основ Java и базового использования Maven поможет вам без проблем следовать инструкциям.

Настройка GroupDocs.Viewer для Java

Чтобы начать использовать GroupDocs.Viewer в вашем Java‑приложении, необходимо добавить библиотеку через Maven.

Maven
Добавьте следующую конфигурацию в ваш файл pom.xml:

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

Шаги получения лицензии

  • Free trial – загрузите пробную версию для оценки всех функций.
  • Temporary license – запросите временную лицензию с ограниченным сроком для полного доступа к функциям во время разработки.
  • Purchase – приобретите постоянную лицензию для неограниченного использования в продакшене.

После настройки Maven и получения лицензии вы можете приступить к инициализации GroupDocs.Viewer. Вот как это сделать:

import com.groupdocs.viewer.Viewer;

public class ViewerInitialization {
    public static void main(String[] args) {
        // Initialize the viewer with your license file if available.
        try (Viewer viewer = new Viewer("path/to/your/document.xlsx")) {
            // Your code here...
        }
    }
}

Как преобразовать Excel в HTML с отображением скрытых данных

Чтобы преобразовать рабочую книгу Excel в HTML с отображением скрытых строк и столбцов, загрузите файл с помощью GroupDocs.Viewer, настройте SpreadsheetOptions для рендеринга скрытых элементов, задайте HtmlViewOptions для нужного формата вывода, а затем вызовите viewer для генерации HTML‑файлов. Следуйте шагам ниже, чтобы выполнить это.

Шаг 1: Определите путь к каталогу вывода

Укажите папку, в которой будут сохранены сгенерированные HTML‑файлы:

import java.nio.file.Path;
import java.nio.file.Paths;

Path outputDirectory = Paths.get("YOUR_OUTPUT_DIRECTORY", "RenderHiddenRowsAndColumns");

Шаг 2: Настройте параметры HTML‑просмотра

HtmlViewOptions управляет тем, как создаются HTML‑файлы, включая то, встраиваются ли ресурсы или сохраняются как отдельные файлы.
Класс HtmlViewOptions является центральным объектом конфигурации для HTML‑рендеринга в GroupDocs.Viewer.

Шаг 3: Включите рендеринг скрытых столбцов и строк

SpreadsheetOptions позволяет переключать видимость скрытых строк и столбцов во время конвертации.
SpreadsheetOptions — это контейнер настроек, определяющий, как обрабатываются специфические для таблиц функции, такие как скрытые ячейки, сетка и выбор листов.

Шаг 4: Инициализируйте Viewer с документом и выполните рендеринг

Класс Viewer является основным компонентом, используемым для рендеринга документов в GroupDocs.Viewer.
Создайте экземпляр Viewer, передайте путь к файлу Excel и вызовите метод view с подготовленными параметрами.
Класс Viewer — точка входа GroupDocs.Viewer; он читает исходный документ и создает запрошенный формат вывода.

import com.groupdocs.viewer.options.HtmlViewOptions;

// Create a file path format for rendering each page.
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);

Практические применения

  1. Financial reporting – обеспечить, чтобы аудиторские следы включали каждый скрытый показатель для соответствия требованиям.
  2. Data analysis – сохранить полный набор данных при экспорте в веб‑панели.
  3. Educational tools – предоставить студентам полный контент таблицы для изучения формул и структур данных.

Соображения по производительности

  • GroupDocs.Viewer поддерживает конвертацию более 50 форматов документов и может обрабатывать рабочие книги из сотен страниц без загрузки всего файла в память, поддерживая низкое потребление памяти.
  • Следите за размером кучи JVM для очень больших файлов Excel; при необходимости увеличьте -Xmx.
  • Храните выходные файлы на быстром SSD‑накопителе, чтобы снизить задержку ввода‑вывода.
  • Держите библиотеку в актуальном состоянии; каждый релиз включает оптимизации производительности и исправления ошибок.

Заключение

В этом учебнике вы узнали, как преобразовать Excel в HTML и настроить GroupDocs.Viewer для Java, чтобы отображать скрытые строки и столбцы в таблицах. Следуя приведённым выше шагам, вы можете гарантировать, что каждая ячейка — видимая или скрытая — будет представлена в HTML‑выводе, обеспечивая полную видимость данных на всех платформах. Поэкспериментируйте с дополнительными параметрами, такими как пользовательский CSS или вывод в один файл, чтобы ещё лучше адаптировать результат к потребностям вашего приложения.

Готовы углубиться? Реализуйте эту функцию в своих проектах и посмотрите, как она улучшит функциональность вашего приложения!

Раздел FAQ

Q1: Могу ли я использовать GroupDocs.Viewer бесплатно?
A1: Да, вы можете скачать пробную версию с официального сайта, чтобы изучить функции. Для полного доступа без ограничений рассмотрите возможность получения временной или постоянной лицензии.

Q2: Какие форматы файлов поддерживает GroupDocs.Viewer?
A2: Он поддерживает более 50 различных форматов документов, включая PDF, Word, Excel, PowerPoint и распространённые типы изображений.

Q3: Как работать с большими документами в GroupDocs.Viewer?
A3: Оптимизируйте управление памятью, корректируя настройки кучи Java, и при необходимости разбейте большие рабочие книги на более мелкие части перед рендерингом.

Q4: Можно ли настроить формат HTML‑вывода?
A4: Да, вы можете настроить различные параметры с помощью HtmlViewOptions, чтобы адаптировать внешний вид, встраивать ресурсы или генерировать одностраничный HTML‑файл.

Q5: Как лучше всего устранять проблемы с GroupDocs.Viewer?
A5: Обратитесь к официальной документации и форумам сообщества, убедитесь, что все Maven‑зависимости соответствуют версии библиотеки, и включите подробный лог, чтобы захватить детальную информацию об ошибках.

Часто задаваемые вопросы

Q: Влияет ли включение setRenderHiddenColumns(true) на производительность?
A: Рендеринг скрытых столбцов добавляет небольшие накладные расходы, но влияние минимально для типичных рабочих книг. Для очень больших листов следите за использованием памяти и рассматривайте возможность увеличения размера кучи JVM.

Q: Могу ли я преобразовать файл XLSX в одну HTML‑страницу вместо нескольких?
A: Да, задайте пользовательское имя файла в HtmlViewOptions без плейсхолдера {0}, чтобы сгенерировать один HTML‑файл, содержащий все листы.

Q: Как отобразить скрытые данные таблицы только для определённых листов?
A: Используйте viewOptions.getSpreadsheetOptions().setWorksheetIndexes(...), чтобы выбрать конкретные листы перед включением рендеринга скрытого содержимого.

Q: Можно ли скрыть панель инструментов или навигацию после конвертации?
A: HTML‑вывод, генерируемый GroupDocs.Viewer, статичен; вы можете вручную удалить элементы навигации, отредактировав сгенерированный шаблон или применив пользовательский CSS.

Q: Какая версия GroupDocs.Viewer требуется для рендеринга скрытых строк/столбцов?
A: Функция доступна, начиная с версии 22.0; мы рекомендуем использовать последнюю стабильную версию (в данный момент 25.2) для лучшей производительности и поддержки.

Ресурсы

Последнее обновление: 2026-09-20
Тестировано с: GroupDocs.Viewer 25.2 for Java
Автор: GroupDocs

// Enable rendering of hidden columns and rows.
viewOptions.getSpreadsheetOptions().setRenderHiddenColumns(true);
viewOptions.getSpreadsheetOptions().setRenderHiddenRows(true);

import com.groupdocs.viewer.Viewer;

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_XLSX_WITH_HIDDEN_ROW_AND_COLUMN")) {
    // Render the document to HTML using the specified view options.
    viewer.view(viewOptions);
} catch (Exception e) {
    System.out.println("Error rendering document: " + e.getMessage());
}

Связанные учебники