Источник данных управляет Вашим содержанием

Объект источника данных является объектом, ответственным за управление содержанием, Вы представляете использование представления набора. Объект источника данных должен соответствовать UICollectionViewDataSource протокол, определяющий основное поведение и методы, которые необходимо поддерживать. Задание источника данных должно предоставить представлению набора ответы на следующие вопросы:

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

• Для данного раздела, сколько содержат элементы раздел?

• Для данного раздела или элемента, какие представления должны использоваться для отображения соответствующего содержания?

Разделы и элементы являются фундаментальным принципом организации для содержания представления набора. Представление набора обычно имеет по крайней мере один раздел и может содержать больше. Каждый раздел, в свою очередь, содержит нуль или больше элементов. Элементы представляют основное содержание, которое Вы хотите представить, тогда как разделы организуют те элементы в логические группы. Например, фото приложение могло бы использовать разделы для представления единственного альбома фотографий или ряда фотографий, сделанных в тот же день.

Представление набора относится к данным, это содержит использование NSIndexPath объекты. При попытке определить местоположение элемента, представление набора использует индексную информацию пути, предоставленную ему объектом расположения. Для элементов индексный путь содержит число раздела и номер изделия. Для дополнительного и представлений художественного оформления, индексный путь содержит, какой бы ни значения были предоставлены объектом расположения. Значение индексных путей, присоединенных к дополнительному и представлениям художественного оформления, зависит от Вашего приложения, хотя первый индекс соответствует определенному разделу в источнике данных. Индексные пути этих представлений больше об идентификации, чем значение, идентифицируя, какое представление, какого вида в настоящее время рассматривается. Так, если, например, у Вас есть дополнительные представления, создающие заголовки и нижние колонтитулы для Ваших разделов, как замечено в перетекающем макете, релевантная информация, предоставленная индексным путем, является разделом, на который ссылаются.

Независимо от того, как Вы располагаете разделы и элементы в Вашем объекте данных, визуальное представление тех разделов и элементов все еще определяется объектом расположения. Различные объекты расположения могли представить раздел и данные элемента очень по-другому, как показано на рисунке 2-1. В этом числе объект перетекающего макета располагает разделы вертикально с каждым последовательным разделом ниже предыдущего. Пользовательский макет мог расположить разделы в нелинейное расположение, демонстрируя снова разделение расположения от фактических данных.

Разработка Ваших объектов данных

Эффективный источник данных использует разделы и элементы, чтобы помочь организовать его базовые объекты данных. Организация Ваших данных в разделы и элементы делает намного проще реализовать Ваши методы источника данных позже. И потому что Ваши методы источника данных часто вызывают, Вы хотите удостовериться, что Ваши реализации тех методов в состоянии получить данные как можно быстрее.

Одно простое решение (но конечно не единственное решение) для Вашего источника данных для использования ряда вложенных массивов, как показано на рисунке 2-2. В этой конфигурации массив верхнего уровня содержит один или несколько массивов, представляющих разделы Вашего источника данных. Каждый массив раздела тогда содержит элементы данных для того раздела. Нахождение элемента в разделе является вопросом получения его массива раздела и затем получения элемента от того массива. Этот тип расположения упрощает управлять умеренно измеренными наборами элементов и получать отдельные элементы по требованию.

При разработке структур данных можно всегда запускать с простого набора массивов и перемещаться в более эффективную структуру по мере необходимости. В целом Ваши объекты данных никогда не должны быть узким местом производительности. Представление набора обычно получает доступ к Вашему источнику данных только для вычисления сколько объектов, там всего и получить представления для элементов, которые являются в настоящее время экранными. Если объект расположения полагается только на данные от Ваших объектов данных, на производительность можно было бы сильно повлиять, когда источник данных содержит тысячи объектов.

- (NSInteger)numberOfSectionsInCollectionView:(UICollectionView*)collectionView {

    // _data is a class member variable that contains one array per section.

    return [_data count];

}

