Содержание
Экран со списком файлов представлен на илл. «Список файлов».
Элементы управления экрана со списком файлов.
Элемент управления | Расположение на экране | Описание |
---|---|---|
Верхняя панель | ||
| |
Слева | |
«Навигатор» - кнопка перехода к навигатору хранилища |
«Файлы» |
По центру |
Выпадающий список для переключения между модулями |
| |
Справа | |
«Создать» - кнопка добавления файла, создания новой папки и и создания документа |
| |
Левее кнопки «Создать» | |
«Поиск» - кнопка для перехода к поиску по файлам |
Компонент «Путь» |
Ниже верхней панели |
Компонент, отображающий путь до текущей открытой папки |
Рабочая область | ||
Вся рабочая область ниже пути |
Плашки, отображающие информацию о папке / файле |
По нажатию на «Файлы» на верхней панели не отображаются все кнопки, под панелью открывается выпадающий список с модулями (илл. «Переключение между модулями»):
До вызова выпадающего списка стрелка отображается указателем вниз, по вызову меняется указателем вверх. По нажатию вне области выпадающего списка, а также по указателю и шапке списка, он скрывается. По нажатию на текущий модуль список обновляется, на другой модуль - открывается соответствующий модуль.
Компонент «Путь» содержит полный
путь до папки хранилища (path
). Содержимое
компонента: полные названия папок от корневой родительской до
текущей открытой, включая её саму. При этом путь должен быть не
абсолютным согласно хранилища, а относительным согласно его
расположения в дереве папок.
Например, из структуры папок Хранилище -> Папка 1 -> Папка 1.1 пользователю согласно его ролям доступна только Папка 1.1. В качестве пути будет отображаться не полный (абсолютный) путь
Хранилище -> Папка 1 -> Папка 1.1
, а относительныйПапка 1.1
.
Каждый элемент пути, кроме последнего, отделен от предыдущего / следующего символом . Если все элементы не помещаются на ширину экрана, только в данном компоненте должен активироваться горизонтальный скролл, при этом слева и справа невмещающиеся названия должны затемняться градиентом из прозрачного в цвет фона.
Кроме того, каждый элемент пути является кликабельной ссылкой на соответствующую папку. Таким образом, навигация по хранилищу возможна тремя способами:
переход в любую папку хранилища, используя навигатор;
переход только в дочерние папки из общего списка папок и файлов;
переход в родительские папки, используя компонент «Путь».
Пример навигации, используя компонент «Путь»:
Для того, чтобы вернуться «на уровень выше», необходимо в пути выбрать предпоследний элемент и нажать на него.
Для того, чтобы вернуться «домой» (т.е. в корневой элемент), необходимо в пути выбрать самый первый элемент (при необходимости прокрутив компонент по горизонтали) и нажать на него.
Папки и файлы в списке отображаются все сразу. При прокрутке пользователем в начале списка вверх (действие dropdown) список обновляется.
Список папок и файлов сортируется следующим образом. Сначала отображаются папки, затем файлы, между собой элементы должны быть отсортированы по названию в порядке возрастания (сначала 0-9, затем A-Z, затем А-Я).
Плашка элемента хранилища.
Плашка папки / файла - это компонент, отображающий информацию об элементе хранилища. Плашки могут быть разных размеров.
Элемент | Расположение | Описание | Поле API |
---|---|---|---|
| |
В левой части всей плашки | |
Тип элемента хранилища | |
|
Справа от иконки; все строки, кроме последней |
Полное название папки или файла |
| |
Абдрешен Л.С. |
Справа от иконки; последняя строка плашки, слева |
ФИО пользователя, выполнившего последнее изменение папки или файла |
|
01.01.16 09:00:00 |
Справа от иконки; последняя строка плашки, справа |
Дата и время последнего изменения папки или файла |
|
Тип элемента хранилища отображается в виде
пиктограммы папки (is_folder
= true) или файла
(is_folder
= false). Пример иконки папки
приведен в таблице выше. Иконки файлов зависят от расширения, они
аналогичны таковым в панели вложений
работы.
Пользователь, выполнивший последнее изменение элемента хранилища. Отображается в формате %Фамилия И.О.%
Дата и время последнего изменения элемента хранилища. Отображается в формате %ДД.ММ.ГГ ЧЧ:ММ:СС%.
Возможные действия на экране.
По нажатию на кнопку «Навигатор», а также проведя пальцем от левой стороны экрана к правой, раскрывается левая панель навигатора по хранилищу).
По нажатию на кнопку «+» вызывается меню «Создать»
(аналогичное в модуле «Работы»), в построении которого участвуют
пункты параметра files_items
:
favorite_documents
;
all_documents
;
upload_document
;
new_folder
.
Действия favorite_documents
и
all_documents
соответствуют пунктам
создания документов.
Действие upload_document
соответствует
групповому пункту добавления файла в
хранилище, который по умолчанию всегда раскрыт, а также
двум подпунктам «С устройства» и «Сфотографировать».
Действие new_folder
соответствует пункту
создания новой папки.
Кнопка «+» может отсутствовать вовсе, см. подробнее в разделе Действия в хранилище. В таком случае кнопка «Поиск» должна переместиться на место кнопки «Создать». В целом же логика меню «Создать» и экрана «Избранное» не отличается от таковой в работах.
По нажатию на кнопку поиска открывается отдельный экран «Поиск».
По нажатию на элемент пути обновляется список: в нем должно отображаться содержимое соответствующей папки.
По нажатию на кнопку «Назад»:
для переключателя «Запомнить меня» со значением «Выкл» - открывается экран авторизации;
для переключателя «Запомнить меня» со значением «Вкл» - происходит закрытие приложения.
Возможные действия с плашкой папки:
При выделении папки (tap) обновляется список: в нем должно отображаться содержимое выделенной папки.
В результате долгого нажатия по плашке возможно появление меню для осуществления дополнительных действий с папкой. Набор пунктов меню зависит от прав пользователя на папку. Если нет прав для совершения ни одного действия - меню не отображается. Возможные пункты меню:
Возможные действия с плашкой файла:
При выделении файла (tap) он скачивается на устройство и открывается системными средствами.
В результате долгого нажатия по плашке возможно появление меню для осуществления дополнительных действий с папкой. Набор пунктов меню зависит от прав пользователя на папку, в которой лежит данный файл. Если нет прав для совершения ни одного действия - меню не отображается. Возможные пункты меню:
Примечание
Метод получения содержимого папок хранилища описан в javadoc:
kz.arta.synergy.server.api.rest.stotage#listFiles.
http://tdd.lan.arta.kz/docs/synergy/trunk/sdk-doc/javadoc/kz/arta/synergy/server/api/rest/storage/StorageService.html#listFiles%28java.lang.String,%20boolean,%20java.lang.String%29