ArcSeekBar

ArcSeekBar для Android — это дугообразный ползунок прогресса с полностью настраиваемыми параметрами.

ArcSeekBar основан на библиотеке CircleProgressView, но был доработан и улучшен. Хотя большая часть функций CircleProgressView поддерживается ArcSeekBar, он предлагает более детальные настройки.

Создание ArcSeekBar вместо модификации CircleProgressView было обусловлено тем, что некоторые анимационные эффекты в CircleProgressView не подходят для SeekBar. ArcSeekBar был создан на основе CircleProgressView с удалением некоторых элементов и последующим расширением и улучшением. Выбор между этими двумя библиотеками зависит от конкретных требований проекта.

GIF-демонстрация

Вы также можете скачать демонстрационное приложение, чтобы оценить его работу.

Использование

• Gradle:
  1. В файле build.gradle или setting.gradle проекта добавьте удалённый репозиторий:

     repositories {
         //...
         mavenCentral()
     }
  2. В файле build.gradle модуля добавьте зависимость:

     implementation 'com.github.jenly1314:arcseekbar:1.1.1'

Свойства ArcSeekBar (по умолчанию используется градиентная заливка)

arcTickPadding | dimension | 2dp | кольцевая отметка и интервал между кольцами |

| arcTickSplitAngle | integer | 5 | угол интервала между отметками |

| arcBlockAngle | integer | 1 | угол отметки |

| arcTickOffsetAngle | integer | 0 | угол смещения отметки |

| arcThumbStrokeWidth | dimension | 10dp | ширина кисти для рисования кнопки перетаскивания |

| arcThumbColor | color | #FFE8D30F | цвет кнопки перетаскивания**|**

| arcThumbRadius | dimension | 8dp | радиус кнопки перетаскивания**|

| arcThumbRadiusEnlarges | dimension | 2dp | увеличение радиуса кнопки при касании**|

| arcShowThumb | boolean | true | показывать ли кнопку перетаскивания**|

| arcThumbDrawable | reference | | изображение кнопки перетаскивания (приоритет arcThumbDrawable выше, чем у arcThumbColor) |

| arcAllowableOffsets | dimension | 10dp | допустимое смещение при касании: чем больше смещение, тем меньше точность касания**|

| arcEnabledDrag | boolean | true | включить изменение прогресса путём перетаскивания**|

| arcEnabledSingle | boolean | true | включить изменение прогресса нажатием**|

Пример

Пример макета:

    <com.king.view.arcseekbar.ArcSeekBar
        android:id="@+id/arcSeekBar"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        app:arcEnabledDrag="true"/>

Пример кода:

    // Прогресс изменения слушателя
    arcSeekBar.setOnChangeListener(listener);
    // Установить прогресс
    arcSeekBar.setProgress(progress);
    // Показать анимацию прогресса (прогресс, время анимации)
    arcSeekBar.showAnimation(80,3000);

Для получения дополнительной информации о применении см. примеры использования в приложении или непосредственно в документации API.

Рекомендуемые аналоги

• CircleProgressView — это круговой индикатор прогресса с плавной анимацией.

Журнал версий

v1.1.1：2024-7-17

• Оптимизация деталей.

v1.1.0：2024-6-25

• Добавлен настраиваемый атрибут arcThumbDrawable.
• Оптимизированы детали.

v1.0.3：2021-9-1 (с версии v1.0.3 публикуется в MavenCentral)

• Экспортировано больше методов getter и setter.
• Добавлена настройка arcTickOffsetAngle.
• Публикация в MavenCentral.

v1.0.2：2020-12-2

• Улучшена обработка процесса установки градиента.

v1.0.1：2020-9-16

• Детали оптимизированы.

v1.0.0：2020-3-28

• Начальная версия ArcSeekBar.

Пожертвование

Если вам нравится ArcSeekBar или вы считаете, что ArcSeekBar вам помог, вы можете поддержать его, поставив «Star». Ваша поддержка — моя мотивация, спасибо

Вы также можете отсканировать следующий QR-код, чтобы поддержать автора:

Обо мне

Свяжитесь со мной

Примечание: в тексте запроса присутствуют ссылки на внешние ресурсы, которые не были переведены. QQ邮箱 | QQ群 | QQ群 | |:---------------------|:-----------------------------------------------------------------------------|:------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------|:------------------------------------------------------------------------------------------------------------| | Jenly666 (http://weixin.qq.com/r/wzpWTuPEQL4-ract92-R) | jenly1314@gmail.com | jenly1314@vip.qq.com | 20867961 | 64020761 |