- (NSInteger)collectionView:(UICollectionView*)collectionView numberOfItemsInSection:(NSInteger)section {

    NSArray* sectionArray = [_data objectAtIndex:section];

    return [sectionArray count];

}

Конфигурирование ячеек и дополнительных представлений

Другая важная задача Вашего источника данных состоит в том, чтобы обеспечить представления что использование представления набора для отображения содержания. Представление набора не отслеживает содержание Вашего приложения. Это просто получает представления предоставление его, и применяет информацию о текущем макете к ним. Поэтому все, что выведено на экран представлениями, является Вашей ответственностью.

После того, как Ваш источник данных сообщает, сколько разделов и элементов он управляет, представление набора спрашивает объект расположения обеспечить атрибуты макета для содержания представления набора. В некоторый момент представление набора спрашивает объект расположения обеспечить список элементов в определенном прямоугольнике (часто, это - видимый прямоугольник). Использование представления набора, перечисляющее для выяснения у источника данных соответствующие ячейки и дополнительные представления. Для обеспечения тех ячеек и дополнительных представлений код должен сделать следующее:

1. Встройте свои шаблонные ячейки и представления в Вашем файле раскадровки. (Также зарегистрируйте класс или файл пера для каждого типа поддерживаемой ячейки или представления.)

2. В Вашем источнике данных исключите из очереди и сконфигурируйте надлежащую ячейку или представление, когда спросили.

Чтобы гарантировать, что ячейки и дополнительные представления используются самым эффективным возможным способом, представление набора принимает на себя ответственность создания тех объектов для Вас. Каждое представление набора поддерживает внутренние очереди в настоящее время неиспользованных ячеек и дополнительных представлений. Вместо того, чтобы создать объекты самостоятельно, просто попросите, чтобы представление набора предоставило Вам представление, которое Вы хотите. Если Вы ожидаете на очереди повторного использования, представление набора подготавливает ее и возвращает ее Вам быстро. Если Вы не ожидаете, представление набора использует зарегистрированный класс или файл пера, чтобы создать новый и возвратить его Вам. Таким образом, каждый раз, когда Вы исключаете из очереди ячейку или представление, Вы всегда получаете готовый к использованию объект.

Идентификаторы повторного использования позволяют зарегистрировать многократные типы ячеек и многократные типы дополнительных представлений. Идентификатор повторного использования является строкой, которую Вы используете для различения зарегистрированную ячейку и типы представления. Содержание строки относится только к Вашему объекту источника данных. Но, когда спросили относительно представления или ячейки, можно использовать предоставленный индексный путь для определения, какой тип представления или ячейки Вы могли бы хотеть и затем передать надлежащий идентификатор повторного использования методу двухсторонней очереди.

- (UICollectionViewCell *)collectionView:(UICollectionView *)collectionView

                  cellForItemAtIndexPath:(NSIndexPath *)indexPath {

   MyCustomCell* newCell = [self.collectionView dequeueReusableCellWithReuseIdentifier:MyCellID

                                                                          forIndexPath:indexPath];

   newCell.cellLabel.text = [NSString stringWithFormat:@"Section:%d, Item:%d", indexPath.section, indexPath.item];

   return newCell;

}

Вставка, удаляя и перемещая разделы и элементы

Для вставки удалите, или переместите единственный раздел или элемент, выполните эти шаги:

1. Обновите данные в своем объекте источника данных.

2. Вызовите надлежащий метод представления набора, чтобы вставить или удалить раздел или элемент.

Критически важно, что Вы обновляете свой источник данных прежде, чем уведомить представление набора любых изменений. Методы просмотра набора предполагают, что Ваш источник данных содержит в настоящее время корректные данные. Если это не делает, представление набора могло бы получить неправильный набор элементов от Вашего источника данных или попросить элементы, которые не являются там и разрушают Ваше приложение.

