4904
Комментарий:
|
6516
|
Удаления помечены так. | Добавления помечены так. |
Строка 59: | Строка 59: |
= Создание таблиц = Теперь, когда у нас есть тестовые данные, с которыми можно работать, мы может создать таблицу. Так как таблицы - компоненты пользовательского интерфейса, они требуют и контекста и запроса (request). Они передаются как аргументы конструктору класса '''Table'''. {{{#!highlight python >>> from zope.publisher.browser import TestRequest >>> from z3c.table import table >>> request = TestRequest() >>> plainTable = table.Table(folder, request) }}} Когда таблица создана, мы можем ее обновлять и отрисовывать. Так как мы не указали столбцы таблицы, которые нужно отрисовать, таблица отрисуется как пустая строка: {{{#!highlight python >>> plainTable.update() >>> plainTable.render() u'' }}} Также стоит заметить, что класс '''Table''' - реализация интерфейса '''ITable'''. Намного интереснее взглянуть, что предоставляет '''ITable''', когда у нас есть несколько столбцов: {{{#!highlight python >>> from z3c.table import interfaces >>> from zope.interface.verify import verifyObject >>> verifyObject(interfaces.ITable, plainTable) True }}} '''Перевод: Ростислав Дзинько''' |
z3c.table - продвинутые таблицы
Содержание
Z3C Table
Цель, которую преследует пакет z3c.table - предложить модульную библиотеку для отрисовки таблиц. Мы используем шаблон "контент провайдер" с колонками, реализованными как адаптеры. Такой подход - мощная базовая концепция.
Важные требования
- разделение реализации в обновлении частей отрисовки. Такой подход позволяет манипулировать данными после обновления, и перед отрисовкой.
- мы можем использовать шаблоны страниц, если потребуется, но, по умолчанию, все делается в Python.
- мы может отрисовывать порционную навигацию отдельно от самой таблицы.
Никаких скинов
Этот пакет не предоставляет никаких шаблонов и скинов. В любом случае, когда вам нужно отрисовать красивую таблицу, вам придется писать свой собственный скин или шаблон. Отсутствие шаблонов и скинов позволяет удостоверится, что z3c.table имеет очень мало зависимостей, а поэтому легко поддается повторному использованию.
Заметка
Как вы, вероятно, уже знаете, перед тем, как выполняется сортировка по столбцам при порционном отображении данных таблицы, должна быть выполнена сортировка полного набора данных. При большом наборе данных это ведет к проблемам с быстродействием. При работе с большими объемами данных мы рекомендуем не совмещать порционное отображение с сортировкой по столбцам, либо, если нужно, предоставлять "умный" механизм кеширования данных для хранения отсортированных последовательностей.
Пример установки данных
Таблицы часто используются для отображения нормализованных порций данных. Например, нам необходимо отобразить информацию о файлах в папке. Каждый файл имеет заголовок, размер и тип. Наша таблица должна иметь строку для каждого файла и столбец для этих трех полей данных (заголовка, размера, и типа). Контекстом таблицы всегда является структура данных, по которой можно выполнить итерацию, при этом каждый элемент последовательности соответствует строке таблицы. Давайте создадим папку, которую мы сможем использовать как контекст:
XXX: не уверен, куда нам нужно положить эту папку. Также нам можно и не давать значение атрибуту _ _name_ _. Нам не нужно куда либо помещать ее. Давайте установим родительский элемент для папки:
1 >>> root['folder'] = folder
Теперь создадим простой объект File для наполнения созданной нами папки.
Теперь давайте наполним созданную папку файлами.
Создание таблиц
Теперь, когда у нас есть тестовые данные, с которыми можно работать, мы может создать таблицу. Так как таблицы - компоненты пользовательского интерфейса, они требуют и контекста и запроса (request). Они передаются как аргументы конструктору класса Table.
Когда таблица создана, мы можем ее обновлять и отрисовывать. Так как мы не указали столбцы таблицы, которые нужно отрисовать, таблица отрисуется как пустая строка:
Также стоит заметить, что класс Table - реализация интерфейса ITable. Намного интереснее взглянуть, что предоставляет ITable, когда у нас есть несколько столбцов:
Перевод: Ростислав Дзинько