mirror of
https://github.com/material-components/material-components-android.git
synced 2026-01-19 19:41:35 +08:00
108 lines
3.6 KiB
Java
108 lines
3.6 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 android.util.AttributeSet;
|
|
import androidx.annotation.NonNull;
|
|
import androidx.annotation.Nullable;
|
|
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);
|
|
}
|
|
|
|
@Override
|
|
protected boolean pickActiveThumb() {
|
|
if (getActiveThumbIndex() != -1) {
|
|
return true;
|
|
}
|
|
// Only one thumb to focus
|
|
setActiveThumbIndex(0);
|
|
return true;
|
|
}
|
|
}
|