mirror of
https://github.com/material-components/material-components-android.git
synced 2026-01-21 12:33:04 +08:00
8f0aa7f8d6
Slider throws an exception when calling getValue with more than one value. Supporting both single value and multiple values in the same class makes it confusing. While not supporting convenience methods getValue and setValue in the multi value class makes it, well, inconvenient. In addition min, max are also a bit ambiguous since seekBar uses these for valueFrom and valueTo so those were removed. PiperOrigin-RevId: 311774410
98 lines
3.4 KiB
Java
98 lines
3.4 KiB
Java
/*
|
|
* Copyright (C) 2019 The Android Open Source Project
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
package com.google.android.material.slider;
|
|
|
|
import com.google.android.material.R;
|
|
|
|
import android.content.Context;
|
|
import android.content.res.TypedArray;
|
|
import androidx.annotation.NonNull;
|
|
import androidx.annotation.Nullable;
|
|
import android.util.AttributeSet;
|
|
import com.google.android.material.slider.Slider.OnChangeListener;
|
|
import com.google.android.material.slider.Slider.OnSliderTouchListener;
|
|
|
|
/**
|
|
* A widget that allows picking a value within a given range by sliding a thumb along a horizontal
|
|
* line.
|
|
*
|
|
* <p>{@inheritDoc}
|
|
*
|
|
* <p>{@code android:value}: <b>Optional.</b> The initial value of the slider. If not specified, the
|
|
* slider's minimum value {@code android:valueFrom} is used.
|
|
*
|
|
* @attr ref com.google.android.material.R.styleable#SingleSlider_android_value
|
|
*/
|
|
public class Slider extends BaseSlider<Slider, OnChangeListener, OnSliderTouchListener> {
|
|
|
|
/** Interface definition for a callback invoked when a slider's value is changed. */
|
|
public interface OnChangeListener extends BaseOnChangeListener<Slider> {}
|
|
|
|
/**
|
|
* Interface definition for callbacks invoked when a slider's touch event is being
|
|
* started/stopped.
|
|
*/
|
|
public interface OnSliderTouchListener extends BaseOnSliderTouchListener<Slider> {}
|
|
|
|
public Slider(@NonNull Context context) {
|
|
this(context, null);
|
|
}
|
|
|
|
public Slider(@NonNull Context context, @Nullable AttributeSet attrs) {
|
|
this(context, attrs, R.attr.sliderStyle);
|
|
}
|
|
|
|
public Slider(@NonNull Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
|
|
super(context, attrs, defStyleAttr);
|
|
TypedArray a = context.obtainStyledAttributes(attrs, new int[] {android.R.attr.value});
|
|
if (a.hasValue(0)) {
|
|
setValue(a.getFloat(0, 0f));
|
|
}
|
|
a.recycle();
|
|
}
|
|
|
|
/**
|
|
* Returns the value of the slider.
|
|
*
|
|
* @see #setValue(float)
|
|
* @attr ref com.google.android.material.R.styleable#Slider_android_value
|
|
*/
|
|
public float getValue() {
|
|
return getValues().get(0);
|
|
}
|
|
|
|
/**
|
|
* Sets the value of the slider.
|
|
*
|
|
* <p>The thumb value must be greater or equal to {@code valueFrom}, and lesser or equal to {@code
|
|
* valueTo}. If that is not the case, an {@link IllegalStateException} will be thrown when the
|
|
* view is laid out.
|
|
*
|
|
* <p>If the slider is in discrete mode (i.e. the tick increment value is greater than 0), the
|
|
* thumb's value must be set to a value falls on a tick (i.e.: {@code value == valueFrom + x *
|
|
* stepSize}, where {@code x} is an integer equal to or greater than 0). If that is not the case,
|
|
* an {@link IllegalStateException} will be thrown when the view is laid out.
|
|
*
|
|
* @param value The value to which to set the slider
|
|
* @see #getValue()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_android_value
|
|
*/
|
|
public void setValue(float value) {
|
|
setValues(value);
|
|
}
|
|
}
|