Cluster · разработчикам
Table
Локальное редактирование таблицы Page. Для сохранения изменений вызови page.save().
Все методы SDK · Типы и ошибки
Получение объекта
page = await app.ui.page("overview").load()
table = page.table("items")table получена из загруженной Page; у таблицы есть колонка title, а для операций по индексу уже добавлены нужные строки.
__init__
Создаёт Table. Обычный способ получения объекта показан выше; прямой конструктор не выполняет сетевые запросы.
def __init__(page: Page, id: str) -> None: ...Аргументы
page: Page, обязательный. Загруженный объект страницы, содержащий объявление таблицы.id: str, обязательный. Идентификатор объекта, полученный при его создании. Не путь сервера.
Результат
None. Создаёт Table. Обычный способ получения объекта показан выше; прямой конструктор не выполняет сетевые запросы.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
- Отдельного исключения SDK нет. Действуют обычные ошибки типов Python и ошибки переданных функций, если они используются.
Пример
# Обычный способ получения объекта:
page = await app.ui.page("overview").load()
table = page.table("items")rows
Возвращает сам локальный список строк; при отсутствии создаёт пустой список в значениях страницы.
def rows() -> list[dict[str, JSON]]: ...Аргументы
Нет.
Результат
list[dict[str, JSON]]. Возвращает сам локальный список строк; при отсутствии создаёт пустой список в значениях страницы.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
- Отдельного исключения SDK нет. Действуют обычные ошибки типов Python и ошибки переданных функций, если они используются.
Пример
result = table.rows()row
Добавляет строку из именованных колонок. Неизвестные колонки, сложные значения и более 200 строк отклоняются.
def row(**values: None | bool | int | float | str) -> Self: ...Аргументы
values: None | bool | int | float | str, произвольные именованные аргументы. Именованные значения только объявленных колонок. Допускаются простые JSON-типы.
Результат
Self. Тот же объект после успешной операции. Добавляет строку из именованных колонок. Неизвестные колонки, сложные значения и более 200 строк отклоняются.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
ValueError('Unknown table column'): условие проверяется до продолжения операции.ValueError('Too many table rows'): условие проверяется до продолжения операции.ValueError('Invalid table cell'): условие проверяется до продолжения операции.
Пример
table.row(title="Example")cell
Меняет значение ячейки существующей строки и объявленной колонки.
def cell(row: int, column: str, value: None | bool | int | float | str) -> Self: ...Аргументы
row: int, обязательный. Индекс существующей строки таблицы, начиная с нуля.column: str, обязательный. Имя объявленной колонки таблицы.value: None | bool | int | float | str, обязательный. Простое JSON-значение ячейки. Списки и словари не принимаются.
Результат
Self. Тот же объект после успешной операции. Меняет значение ячейки существующей строки и объявленной колонки.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
ValueError('Unknown table column'): условие проверяется до продолжения операции.ValueError('Invalid table cell'): условие проверяется до продолжения операции.
Пример
table.cell(0, "title", "Updated")remove
Удаляет строку по индексу.
def remove(row: int) -> Self: ...Аргументы
row: int, обязательный. Индекс существующей строки таблицы, начиная с нуля.
Результат
Self. Тот же объект после успешной операции. Удаляет строку по индексу.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
- Отдельного исключения SDK нет. Действуют обычные ошибки типов Python и ошибки переданных функций, если они используются.
Пример
result = table.remove(0)move
Переносит строку на другую существующую позицию.
def move(row: int, target: Module) -> Self: ...Аргументы
row: int, обязательный. Индекс существующей строки таблицы, начиная с нуля.target: Module, обязательный. Выбранная зависимость.
Результат
Self. Тот же объект после успешной операции. Переносит строку на другую существующую позицию.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
- Отдельного исключения SDK нет. Действуют обычные ошибки типов Python и ошибки переданных функций, если они используются.
Пример
table.move(0, 1)sort
Сортирует строки по колонке либо пользовательскому key.
def sort(column: str | None = None, key: Callable | None = None, reverse: bool = False) -> Self: ...Аргументы
column: str | None, по умолчаниюNone. Имя объявленной колонки таблицы.key: Callable | None, по умолчаниюNone. Синхронный ключ сортировки. None использует правило класса; вызывается для каждого элемента.reverse: bool, по умолчаниюFalse. Логический переключатель указанного действия.
Результат
Self. Тот же объект после успешной операции. Сортирует строки по колонке либо пользовательскому key.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
ValueError('Unknown table column'): условие проверяется до продолжения операции.
Пример
result = table.sort()clear
Заменяет строки таблицы пустым списком в локальной странице.
def clear() -> Self: ...Аргументы
Нет.
Результат
Self. Тот же объект после успешной операции. Заменяет строки таблицы пустым списком в локальной странице.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
- Отдельного исключения SDK нет. Действуют обычные ошибки типов Python и ошибки переданных функций, если они используются.
Пример
result = table.clear()