Spinner
Süresi bilinmeyen kısa beklemeler için belirsiz bir yükleme göstergesi. currentColor'ı aldığı için içinde durduğu metne ya da butona uyar.
<Spinner label="Yükleniyor" />Import
import { Spinner } from "@merid/react";Örnekler
Boyutlar
Çaplar 14px (sm), 18px (md, varsayılan) ve 24px (lg).
<Spinner size="sm" label="Yükleniyor" />
<Spinner size="md" label="Yükleniyor" />
<Spinner size="lg" label="Yükleniyor" />Metnin yanında
Neyin yüklendiğini görünür bir metin zaten söylüyorsa spinner'ı yardımcı teknolojiden gizlemek için label={null} ver; böylece mesaj iki kez okunmaz.
<Stack direction="row" gap={2} align="center">
<Spinner size="sm" label={null} />
<Text size="sm" as="span">Faturalar yükleniyor…</Text>
</Stack>Renk
color'ı spinner'a ya da bir üst elemana ver. Tek başına duruyorsa ona özel bir label ver.
<span style={{ color: "var(--mrd-accent)" }}>
<Spinner size="lg" label="Yükleniyor" />
</span>API referansı
Bir span render'lar; ref'ini iletir ve native attribute'ları aktarır.
| Prop | Tip | Varsayılan | Açıklama |
|---|---|---|---|
size | "sm" | "md" | "lg" | "md" | Çap: sm 14px, md 18px, lg 24px. |
label | string | null | "Loading" | Erişilebilir ad. Dekoratifse null ver; spinner o zaman aria-hidden olur. Türkçe arayüzlerde Türkçe bir değer ver. |
Stil verme
| Seçici | Değerler |
|---|---|
.mrd-spinner | Kök <span> |
.mrd-spinner__svg | SVG |
.mrd-spinner__track | Soluk tam daire |
.mrd-spinner__arc | Dönen çeyrek yay |
data-size | sm · md · lg |
Component değişkeni: her boyut için ayarlanan --mrd-spinner-size.
.hero .mrd-spinner {
--mrd-spinner-size: 32px;
}Erişilebilirlik
- Etiket verildiğinde spinner
role="status"vearia-labeltaşır, ekran okuyucular onu araya girmeden okur. label={null}ilearia-hiddenolur. Yüklenen bölgeyiaria-busy="true"ile işaretle.prefers-reduced-motionaçıkken dönüş durmaz, yavaşlar; böylece ilerleme görünür kalır.
Kullanım ilkeleri
Yap
Spinner'ı birkaç saniyenin altındaki beklemeler için kullan. Daha uzun ya da ölçülebilir işlerde bir Progress çubuğu göster.
Kaçın
Bir Skeleton gelecek içeriğin şeklini gösterebilecekken bütün sayfayı bir spinner'la değiştirmek.