Когда Вы добавляете, удаляете или перемещаете единственный элемент программно, методы представления набора автоматически создают анимации для отражения изменений. Если Вы хотите анимировать многократные изменения вместе, тем не менее, необходимо выполнить всех, вставляют, удаляют, или вызовы перемещения в блоке и передаче тот блок к performBatchUpdates:completion: метод. Процесс пакетного обновления тогда анимирует все Ваши изменения одновременно, и можно свободно смешать вызовы, чтобы вставить, удалить, или переместить элементы в том же блоке.

Перечисление 2-3 показывает простой пример того, как выполнить пакетное обновление для удаления в настоящее время выбранные пункты. Блок передал performBatchUpdates:completion: метод сначала вызывает пользовательский метод обновить источник данных. Это тогда говорит представлению набора удалять элементы. И блок обновления и блок завершения, который Вы обеспечиваете, выполняются синхронно.

Перечисление 2-3  Удаляя выбранные пункты

[self.collectionView performBatchUpdates:^{

   NSArray* itemPaths = [self.collectionView indexPathsForSelectedItems];

   // Delete the items from the data source.

   [self deleteItemsFromDataSourceAtIndexPaths:itemPaths];

   // Now delete the items from the collection view.

   [self.collectionView deleteItemsAtIndexPaths:tempArray];

} completion:nil];

Управление визуальным состоянием для выборов и выделений

Выбор единственного элемента поддержки представлений набора по умолчанию и может быть сконфигурирован, чтобы поддерживать выбор многократного элемента или отключить выборы в целом. Представление набора обнаруживает касания в своих границах и выделяет или выбирает соответствующую ячейку соответственно. По большей части представление набора изменяет только свойства ячейки, чтобы указать, что оно выбрано или выделено; это не изменяет визуальное появление Ваших ячеек за одним исключением. Если ячейка selectedBackgroundView свойство содержит допустимое представление, представление набора показывает, что представление, когда ячейка выделена или выбрана.

Перечисление 2-4 показывает код, который мог быть включен в Вашу реализацию пользовательской ячейки представления набора для упрощения изменяющегося появления для выделенных и выбранных состояний. Ячейка backgroundView свойство всегда будет представлением по умолчанию, когда ячейка загрузится впервые и когда ячейка или не выделена или не выбрана. selectedBackgroundView свойство заменяет фоновое представление по умолчанию каждый раз, когда ячейка выделена или выбрана. В этом случае цвет фона ячейки был бы изменен от красного до белого, когда выбрано или выделено.

Перечисление 2-4  , Устанавливающее фон, просматривает для указания измененных состояний

UIView* backgroundView = [[UIView alloc] initWithFrame:self.bounds];

backgroundView.backgroundColor = [UIColor redColor];

self.backgroundView = backgroundView;

UIView* selectedBGView = [[UIView alloc] initWithFrame:self.bounds];

selectedBGView.backgroundColor = [UIColor whiteColor];

self.selectedBackgroundView = selectedBGView;

Делегат представления набора предоставляет представлению набора следующие методы для упрощения выделения и выбора:

• collectionView:shouldSelectItemAtIndexPath:

• collectionView:shouldDeselectItemAtIndexPath:

• collectionView:didSelectItemAtIndexPath:

• collectionView:didDeselectItemAtIndexPath:

• collectionView:shouldHighlightItemAtIndexPath:

• collectionView:didHighlightItemAtIndexPath:

• collectionView:didUnhighlightItemAtIndexPath:

Эти методы предоставляют Вам много возможностей настроить выделяющее/выбирающее поведение Вашего представления набора к точным желаемым спецификациям.

Например, если Вы предпочитаете рисовать состояние выбора ячейки сами, можно уехать selectedBackgroundView набор свойств к nil и примените любые визуальные изменения в ячейке с помощью объекта делегата. Вы применили бы визуальные изменения в collectionView:didSelectItemAtIndexPath:: метод и удаляет их в collectionView:didDeselectItemAtIndexPath: метод.

