Компонент электронной таблицы для Angular | ng-hub-ui-spreadsheet

Редактируемая таблица для Angular с клавиатурой Excel, прямоугольным выделением, буфером обмена, работающим с Excel в обе стороны, закреплёнными областями и объединёнными ячейками. MIT, доступная, без платного тарифа.

Последнее обновление 15 нояб. 2026 г.

Обзор

Почему команды ищут эту библиотеку

Используйте ng-hub-ui-spreadsheet, когда экрану нужны ячейки, в которые вводят и вставляют данные, без платы за сетку и без отказа от поддержки экранных дикторов.

Установка

npm install ng-hub-ui-spreadsheet

Перейти к

Идеально для

  • строки счетов и заказов
  • сетки цен и тарифов
  • табели учёта времени и графики смен
  • массовое исправление данных

О библиотеке spreadsheet

ng-hub-ui-spreadsheet is a standalone Angular component that renders rows and columns you already hold and reports what the reader did to them. It never writes to your data. It brings in-cell editing with Excel's keyboard, rectangular selection by shift or dragging, a clipboard that writes and reads both flavours so figures survive a journey between locales, frozen rows and columns, merged blocks, and a save state per cell. It carries real grid semantics — role="grid", row and column indices, a roving tab stop — and depends on nothing outside Angular: its grid primitives live in ng-hub-ui-utils rather than @angular/cdk. Формулы пишутся и по алиасам столбцов, и по координатам, длинный лист рисует только то, что покрывает окно по обеим осям, а всё целиком выгружается в настоящий .xlsx или в CSV и возвращается обратно — zip и XML пишутся здесь, так что ничего из этого не тянет зависимостей.

Руководства по возможностям

Для этой библиотеки пока не задокументировано ни одного руководства по возможностям.

Ключевые возможности

Последние изменения

Version 22.13.0 - 11/15/26, 12:00 AM

added: hubSpreadsheetHeader рисует заголовок столбца по вашему шаблону, например название с кнопкой редактирования. Кнопку, ссылку или поле внутри можно нажать, не перетаскивая столбец; заголовок сохраняет ширину, закрепление и флажок «выбрать все».

Version 22.12.2 - 11/4/26, 12:00 AM

fixed: Число с погрешностью от вычислений выглядит так же, как в электронной таблице: в ячейке, при копировании и в редакторе числа пишутся с 15 значащими цифрами, поэтому 3260,4 − 3120,8 показывается как 139,6. Сохранённое значение не меняется.

Version 22.12.1 - 11/4/26, 12:00 AM

fixed: Столбец списка или даты с выравниванием по концу оставляет в ячейках и заголовке место для стрелки, и она больше не закрывает конец значения.

fixed: Список сохраняет ту же стрелку при открытии: нативный список скрывает стрелку браузера и оставляет стрелку таблицы на том же месте.

Version 22.12.0 - 11/4/26, 12:00 AM

added: editCell открывает редактор ячейки из кода и ждёт только что добавленную строку, так что после кнопки, добавляющей заметку, можно сразу печатать.

added: Alt+Enter (Option+Enter на Mac) открывает действие ячейки, в которую также можно писать, а Enter по-прежнему открывает её поле.

Version 22.11.0 - 11/4/26, 12:00 AM

added: append у столбца показывает после основного значения второе, выбранное из короткого списка: единицу количества или вид скидки. Изменение приходит как commit с ключом append.key, а копирование, вставка и заполнение переносят обе части.

Version 22.10.0 - 11/4/26, 12:00 AM

added: focusCell ставит курсор на ячейку из кода и ждёт только что добавленную строку, так что после кнопки «добавить строку» можно сразу печатать в ней.

added: Ctrl+D (Cmd+D на Mac) при включённом fillHandle заполняет вниз: верхняя строка выделения копируется в нижние, одним событием filled.

added: Вставка длиннее таблицы запрашивает недостающие строки через insertRequested, если это разрешает structure, и приходит целиком, когда они отрисованы.

added: checkAll ставит в заголовок столбца «да/нет» флажок, который отмечает все строки сразу, в смешанном состоянии, пока они различаются, одним событием filled.

