mirror of
https://github.com/material-components/material-components-android.git
synced 2026-01-19 19:41:35 +08:00
340cdea60d
This includes support for Range slider when there is more than one thumb. Each thumb can receive focus and behaves as if it was it's own SeekBar. Resolves https://github.com/material-components/material-components-android/issues/827 PiperOrigin-RevId: 294681995
2229 lines
76 KiB
Java
2229 lines
76 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 static com.google.android.material.theme.overlay.MaterialThemeOverlay.wrap;
|
|
|
|
import android.content.Context;
|
|
import android.content.res.ColorStateList;
|
|
import android.content.res.Resources;
|
|
import android.content.res.TypedArray;
|
|
import android.graphics.Canvas;
|
|
import android.graphics.Paint;
|
|
import android.graphics.Paint.Cap;
|
|
import android.graphics.Paint.Style;
|
|
import android.graphics.PorterDuff.Mode;
|
|
import android.graphics.PorterDuffXfermode;
|
|
import android.graphics.Rect;
|
|
import android.graphics.Region.Op;
|
|
import android.graphics.drawable.Drawable;
|
|
import android.graphics.drawable.RippleDrawable;
|
|
import android.os.Build.VERSION;
|
|
import android.os.Build.VERSION_CODES;
|
|
import android.os.Bundle;
|
|
import android.os.Parcel;
|
|
import android.os.Parcelable;
|
|
import androidx.annotation.ColorInt;
|
|
import androidx.annotation.DimenRes;
|
|
import androidx.annotation.Dimension;
|
|
import androidx.annotation.IntDef;
|
|
import androidx.annotation.IntRange;
|
|
import androidx.annotation.NonNull;
|
|
import androidx.annotation.Nullable;
|
|
import androidx.annotation.VisibleForTesting;
|
|
import androidx.core.graphics.drawable.DrawableCompat;
|
|
import androidx.core.math.MathUtils;
|
|
import androidx.core.view.ViewCompat;
|
|
import androidx.core.view.accessibility.AccessibilityNodeInfoCompat;
|
|
import androidx.core.view.accessibility.AccessibilityNodeInfoCompat.RangeInfoCompat;
|
|
import androidx.customview.widget.ExploreByTouchHelper;
|
|
import androidx.appcompat.content.res.AppCompatResources;
|
|
import android.util.AttributeSet;
|
|
import android.util.Log;
|
|
import android.view.InflateException;
|
|
import android.view.KeyEvent;
|
|
import android.view.MotionEvent;
|
|
import android.view.View;
|
|
import android.view.ViewConfiguration;
|
|
import android.view.ViewGroup;
|
|
import android.view.ViewParent;
|
|
import android.view.accessibility.AccessibilityEvent;
|
|
import android.view.accessibility.AccessibilityManager;
|
|
import android.widget.SeekBar;
|
|
import com.google.android.material.drawable.DrawableUtils;
|
|
import com.google.android.material.internal.DescendantOffsetUtils;
|
|
import com.google.android.material.internal.ThemeEnforcement;
|
|
import com.google.android.material.internal.ViewUtils;
|
|
import com.google.android.material.resources.MaterialResources;
|
|
import com.google.android.material.shape.CornerFamily;
|
|
import com.google.android.material.shape.MaterialShapeDrawable;
|
|
import com.google.android.material.shape.ShapeAppearanceModel;
|
|
import com.google.android.material.tooltip.TooltipDrawable;
|
|
import java.lang.annotation.Retention;
|
|
import java.lang.annotation.RetentionPolicy;
|
|
import java.util.ArrayList;
|
|
import java.util.Collections;
|
|
import java.util.Iterator;
|
|
import java.util.List;
|
|
import java.util.Locale;
|
|
|
|
/**
|
|
* A widget that allows picking a value (or a set of values) within a given range by sliding a thumb
|
|
* along a horizontal line.
|
|
*
|
|
* <p>The slider can function either as a continuous slider, or as a discrete slider. The mode of
|
|
* operation is controlled by the value of the step size. If the step size is set to 0, the slider
|
|
* operates as a continuous slider where the slider's thumb can be moved to any position along the
|
|
* horizontal line. If the step size is set to a number greater than 0, the slider operates as a
|
|
* discrete slider where the slider's thumb will snap to the closest valid value. See {@link
|
|
* #setStepSize(float)}.
|
|
*
|
|
* <p>The {@link OnChangeListener} interface defines a callback to be invoked when the slider
|
|
* changes.
|
|
*
|
|
* <p>The {@link LabelFormatter} interface defines a formatter to be used to render text within the
|
|
* value indicator label on interaction.
|
|
*
|
|
* <p>{@link BasicLabelFormatter} is a simple implementation of the {@link LabelFormatter} that
|
|
* displays the selected value using letters to indicate magnitude (e.g.: 1.5K, 3M, 12B, etc..).
|
|
*
|
|
* <p>With the default style {@link
|
|
* com.google.android.material.R.style.Widget_MaterialComponents_Slider}, colorPrimary and
|
|
* colorOnPrimary are used to customize the color of the slider when enabled, and colorOnSurface is
|
|
* used when disabled. The following attributes are used to customize the slider's appearance
|
|
* further:
|
|
*
|
|
* <ul>
|
|
* <li>{@code haloColor}: the color of the halo around the thumb.
|
|
* <li>{@code haloRadius}: The radius of the halo around the thumb.
|
|
* <li>{@code labelBehavior}: The behavior of the label which can be {@code LABEL_FLOATING},
|
|
* {@code LABEL_WITHIN_BOUNDS}, or {@code LABEL_GONE}. See {@link LabelBehavior} for more
|
|
* information.
|
|
* <li>{@code labelStyle}: the style to apply to the value indicator {@link TooltipDrawable}.
|
|
* <li>{@code thumbColor}: the color of the slider's thumb.
|
|
* <li>{@code thumbElevation}: the elevation of the slider's thumb.
|
|
* <li>{@code thumbRadius}: The radius of the slider's thumb.
|
|
* <li>{@code tickColorActive}: the color of the slider's tick marks for the active part of the
|
|
* track. Only used when the slider is in discrete mode.
|
|
* <li>{@code tickColorInactive}: the color of the slider's tick marks for the inactive part of
|
|
* the track. Only used when the slider is in discrete mode.
|
|
* <li>{@code tickColor}: the color of the slider's tick marks. Only used when the slider is in
|
|
* discrete mode. This is a short hand for setting both the {@code tickColorActive} and {@code
|
|
* tickColorInactive} to the same thing. This takes precedence over {@code tickColorActive}
|
|
* and {@code tickColorInactive}.
|
|
* <li>{@code trackColorActive}: The color of the active part of the track.
|
|
* <li>{@code trackColorInactive}: The color of the inactive part of the track.
|
|
* <li>{@code trackColor}: The color of the whole track. This is a short hand for setting both the
|
|
* {@code trackColorActive} and {@code trackColorInactive} to the same thing. This takes
|
|
* precedence over {@code trackColorActive} and {@code trackColorInactive}.
|
|
* <li>{@code trackHeight}: The height of the track.
|
|
* </ul>
|
|
*
|
|
* <p>The following XML attributes are used to set the slider's various parameters of operation:
|
|
*
|
|
* <ul>
|
|
* <li>{@code android:valueFrom}: <b>Required.</b> The slider's minimum value. This attribute is
|
|
* required, if missing, an {@link InflateException} is thrown.
|
|
* <li>{@code android:valueTo}: <b>Required.</b> The slider's maximum value. This attribute is
|
|
* required, if missing, an {@link InflateException} is thrown.
|
|
* <li>{@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.
|
|
* <li>{@code android:stepSize}: <b>Optional.</b> This value dictates whether the slider operates
|
|
* in continuous mode, or in discrete mode. If missing or equal to 0, the slider operates in
|
|
* continuous mode. If greater than 0 and evenly divides the range described by {@code
|
|
* valueFrom} and {@code valueTo}, the slider operates in discrete mode. If negative, or
|
|
* greater than 0 but not a factor of the range described by {@code valueFrom} and {@code
|
|
* valueTo}, an {@link IllegalArgumentException} is thrown.
|
|
* </ul>
|
|
*
|
|
* @attr ref com.google.android.material.R.styleable#Slider_android_stepSize
|
|
* @attr ref com.google.android.material.R.styleable#Slider_android_value
|
|
* @attr ref com.google.android.material.R.styleable#Slider_android_valueFrom
|
|
* @attr ref com.google.android.material.R.styleable#Slider_android_valueTo
|
|
* @attr ref com.google.android.material.R.styleable#Slider_haloColor
|
|
* @attr ref com.google.android.material.R.styleable#Slider_haloRadius
|
|
* @attr ref com.google.android.material.R.styleable#Slider_labelBehavior
|
|
* @attr ref com.google.android.material.R.styleable#Slider_labelStyle
|
|
* @attr ref com.google.android.material.R.styleable#Slider_thumbColor
|
|
* @attr ref com.google.android.material.R.styleable#Slider_thumbElevation
|
|
* @attr ref com.google.android.material.R.styleable#Slider_thumbRadius
|
|
* @attr ref com.google.android.material.R.styleable#Slider_tickColor
|
|
* @attr ref com.google.android.material.R.styleable#Slider_tickColorActive
|
|
* @attr ref com.google.android.material.R.styleable#Slider_tickColorInactive
|
|
* @attr ref com.google.android.material.R.styleable#Slider_trackColor
|
|
* @attr ref com.google.android.material.R.styleable#Slider_trackColorActive
|
|
* @attr ref com.google.android.material.R.styleable#Slider_trackColorInactive
|
|
* @attr ref com.google.android.material.R.styleable#Slider_trackHeight
|
|
*/
|
|
public class Slider extends View {
|
|
|
|
private static final String TAG = Slider.class.getSimpleName();
|
|
private static final String EXCEPTION_ILLEGAL_VALUE =
|
|
"Slider value must be greater or equal to valueFrom, and lower or equal to valueTo";
|
|
private static final String EXCEPTION_ILLEGAL_DISCRETE_VALUE =
|
|
"Value must be equal to valueFrom plus a multiple of stepSize when using stepSize";
|
|
private static final String EXCEPTION_ILLEGAL_VALUE_FROM =
|
|
"valueFrom must be smaller than valueTo";
|
|
private static final String EXCEPTION_ILLEGAL_VALUE_TO = "valueTo must be greater than valueFrom";
|
|
private static final String EXCEPTION_ILLEGAL_STEP_SIZE =
|
|
"The stepSize must be 0, or a factor of the valueFrom-valueTo range";
|
|
|
|
private static final int TIMEOUT_SEND_ACCESSIBILITY_EVENT = 200;
|
|
private static final int HALO_ALPHA = 63;
|
|
private static final double THRESHOLD = .0001;
|
|
|
|
private static final int DEF_STYLE_RES = R.style.Widget_MaterialComponents_Slider;
|
|
|
|
@NonNull private final Paint inactiveTrackPaint;
|
|
@NonNull private final Paint activeTrackPaint;
|
|
@NonNull private final Paint thumbPaint;
|
|
@NonNull private final Paint haloPaint;
|
|
@NonNull private final Paint inactiveTicksPaint;
|
|
@NonNull private final Paint activeTicksPaint;
|
|
@NonNull private final AccessibilityHelper accessibilityHelper;
|
|
private final AccessibilityManager accessibilityManager;
|
|
private AccessibilityEventSender accessibilityEventSender;
|
|
|
|
private interface TooltipDrawableFactory {
|
|
TooltipDrawable createTooltipDrawable();
|
|
}
|
|
|
|
@NonNull private final TooltipDrawableFactory labelMaker;
|
|
@NonNull private final List<TooltipDrawable> labels = new ArrayList<>();
|
|
@NonNull private final List<OnChangeListener> changeListeners = new ArrayList<>();
|
|
@NonNull private final List<OnSliderTouchListener> touchListeners = new ArrayList<>();
|
|
|
|
private final int scaledTouchSlop;
|
|
|
|
private int widgetHeight;
|
|
private int labelBehavior;
|
|
private int trackHeight;
|
|
private int trackSidePadding;
|
|
private int trackTop;
|
|
private int thumbRadius;
|
|
private int haloRadius;
|
|
private int labelPadding;
|
|
private float touchDownX;
|
|
private LabelFormatter formatter;
|
|
private boolean thumbIsPressed = false;
|
|
private float valueFrom;
|
|
private float valueTo;
|
|
// Holds the values set to this slider. We keep this array sorted in order to check if the value
|
|
// has been changed when a new value is set and to find the minimum and maximum values.
|
|
private ArrayList<Float> values = new ArrayList<>();
|
|
// The index of the currently touched thumb.
|
|
private int activeThumbIdx = -1;
|
|
// The index of the currently focused thumb.
|
|
private int focusedThumbIdx = -1;
|
|
private float stepSize = 0.0f;
|
|
private float[] ticksCoordinates;
|
|
private int trackWidth;
|
|
private boolean forceDrawCompatHalo;
|
|
private boolean isLongPress = false;
|
|
|
|
@NonNull private ColorStateList haloColor;
|
|
@NonNull private ColorStateList tickColorActive;
|
|
@NonNull private ColorStateList tickColorInactive;
|
|
@NonNull private ColorStateList trackColorActive;
|
|
@NonNull private ColorStateList trackColorInactive;
|
|
|
|
@NonNull private final MaterialShapeDrawable thumbDrawable = new MaterialShapeDrawable();
|
|
|
|
public static final int LABEL_FLOATING = 0;
|
|
public static final int LABEL_WITHIN_BOUNDS = 1;
|
|
public static final int LABEL_GONE = 2;
|
|
private float touchPosition;
|
|
|
|
/**
|
|
* Determines the behavior of the label which can be any of the following.
|
|
*
|
|
* <ul>
|
|
* <li>{@code LABEL_FLOATING}: The label will only be visible on interaction. It will float
|
|
* above the slider and may cover views above this one. This is the default and recommended
|
|
* behavior.
|
|
* <li>{@code LABEL_WITHIN_BOUNDS}: The label will only be visible on interaction. The label
|
|
* will always be drawn within the bounds of this view. This means extra space will be
|
|
* visible above the slider when the label is not visible.
|
|
* <li>{@code LABEL_GONE}: The label will never be drawn.
|
|
* </ul>
|
|
*/
|
|
@IntDef({LABEL_FLOATING, LABEL_WITHIN_BOUNDS, LABEL_GONE})
|
|
@Retention(RetentionPolicy.SOURCE)
|
|
public @interface LabelBehavior {}
|
|
|
|
/** Interface definition for a callback invoked when a slider's value is changed. */
|
|
public interface OnChangeListener {
|
|
|
|
/**
|
|
* Called when the value of the slider changes. If multiple values are set at the same time
|
|
* (i.e. from calling {@link #setValues(List)}) this method will be called once for each value.
|
|
*
|
|
* @see #getValues()
|
|
* @see #getMinimumValue()
|
|
* @see #getMaximumValue()
|
|
*/
|
|
void onValueChange(@NonNull Slider slider, float value, boolean fromUser);
|
|
}
|
|
|
|
/**
|
|
* Interface definition for callbacks invoked when a slider's touch event is being
|
|
* started/stopped.
|
|
*/
|
|
public interface OnSliderTouchListener {
|
|
void onStartTrackingTouch(@NonNull Slider slider);
|
|
|
|
void onStopTrackingTouch(@NonNull Slider slider);
|
|
}
|
|
|
|
/**
|
|
* Interface definition for applying custom formatting to the text displayed inside the bubble
|
|
* shown when a slider is used in discrete mode.
|
|
*/
|
|
public interface LabelFormatter {
|
|
@NonNull
|
|
String getFormattedValue(float value);
|
|
}
|
|
|
|
/**
|
|
* A simple implementation of the {@link LabelFormatter} interface, that limits the number
|
|
* displayed inside a discrete slider's bubble to three digits, and a single-character suffix that
|
|
* denotes magnitude (e.g.: 1.5K, 2.2M, 1.3B, 2T).
|
|
*/
|
|
public static final class BasicLabelFormatter implements LabelFormatter {
|
|
|
|
private static final long TRILLION = 1000000000000L;
|
|
private static final int BILLION = 1000000000;
|
|
private static final int MILLION = 1000000;
|
|
private static final int THOUSAND = 1000;
|
|
|
|
@NonNull
|
|
@Override
|
|
public String getFormattedValue(float value) {
|
|
if (value >= TRILLION) {
|
|
return String.format(Locale.US, "%.1fT", value / TRILLION);
|
|
} else if (value >= BILLION) {
|
|
return String.format(Locale.US, "%.1fB", value / BILLION);
|
|
} else if (value >= MILLION) {
|
|
return String.format(Locale.US, "%.1fM", value / MILLION);
|
|
} else if (value >= THOUSAND) {
|
|
return String.format(Locale.US, "%.1fK", value / THOUSAND);
|
|
} else {
|
|
return String.format(Locale.US, "%.0f", value);
|
|
}
|
|
}
|
|
}
|
|
|
|
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 final AttributeSet attrs, final int defStyleAttr) {
|
|
super(wrap(context, attrs, defStyleAttr, DEF_STYLE_RES), attrs, defStyleAttr);
|
|
// Ensure we are using the correctly themed context rather than the context that was passed in.
|
|
context = getContext();
|
|
|
|
inactiveTrackPaint = new Paint();
|
|
inactiveTrackPaint.setStyle(Style.STROKE);
|
|
inactiveTrackPaint.setStrokeCap(Cap.ROUND);
|
|
|
|
activeTrackPaint = new Paint();
|
|
activeTrackPaint.setStyle(Style.STROKE);
|
|
activeTrackPaint.setStrokeCap(Cap.ROUND);
|
|
|
|
thumbPaint = new Paint(Paint.ANTI_ALIAS_FLAG);
|
|
thumbPaint.setStyle(Style.FILL);
|
|
thumbPaint.setXfermode(new PorterDuffXfermode(Mode.CLEAR));
|
|
|
|
haloPaint = new Paint(Paint.ANTI_ALIAS_FLAG);
|
|
haloPaint.setStyle(Style.FILL);
|
|
|
|
inactiveTicksPaint = new Paint();
|
|
inactiveTicksPaint.setStyle(Style.STROKE);
|
|
inactiveTicksPaint.setStrokeCap(Cap.ROUND);
|
|
|
|
activeTicksPaint = new Paint();
|
|
activeTicksPaint.setStyle(Style.STROKE);
|
|
activeTicksPaint.setStrokeCap(Cap.ROUND);
|
|
|
|
loadResources(context.getResources());
|
|
|
|
// Because there's currently no way to copy the TooltipDrawable we use this to make more if more
|
|
// thumbs are added.
|
|
labelMaker =
|
|
new TooltipDrawableFactory() {
|
|
@Override
|
|
public TooltipDrawable createTooltipDrawable() {
|
|
final TypedArray a =
|
|
ThemeEnforcement.obtainStyledAttributes(
|
|
getContext(), attrs, R.styleable.Slider, defStyleAttr, DEF_STYLE_RES);
|
|
TooltipDrawable d = parseLabelDrawable(getContext(), a);
|
|
a.recycle();
|
|
return d;
|
|
}
|
|
};
|
|
|
|
processAttributes(context, attrs, defStyleAttr);
|
|
|
|
setFocusable(true);
|
|
|
|
// Set up the thumb drawable to always show the compat shadow.
|
|
thumbDrawable.setShadowCompatibilityMode(MaterialShapeDrawable.SHADOW_COMPAT_MODE_ALWAYS);
|
|
|
|
scaledTouchSlop = ViewConfiguration.get(context).getScaledTouchSlop();
|
|
|
|
accessibilityHelper = new AccessibilityHelper();
|
|
ViewCompat.setAccessibilityDelegate(this, accessibilityHelper);
|
|
|
|
accessibilityManager =
|
|
(AccessibilityManager) getContext().getSystemService(Context.ACCESSIBILITY_SERVICE);
|
|
}
|
|
|
|
private void loadResources(@NonNull Resources resources) {
|
|
widgetHeight = resources.getDimensionPixelSize(R.dimen.mtrl_slider_widget_height);
|
|
|
|
trackSidePadding = resources.getDimensionPixelOffset(R.dimen.mtrl_slider_track_side_padding);
|
|
trackTop = resources.getDimensionPixelOffset(R.dimen.mtrl_slider_track_top);
|
|
|
|
labelPadding = resources.getDimensionPixelSize(R.dimen.mtrl_slider_label_padding);
|
|
}
|
|
|
|
private void processAttributes(Context context, AttributeSet attrs, int defStyleAttr) {
|
|
TypedArray a =
|
|
ThemeEnforcement.obtainStyledAttributes(
|
|
context, attrs, R.styleable.Slider, defStyleAttr, DEF_STYLE_RES);
|
|
valueFrom = a.getFloat(R.styleable.Slider_android_valueFrom, 0.0f);
|
|
valueTo = a.getFloat(R.styleable.Slider_android_valueTo, 1.0f);
|
|
setValue(a.getFloat(R.styleable.Slider_android_value, valueFrom));
|
|
stepSize = a.getFloat(R.styleable.Slider_android_stepSize, 0.0f);
|
|
|
|
boolean hasTrackColor = a.hasValue(R.styleable.Slider_trackColor);
|
|
|
|
int trackColorInactiveRes =
|
|
hasTrackColor ? R.styleable.Slider_trackColor : R.styleable.Slider_trackColorInactive;
|
|
int trackColorActiveRes =
|
|
hasTrackColor ? R.styleable.Slider_trackColor : R.styleable.Slider_trackColorActive;
|
|
|
|
ColorStateList trackColorInactive =
|
|
MaterialResources.getColorStateList(context, a, trackColorInactiveRes);
|
|
setTrackColorInactive(
|
|
trackColorInactive != null
|
|
? trackColorInactive
|
|
: AppCompatResources.getColorStateList(
|
|
context, R.color.material_slider_inactive_track_color));
|
|
ColorStateList trackColorActive =
|
|
MaterialResources.getColorStateList(context, a, trackColorActiveRes);
|
|
setTrackColorActive(
|
|
trackColorActive != null
|
|
? trackColorActive
|
|
: AppCompatResources.getColorStateList(
|
|
context, R.color.material_slider_active_track_color));
|
|
ColorStateList thumbColor =
|
|
MaterialResources.getColorStateList(context, a, R.styleable.Slider_thumbColor);
|
|
thumbDrawable.setFillColor(thumbColor);
|
|
ColorStateList haloColor =
|
|
MaterialResources.getColorStateList(context, a, R.styleable.Slider_haloColor);
|
|
setHaloColor(
|
|
haloColor != null
|
|
? haloColor
|
|
: AppCompatResources.getColorStateList(context, R.color.material_slider_halo_color));
|
|
|
|
boolean hasTickColor = a.hasValue(R.styleable.Slider_tickColor);
|
|
int tickColorInactiveRes =
|
|
hasTickColor ? R.styleable.Slider_tickColor : R.styleable.Slider_tickColorInactive;
|
|
int tickColorActiveRes =
|
|
hasTickColor ? R.styleable.Slider_tickColor : R.styleable.Slider_tickColorActive;
|
|
ColorStateList tickColorInactive =
|
|
MaterialResources.getColorStateList(context, a, tickColorInactiveRes);
|
|
setTickColorInactive(
|
|
tickColorInactive != null
|
|
? tickColorInactive
|
|
: AppCompatResources.getColorStateList(
|
|
context, R.color.material_slider_inactive_tick_marks_color));
|
|
ColorStateList tickColorActive =
|
|
MaterialResources.getColorStateList(context, a, tickColorActiveRes);
|
|
setTickColorActive(
|
|
tickColorActive != null
|
|
? tickColorActive
|
|
: AppCompatResources.getColorStateList(
|
|
context, R.color.material_slider_active_tick_marks_color));
|
|
|
|
setThumbRadius(a.getDimensionPixelSize(R.styleable.Slider_thumbRadius, 0));
|
|
setHaloRadius(a.getDimensionPixelSize(R.styleable.Slider_haloRadius, 0));
|
|
|
|
setThumbElevation(a.getDimension(R.styleable.Slider_thumbElevation, 0));
|
|
|
|
setTrackHeight(a.getDimensionPixelSize(R.styleable.Slider_trackHeight, 0));
|
|
|
|
labelBehavior = a.getInt(R.styleable.Slider_labelBehavior, LABEL_FLOATING);
|
|
a.recycle();
|
|
|
|
validateValueFrom();
|
|
validateValueTo();
|
|
validateStepSize();
|
|
}
|
|
|
|
@NonNull
|
|
private static TooltipDrawable parseLabelDrawable(
|
|
@NonNull Context context, @NonNull TypedArray a) {
|
|
return TooltipDrawable.createFromAttributes(
|
|
context,
|
|
null,
|
|
0,
|
|
a.getResourceId(R.styleable.Slider_labelStyle, R.style.Widget_MaterialComponents_Tooltip));
|
|
}
|
|
|
|
private void validateValueFrom() {
|
|
if (valueFrom >= valueTo) {
|
|
Log.e(TAG, EXCEPTION_ILLEGAL_VALUE_FROM);
|
|
throw new IllegalArgumentException(EXCEPTION_ILLEGAL_VALUE_FROM);
|
|
}
|
|
}
|
|
|
|
private void validateValueTo() {
|
|
if (valueTo <= valueFrom) {
|
|
Log.e(TAG, EXCEPTION_ILLEGAL_VALUE_TO);
|
|
throw new IllegalArgumentException(EXCEPTION_ILLEGAL_VALUE_TO);
|
|
}
|
|
}
|
|
|
|
private void validateStepSize() {
|
|
if (stepSize < 0.0f) {
|
|
Log.e(TAG, EXCEPTION_ILLEGAL_STEP_SIZE);
|
|
throw new IllegalArgumentException(EXCEPTION_ILLEGAL_STEP_SIZE);
|
|
} else if (stepSize > 0.0f && ((valueTo - valueFrom) / stepSize) % 1 > THRESHOLD) {
|
|
Log.e(TAG, EXCEPTION_ILLEGAL_STEP_SIZE);
|
|
throw new IllegalArgumentException(EXCEPTION_ILLEGAL_STEP_SIZE);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the slider's {@code valueFrom} value.
|
|
*
|
|
* @see #setValueFrom(float)
|
|
* @attr ref com.google.android.material.R.styleable#Slider_android_valueFrom
|
|
*/
|
|
public float getValueFrom() {
|
|
return valueFrom;
|
|
}
|
|
|
|
/**
|
|
* Sets the slider's {@code valueFrom} value.
|
|
*
|
|
* <p>The {@code valueFrom} value must be strictly lower than the {@code valueTo} value. If that
|
|
* is not the case, an {@link IllegalArgumentException} will be thrown.
|
|
*
|
|
* @param valueFrom The minimum value for the slider's range of values
|
|
* @throws IllegalArgumentException If {@code valueFrom} is greater or equal to {@code valueTo}
|
|
* @see #getValueFrom()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_android_valueFrom
|
|
*/
|
|
public void setValueFrom(float valueFrom) {
|
|
this.valueFrom = valueFrom;
|
|
validateValueFrom();
|
|
}
|
|
|
|
/**
|
|
* Returns the slider's {@code valueTo} value.
|
|
*
|
|
* @see #setValueTo(float)
|
|
* @attr ref com.google.android.material.R.styleable#Slider_android_valueTo
|
|
*/
|
|
public float getValueTo() {
|
|
return valueTo;
|
|
}
|
|
|
|
/**
|
|
* Sets the slider's {@code valueTo} value.
|
|
*
|
|
* <p>The {@code valueTo} value must be strictly greater than the {@code valueFrom} value. If that
|
|
* is not the case, an {@link IllegalArgumentException} will be thrown.
|
|
*
|
|
* @param valueTo The maximum value for the slider's range of values
|
|
* @throws IllegalArgumentException If {@code valueTo} is lesser or equal to {@code valueFrom}
|
|
* @see #getValueTo()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_android_valueTo
|
|
*/
|
|
public void setValueTo(float valueTo) {
|
|
this.valueTo = valueTo;
|
|
validateValueTo();
|
|
}
|
|
|
|
/**
|
|
* Returns the value of the slider.
|
|
*
|
|
* @throws IllegalStateException If more than one value is set on the Slider
|
|
* @see #setValue(float)
|
|
* @see #setValues(List<Float>)
|
|
* @attr ref com.google.android.material.R.styleable#Slider_android_value
|
|
*/
|
|
public float getValue() {
|
|
if (values.size() > 1) {
|
|
throw new IllegalStateException(
|
|
"More than one value is set on the Slider. Use getValues() instead.");
|
|
}
|
|
return values.get(0);
|
|
}
|
|
|
|
@NonNull
|
|
public List<Float> getValues() {
|
|
return new ArrayList<>(values);
|
|
}
|
|
|
|
/**
|
|
* 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 IllegalArgumentException} will be thrown.
|
|
*
|
|
* <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 IllegalArgumentException} will be thrown.
|
|
*
|
|
* @param value The value to which to set the slider
|
|
* @throws IllegalArgumentException If the value is not within {@code valueFrom} and {@code
|
|
* valueTo}. If stepSize is greater than 0 and value does not fall on a tick
|
|
* @see #getValue()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_android_value
|
|
*/
|
|
public void setValue(float value) {
|
|
setValues(value);
|
|
}
|
|
|
|
/**
|
|
* Sets multiple values for the slider. Each value will represent a different thumb.
|
|
*
|
|
* <p>Each value must be greater or equal to {@code valueFrom}, and lesser or equal to {@code
|
|
* valueTo}. If that is not the case, an {@link IllegalArgumentException} will be thrown.
|
|
*
|
|
* <p>If the slider is in discrete mode (i.e. the tick increment value is greater than 0), the
|
|
* values 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
|
|
* IllegalArgumentException} will be thrown.
|
|
*
|
|
* @param values An array of values to set.
|
|
* @throws IllegalArgumentException If the value is not within {@code valueFrom} and {@code
|
|
* valueTo}. If stepSize is greater than 0 and value does not fall on a tick
|
|
* @see #getValues()
|
|
*/
|
|
public void setValues(@NonNull Float... values) {
|
|
ArrayList<Float> list = new ArrayList<>();
|
|
Collections.addAll(list, values);
|
|
setValuesInternal(list);
|
|
}
|
|
|
|
/**
|
|
* Sets multiple values for the slider. Each value will represent a different thumb.
|
|
*
|
|
* <p>Each value must be greater or equal to {@code valueFrom}, and lesser or equal to {@code
|
|
* valueTo}. If that is not the case, an {@link IllegalArgumentException} will be thrown.
|
|
*
|
|
* <p>If the slider is in discrete mode (i.e. the tick increment value is greater than 0), the
|
|
* values 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
|
|
* IllegalArgumentException} will be thrown.
|
|
*
|
|
* @param values An array of values to set.
|
|
* @throws IllegalArgumentException If the value is not within {@code valueFrom} and {@code
|
|
* valueTo}. If stepSize is greater than 0 and value does not fall on a tick
|
|
* @throws IllegalArgumentException If {@values} is empty.
|
|
* @see #getValues()
|
|
*/
|
|
public void setValues(@NonNull List<Float> values) {
|
|
setValuesInternal(new ArrayList<>(values));
|
|
}
|
|
|
|
/**
|
|
* This method assumes the list passed in is a copy. It is split out so we can call it from {@link
|
|
* #setValues(Float...)} and {@link #setValues(List)}
|
|
*/
|
|
private void setValuesInternal(@NonNull ArrayList<Float> values) {
|
|
if (values.isEmpty()) {
|
|
throw new IllegalArgumentException("At least one value must be set");
|
|
}
|
|
|
|
Collections.sort(values);
|
|
|
|
if (this.values.size() == values.size()) {
|
|
if (this.values.equals(values)) {
|
|
return;
|
|
}
|
|
}
|
|
|
|
for (float value : values) {
|
|
if (!isValueValid(value)) {
|
|
return;
|
|
}
|
|
}
|
|
|
|
this.values = values;
|
|
// Only update the focused thumb index. The active thumb index will be updated on touch.
|
|
focusedThumbIdx = 0;
|
|
updateHaloHotspot();
|
|
createLabelPool();
|
|
dispatchOnChangedProgramatically();
|
|
invalidate();
|
|
}
|
|
|
|
private void createLabelPool() {
|
|
// If there are too many labels, remove the extra ones from the end.
|
|
if (labels.size() > values.size()) {
|
|
labels.subList(values.size(), labels.size()).clear();
|
|
}
|
|
|
|
// If there's not enough labels, add more.
|
|
while (labels.size() < values.size()) {
|
|
labels.add(labelMaker.createTooltipDrawable());
|
|
}
|
|
|
|
// Add a stroke if there is more than one label for when they overlap.
|
|
int strokeWidth = labels.size() == 1 ? 0 : 1;
|
|
for (TooltipDrawable label : labels) {
|
|
label.setStrokeWidth(strokeWidth);
|
|
}
|
|
}
|
|
|
|
private boolean isValueValid(float value) {
|
|
if (value < valueFrom || value > valueTo) {
|
|
Log.e(TAG, EXCEPTION_ILLEGAL_VALUE);
|
|
return false;
|
|
}
|
|
if (stepSize > 0.0f && ((valueFrom - value) / stepSize) % 1 > THRESHOLD) {
|
|
Log.e(TAG, EXCEPTION_ILLEGAL_DISCRETE_VALUE);
|
|
return false;
|
|
}
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Returns the step size used to mark the ticks.
|
|
*
|
|
* <p>A step size of 0 means that the slider is operating in continuous mode. A step size greater
|
|
* than 0 means that the slider is operating in discrete mode.
|
|
*
|
|
* @see #setStepSize(float)
|
|
* @attr ref com.google.android.material.R.styleable#Slider_android_stepSize
|
|
*/
|
|
public float getStepSize() {
|
|
return stepSize;
|
|
}
|
|
|
|
/**
|
|
* Sets the step size to use to mark the ticks.
|
|
*
|
|
* <p>Setting this value to 0 will make the slider operate in continuous mode. Setting this value
|
|
* to a number greater than 0 will make the slider operate in discrete mode.
|
|
*
|
|
* <p>The step size must evenly divide the range described by the {@code valueFrom} and {@code
|
|
* valueTo}, it must be a factor of the range. If the step size is not a factor of the range, an
|
|
* {@link IllegalArgumentException} will be thrown.
|
|
*
|
|
* <p>Setting this value to a negative value will result in an {@link IllegalArgumentException}.
|
|
*
|
|
* @param stepSize The interval value at which ticks must be drawn. Set to 0 to operate the slider
|
|
* in continuous mode and not have any ticks.
|
|
* @throws IllegalArgumentException If the step size is not a factor of the {@code
|
|
* valueFrom}-{@code valueTo} range. If the step size is less than 0
|
|
* @see #getStepSize()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_android_stepSize
|
|
*/
|
|
public void setStepSize(float stepSize) {
|
|
if (this.stepSize != stepSize) {
|
|
this.stepSize = stepSize;
|
|
validateStepSize();
|
|
if (trackWidth > 0) {
|
|
calculateTicksCoordinates();
|
|
}
|
|
postInvalidate();
|
|
}
|
|
}
|
|
|
|
/** Returns the largest value of the Slider. */
|
|
public float getMaximumValue() {
|
|
return values.get(values.size() - 1);
|
|
}
|
|
|
|
/** Returns the smallest value of the Slider. */
|
|
public float getMinimumValue() {
|
|
return values.get(0);
|
|
}
|
|
|
|
/** Returns the index of the currently focused thumb */
|
|
public int getFocusedThumbIndex() {
|
|
return focusedThumbIdx;
|
|
}
|
|
|
|
/** Sets the index of the currently focused thumb */
|
|
public void setFocusedThumbIndex(int index) {
|
|
if (index < 0 || index >= values.size()) {
|
|
throw new IllegalArgumentException("index out of range");
|
|
}
|
|
focusedThumbIdx = index;
|
|
accessibilityHelper.requestKeyboardFocusForVirtualView(focusedThumbIdx);
|
|
postInvalidate();
|
|
}
|
|
|
|
/** Returns the index of the currently active thumb, or -1 if no thumb is active */
|
|
public int getActiveThumbIndex() {
|
|
return activeThumbIdx;
|
|
}
|
|
|
|
/**
|
|
* Registers a callback to be invoked when the slider changes.
|
|
*
|
|
* @param listener The callback to run when the slider changes
|
|
*/
|
|
public void addOnChangeListener(@Nullable OnChangeListener listener) {
|
|
changeListeners.add(listener);
|
|
}
|
|
|
|
/**
|
|
* Removes a callback for value changes from this {@link Slider}
|
|
*
|
|
* @param listener The callback that'll stop receive slider changes
|
|
*/
|
|
public void removeOnChangeListener(@NonNull OnChangeListener listener) {
|
|
changeListeners.remove(listener);
|
|
}
|
|
|
|
/** Removes all instances of {@link Slider.OnChangeListener} attached to this slider */
|
|
public void clearOnChangeListeners() {
|
|
changeListeners.clear();
|
|
}
|
|
|
|
/**
|
|
* Registers a callback to be invoked when the slider touch event is being started or stopped
|
|
*
|
|
* @param listener The callback to run when the slider starts or stops being touched
|
|
*/
|
|
public void addOnSliderTouchListener(@NonNull OnSliderTouchListener listener) {
|
|
touchListeners.add(listener);
|
|
}
|
|
|
|
/**
|
|
* Removes a callback to be invoked when the slider touch event is being started or stopped
|
|
*
|
|
* @param listener The callback that'll stop be notified when the slider is being touched
|
|
*/
|
|
public void removeOnSliderTouchListener(@NonNull OnSliderTouchListener listener) {
|
|
touchListeners.remove(listener);
|
|
}
|
|
|
|
/** Removes all instances of {@link Slider.OnSliderTouchListener} attached to this slider */
|
|
public void clearOnSliderTouchListeners() {
|
|
touchListeners.clear();
|
|
}
|
|
|
|
/**
|
|
* Returns {@code true} if the slider has a {@link LabelFormatter} attached, {@code false}
|
|
* otherwise.
|
|
*/
|
|
public boolean hasLabelFormatter() {
|
|
return formatter != null;
|
|
}
|
|
|
|
/**
|
|
* Registers a {@link LabelFormatter} to be used to format the value displayed in the bubble shown
|
|
* when the slider operates in discrete mode.
|
|
*
|
|
* @param formatter The {@link LabelFormatter} to use to format the bubble's text
|
|
*/
|
|
public void setLabelFormatter(@Nullable LabelFormatter formatter) {
|
|
this.formatter = formatter;
|
|
}
|
|
|
|
/**
|
|
* Returns the elevation of the thumb.
|
|
*
|
|
* @see #setThumbElevation(float)
|
|
* @see #setThumbElevationResource(int)
|
|
* @attr ref com.google.android.material.R.styleable#Slider_thumbElevation
|
|
*/
|
|
public float getThumbElevation() {
|
|
return thumbDrawable.getElevation();
|
|
}
|
|
|
|
/**
|
|
* Sets the elevation of the thumb.
|
|
*
|
|
* @see #getThumbElevation()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_thumbElevation
|
|
*/
|
|
public void setThumbElevation(float elevation) {
|
|
thumbDrawable.setElevation(elevation);
|
|
}
|
|
|
|
/**
|
|
* Sets the elevation of the thumb from a dimension resource.
|
|
*
|
|
* @see #getThumbElevation()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_thumbElevation
|
|
*/
|
|
public void setThumbElevationResource(@DimenRes int elevation) {
|
|
setThumbElevation(getResources().getDimension(elevation));
|
|
}
|
|
|
|
/**
|
|
* Returns the radius of the thumb.
|
|
*
|
|
* @see #setThumbRadius(int)
|
|
* @see #setThumbRadiusResource(int)
|
|
* @attr ref com.google.android.material.R.styleable#Slider_thumbRadius
|
|
*/
|
|
@Dimension
|
|
public int getThumbRadius() {
|
|
return thumbRadius;
|
|
}
|
|
|
|
/**
|
|
* Sets the radius of the thumb in pixels.
|
|
*
|
|
* @see #getThumbRadius()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_thumbRadius
|
|
*/
|
|
public void setThumbRadius(@IntRange(from = 0) @Dimension int radius) {
|
|
if (radius == thumbRadius) {
|
|
return;
|
|
}
|
|
|
|
thumbRadius = radius;
|
|
|
|
thumbDrawable.setShapeAppearanceModel(
|
|
ShapeAppearanceModel.builder().setAllCorners(CornerFamily.ROUNDED, thumbRadius).build());
|
|
thumbDrawable.setBounds(0, 0, thumbRadius * 2, thumbRadius * 2);
|
|
|
|
postInvalidate();
|
|
}
|
|
|
|
/**
|
|
* Sets the radius of the thumb from a dimension resource.
|
|
*
|
|
* @see #getThumbRadius()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_thumbRadius
|
|
*/
|
|
public void setThumbRadiusResource(@DimenRes int radius) {
|
|
setThumbRadius(getResources().getDimensionPixelSize(radius));
|
|
}
|
|
|
|
/**
|
|
* Returns the radius of the halo.
|
|
*
|
|
* @see #setHaloRadius(int)
|
|
* @see #setHaloRadiusResource(int)
|
|
* @attr ref com.google.android.material.R.styleable#Slider_haloRadius
|
|
*/
|
|
@Dimension()
|
|
public int getHaloRadius() {
|
|
return haloRadius;
|
|
}
|
|
|
|
/**
|
|
* Sets the radius of the halo in pixels.
|
|
*
|
|
* @see #getHaloRadius()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_haloRadius
|
|
*/
|
|
public void setHaloRadius(@IntRange(from = 0) @Dimension int radius) {
|
|
if (radius == haloRadius) {
|
|
return;
|
|
}
|
|
|
|
haloRadius = radius;
|
|
if (!shouldDrawCompatHalo()) {
|
|
Drawable background = getBackground();
|
|
if (background instanceof RippleDrawable) {
|
|
DrawableUtils.setRippleDrawableRadius((RippleDrawable) background, haloRadius);
|
|
}
|
|
} else {
|
|
postInvalidate();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Sets the radius of the halo from a dimension resource.
|
|
*
|
|
* @see #getHaloRadius()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_haloRadius
|
|
*/
|
|
public void setHaloRadiusResource(@DimenRes int radius) {
|
|
setHaloRadius(getResources().getDimensionPixelSize(radius));
|
|
}
|
|
|
|
/**
|
|
* Returns the {@link LabelBehavior} used.
|
|
*
|
|
* @see #setLabelBehavior(int)
|
|
* @attr ref com.google.android.material.R.styleable#Slider_labelBehavior
|
|
*/
|
|
@LabelBehavior
|
|
public int getLabelBehavior() {
|
|
return labelBehavior;
|
|
}
|
|
|
|
/**
|
|
* Determines the {@link LabelBehavior} used.
|
|
*
|
|
* @see LabelBehavior
|
|
* @see #getLabelBehavior()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_labelBehavior
|
|
*/
|
|
public void setLabelBehavior(@LabelBehavior int labelBehavior) {
|
|
if (this.labelBehavior != labelBehavior) {
|
|
this.labelBehavior = labelBehavior;
|
|
requestLayout();
|
|
}
|
|
}
|
|
|
|
/** Returns the side padding of the track. */
|
|
@Dimension()
|
|
public int getTrackSidePadding() {
|
|
return trackSidePadding;
|
|
}
|
|
|
|
/** Returns the width of the track in pixels. */
|
|
@Dimension()
|
|
public int getTrackWidth() {
|
|
return trackWidth;
|
|
}
|
|
|
|
/**
|
|
* Returns the height of the track in pixels.
|
|
*
|
|
* @see #setTrackHeight(int)
|
|
* @attr ref com.google.android.material.R.styleable#Slider_trackHeight
|
|
*/
|
|
@Dimension()
|
|
public int getTrackHeight() {
|
|
return trackHeight;
|
|
}
|
|
|
|
/**
|
|
* Set the height of the track in pixels.
|
|
*
|
|
* @see #getTrackHeight()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_trackHeight
|
|
*/
|
|
public void setTrackHeight(@IntRange(from = 0) @Dimension int trackHeight) {
|
|
if (this.trackHeight != trackHeight) {
|
|
this.trackHeight = trackHeight;
|
|
invalidateTrack();
|
|
postInvalidate();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the color of the halo.
|
|
*
|
|
* @see #setHaloColor(ColorStateList)
|
|
* @attr ref com.google.android.material.R.styleable#Slider_haloColor
|
|
*/
|
|
@NonNull
|
|
public ColorStateList getHaloColor() {
|
|
return haloColor;
|
|
}
|
|
|
|
/**
|
|
* Sets the color of the halo.
|
|
*
|
|
* @see #getHaloColor()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_haloColor
|
|
*/
|
|
public void setHaloColor(@NonNull ColorStateList haloColor) {
|
|
if (haloColor.equals(this.haloColor)) {
|
|
return;
|
|
}
|
|
|
|
this.haloColor = haloColor;
|
|
if (!shouldDrawCompatHalo()) {
|
|
Drawable background = getBackground();
|
|
if (background instanceof RippleDrawable) {
|
|
((RippleDrawable) background).setColor(haloColor);
|
|
}
|
|
} else {
|
|
haloPaint.setColor(getColorForState(haloColor));
|
|
haloPaint.setAlpha(HALO_ALPHA);
|
|
invalidate();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the color of the thumb.
|
|
*
|
|
* @see #setThumbColor(ColorStateList)
|
|
* @attr ref com.google.android.material.R.styleable#Slider_thumbColor
|
|
*/
|
|
@NonNull
|
|
public ColorStateList getThumbColor() {
|
|
return thumbDrawable.getFillColor();
|
|
}
|
|
|
|
/**
|
|
* Sets the color of the thumb.
|
|
*
|
|
* @see #getThumbColor()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_thumbColor
|
|
*/
|
|
public void setThumbColor(@NonNull ColorStateList thumbColor) {
|
|
thumbDrawable.setFillColor(thumbColor);
|
|
}
|
|
|
|
/**
|
|
* Returns the color of the tick if the active and inactive parts aren't different.
|
|
*
|
|
* @throws IllegalStateException If {@code tickColorActive} and {@code tickColorInactive} have
|
|
* been set to different values.
|
|
* @see #setTickColor(ColorStateList)
|
|
* @see #setTickColorInactive(ColorStateList)
|
|
* @see #setTickColorActive(ColorStateList)
|
|
* @see #getTickColorInactive()
|
|
* @see #getTickColorActive()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_tickColor
|
|
*/
|
|
@NonNull
|
|
public ColorStateList getTickColor() {
|
|
if (!tickColorInactive.equals(tickColorActive)) {
|
|
throw new IllegalStateException(
|
|
"The inactive and active ticks are different colors. Use the getTickColorInactive() and"
|
|
+ " getTickColorActive() methods instead.");
|
|
}
|
|
return tickColorActive;
|
|
}
|
|
|
|
/**
|
|
* Sets the color of the tick marks.
|
|
*
|
|
* @see #setTickColorInactive(ColorStateList)
|
|
* @see #setTickColorActive(ColorStateList)
|
|
* @see #getTickColor()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_tickColor
|
|
*/
|
|
public void setTickColor(@NonNull ColorStateList tickColor) {
|
|
setTickColorInactive(tickColor);
|
|
setTickColorActive(tickColor);
|
|
}
|
|
|
|
/**
|
|
* Returns the color of the ticks on the active portion of the track.
|
|
*
|
|
* @see #setTickColorActive(ColorStateList)
|
|
* @see #setTickColor(ColorStateList)
|
|
* @see #getTickColor()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_tickColorActive
|
|
*/
|
|
@NonNull
|
|
public ColorStateList getTickColorActive() {
|
|
return tickColorActive;
|
|
}
|
|
|
|
/**
|
|
* Sets the color of the ticks on the active portion of the track.
|
|
*
|
|
* @see #getTickColorActive()
|
|
* @see #setTickColor(ColorStateList)
|
|
* @attr ref com.google.android.material.R.styleable#Slider_tickColorActive
|
|
*/
|
|
public void setTickColorActive(@NonNull ColorStateList tickColor) {
|
|
if (tickColor.equals(tickColorActive)) {
|
|
return;
|
|
}
|
|
tickColorActive = tickColor;
|
|
activeTicksPaint.setColor(getColorForState(tickColorActive));
|
|
invalidate();
|
|
}
|
|
|
|
/**
|
|
* Returns the color of the ticks on the inactive portion of the track.
|
|
*
|
|
* @see #setTickColorInactive(ColorStateList)
|
|
* @see #setTickColor(ColorStateList)
|
|
* @see #getTickColor()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_tickColorInactive
|
|
*/
|
|
@NonNull
|
|
public ColorStateList getTickColorInactive() {
|
|
return tickColorInactive;
|
|
}
|
|
|
|
/**
|
|
* Sets the color of the ticks on the inactive portion of the track.
|
|
*
|
|
* @see #getTickColorInactive()
|
|
* @see #setTickColor(ColorStateList)
|
|
* @attr ref com.google.android.material.R.styleable#Slider_tickColorInactive
|
|
*/
|
|
public void setTickColorInactive(@NonNull ColorStateList tickColor) {
|
|
if (tickColor.equals(tickColorInactive)) {
|
|
return;
|
|
}
|
|
tickColorInactive = tickColor;
|
|
inactiveTicksPaint.setColor(getColorForState(tickColorInactive));
|
|
invalidate();
|
|
}
|
|
|
|
/**
|
|
* Returns the color of the track if the active and inactive parts aren't different.
|
|
*
|
|
* @throws IllegalStateException If {@code trackColorActive} and {@code trackColorInactive} have
|
|
* been set to different values.
|
|
* @see #setTrackColor(ColorStateList)
|
|
* @see #setTrackColorInactive(ColorStateList)
|
|
* @see #setTrackColorActive(ColorStateList)
|
|
* @see #getTrackColorInactive()
|
|
* @see #getTrackColorActive()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_trackColor
|
|
*/
|
|
@NonNull
|
|
public ColorStateList getTrackColor() {
|
|
if (!trackColorInactive.equals(trackColorActive)) {
|
|
throw new IllegalStateException(
|
|
"The inactive and active parts of the track are different colors. Use the"
|
|
+ " getInactiveTrackColor() and getActiveTrackColor() methods instead.");
|
|
}
|
|
return trackColorActive;
|
|
}
|
|
|
|
/**
|
|
* Sets the color of the track.
|
|
*
|
|
* @see #setTrackColorInactive(ColorStateList)
|
|
* @see #setTrackColorActive(ColorStateList)
|
|
* @see #getTrackColor()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_trackColor
|
|
*/
|
|
public void setTrackColor(@NonNull ColorStateList trackColor) {
|
|
setTrackColorInactive(trackColor);
|
|
setTrackColorActive(trackColor);
|
|
}
|
|
|
|
/**
|
|
* Returns the color of the active portion of the track.
|
|
*
|
|
* @see #setTrackColorActive(ColorStateList)
|
|
* @see #setTrackColor(ColorStateList)
|
|
* @see #getTrackColor()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_trackColorActive
|
|
*/
|
|
@NonNull
|
|
public ColorStateList getTrackColorActive() {
|
|
return trackColorActive;
|
|
}
|
|
|
|
/**
|
|
* Sets the color of the active portion of the track.
|
|
*
|
|
* @see #getTrackColorActive()
|
|
* @see #setTrackColor(ColorStateList)
|
|
* @attr ref com.google.android.material.R.styleable#Slider_trackColorActive
|
|
*/
|
|
public void setTrackColorActive(@NonNull ColorStateList trackColor) {
|
|
if (trackColor.equals(trackColorActive)) {
|
|
return;
|
|
}
|
|
trackColorActive = trackColor;
|
|
activeTrackPaint.setColor(getColorForState(trackColorActive));
|
|
invalidate();
|
|
}
|
|
|
|
/**
|
|
* Returns the color of the inactive portion of the track.
|
|
*
|
|
* @see #setTrackColorInactive(ColorStateList)
|
|
* @see #setTrackColor(ColorStateList)
|
|
* @see #getTrackColor()
|
|
* @attr ref com.google.android.material.R.styleable#Slider_trackColorInactive
|
|
*/
|
|
@NonNull
|
|
public ColorStateList getTrackColorInactive() {
|
|
return trackColorInactive;
|
|
}
|
|
|
|
/**
|
|
* Sets the color of the inactive portion of the track.
|
|
*
|
|
* @see #getTrackColorInactive()
|
|
* @see #setTrackColor(ColorStateList)
|
|
* @attr ref com.google.android.material.R.styleable#Slider_trackColorInactive
|
|
*/
|
|
public void setTrackColorInactive(@NonNull ColorStateList trackColor) {
|
|
if (trackColor.equals(trackColorInactive)) {
|
|
return;
|
|
}
|
|
trackColorInactive = trackColor;
|
|
inactiveTrackPaint.setColor(getColorForState(trackColorInactive));
|
|
invalidate();
|
|
}
|
|
|
|
@Override
|
|
public void setEnabled(boolean enabled) {
|
|
super.setEnabled(enabled);
|
|
// When we're disabled, set the layer type to hardware so we can clear the track out from behind
|
|
// the thumb.
|
|
setLayerType(enabled ? LAYER_TYPE_NONE : LAYER_TYPE_HARDWARE, null);
|
|
}
|
|
|
|
@Override
|
|
protected void onAttachedToWindow() {
|
|
super.onAttachedToWindow();
|
|
// The label is attached on the Overlay relative to the content.
|
|
for (TooltipDrawable label : labels) {
|
|
label.setRelativeToView(ViewUtils.getContentView(this));
|
|
}
|
|
}
|
|
|
|
@Override
|
|
protected void onDetachedFromWindow() {
|
|
if (accessibilityEventSender != null) {
|
|
removeCallbacks(accessibilityEventSender);
|
|
}
|
|
|
|
for (TooltipDrawable label : labels) {
|
|
ViewUtils.getContentViewOverlay(this).remove(label);
|
|
label.detachView(ViewUtils.getContentView(this));
|
|
}
|
|
|
|
super.onDetachedFromWindow();
|
|
}
|
|
|
|
@Override
|
|
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
|
|
super.onMeasure(
|
|
widthMeasureSpec,
|
|
MeasureSpec.makeMeasureSpec(
|
|
widgetHeight
|
|
+ (labelBehavior == LABEL_WITHIN_BOUNDS ? labels.get(0).getIntrinsicHeight() : 0),
|
|
MeasureSpec.EXACTLY));
|
|
}
|
|
|
|
@Override
|
|
protected void onSizeChanged(int w, int h, int oldw, int oldh) {
|
|
super.onSizeChanged(w, h, oldw, oldh);
|
|
|
|
// Update the visible track width.
|
|
trackWidth = w - trackSidePadding * 2;
|
|
|
|
// Update the visible tick coordinates.
|
|
if (stepSize > 0.0f) {
|
|
calculateTicksCoordinates();
|
|
}
|
|
|
|
updateHaloHotspot();
|
|
}
|
|
|
|
private void calculateTicksCoordinates() {
|
|
int tickCount = (int) ((valueTo - valueFrom) / stepSize + 1);
|
|
// Limit the tickCount if they will be too dense.
|
|
tickCount = Math.min(tickCount, trackWidth / (trackHeight * 2) + 1);
|
|
if (ticksCoordinates == null || ticksCoordinates.length != tickCount * 2) {
|
|
ticksCoordinates = new float[tickCount * 2];
|
|
}
|
|
|
|
float interval = trackWidth / (float) (tickCount - 1);
|
|
for (int i = 0; i < tickCount * 2; i += 2) {
|
|
ticksCoordinates[i] = trackSidePadding + i / 2 * interval;
|
|
ticksCoordinates[i + 1] = calculateTop();
|
|
}
|
|
}
|
|
|
|
private void updateHaloHotspot() {
|
|
// Set the hotspot as the halo if RippleDrawable is being used.
|
|
if (!shouldDrawCompatHalo() && getMeasuredWidth() > 0) {
|
|
final Drawable background = getBackground();
|
|
if (background instanceof RippleDrawable) {
|
|
int x = (int) (normalizeValue(values.get(focusedThumbIdx)) * trackWidth + trackSidePadding);
|
|
int y = calculateTop();
|
|
DrawableCompat.setHotspotBounds(
|
|
background, x - haloRadius, y - haloRadius, x + haloRadius, y + haloRadius);
|
|
}
|
|
}
|
|
}
|
|
|
|
private int calculateTop() {
|
|
return trackTop
|
|
+ (labelBehavior == LABEL_WITHIN_BOUNDS ? labels.get(0).getIntrinsicHeight() : 0);
|
|
}
|
|
|
|
@Override
|
|
protected void onDraw(@NonNull Canvas canvas) {
|
|
super.onDraw(canvas);
|
|
|
|
int top = calculateTop();
|
|
|
|
drawInactiveTrack(canvas, trackWidth, top);
|
|
if (getMaximumValue() > valueFrom) {
|
|
drawActiveTrack(canvas, trackWidth, top);
|
|
}
|
|
|
|
if (stepSize > 0.0f) {
|
|
drawTicks(canvas);
|
|
}
|
|
|
|
if ((thumbIsPressed || isFocused()) && isEnabled()) {
|
|
maybeDrawHalo(canvas, trackWidth, top);
|
|
|
|
// Draw labels if there is an active thumb.
|
|
if (activeThumbIdx != -1) {
|
|
ensureLabels();
|
|
}
|
|
}
|
|
|
|
drawThumbs(canvas, trackWidth, top);
|
|
}
|
|
|
|
/**
|
|
* Returns a float array where {@code float[0]} is the normalized left position and {@code
|
|
* float[1]} is the normalized right position of the range.
|
|
*/
|
|
private float[] getActiveRange() {
|
|
float left = normalizeValue(values.size() == 1 ? valueFrom : getMinimumValue());
|
|
float right = normalizeValue(getMaximumValue());
|
|
|
|
// In RTL we draw things in reverse, so swap the left and right range values
|
|
if (ViewCompat.getLayoutDirection(this) == ViewCompat.LAYOUT_DIRECTION_RTL) {
|
|
return new float[] {right, left};
|
|
} else {
|
|
return new float[] {left, right};
|
|
}
|
|
}
|
|
|
|
private void drawInactiveTrack(@NonNull Canvas canvas, int width, int top) {
|
|
float[] activeRange = getActiveRange();
|
|
float right = trackSidePadding + activeRange[1] * width;
|
|
if (right < trackSidePadding + width) {
|
|
canvas.drawLine(right, top, trackSidePadding + width, top, inactiveTrackPaint);
|
|
}
|
|
|
|
// Also draw inactive track to the left if there is any
|
|
float left = trackSidePadding + activeRange[0] * width;
|
|
if (left > trackSidePadding) {
|
|
canvas.drawLine(trackSidePadding, top, left, top, inactiveTrackPaint);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns a number between 0 and 1 indicating where on the track this value should sit with 0
|
|
* being on the far left, and 1 on the far right.
|
|
*/
|
|
private float normalizeValue(float value) {
|
|
float normalized = (value - valueFrom) / (valueTo - valueFrom);
|
|
if (ViewCompat.getLayoutDirection(this) == ViewCompat.LAYOUT_DIRECTION_RTL) {
|
|
return 1 - normalized;
|
|
}
|
|
return normalized;
|
|
}
|
|
|
|
private void drawActiveTrack(@NonNull Canvas canvas, int width, int top) {
|
|
float[] activeRange = getActiveRange();
|
|
float right = trackSidePadding + activeRange[1] * width;
|
|
float left = trackSidePadding + activeRange[0] * width;
|
|
canvas.drawLine(left, top, right, top, activeTrackPaint);
|
|
}
|
|
|
|
private void drawTicks(@NonNull Canvas canvas) {
|
|
float[] activeRange = getActiveRange();
|
|
int leftPivotIndex = pivotIndex(ticksCoordinates, activeRange[0]);
|
|
int rightPivotIndex = pivotIndex(ticksCoordinates, activeRange[1]);
|
|
|
|
// Draw inactive ticks to the left of the smallest thumb.
|
|
canvas.drawPoints(ticksCoordinates, 0, leftPivotIndex * 2, inactiveTicksPaint);
|
|
|
|
// Draw active ticks between the thumbs.
|
|
canvas.drawPoints(
|
|
ticksCoordinates,
|
|
leftPivotIndex * 2,
|
|
rightPivotIndex * 2 - leftPivotIndex * 2,
|
|
activeTicksPaint);
|
|
|
|
// Draw inactive ticks to the right of the largest thumb.
|
|
canvas.drawPoints(
|
|
ticksCoordinates,
|
|
rightPivotIndex * 2,
|
|
ticksCoordinates.length - rightPivotIndex * 2,
|
|
inactiveTicksPaint);
|
|
}
|
|
|
|
private void drawThumbs(@NonNull Canvas canvas, int width, int top) {
|
|
// Clear out the track behind the thumb if we're in a disable state since the thumb is
|
|
// transparent.
|
|
if (!isEnabled()) {
|
|
for (Float value : values) {
|
|
canvas.drawCircle(
|
|
trackSidePadding + normalizeValue(value) * width, top, thumbRadius, thumbPaint);
|
|
}
|
|
}
|
|
|
|
for (Float value : values) {
|
|
canvas.save();
|
|
canvas.translate(
|
|
trackSidePadding + (int) (normalizeValue(value) * width) - thumbRadius,
|
|
top - thumbRadius);
|
|
thumbDrawable.draw(canvas);
|
|
canvas.restore();
|
|
}
|
|
}
|
|
|
|
private void maybeDrawHalo(@NonNull Canvas canvas, int width, int top) {
|
|
// Only draw the halo for devices that aren't using the ripple.
|
|
if (shouldDrawCompatHalo()) {
|
|
int centerX = (int) (trackSidePadding + normalizeValue(values.get(focusedThumbIdx)) * width);
|
|
if (VERSION.SDK_INT < VERSION_CODES.P) {
|
|
// In this case we can clip the rect to allow drawing outside the bounds.
|
|
canvas.clipRect(
|
|
centerX - haloRadius,
|
|
top - haloRadius,
|
|
centerX + haloRadius,
|
|
top + haloRadius,
|
|
Op.UNION);
|
|
}
|
|
canvas.drawCircle(centerX, top, haloRadius, haloPaint);
|
|
}
|
|
}
|
|
|
|
private boolean shouldDrawCompatHalo() {
|
|
return forceDrawCompatHalo
|
|
|| VERSION.SDK_INT < VERSION_CODES.LOLLIPOP
|
|
|| !(getBackground() instanceof RippleDrawable);
|
|
}
|
|
|
|
@Override
|
|
public boolean onTouchEvent(@NonNull MotionEvent event) {
|
|
if (!isEnabled()) {
|
|
return false;
|
|
}
|
|
float x = event.getX();
|
|
touchPosition = (x - trackSidePadding) / trackWidth;
|
|
touchPosition = Math.max(0, touchPosition);
|
|
touchPosition = Math.min(1, touchPosition);
|
|
|
|
switch (event.getActionMasked()) {
|
|
case MotionEvent.ACTION_DOWN:
|
|
touchDownX = x;
|
|
|
|
// If we're inside a scrolling container,
|
|
// we should start dragging in ACTION_MOVE
|
|
if (isInScrollingContainer()) {
|
|
break;
|
|
}
|
|
getParent().requestDisallowInterceptTouchEvent(true);
|
|
|
|
if (!pickActiveThumb()) {
|
|
// Couldn't determine the active thumb yet.
|
|
break;
|
|
}
|
|
|
|
requestFocus();
|
|
thumbIsPressed = true;
|
|
snapTouchPosition();
|
|
updateHaloHotspot();
|
|
invalidate();
|
|
onStartTrackingTouch();
|
|
break;
|
|
case MotionEvent.ACTION_MOVE:
|
|
if (!thumbIsPressed) {
|
|
// Check if we're trying to scroll instead of dragging this Slider
|
|
if (Math.abs(x - touchDownX) < scaledTouchSlop) {
|
|
return false;
|
|
}
|
|
getParent().requestDisallowInterceptTouchEvent(true);
|
|
onStartTrackingTouch();
|
|
}
|
|
|
|
if (!pickActiveThumb()) {
|
|
// Couldn't determine the active thumb yet.
|
|
break;
|
|
}
|
|
|
|
thumbIsPressed = true;
|
|
snapTouchPosition();
|
|
updateHaloHotspot();
|
|
invalidate();
|
|
break;
|
|
case MotionEvent.ACTION_UP:
|
|
thumbIsPressed = false;
|
|
if (activeThumbIdx != -1) {
|
|
snapTouchPosition();
|
|
activeThumbIdx = -1;
|
|
}
|
|
for (TooltipDrawable label : labels) {
|
|
ViewUtils.getContentViewOverlay(this).remove(label);
|
|
}
|
|
onStopTrackingTouch();
|
|
invalidate();
|
|
break;
|
|
default:
|
|
// Nothing to do in this case.
|
|
}
|
|
|
|
// Set if the thumb is pressed. This will cause the ripple to be drawn.
|
|
setPressed(thumbIsPressed);
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Calculates the index the closest tick coordinates that the thumb should snap to.
|
|
*
|
|
* @param coordinates Tick coordinates defined in {@code #setTicksCoordinates()}.
|
|
* @param position Actual thumb position.
|
|
* @return Index of the closest tick coordinate.
|
|
*/
|
|
private static int pivotIndex(float[] coordinates, float position) {
|
|
return Math.round(position * (coordinates.length / 2 - 1));
|
|
}
|
|
|
|
private float snapPosition(float position) {
|
|
if (stepSize > 0.0f) {
|
|
float stepCount = (int) ((valueTo - valueFrom) / stepSize);
|
|
return Math.round(position * stepCount) / stepCount;
|
|
}
|
|
|
|
return position;
|
|
}
|
|
|
|
/**
|
|
* Tries to pick the active thumb if one hasn't already been set. This will pick the closest thumb
|
|
* if there is only one thumb under the touch position. If there is more than one thumb under the
|
|
* touch position, it will wait for enough drag left or right to determine which thumb to pick.
|
|
*/
|
|
private boolean pickActiveThumb() {
|
|
if (activeThumbIdx != -1) {
|
|
return true;
|
|
}
|
|
|
|
float touchValue = getValueOfTouchPosition();
|
|
float touchX = valueToX(touchValue);
|
|
|
|
float leftXBound = Math.min(touchX, touchDownX);
|
|
float rightXBound = Math.max(touchX, touchDownX);
|
|
|
|
activeThumbIdx = 0;
|
|
float activeThumbDiff = Math.abs(values.get(activeThumbIdx) - touchValue);
|
|
for (int i = 0; i < values.size(); i++) {
|
|
float valueDiff = Math.abs(values.get(i) - touchValue);
|
|
|
|
float valueX = valueToX(values.get(i));
|
|
float valueDiffX = Math.abs(valueX - touchX);
|
|
float activeValueDiffX = Math.abs(valueToX(values.get(activeThumbIdx)) - touchX);
|
|
|
|
// Check if we've received touch events that's passing over a thumb.
|
|
if (leftXBound < valueX && rightXBound > valueX) {
|
|
activeThumbIdx = i;
|
|
return true;
|
|
}
|
|
|
|
// If the new point and the active point are both within scaled touch slop of the touch and
|
|
// the value is not the same, we have to wait for the touch to move.
|
|
if (valueDiffX < scaledTouchSlop
|
|
&& activeValueDiffX < scaledTouchSlop
|
|
&& Math.abs(valueDiffX - activeValueDiffX) > THRESHOLD) {
|
|
activeThumbIdx = -1;
|
|
return false;
|
|
}
|
|
|
|
if (valueDiff < activeThumbDiff) {
|
|
// This value is closer to the thumb so update the active thumb index.
|
|
activeThumbDiff = valueDiff;
|
|
activeThumbIdx = i;
|
|
}
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Snaps the thumb position to the closest tick coordinates in discrete mode, and the input
|
|
* position in continuous mode.
|
|
*
|
|
* @return true, if {@code #thumbPosition is updated}; false, otherwise.
|
|
*/
|
|
private boolean snapTouchPosition() {
|
|
return snapActiveThumbToValue(getValueOfTouchPosition());
|
|
}
|
|
|
|
private boolean snapActiveThumbToValue(float value) {
|
|
return snapThumbToValue(activeThumbIdx, value);
|
|
}
|
|
|
|
private boolean snapThumbToValue(int idx, float value) {
|
|
// Check if the new value equals a value that was already set.
|
|
if (value == values.get(idx)) {
|
|
return false;
|
|
}
|
|
|
|
// Replace the old value with the new value of the touch position.
|
|
values.set(idx, value);
|
|
Collections.sort(values);
|
|
if (idx == activeThumbIdx) {
|
|
// Hold on to the active thumb if that's what we're tracking.
|
|
idx = values.indexOf(value);
|
|
}
|
|
activeThumbIdx = idx;
|
|
focusedThumbIdx = idx;
|
|
|
|
dispatchOnChangedFromUser(idx);
|
|
return true;
|
|
}
|
|
|
|
private float getValueOfTouchPosition() {
|
|
float position = snapPosition(touchPosition);
|
|
|
|
// We might need to invert the touch position to get the correct value.
|
|
if (ViewCompat.getLayoutDirection(this) == ViewCompat.LAYOUT_DIRECTION_RTL) {
|
|
position = 1 - position;
|
|
}
|
|
return position * (valueTo - valueFrom) + valueFrom;
|
|
}
|
|
|
|
private float valueToX(float value) {
|
|
return normalizeValue(value) * trackWidth + trackSidePadding;
|
|
}
|
|
|
|
private void ensureLabels() {
|
|
if (labelBehavior == LABEL_GONE) {
|
|
// If the label shouldn't be drawn we can skip this.
|
|
return;
|
|
}
|
|
|
|
Iterator<TooltipDrawable> labelItr = labels.iterator();
|
|
|
|
for (int i = 0; i < values.size() && labelItr.hasNext(); i++) {
|
|
if (i == focusedThumbIdx) {
|
|
// We position the focused thumb last so it's displayed on top, so skip it for now.
|
|
continue;
|
|
}
|
|
|
|
setValueForLabel(labelItr.next(), values.get(i));
|
|
}
|
|
|
|
if (!labelItr.hasNext()) {
|
|
throw new IllegalStateException("Not enough labels to display all the values");
|
|
}
|
|
|
|
// Now set the label for the focused thumb so it's on top.
|
|
setValueForLabel(labelItr.next(), values.get(focusedThumbIdx));
|
|
}
|
|
|
|
private String formatValue(float value) {
|
|
if (hasLabelFormatter()) {
|
|
return formatter.getFormattedValue(value);
|
|
} else {
|
|
return String.format((int) value == value ? "%.0f" : "%.2f", value);
|
|
}
|
|
}
|
|
|
|
private void setValueForLabel(TooltipDrawable label, float value) {
|
|
label.setText(formatValue(value));
|
|
|
|
int left =
|
|
trackSidePadding
|
|
+ (int) (normalizeValue(value) * trackWidth)
|
|
- label.getIntrinsicWidth() / 2;
|
|
int top = calculateTop() - (labelPadding + thumbRadius);
|
|
label.setBounds(left, top - label.getIntrinsicHeight(), left + label.getIntrinsicWidth(), top);
|
|
|
|
// Calculate the difference between the bounds of this view and the bounds of the root view to
|
|
// correctly position this view in the overlay layer.
|
|
Rect rect = new Rect(label.getBounds());
|
|
DescendantOffsetUtils.offsetDescendantRect(ViewUtils.getContentView(this), this, rect);
|
|
label.setBounds(rect);
|
|
|
|
ViewUtils.getContentViewOverlay(this).add(label);
|
|
}
|
|
|
|
private void invalidateTrack() {
|
|
inactiveTrackPaint.setStrokeWidth(trackHeight);
|
|
activeTrackPaint.setStrokeWidth(trackHeight);
|
|
inactiveTicksPaint.setStrokeWidth(trackHeight / 2.0f);
|
|
activeTicksPaint.setStrokeWidth(trackHeight / 2.0f);
|
|
}
|
|
|
|
/**
|
|
* If this returns true, we can't start dragging the Slider immediately when we receive a {@link
|
|
* MotionEvent#ACTION_DOWN}. Instead, we must wait for a {@link MotionEvent#ACTION_MOVE}. Copied
|
|
* from hidden method of {@link View} isInScrollingContainer.
|
|
*
|
|
* @return true if any of this View's parents is a scrolling View.
|
|
*/
|
|
private boolean isInScrollingContainer() {
|
|
ViewParent p = getParent();
|
|
while (p instanceof ViewGroup) {
|
|
if (((ViewGroup) p).shouldDelayChildPressedState()) {
|
|
return true;
|
|
}
|
|
p = p.getParent();
|
|
}
|
|
return false;
|
|
}
|
|
|
|
private void dispatchOnChangedProgramatically() {
|
|
for (OnChangeListener listener : changeListeners) {
|
|
for (Float value : values) {
|
|
listener.onValueChange(this, value, false);
|
|
}
|
|
}
|
|
}
|
|
|
|
private void dispatchOnChangedFromUser(int idx) {
|
|
for (OnChangeListener listener : changeListeners) {
|
|
listener.onValueChange(this, values.get(idx), true);
|
|
}
|
|
if (accessibilityManager != null && accessibilityManager.isEnabled()) {
|
|
scheduleAccessibilityEventSender(idx);
|
|
}
|
|
}
|
|
|
|
private void onStartTrackingTouch() {
|
|
for (OnSliderTouchListener listener : touchListeners) {
|
|
listener.onStartTrackingTouch(this);
|
|
}
|
|
}
|
|
|
|
private void onStopTrackingTouch() {
|
|
for (OnSliderTouchListener listener : touchListeners) {
|
|
listener.onStopTrackingTouch(this);
|
|
}
|
|
}
|
|
|
|
@Override
|
|
protected void drawableStateChanged() {
|
|
super.drawableStateChanged();
|
|
|
|
inactiveTrackPaint.setColor(getColorForState(trackColorInactive));
|
|
activeTrackPaint.setColor(getColorForState(trackColorActive));
|
|
inactiveTicksPaint.setColor(getColorForState(tickColorInactive));
|
|
activeTicksPaint.setColor(getColorForState(tickColorActive));
|
|
for (TooltipDrawable label : labels) {
|
|
if (label.isStateful()) {
|
|
label.setState(getDrawableState());
|
|
}
|
|
}
|
|
if (thumbDrawable.isStateful()) {
|
|
thumbDrawable.setState(getDrawableState());
|
|
}
|
|
haloPaint.setColor(getColorForState(haloColor));
|
|
haloPaint.setAlpha(HALO_ALPHA);
|
|
}
|
|
|
|
@ColorInt
|
|
private int getColorForState(@NonNull ColorStateList colorStateList) {
|
|
return colorStateList.getColorForState(getDrawableState(), colorStateList.getDefaultColor());
|
|
}
|
|
|
|
@VisibleForTesting
|
|
void forceDrawCompatHalo(boolean force) {
|
|
forceDrawCompatHalo = force;
|
|
}
|
|
|
|
@Override
|
|
public boolean onKeyDown(int keyCode, @NonNull KeyEvent event) {
|
|
if (isEnabled()) {
|
|
// If there's only one thumb, we can select it right away.
|
|
if (values.size() == 1) {
|
|
activeThumbIdx = 0;
|
|
}
|
|
|
|
// If there is no active thumb, key events will be used to pick the thumb to change.
|
|
if (activeThumbIdx == -1) {
|
|
switch (keyCode) {
|
|
case KeyEvent.KEYCODE_TAB:
|
|
if (event.hasNoModifiers()) {
|
|
moveFocus(1);
|
|
return true;
|
|
} else if (event.isShiftPressed()) {
|
|
moveFocus(-1);
|
|
return true;
|
|
}
|
|
return false;
|
|
case KeyEvent.KEYCODE_DPAD_LEFT:
|
|
case KeyEvent.KEYCODE_MINUS:
|
|
moveFocus(-1);
|
|
return true;
|
|
case KeyEvent.KEYCODE_DPAD_RIGHT:
|
|
case KeyEvent.KEYCODE_PLUS:
|
|
moveFocus(1);
|
|
return true;
|
|
case KeyEvent.KEYCODE_DPAD_CENTER:
|
|
case KeyEvent.KEYCODE_ENTER:
|
|
activeThumbIdx = focusedThumbIdx;
|
|
postInvalidate();
|
|
return true;
|
|
default:
|
|
// Nothing to do in this case.
|
|
}
|
|
} else {
|
|
isLongPress |= event.isLongPress();
|
|
Float increment = calculateIncrementForKey(event, keyCode);
|
|
if (increment != null) {
|
|
if (ViewCompat.getLayoutDirection(this) == ViewCompat.LAYOUT_DIRECTION_RTL) {
|
|
increment = -increment;
|
|
}
|
|
float clamped =
|
|
MathUtils.clamp(values.get(activeThumbIdx) + increment, valueFrom, valueTo);
|
|
if (snapActiveThumbToValue(clamped)) {
|
|
updateHaloHotspot();
|
|
postInvalidate();
|
|
}
|
|
return true;
|
|
}
|
|
}
|
|
}
|
|
|
|
return super.onKeyDown(keyCode, event);
|
|
}
|
|
|
|
@Override
|
|
public boolean onKeyUp(int keyCode, @NonNull KeyEvent event) {
|
|
isLongPress = false;
|
|
return super.onKeyUp(keyCode, event);
|
|
}
|
|
|
|
private void moveFocus(int direction) {
|
|
focusedThumbIdx += direction;
|
|
focusedThumbIdx = MathUtils.clamp(focusedThumbIdx, 0, values.size() - 1);
|
|
if (activeThumbIdx != -1) {
|
|
activeThumbIdx = focusedThumbIdx;
|
|
}
|
|
updateHaloHotspot();
|
|
postInvalidate();
|
|
}
|
|
|
|
private Float calculateIncrementForKey(KeyEvent event, int keyCode) {
|
|
// If this is a long press, increase the increment so it will only take around 20 steps.
|
|
// Otherwise choose the smallest valid increment.
|
|
float increment = isLongPress ? calculateStepIncrement(20) : calculateStepIncrement();
|
|
switch (keyCode) {
|
|
case KeyEvent.KEYCODE_TAB:
|
|
if (event.isShiftPressed()) {
|
|
return -increment;
|
|
} else {
|
|
return increment;
|
|
}
|
|
case KeyEvent.KEYCODE_DPAD_LEFT:
|
|
case KeyEvent.KEYCODE_MINUS:
|
|
increment = -increment;
|
|
// fallthrough
|
|
case KeyEvent.KEYCODE_DPAD_RIGHT:
|
|
case KeyEvent.KEYCODE_PLUS:
|
|
case KeyEvent.KEYCODE_EQUALS:
|
|
return increment;
|
|
default:
|
|
return null;
|
|
}
|
|
}
|
|
|
|
/** Returns a small valid step increment to use when adding an offset to an existing value */
|
|
private float calculateStepIncrement() {
|
|
return stepSize == 0 ? 1 : stepSize;
|
|
}
|
|
|
|
/**
|
|
* Returns a valid increment based on the {@code stepSize} (if it's set) that will allow
|
|
* approximately {@code stepFactor} steps to cover the whole range.
|
|
*/
|
|
private float calculateStepIncrement(int stepFactor) {
|
|
float increment = calculateStepIncrement();
|
|
float numSteps = (valueTo - valueFrom) / increment;
|
|
if (numSteps <= stepFactor) {
|
|
return increment;
|
|
}
|
|
|
|
return Math.round((numSteps / stepFactor)) * increment;
|
|
}
|
|
|
|
@Override
|
|
protected void onFocusChanged(
|
|
boolean gainFocus, int direction, @Nullable Rect previouslyFocusedRect) {
|
|
super.onFocusChanged(gainFocus, direction, previouslyFocusedRect);
|
|
if (!gainFocus) {
|
|
activeThumbIdx = -1;
|
|
for (TooltipDrawable label : labels) {
|
|
ViewUtils.getContentViewOverlay(this).remove(label);
|
|
}
|
|
accessibilityHelper.requestKeyboardFocusForVirtualView(ExploreByTouchHelper.INVALID_ID);
|
|
} else {
|
|
accessibilityHelper.requestKeyboardFocusForVirtualView(focusedThumbIdx);
|
|
}
|
|
}
|
|
|
|
@NonNull
|
|
@Override
|
|
public CharSequence getAccessibilityClassName() {
|
|
return SeekBar.class.getName();
|
|
}
|
|
|
|
@Override
|
|
public boolean dispatchHoverEvent(@NonNull MotionEvent event) {
|
|
return accessibilityHelper.dispatchHoverEvent(event) || super.dispatchHoverEvent(event);
|
|
}
|
|
|
|
@Override
|
|
public boolean dispatchKeyEvent(@NonNull KeyEvent event) {
|
|
// We explicitly don't pass the key event to the accessibilityHelper because it doesn't handle
|
|
// focus correctly in some cases (Such as moving left after moving right a few times).
|
|
return super.dispatchKeyEvent(event);
|
|
}
|
|
|
|
/**
|
|
* Schedule a command for sending an accessibility event. </br> Note: A command is used to ensure
|
|
* that accessibility events are sent at most one in a given time frame to save system resources
|
|
* while the value changes quickly.
|
|
*/
|
|
private void scheduleAccessibilityEventSender(int idx) {
|
|
if (accessibilityEventSender == null) {
|
|
accessibilityEventSender = new AccessibilityEventSender();
|
|
} else {
|
|
removeCallbacks(accessibilityEventSender);
|
|
}
|
|
accessibilityEventSender.setVirtualViewId(idx);
|
|
postDelayed(accessibilityEventSender, TIMEOUT_SEND_ACCESSIBILITY_EVENT);
|
|
}
|
|
|
|
/** Command for sending an accessibility event. */
|
|
private class AccessibilityEventSender implements Runnable {
|
|
int virtualViewId = -1;
|
|
|
|
void setVirtualViewId(int virtualViewId) {
|
|
this.virtualViewId = virtualViewId;
|
|
}
|
|
|
|
@Override
|
|
public void run() {
|
|
accessibilityHelper.sendEventForVirtualView(
|
|
virtualViewId, AccessibilityEvent.TYPE_VIEW_SELECTED);
|
|
}
|
|
}
|
|
|
|
@Override
|
|
protected Parcelable onSaveInstanceState() {
|
|
Parcelable superState = super.onSaveInstanceState();
|
|
SliderState sliderState = new SliderState(superState);
|
|
sliderState.valueFrom = valueFrom;
|
|
sliderState.valueTo = valueTo;
|
|
sliderState.values = new ArrayList<>(values);
|
|
sliderState.stepSize = stepSize;
|
|
sliderState.hasFocus = hasFocus();
|
|
return sliderState;
|
|
}
|
|
|
|
@Override
|
|
protected void onRestoreInstanceState(Parcelable state) {
|
|
SliderState sliderState = (SliderState) state;
|
|
super.onRestoreInstanceState(sliderState.getSuperState());
|
|
|
|
valueFrom = sliderState.valueFrom;
|
|
valueTo = sliderState.valueTo;
|
|
values = sliderState.values;
|
|
stepSize = sliderState.stepSize;
|
|
if (sliderState.hasFocus) {
|
|
requestFocus();
|
|
}
|
|
dispatchOnChangedProgramatically();
|
|
}
|
|
|
|
static class SliderState extends BaseSavedState {
|
|
|
|
float valueFrom;
|
|
float valueTo;
|
|
ArrayList<Float> values;
|
|
float stepSize;
|
|
boolean hasFocus;
|
|
|
|
public static final Parcelable.Creator<SliderState> CREATOR =
|
|
new Parcelable.Creator<SliderState>() {
|
|
|
|
@NonNull
|
|
@Override
|
|
public SliderState createFromParcel(@NonNull Parcel source) {
|
|
return new SliderState(source);
|
|
}
|
|
|
|
@NonNull
|
|
@Override
|
|
public SliderState[] newArray(int size) {
|
|
return new SliderState[size];
|
|
}
|
|
};
|
|
|
|
SliderState(Parcelable superState) {
|
|
super(superState);
|
|
}
|
|
|
|
private SliderState(@NonNull Parcel source) {
|
|
super(source);
|
|
valueFrom = source.readFloat();
|
|
valueTo = source.readFloat();
|
|
source.readList(values, Float.class.getClassLoader());
|
|
stepSize = source.readFloat();
|
|
hasFocus = source.createBooleanArray()[0];
|
|
}
|
|
|
|
@Override
|
|
public void writeToParcel(@NonNull Parcel dest, int flags) {
|
|
super.writeToParcel(dest, flags);
|
|
dest.writeFloat(valueFrom);
|
|
dest.writeFloat(valueTo);
|
|
dest.writeList(values);
|
|
dest.writeFloat(stepSize);
|
|
boolean[] booleans = new boolean[1];
|
|
booleans[0] = hasFocus;
|
|
dest.writeBooleanArray(booleans);
|
|
}
|
|
}
|
|
|
|
private class AccessibilityHelper extends ExploreByTouchHelper {
|
|
|
|
Rect bounds = new Rect();
|
|
|
|
AccessibilityHelper() {
|
|
super(Slider.this);
|
|
}
|
|
|
|
@Override
|
|
protected int getVirtualViewAt(float x, float y) {
|
|
for (int i = 0; i < getValues().size(); i++) {
|
|
updateBoundsForVirturalViewId(i);
|
|
if (bounds.contains((int) x, (int) y)) {
|
|
return i;
|
|
}
|
|
}
|
|
return HOST_ID;
|
|
}
|
|
|
|
@Override
|
|
protected void getVisibleVirtualViews(List<Integer> virtualViewIds) {
|
|
for (int i = 0; i < getValues().size(); i++) {
|
|
virtualViewIds.add(i);
|
|
}
|
|
}
|
|
|
|
@Override
|
|
protected void onPopulateNodeForVirtualView(
|
|
int virtualViewId, AccessibilityNodeInfoCompat info) {
|
|
|
|
info.addAction(AccessibilityNodeInfoCompat.AccessibilityActionCompat.ACTION_SET_PROGRESS);
|
|
|
|
final float value = getValues().get(virtualViewId);
|
|
|
|
if (isEnabled()) {
|
|
if (value > valueFrom) {
|
|
info.addAction(AccessibilityNodeInfoCompat.ACTION_SCROLL_BACKWARD);
|
|
}
|
|
if (value < valueTo) {
|
|
info.addAction(AccessibilityNodeInfoCompat.ACTION_SCROLL_FORWARD);
|
|
}
|
|
}
|
|
|
|
info.setRangeInfo(
|
|
AccessibilityNodeInfoCompat.RangeInfoCompat.obtain(
|
|
RangeInfoCompat.RANGE_TYPE_FLOAT, valueFrom, valueTo, value));
|
|
|
|
info.setClassName(SeekBar.class.getName());
|
|
StringBuilder contentDescription = new StringBuilder();
|
|
// Add the content description of the slider.
|
|
contentDescription.append(getContentDescription());
|
|
if (contentDescription.length() != 0) {
|
|
contentDescription.append(",");
|
|
}
|
|
// Add the range to the content description.
|
|
contentDescription.append(
|
|
getContext()
|
|
.getString(
|
|
R.string.mtrl_slider_range_content_description,
|
|
formatValue(getMinimumValue()),
|
|
formatValue(getMaximumValue())));
|
|
info.setContentDescription(contentDescription.toString());
|
|
|
|
updateBoundsForVirturalViewId(virtualViewId);
|
|
info.setBoundsInParent(bounds);
|
|
}
|
|
|
|
private void updateBoundsForVirturalViewId(int virtualViewId) {
|
|
int x =
|
|
trackSidePadding + (int) (normalizeValue(getValues().get(virtualViewId)) * trackWidth);
|
|
int y = calculateTop();
|
|
|
|
bounds.set(x - thumbRadius, y - thumbRadius, x + thumbRadius, y + thumbRadius);
|
|
}
|
|
|
|
@Override
|
|
protected boolean onPerformActionForVirtualView(
|
|
int virtualViewId, int action, Bundle arguments) {
|
|
if (!isEnabled()) {
|
|
return false;
|
|
}
|
|
|
|
switch (action) {
|
|
case android.R.id.accessibilityActionSetProgress:
|
|
{
|
|
if (arguments == null
|
|
|| !arguments.containsKey(
|
|
AccessibilityNodeInfoCompat.ACTION_ARGUMENT_PROGRESS_VALUE)) {
|
|
return false;
|
|
}
|
|
float value =
|
|
arguments.getFloat(AccessibilityNodeInfoCompat.ACTION_ARGUMENT_PROGRESS_VALUE);
|
|
if (snapThumbToValue(virtualViewId, value)) {
|
|
updateHaloHotspot();
|
|
postInvalidate();
|
|
invalidateVirtualView(virtualViewId);
|
|
return true;
|
|
}
|
|
return false;
|
|
}
|
|
case AccessibilityNodeInfoCompat.ACTION_SCROLL_FORWARD:
|
|
case AccessibilityNodeInfoCompat.ACTION_SCROLL_BACKWARD:
|
|
{
|
|
float increment = calculateStepIncrement(20);
|
|
if (action == AccessibilityNodeInfoCompat.ACTION_SCROLL_BACKWARD) {
|
|
increment = -increment;
|
|
}
|
|
|
|
// Swap the increment if we're in RTL.
|
|
if (ViewCompat.getLayoutDirection(Slider.this) == ViewCompat.LAYOUT_DIRECTION_RTL) {
|
|
increment = -increment;
|
|
}
|
|
|
|
float clamped =
|
|
MathUtils.clamp(values.get(virtualViewId) + increment, valueFrom, valueTo);
|
|
if (snapThumbToValue(virtualViewId, clamped)) {
|
|
updateHaloHotspot();
|
|
postInvalidate();
|
|
|
|
// If the index of the new value has changed, refocus on the correct virtual view.
|
|
if (values.indexOf(clamped) != virtualViewId) {
|
|
virtualViewId = values.indexOf(clamped);
|
|
sendEventForVirtualView(virtualViewId, AccessibilityEvent.TYPE_VIEW_FOCUSED);
|
|
} else {
|
|
invalidateVirtualView(virtualViewId);
|
|
}
|
|
|
|
return true;
|
|
}
|
|
return false;
|
|
}
|
|
default:
|
|
return false;
|
|
}
|
|
}
|
|
}
|
|
}
|