Если Вы предпочитаете рисовать выделение, утверждают себя, можно переопределить collectionView:didHighlightItemAtIndexPath: и collectionView:didUnhighlightItemAtIndexPath: методы делегата и используют их для применения выделений. Если Вы также указали представление в selectedBackgroundView свойство, необходимо внести изменения в представление содержания ячейки, чтобы гарантировать, что изменения видимы. Перечисление 2-5 показывает простой способ изменить выделение с помощью цвета фона представления содержания.

Перечисление 2-5  , Применяющее временное выделение к ячейке

- (void)collectionView:(UICollectionView *)colView didHighlightItemAtIndexPath:(NSIndexPath *)indexPath {

    UICollectionViewCell* cell = [colView cellForItemAtIndexPath:indexPath];

    cell.contentView.backgroundColor = [UIColor blueColor];

}

- (void)collectionView:(UICollectionView *)colView didUnhighlightItemAtIndexPath:(NSIndexPath *)indexPath {

    UICollectionViewCell* cell = [colView cellForItemAtIndexPath:indexPath];

    cell.contentView.backgroundColor = nil;

}

Существует тонкое, но важное различие между выделенным состоянием ячейки и его выбранным состоянием. Выделенное состояние является переходным состоянием, которое можно использовать для применения видимых выделений к ячейке, в то время как палец пользователя все еще касается устройства. Это состояние установлено в YES только, в то время как представление набора отслеживает сенсорные события по ячейке. Когда сенсорные события останавливаются, выделенное состояние возвращается к значению NO. В отличие от этого, выбранные изменения состояния только после серии сенсорных событий закончились — в частности, когда те сенсорные события указали, что пользователь попытался выбрать ячейку.

Рисунок 2-3 иллюстрирует серию шагов, происходящую, когда пользователь касается отменявшей ячейки. Начальное событие приземления заставляет представление набора изменять выделенное состояние ячейки к YES, несмотря на то, что выполнение так автоматически не изменяет появление ячейки. Если последний штрих событие имеет место в ячейке, выделенное состояние возвращается к NO и представление набора изменяет выбранное состояние на YES. Когда пользователь изменяет выбранное состояние, представление набора выводит на экран представление в ячейке selectedBackgroundView свойство, но это - единственное визуальное изменение, которое представление набора вносит в ячейку. Любые другие визуальные изменения должны быть внесены Вашим объектом делегата.

Выбирает ли пользователь или отменяет выбор ячейки, выбранное состояние ячейки всегда является последней вещью измениться. Касания в ячейке всегда приводят к изменениям в выделенном состоянии ячейки сначала. Только после того, как концы последовательности касания и любые выделения, примененные во время той последовательности, удалены, делает выбранное состояние изменения ячеек. При разработке ячеек необходимо удостовериться, что визуальное появление выделений и выбранного состояния не конфликтует непреднамеренными способами.

Показ меню редактирования для ячейки

Когда пользователь выполняет жест длинного касания на ячейке, представление набора пытается вывести на экран меню Edit для той ячейки. Меню Edit может использоваться, чтобы сократить, скопировать, и вставить ячейки в представлении набора. Нескольким условиям нужно удовлетворить, прежде чем меню Edit может быть выведено на экран:

• Делегат должен реализовать все три метода, связанные с обработкой действий:

  collectionView:shouldShowMenuForItemAtIndexPath:

  collectionView:canPerformAction:forItemAtIndexPath:withSender:

  collectionView:performAction:forItemAtIndexPath:withSender:

• collectionView:shouldShowMenuForItemAtIndexPath: метод должен возвратиться YES для обозначенной ячейки.

• collectionView:canPerformAction:forItemAtIndexPath:withSender: метод должен возвратиться YES для по крайней мере одного из желаемых действий. Представление набора поддерживает следующие действия:

  cut:

  copy:

  paste:

Если этим условиям удовлетворяют, и пользователь выбирает действие из меню, представление набора вызывает делегата collectionView:performAction:forItemAtIndexPath:withSender: метод для выполнения действия с обозначенным элементом.

