mirror of
https://github.com/material-components/material-components-ios.git
synced 2026-02-20 08:27:32 +08:00
61277455f1
Many of our color themers are accessing optional properties without first verifying that the color scheme responds to the selector. This can result in crashes. Instead, each optional property should be checked for safety before being used.
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