Функция CircularProgressIndicator

Функция CircularProgressIndicator рисует кольцо прогресса по центру области. Параметр progress задаёт долю от 0 до 1 через лямбду () -> Float в актуальном Material3. Без progress кольцо крутится в бесконечном режиме ожидания.

Синтаксис

CircularProgressIndicator(
	progress = { 0.7f },
)

Параметры

Параметр	Описание
`progress`	Лямбда, возвращающая долю обхода от `0f` до `1f`. Без параметра индикатор крутится бесконечно.
`color`	Цвет дуги прогресса.
`strokeWidth`	Толщина линии кольца в dp.

Пример

Давайте покажем прогресс на семь десятых:

import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.material3.CircularProgressIndicator

class MainActivity : ComponentActivity() {
	override fun onCreate(savedInstanceState: Bundle?) {
		super.onCreate(savedInstanceState)
		setContent {
			CircularProgressIndicator(
				progress = { 0.7f },
			)
		}
	}
}

На экране кольцо будет заполнено примерно на семь десятых оборота.

Пример

Давайте покажем бесконечную загрузку:

import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.material3.CircularProgressIndicator

class MainActivity : ComponentActivity() {
	override fun onCreate(savedInstanceState: Bundle?) {
		super.onCreate(savedInstanceState)
		setContent {
			CircularProgressIndicator()
		}
	}
}

На экране кольцо будет непрерывно вращаться без фиксированного процента.

Смотрите также

функция LinearProgressIndicator,
которая рисует горизонтальную полоску
функция Box,
куда центрируют круговой индикатор
класс Color,
которым меняют цвет дуги
функция Button,
рядом с которой показывают загрузку