changed: title ячейки показывается во всплывающей подсказке таблицы, и при наведении, и с клавиатуры, а не в нативном title, который клавиатура не показывает.

changed: Шаблон ячейки сохраняет её собственные элементы управления: у столбца «да/нет» флажок с шаблоном рядом, у столбца списка или даты стрелку, которая его открывает.

fixed: Пустая строка теперь такой же высоты, как заполненная, а не сжимается до отступов.

fixed: Ячейка в нижнем углу рамки повторяет её скругление, и контур курсора больше не выступает.

Version 22.9.1 - 11/3/26, 12:00 AM

changed: Подписи таблицы используют hubTranslate вместо устаревшего пайпа translate. Для хоста ничего не меняется.

Version 22.9.0 - 11/3/26, 12:00 AM

added: Строка перемещается с клавиатуры клавишами Alt+Shift и стрелкой вверх или вниз, сообщается через rowMoved, как при отпускании, а живая область зачитывает, куда она ушла.

fixed: Клавиши, нажатые в собственном редакторе или в раскрытой строке, принадлежат им: в поле поиска выбора можно печатать, а стрелки двигают его текстовый курсор, а не курсор таблицы.

fixed: Собственный редактор закрывается как редактор таблицы: по Escape, по Tab и когда фокус покидает его, а Enter, выбирающий ответ, больше не открывает ячейку ниже. В контексте появился draft для редактора, которому есть что подтвердить.

fixed: Текст, который ячейка не может хранить, больше не теряется, когда читатель её покидает: ячейка сохраняет его в рамке и с объяснением, а invalidDrafts сообщает об этом хосту.

Version 22.8.0 - 10/28/26, 12:00 AM

added: Строку можно перетащить в другое место, как уже можно было со столбцом. При наведении на строку у её начального края появляется ручка, при наведении на столбец — над его заголовком. Перенос сообщается через rowMoved, уже в новом порядке, в той же форме, что и columnMoved.

changed: Перемещение теперь видно: копия следует за указателем, пройденные строки или столбцы расступаются, освобождая место, а у края лист прокручивается. Пока кнопка зажата, ручки скрыты.

Version 22.7.0 - 10/27/26, 12:00 AM

changed: Сообщение проверки ячейки открывается в красной подсказке при наведении или когда клавиатура переходит на ячейку, вместо серого title браузера.

changed: Backspace или Delete на одной ячейке очищает её и открывает редактор, чтобы сразу ввести новое значение. Несколько ячеек по-прежнему очищаются через cleared.

changed: Курсор и выделение рисуются только пока лист в фокусе, поэтому покинутый лист больше не выглядит готовым к вводу.

added: Поля формы, открытые внутри ячейки, показывают ошибку в подсказке, и строка сохраняет свою высоту.

Version 22.6.0 - 9/30/26, 12:00 AM

added: Ячейка может сказать, чего в ней нет: placeholder — подсказка, показываемая в этой ячейке, пока она пуста, при наведении, с откатом к подсказке столбца.

Version 22.5.0 - 9/29/26, 12:00 AM

changed: hubSpreadsheetCellAction теперь принимает и функцию строки: в столбце могут открываться лишь некоторые ячейки — Enter остаётся за ними, остальные принадлежат листу.

Version 22.4.0 - 9/28/26, 12:00 AM

added: Строка раскрывается на месте, с expansion и expandedRow: шаблон под самой строкой для того, что она хранит за своими числами, а не в диалоге поверх неё.

added: Ячейка, открывающая что-то, объявленная её собственным шаблоном: hubSpreadsheetCellAction оставляет Enter за ячейкой, а нажатие сообщается через opened.

added: Столбцы и строки сворачиваются по структуре, как группировка в Excel: серия столбцов или строк на уровне сворачивается одной кнопкой, а какие группы свёрнуты — ваше дело.

Version 22.2.0 - 9/27/26, 12:00 AM

added: Ячейка, вычисляемая формулой, а не введённая, несёт маленький fx в верхнем углу, видимый, пока на ней указатель. С двумя своими токенами: --hub-spreadsheet-formula-bg и --hub-spreadsheet-formula-color.

fixed: Координаты появляются только для формулы. Редактирование обычной ячейки больше не рисует вокруг рамку из букв и чисел — они ждут первого =.

