mirror of
https://github.com/material-components/material-components-ios.git
synced 2026-02-20 08:27:32 +08:00
1080e89422
* [ActivityIndicator] Swift first in README * [AnimationTiming] Swift first in readme. * [AppBar] Swift first in readme. * [ButtonBar] Swift first in readme. * [Buttons] Swift first in readme. * [CollectionLayoutAttributes] Swift first in readme * [Collections] Swift first in readme. * [Dialogs] Swift first in readme. * [FeatureHighlight] Swift first in readme. * [FlexibleHeader] Swift first in readme. * [FontDiskLoader] Swift first in readme. * [HeaderStackView] Swift first in readme. * [Ink] Swift first in readme. * [NavigationBar] Swift first in readme. * [OverlayWindow] Adding missing site comments. Swift first in readme. * [PageControl] Swift first in readme. * [Palettes] Swift first in readme. * [ProgressView] Swift first in readme. * [RobotoFontLoader] Swift first in readme. * [ShadowElevations] Swift first in readme. * [ShadowLayer] Swift first in readme. * [Slider] Swift first in readme. * [Snackbar] Swift first in readme. * [SpritedAnimationView] Swift first in readme. * [Switch] Swift first in readme. * [Typography] Swift first in readme. * [ShadowLayer] Reducing font size in readme. * [Switch] Reducing font size in readme.
88 lines
2.4 KiB
Markdown
88 lines
2.4 KiB
Markdown
# Collection Layout Attributes
|
|
|
|
Allows passing layout attributes to the cells and supplementary views.
|
|
<!--{: .intro :}-->
|
|
|
|
### API Documentation
|
|
|
|
<ul class="icon-list">
|
|
<li class="icon-link"><a href="https://material-ext.appspot.com/mdc-ios-preview/components/CollectionLayoutAttributes/apidocs/Classes/MDCCollectionViewLayoutAttributes.html">MDCCollectionViewLayoutAttributes</a></li>
|
|
</ul>
|
|
|
|
- - -
|
|
|
|
## Installation
|
|
|
|
### Requirements
|
|
|
|
- Xcode 7.0 or higher.
|
|
- iOS SDK version 7.0 or higher.
|
|
|
|
### Installation with CocoaPods
|
|
|
|
To add this component to your Xcode project using CocoaPods, add the following to your `Podfile`:
|
|
|
|
~~~
|
|
pod 'MaterialComponents/CollectionLayoutAttributes'
|
|
~~~
|
|
|
|
Then, run the following command:
|
|
|
|
~~~ bash
|
|
pod install
|
|
~~~
|
|
|
|
- - -
|
|
|
|
## Usage
|
|
|
|
### Importing
|
|
|
|
Before using Collection Layout Attributes, you'll need to import it:
|
|
|
|
<!--<div class="material-code-render" markdown="1">-->
|
|
#### Swift
|
|
~~~ swift
|
|
import MaterialComponents.MaterialCollectionLayoutAttributes
|
|
~~~
|
|
|
|
#### Objective-C
|
|
~~~ objc
|
|
#import "MaterialCollectionLayoutAttributes.h"
|
|
~~~
|
|
<!--</div>-->
|
|
|
|
The `MDCCollectionViewLayoutAttributes` class allows passing properties to a cell from a collection
|
|
view layout. Override the `-applyLayoutAttributes` method of any `UICollectionReusableView` or
|
|
`UICollectionViewCell` subclasses, then apply any of the properties of the attributes class.
|
|
|
|
<!--<div class="material-code-render" markdown="1">-->
|
|
#### Swift
|
|
~~~ swift
|
|
override func applyLayoutAttributes(layoutAttributes: UICollectionViewLayoutAttributes) {
|
|
super.applyLayoutAttributes(layoutAttributes)
|
|
if let attr = layoutAttributes as? MDCCollectionViewLayoutAttributes {
|
|
if (attr.representedElementCategory == .Cell) {
|
|
|
|
// Example to set a background image to the cell background view.
|
|
self.backgroundView = UIImageView(image: attr.backgroundImage)
|
|
}
|
|
}
|
|
}
|
|
~~~
|
|
#### Objective-C
|
|
~~~ objc
|
|
- (void)applyLayoutAttributes:(UICollectionViewLayoutAttributes *)layoutAttributes {
|
|
[super applyLayoutAttributes:layoutAttributes];
|
|
if ([layoutAttributes isKindOfClass:[MDCCollectionViewLayoutAttributes class]]) {
|
|
MDCCollectionViewLayoutAttributes *attr = (MDCCollectionViewLayoutAttributes *)layoutAttributes;
|
|
if (attr.representedElementCategory == UICollectionElementCategoryCell) {
|
|
|
|
// Example to set a background image to the cell background view.
|
|
self.backgroundView = [[UIImageView alloc] initWithImage:attr.backgroundImage];
|
|
}
|
|
}
|
|
}
|
|
~~~
|
|
<!--</div>-->
|