Status Tracker

Bir durum izleyici: bir dizi adım, bir sıra blok olarak; her blok, o adımda olanın renginde. Bir hizmetin ayakta olduğu günler, geçen derlemeler: kötü olanların nerede olduğu bir bakışta görülür, hangileri olduğu gösterilerek okunur.

import com.pantrixui.components.chart.statustracker.PantrixStatusTracker

• Gösterilen blok. İmlecin altındaki ya da dokunulan bloğun adı, renginin yanında, sıranın altına yazılır; ötekiler soluk çizilir. Parmakla, gösterilen bloğa yeniden dokunmak onu bırakır.
• Alttaki satır. caption kapatılırsa ad yazılmaz. Satırın yeri, bir blok gösterilse de gösterilmese de tutulur: sıra yerinden oynamaz.
• Basmak. onSelect, basılan bloğun sıfırdan sayılan yerini verir.
• Durum. Gösterilen blok ChartState'te, x'i bloğun yeri olan bir seçim olarak durur.
• Yön. Sağdan sola okunan dilde ilk blok sağda durur ve oklar gösterdikleri yöne gider.
• Dışa aktarma. export grafiğin üstüne bir düğme koyar: grafik ekrandaki hâliyle, gösterilen yer ve tooltip olmadan, PNG, SVG ya da PDF dosyası olarak üretilir ve uygulamaya verilir.
• Otomasyon. StatusTracker_<tagKey>; sıra .Blocks, bloklar .Block_<sıra>, alttaki satır .Caption.

Örnekler

Bir hizmetin günleri

Bir hizmetin son otuz günü: yeşil günlerde ayakta, sarı günlerde yavaş, kırmızı günde kesik; gri günün kaydı yok.

İmleci bir bloğun üstüne getir ya da bloğa dokun: günün adı sıranın altına yazılır ve öteki günler solar. Klavyede oklar günden güne gider.

PantrixStatusTracker(
    blocks = uptimeDays(),
    description = "Son otuz günün durumu",
    tagKey = "plain"
)

@Composable
private fun uptimeDays(): List<StatusBlock> {
    val colors = PantrixTheme.colors
    return List(30) { index ->
        val day = "${index + 1}. gün"
        when (index) {
            7, 21 -> StatusBlock("$day: Yavaş", colors.warning.color)
            13 -> StatusBlock("$day: Kesinti", colors.danger.color)
            26 -> StatusBlock("$day: Kayıt yok")
            else -> StatusBlock("$day: Sorunsuz", colors.success.color)
        }
    }
}

Bir bloğa basmak

onSelect, basılan bloğun yerini verir: bir güne bas ya da klavyeyle bir güne gidip Enter'a bas, kartın altındaki satır basılanı yazar. Burada alttaki ad satırı kapalı (caption = false).

val report = LocalExampleEvents.current
val days = uptimeDays()
PantrixStatusTracker(
    blocks = days,
    caption = false,
    description = "Son otuz günün durumu",
    onSelect = { report(days[it].name) },
    tagKey = "pressed"
)

@Composable
private fun uptimeDays(): List<StatusBlock> {
    val colors = PantrixTheme.colors
    return List(30) { index ->
        val day = "${index + 1}. gün"
        when (index) {
            7, 21 -> StatusBlock("$day: Yavaş", colors.warning.color)
            13 -> StatusBlock("$day: Kesinti", colors.danger.color)
            26 -> StatusBlock("$day: Kayıt yok")
            else -> StatusBlock("$day: Sorunsuz", colors.success.color)
        }
    }
}

Kendi ölçülerin

Bir sıranın kendi ölçüleri: bloklar daha yüksek (trackerHeight), araları daha açık (barGap) ve köşeleri keskin (barRadius). Verilmeyen alan temanınki kalır.

PantrixStatusTracker(
    blocks = uptimeDays().take(14),
    description = "Son iki haftanın durumu",
    style = ChartStyle(trackerHeight = 48.dp, barGap = 6.dp, barRadius = 0.dp),
    tagKey = "own_look"
)

@Composable
private fun uptimeDays(): List<StatusBlock> {
    val colors = PantrixTheme.colors
    return List(30) { index ->
        val day = "${index + 1}. gün"
        when (index) {
            7, 21 -> StatusBlock("$day: Yavaş", colors.warning.color)
            13 -> StatusBlock("$day: Kesinti", colors.danger.color)
            26 -> StatusBlock("$day: Kayıt yok")
            else -> StatusBlock("$day: Sorunsuz", colors.success.color)
        }
    }
}

Dışa aktarma

export = ChartExport(...) grafiğin üstüne bir dışa aktarma düğmesi koyar: bas ve türü seç (PNG, SVG ya da PDF). Grafik dosyayı üretir ve onExport'a verir; altta adı ve boyu, PNG ise resmi görünür, "Dosyayı kaydet" onu platformun yoluyla verir.

Dosyada blokların satırı durur; altındaki, gösterilen bloğun adını yazan satır dosyada yoktur.

var file by remember { mutableStateOf<ChartExportFile?>(null) }
PantrixStatusTracker(
    blocks = uptimeDays(),
    description = "Son otuz günün durumu",
    tagKey = "exported",
    export = ChartExport(fileName = "son-otuz-gun") { file = it }
)
ExportedFile(file, tagKey = "exported")

@Composable
private fun uptimeDays(): List<StatusBlock> {
    val colors = PantrixTheme.colors
    return List(30) { index ->
        val day = "${index + 1}. gün"
        when (index) {
            7, 21 -> StatusBlock("$day: Yavaş", colors.warning.color)
            13 -> StatusBlock("$day: Kesinti", colors.danger.color)
            26 -> StatusBlock("$day: Kayıt yok")
            else -> StatusBlock("$day: Sorunsuz", colors.success.color)
        }
    }
}

API

blocks

Bir durum izleyici: bir dizi adım, bir sıra blok olarak; her blok, o adımda olanın renginde. Bir hizmetin ayakta olduğu günler, geçen derlemeler: kötü olanların nerede olduğu bir bakışta görülür, hangileri olduğu gösterilerek okunur.

ChartStyle

Bir grafiğin geometrisi: hiçbir şey söylemediğinde ne kadar yüksek olduğu, çizgilerinin ne kadar kalın, işaretlerinin ne kadar büyük olduğu ve parçalarının arasındaki boşluk; ve dolgularının renklerinin yanında desen alıp almadığı.

ChartColors

Temanın renklerini almayan bir grafik için, onun neyle boyandığı: verilen renk kullanılır, verilmeyen temanınki kalır.

Erişilebilirlik

• Klavye. Sıra, Tab için tek duraktır: oklar bloktan bloğa gider ve uçlarda durur, Home ve End ilk ve son bloğa gider, Escape bırakır, Enter ve boşluk gösterilen bloğa basar.
• Ekran okuyucu. Sıra description'ını, ardından her bloğu adıyla söyler. İki yüzden çok bloğu olan sıra yalnızca açıklamasıyla anlatılır.