# TableViewSuite

This sample shows how to use UITableView and UITableViewController through a progression of increasingly advanced applications that display information about time zones.

## SimpleTableView

This example shows a simple list of the time zone names. It shows how to display a simple data set in a table view.

## SimpleSectionedTableView

This example shows the time zones split into sections by region, with the region name as the section heading. It shows how to create an indexed table view.

This example introduces custom wrapper classes to represent regions and time zones to help reduce the overhead of calculating the required information. The wrapper classes are shared across the remaining projects. 

## SimpleIndexedTableView

This example shows how to set up a table view to display an index. The time zones are separated into sections using UILocalizedIndexedCollation.

## TableViewCellSubviews

This example displays more information about each time zone, such as the time and relative day in that time zone. Its main aim is to show how you can customize a table view cell using subviews. The views are laid out using auto layout. 

Notice that the content compression resistance priority of the time field is increased slightly so that the region name field is narrowed if the name is too long (as might be the case with, for example, “Buenos Aires (Argentina)”).

### IMPORTANT

When implementing a table view cell, there's a tension between optimal scrolling performance and optimal edit/reordering performance. You should typically use subviews in the cell's content view (as illustrated by this sample).

When you have an edit or reordering control, using subviews makes the implementation easier, and the animations perform better because UIKit doesn't have to redraw during animations.

Subviews have two costs:

1. Initialization. This can be largely mitigated by reusing table cells.

2. Compositing. This can be largely mitigated by making the views opaque. Often, one translucent subview is fine, but more than one frequently causes frame drops while scrolling.

If the content is complex, however (more than about three subviews), scrolling performance may suffer. If this becomes a problem, you can instead draw directly in a subview of the table view cell's content view. CustomTableViewCell illustrates how to implement such behavior.

## CustomTableViewCell

This example is an extension of the fourth. It displays even more information about each time zone, such as the time and relative day in that time zone. Its shows how you can create a custom table view cell that contains a custom view that draws its content in -drawRect:.

## SelfSizingTableViewCell

This example also extends the fourth. It shows how to implement self sizing UITableViewCells with subviews and Auto Layout. A string with varying length (per time zone) is loaded into a multiline UITextField. The text field's height will vary depending on the length of the string it displays. NSLayoutConstraints force the height of the cell to fit to the height of the text field.

## REQUIREMENTS

### Build

Xcode 6 or later

### Runtime

iOS 8.0 or later

Copyright (C) 2008-2016 Apple Inc. All rights reserved.