Перечисление 2-6 показывает, как препятствовать тому, чтобы появился один из пунктов меню. В этом примере, collectionView:canPerformAction:forItemAtIndexPath:withSender: метод препятствует тому, чтобы пункт меню Cut появился в меню Edit. Это включает элементы Копии и Вставки так, чтобы пользователь мог вставить содержание.

Перечисление 2-6  , Выборочно запрещающее действия в меню Edit

- (BOOL)collectionView:(UICollectionView *)collectionView

        canPerformAction:(SEL)action

        forItemAtIndexPath:(NSIndexPath *)indexPath

        withSender:(id)sender {

   // Support only copying and pasting of cells.

   if ([NSStringFromSelector(action) isEqualToString:@"copy:"]

      || [NSStringFromSelector(action) isEqualToString:@"paste:"])

      return YES;

   // Prevent all other actions.

   return NO;

}

Для получения дополнительной информации о работе с командами области монтажа см. текстовое Руководство по программированию для iOS.

Переход между разметками

Самый простой способ перейти между разметками при помощи setCollectionViewLayout:animated: метод. Однако, если Вы требуете управления перехода или хотите, чтобы он был интерактивным, используйте a UICollectionViewTransitionLayout объект.

UICollectionViewTransitionLayout класс является специальным типом расположения, установленного как объект расположения представления набора при переходе к новому расположению. С объектом расположения перехода у Вас могут быть объекты, следуют за не линейным контуром, используют различный алгоритм синхронизации или перемещаются согласно входящим сенсорным событиям. Стандартный класс обеспечивает линейный переход к новому расположению, но как UICollectionViewLayout класс, UICollectionViewTransitionLayout класс может быть разделен на подклассы для создания любого желаемого эффекта. При этом необходимо реализовать те же методы, Вы были бы при создании пользовательского макета, и позвольте реализации адаптироваться для ввода от пользователя, чаще всего от устройства распознавания жеста. Для получения дополнительной информации о создании объектов пользовательского макета, посмотрите Пользовательские макеты Создания.

UICollectionViewLayout класс обеспечивает несколько методов для отслеживания перехода между разметками. UICollectionViewTransitionLayout объекты отслеживают завершение перехода через transitionProgress свойство. Поскольку переход происходит, Ваш код обновляет это свойство периодически для указания процента завершения перехода. Например, использование UICollectionViewTransitionLayout класс в сочетании с объектами как устройства распознавания жеста, которые можно использовать для перехода между разметками, позволяет Вам создавать интерактивные переходы. Также, если Вы реализуете пользовательский объект расположения перехода, UICollectionViewTransitionLayout класс обеспечивает два метода для отслеживания значений, относящихся к Вашему расположению: updateValue:forAnimatedKey: и valueForAnimatedKey: методы. Эти методы отслеживают специальные значения с плавающей точкой, которые можно установить и изменить во время перехода для передачи с важной информацией расположения. Например, если бы Вы перешли между разметками с помощью жеста повышения, то Вы могли бы использовать эти методы для сообщения объекта расположения перехода в том, что смещает потребность представления быть от друг друга.

Шаги для включения a UICollectionViewTransitionLayout объект в Вашем приложении следующие:

1. Создайте экземпляр стандартного класса или Вашего собственного класса с помощью initWithCurrentLayout:nextLayout: метод.

2. Передайте прогресс перехода путем периодического изменения transitionProgress свойство. Не забывайте лишать законной силы расположение с помощью представления набора invalidateLayout метод после изменения прогресса перехода.

3. Реализуйте collectionView:transitionLayoutForOldLayout:newLayout: метод в Вашем делегате представления набора и возвращает Ваш объект расположения перехода.

4. Дополнительно измените значения для своего расположения с помощью updateValue:forAnimatedKey: метод для указания измененных значений, относящихся к объекту расположения. Стабильное значение в этом случае 0.