Open Radar

 
Area:
UIKit

Summary:
When adding Drag & Drop support to our application, I noticed that the documentation to add D&D support to UICollectionView (https://developer.apple.com/documentation/uikit/views_and_controls/collection_views/supporting_drag_and_drop_in_collection_views) states that to provide a better user experience, placeholders should be used.

The documentation states that a placeholder should be inserted into the collection view calling -[UICollectionViewDropCoordinator dropItem:toPlaceholderInsertedAtIndexPath:withReuseIdentifier:cellUpdateHandler:]. However, the method name on the documentation is not a link anymore, and references to that API can't be found.

Also, I noticed that the header for UICollectionView, on the UICollectionViewDropCoordinator section, the documentation block for the method `-[UICollectionViewDropCoordinator dropItem:toPlaceholder]` still makes reference to parameters that should be present according to the documentation link provided above (indexPath, cellUpdateHandler).

Attached you can find a screenshot taken of UICollectionView.h on iOS 11.4 SDK.

Steps to Reproduce:

Try to add placeholders while performing a drop on UICollectionView following the official documentation.

Expected Results:

The method is available and the documentation is properly updated.

Actual Results:

The specified method for adding placeholders is not available on UICollectionViewDropCoordinator, and both the header and official docs still make reference to its existence.

Version/Build:

iOS 11.4/Xcode 9.4.1