fixed: Координаты рисуются вне рамки листа. Рамка сдвигается, освобождая место, а значки плавают снаружи, так что рамка остаётся между ними и таблицей.

fixed: Список того, что может войти в формулу, следует за рамкой. Первый = сдвигает лист, и список ставится заново после сдвига, свисая с ячейки, где она теперь.

Version 22.1.0 - 9/27/26, 12:00 AM

added: Несколько блоков сразу: с Ctrl клик откладывает рисуемый прямоугольник и начинает новый, Delete очищает все, а selectionRangesChange сообщает обо всех. Копирование только когда блоки складываются в таблицу, а маркер заполнения исчезает, пока их несколько.

added: hub-spreadsheet-theme — один include для 65 настраиваемой переменной листа, все параметры необязательны: выводится только то, что передали.

added: Формула пишется цветом: во время ввода функция, псевдоним столбца, ссылка на ячейку и строка в кавычках рисуются каждый своим цветом, чтобы грамматика читалась с первого взгляда.

added: Указывайте ячейки, чтобы вписать их ссылку: во время ввода формулы нажатие или перетаскивание по другим ячейкам вставляет указанное в формулу в позицию курсора — B3 для одной, B3:D7 для прямоугольника — не завершая текст.

added: Пока ячейка открыта, показываются буквы столбцов и номера строк: лист немного сдвигается, и в освободившемся месте всплывают значки — буква и псевдоним над каждым столбцом, номер строки слева — чтобы ссылку можно было прочитать, а не считать, с короткой анимацией появления.

fixed: Темизация листа извне теперь вообще работает. Переменные объявлялись на самом элементе, а это сильнее любого наследования, поэтому :root, обёртка и тема на уровне маршрута молча игнорировались. Теперь они читаются там, где используются, а значения по умолчанию не изменились.

fixed: Список того, что может войти в формулу, теперь действительно виден. Он существовал, но обрезался областью прокрутки листа и любым overflow:hidden между ячейкой и страницей, поэтому в последней строке никогда не появлялся. Теперь он закреплён к окну и открывается над ячейкой, когда снизу нет места.

Version 22.0.0 - 9/27/26, 12:00 AM

added: hub-spreadsheet: редактирование в ячейке, полная навигация с клавиатуры и прямоугольное выделение.

added: Буфер обмена, работающий с Excel в обе стороны и читающий сырое число из HTML-формата.

added: Закреплённые строки и столбцы, отсчитываемые от края.

added: Объединённые блоки, объявляемые владельцем, которые навигация и выделение считают одной ячейкой.

added: Запросы на вставку и удаление, ограниченные разрешениями, с псевдонимами, которые никогда не используются повторно.

Связанные библиотеки

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

Как вставить данные из Excel в сетку Angular, не испортив числа?

Читайте HTML-формат буфера обмена, а не только простой текст. Excel записывает там сырое число в атрибуте; простой текст содержит то, что показывала локаль источника, поэтому 1.234,56 разбирается как текст или как 1.23 в зависимости от того, где его скопировали. ng-hub-ui-spreadsheet читает оба формата и отдаёт предпочтение сырому значению.

Есть ли бесплатный компонент таблицы для Angular?

ng-hub-ui-spreadsheet распространяется под MIT, без платного тарифа и закрытых функций. Редактирование, прямоугольное выделение, буфер обмена, закреплённые области и объединённые ячейки входят в пакет, чего нельзя сказать о большинстве сеток, где буфер обмена и выделение диапазонов спрятаны за корпоративной лицензией.

Работает ли он с экранным диктором?

Да. Он отрисовывает настоящий role="grid" с aria-colindex у каждой ячейки, aria-rowindex у каждой строки, aria-selected, следующим за выделением, aria-readonly у ячеек, в которые нельзя вводить, и aria-busy, пока ячейка сохраняется, с одной перемещающейся точкой табуляции и навигацией стрелками.

Нужен ли @angular/cdk?

Нет. Двумерная навигация, прямоугольное выделение и карта клавиш находятся в ng-hub-ui-utils, поэтому установка таблицы не приносит ничего, кроме самого Angular.