Meter Group

Bir ölçüm grubu: bir bütünün birkaç miktarı, tek bir çubukta yan yana. Bir depolamanın neyle dolduğu, bir bütçenin nasıl harcandığı: parçalar birbirine ve kalana göre okunur.

import com.pantrixui.components.chart.metergroup.PantrixMeterGroup

• Değerler. Bir parçanın değeri max ile aynı birimdendir. Değeri olmayan ya da sıfırı aşmayan parça çubukta yer almaz, lejantta adı durur. Parçaların toplamı max'i aşarsa fazlası çubuğun ucunda kesilir.
• Lejant. Her parçanın adını, ardından değerini, renginin yanında yazar. Çubuğun üstünde ya da altında durur: başta duran lejant üstte, sonda duran altta sayılır. Kayıtları burada anahtar değildir: çubuk kendisine verileni gösterir.
• Yazım. format bir değerin lejantta nasıl yazılacağını söyler; verilmezse temanın diliyle sayı olarak yazılır.
• Yön. Sağdan sola okunan dilde ilk parça sağda durur.
• 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. MeterGroup_<tagKey>; çubuk .Bar, lejantın kayıtları .Legend_<parçanın anahtarı>.

Örnekler

Bir bütünü dolduranlar

En yalın hâli: altmış dört gigabaytlık bir depolamayı dolduran dört şey. Çubuğun dolmayan ucu boş kalan yeri gösterir; lejant her parçayı değeriyle yazar.

PantrixMeterGroup(
    items = METER_STORAGE,
    max = 64,
    format = { "${it.toInt()} GB" },
    description = "Depolama",
    tagKey = "plain"
)

private val METER_STORAGE = listOf(
    MeterItem("apps", "Uygulamalar", 16),
    MeterItem("photos", "Fotoğraflar", 24),
    MeterItem("messages", "Mesajlar", 8),
    MeterItem("system", "Sistem", 10)
)

Lejant üstte

Lejant çubuğun üstünde ve satırın başında (ChartLegend(position = Top, alignment = Start)). Değerler bütünün payı olarak, temanın diliyle yazılıyor.

val strings = PantrixTheme.strings
PantrixMeterGroup(
    items = METER_BUDGET,
    format = { strings.percent(it / 100) },
    legend = ChartLegend(position = ChartLegendPosition.Top, alignment = ChartLegendAlignment.Start),
    description = "Bütçenin dağılımı",
    tagKey = "legend_above"
)

private val METER_BUDGET = listOf(
    MeterItem("rent", "Kira", 40),
    MeterItem("food", "Mutfak", 25),
    MeterItem("transport", "Ulaşım", 15),
    MeterItem("savings", "Birikim", 20)
)

Yalnızca çubuk

Lejantsız bir çubuk (legend = null): bir satırın içinde, yanındaki yazı neyi gösterdiğini zaten söylerken. Ekran okuyucu parçaları çubuğun kendisinden duyar.

PantrixMeterGroup(
    items = METER_STORAGE,
    max = 64,
    format = { "${it.toInt()} GB" },
    legend = null,
    description = "Depolama",
    tagKey = "bar_only"
)

private val METER_STORAGE = listOf(
    MeterItem("apps", "Uygulamalar", 16),
    MeterItem("photos", "Fotoğraflar", 24),
    MeterItem("messages", "Mesajlar", 8),
    MeterItem("system", "Sistem", 10)
)

Kendi renklerin ve ölçülerin

Bir çubuğun kendi görünüşü: her parça kendi rengini söylüyor, çubuk daha kalın (meterHeight), uçları köşeli (barRadius) ve parçaların arası kapalı (sliceGap). Verilmeyen alan temanınki kalır.

val violet = PantrixPalette.Violet
PantrixMeterGroup(
    items = listOf(
        MeterItem("done", "Biten", 18, color = violet.shade700),
        MeterItem("doing", "Süren", 9, color = violet.shade500),
        MeterItem("waiting", "Bekleyen", 13, color = violet.shade300)
    ),
    max = 40,
    description = "İşlerin durumu",
    style = ChartStyle(meterHeight = 16.dp, barRadius = 0.dp, sliceGap = 0.dp),
    tagKey = "own_look"
)

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 çubuk ve altında lejant durur: her parçanın adı ve değeri.

var file by remember { mutableStateOf<ChartExportFile?>(null) }
PantrixMeterGroup(
    items = METER_STORAGE,
    max = 64,
    format = { "${it.toInt()} GB" },
    description = "Depolama",
    tagKey = "exported",
    export = ChartExport(fileName = "depolama") { file = it }
)
ExportedFile(file, tagKey = "exported")

private val METER_STORAGE = listOf(
    MeterItem("apps", "Uygulamalar", 16),
    MeterItem("photos", "Fotoğraflar", 24),
    MeterItem("messages", "Mesajlar", 8),
    MeterItem("system", "Sistem", 10)
)

API

items

Bir ölçüm grubu: bir bütünün birkaç miktarı, tek bir çubukta yan yana. Bir depolamanın neyle dolduğu, bir bütçenin nasıl harcandığı: parçalar birbirine ve kalana göre 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

• Ekran okuyucu. Çubuk description'ıyla bir resimdir; parçaları lejantın kayıtları söyler. Lejantı olmayan çubuk parçalarını kendisi söyler.