mirror of
https://github.com/material-components/material-components-ios.git
synced 2026-02-20 08:27:32 +08:00
294643fc0b
* Add Slider appearance properties and enable UIAppearance. Adds `thumbRadius` and `thumbElevation` as UIAppearance properties. Makes `color`, `disabledColor`, and `trackBackgroundColor` UIAppearance-compatible. * Added unit tests for slider. * Remove infeasible coding unit test for now. * Line-length formatting. * Rename and condense color tests, sort by order that they appear in the header. * Rename tests and mark the thumb section. * Replace `_thumbTrack.thumbRadius` usage with `self.thumbRadius`. * Remove NSCoding-related helper, moved to another branch. * Search-and-replace mixup. * Line-length fixups.
Slider
The MDCSlider object is a Material Design control used to select a value from a continuous range
or discrete set of values.
Design & API Documentation
Installation
Installation with CocoaPods
To add this component to your Xcode project using CocoaPods, add the following to your Podfile:
pod 'MaterialComponents/Slider'
To add this component along with its themer and other related extensions, please add the following instead:
pod 'MaterialComponents/Slider+Extensions'
Then, run the following command:
pod install
Usage
Importing
Before using Slider, you'll need to import it:
Swift
import MaterialComponents.MaterialSlider
Objective-C
#import "MaterialSlider.h"
Standard usage
MDCSlider can be be used like a standard UIControl.
Swift
override func viewDidLoad() {
super.viewDidLoad()
let slider = MDCSlider(frame: CGRect(x: 50, y: 50, width: 100, height: 27))
slider.addTarget(self,
action: #selector(didChangeSliderValue(senderSlider:)),
for: .valueChanged)
view.addSubview(slider)
}
func didChangeSliderValue(senderSlider:MDCSlider) {
print("Did change slider value to: %@", senderSlider.value)
}
Objective C
- (void)viewDidLoad {
MDCSlider *slider = [[MDCSlider alloc] initWithFrame:CGRectMake(50, 50, 100, 27)];
[slider addTarget:self
action:@selector(didChangeSliderValue:)
forControlEvents:UIControlEventValueChanged];
[self.view addSubview:slider];
}
- (void)didChangeSliderValue:(MDCSlider *)slider {
NSLog(@"did change %@ value: %f", NSStringFromClass([slider class]), slider.value);
}
The differences between the UISlider class and the MDCSlider class:
Does not have api to:
- set right and left icons
- set the thumb image
- set the right and left track images (for a custom track)
- set the right (background track) color
Same features:
- set color for thumb via @c thumbColor
- set color of track via @c trackColor
New features:
- making the slider a snap to discrete values via property numberOfDiscreteValues