Tipografi

Pantrix'in yazı ölçeği, stili verilmeyen yazının neyle yazıldığı ve metin alanlarına yazılan yazının boyu.

1. Ölçek

PantrixTypography dokuz rol tutar. Boyutlar ve satır yükseklikleri sp iledir, sistemin yazı boyutuyla büyür.

2. Rolüyle anmak: TypeRole

Bir bileşenin stili yazı tipi tutmaz, yalnız hangi rolde yazdığını söyler. Yazı tipi temanındır:

val style: TextStyle = PantrixTheme.typography[TypeRole.Body]

TypeRole her rol için bir değer taşır (Display … Code). Bir stilin TypeRole? alanı boş kalırsa preset'inki geçerlidir.

3. Temel yazı: LocalPantrixTextStyle

Stili verilmeyen yazının stili. PantrixText, PantrixLink ve PantrixAutoText style verilmediğinde bunu alır.

• PantrixTheme onu ölçeğin label'ıyla başlatır. İç içe bir tema kendi ölçeğinin label'ıyla yeniden başlatır.

• Bir bölüm kendi temel yazısını verir. Verdiği alanlar kazanır, vermedikleri çevresindekinde kalır:

ProvidePantrixTextStyle(PantrixTheme.typography.body) {
    PantrixText("Bu bölümdeki paragraflar body ile yazılır.")
    ProvidePantrixTextStyle(TextStyle(fontWeight = FontWeight.SemiBold)) {
        PantrixText("Yalnız kalınlık değişir, boyut body'nin kalır.")
    }
}

• Açıkça verilen bir style temel yazının üstündedir.

• Bir PantrixTheme'in dışında değer TextStyle.Default'tur.

Compose foundation'ın BasicText'i bu değeri okumaz

BasicText'e stil verilmezse metin TextStyle.Default ile yazılır: sistemin yazı tipi, 14sp. Material'in LocalTextStyle'ını da yalnız Material'in kendi bileşenleri okur. Uygulamanın kendi BasicText'i temel yazıyı kendisi almalıdır:

BasicText(text = words, style = LocalPantrixTextStyle.current)

Kütüphanenin kendi içinde stilsiz bir BasicText yoktur (2026-10-18'de tarandı): yazıların hepsi PantrixText'ten geçer.

4. Metin alanına yazılan yazının boyu

Metin alanının stili hangi rolde yazdığını textRole ile söyler: TextFieldStyle.textRole ve FilledTextFieldStyle.textRole.

Bu rolle yazılanlar:

• Yazılan yazı ve yer tutucu, bütün alan türlerinde: çerçeveli, dolu, gizli yazılı ve kendini boyutlayan alanlar.

• Dolu alanın içerideki etiketi dinlenirken. Yukarı kalkınca footnote olur.

• Select'in kutusu ve listesindeki arama alanı. Select'in "seçenekleri kadar geniş" ölçüsü de bununla yapılır.

• Sayfalamanın sayfaya atlama alanı.

Kutunun üstündeki etiket (label rolü) ve yardım metni (footnote) değişmez.

Material 3 ile karşılaştırma

Material 3'te bunlar OutlinedTextFieldTokens.InputFont = BodyLarge ile gelir; MaterialTheme de LocalTextStyle'a bodyLarge verir. Pantrix'in label'ı Material 3'te labelLarge'a denk gelir (14/20, Medium), ama M3 onu düğme ve sekme yazısında kullanır.

Bütün uygulama için değiştirmek

PantrixTheme(
    styles = pantrixStyles(
        TextFieldStyle.override(all = TextFieldStyle(textRole = TypeRole.Body)),
        FilledTextFieldStyle.override(all = FilledTextFieldStyle(textRole = TypeRole.Body))
    )
) { App() }

Tek bir alan için PantrixTextField(style = TextFieldStyle(textRole = TypeRole.Callout)) yeter.

5. Tuzaklar

• Masaüstünde etiket ve yazı aynı boydadır. Kutunun üstündeki etiket de yazılan yazı da 14sp'dir: ayrım renk ve kalınlıkla kalır.

• Alanın boyu değişmez. Kutunun yüksekliği en az yüksekliktir. Tek satırlı alan aynı boyda kalır; çok satırlı alanın satırları masaüstünde 20sp'ye iner.

• iPhone'daki Safari 16px'ten küçük yazılı bir alana odaklanınca sayfayı yakınlaştırır. Web hedefi iPhone'da label (14sp) yazar. Compose web'in arkadaki gizli giriş alanının buna takılıp takılmadığı denenmedi.

• Stil görünüştür, rol değil. Başlık stiliyle yazılan metin ekran okuyucu için başlık olmaz: PantrixText'in role parametresi söyler.

6. Dosyalar