insertRows(at:with:)
Inserts rows in the table view at the locations that an array of index paths identifies, with an option to animate the insertion.
Declaration
func insertRows(at indexPaths: [IndexPath], with animation: UITableView.RowAnimation)Parameters
- indexPaths:
An array of index path objects, each representing a row index and section index that together identify a row in the table view.
- animation:
A constant that either specifies the kind of animation to perform when inserting the cell or requests no animation. See Rowanimation for descriptions of the constants.
Discussion
UITableView calls the relevant delegate and data source methods immediately afterward to get the cells and other content for visible cells.
When this method is called in an animation block defined by the beginUpdates() and endUpdates() methods, UITableView defers any insertions of rows or sections until after it has handled the deletions of rows or sections. This order is followed regardless of how the insertion and deletion method calls are ordered. This is unlike inserting or removing an item in a mutable array, in which the operation can affect the array index used for the successive insertion or removal operation. For more on this subject, see Batch Insertion, Deletion, and Reloading of Rows and Sections in Table View Programming Guide for iOS.