Arc

Disegna un arco ellittico in base all'angolo iniziale e all'angolo di apertura, adatto per archi in scala e visualizzazione dell'avanzamento. Il bordo è determinato dalla larghezza e dall'altezza. La larghezza, il punto finale e la posizione del tratto sono configurabili e lo sfondo può riempirsi quando è completamente chiuso.

Esempio

function main() {
  return (
    <Arc
      width={120}
      height={120}
      startAngle={-90}
      sweepAngle={240}
      stroke={$env.accent}
      lineWidth={8}
      lineCap="round"
      strokePosition="center"
    />
  );
}

Utilizzo

Ellipse e Arc usano tutta larghezza e altezza; uguali danno un cerchio. Gli archi parziali restano aperti senza unirsi al centro. background riempie solo un giro intero chiuso.
Angoli in gradi: 0 destra, 90 basso, sweep positivo orario. startAngle modulo 360, sweepAngle limitato a −360…360. Zero non disegna, ±360 chiude. wrap:360 solo per startAngle.
background/stroke accettano Color o Gradient. Usa tre costruttori Gradient: posizioni e centri 0–1, raggi in punti. HDR avvolge un colore; luminosità dipende da dispositivo e ambiente.

Proprietà

startAngle?number

Angolo iniziale in gradi, normalizzato modulo 360 durante il campionamento.

Esempio-90

sweepAngle?number

Ampiezza in gradi, limitata a -360…360 durante il campionamento. I valori positivi seguono il senso orario; wrap non è supportato.

Esempio270

background?Paint

Riempimento di un cerchio o ellisse completi e chiusi. Ignorato per archi parziali.

Esempio"clear"

stroke?Paint

Colore o gradiente del tratto; clear lo nasconde.

EsempioHDR($env.dark ? "white" : "black")

lineWidth?number

Spessore del tratto in punti; 0 non disegna il tratto.

Esempio2

strokePosition?"inside" | "center" | "outside"

Posizione del tratto rispetto al contorno completo del cerchio o dell’ellisse. Valore predefinito: inside.

Esempio"inside"

lineCap?"round" | "butt" | "square"

Estremità: butt taglia, square prolunga in quadrato, round arrotonda.

Esempio"round"

dash?number[]

Lunghezze alternate di tratto e spazio in punti; array vuoto per linea continua.

Esempio[]

dashPhase?number

Spostamento del motivo tratteggiato in punti.

Esempio0

Proprietà comuni

width?number | "auto" | "fill"

Larghezza in punti, dimensione automatica o riempimento del contenitore.

Esempio"fill"

height?number | "auto" | "fill"

Altezza in punti, dimensione automatica o riempimento del contenitore.

Esempio"fill"

x?number

Spostamento visivo in punti: x a destra, y in basso; non cambia lo spazio nel layout.

Esempio0

y?number

Spostamento visivo in punti: x a destra, y in basso; non cambia lo spazio nel layout.

Esempio0

transform?ViewTransform

Trasformazione globale senza cambiare il layout. Traslazione in punti, rotazione/inclinazione in gradi, scala 1 invariata, ancoraggi 0–1.

Esempio{rotation: 0}

opacity?number

Opacità dell’intero View: 0 trasparente, 1 opaco.

Esempio1

clipped?boolean

Ritaglia il disegno oltre i limiti del View.

Esempiofalse

clip?"rectangle" | "ellipse"

Forma di ritaglio rectangle o ellipse; Material accetta anche false per disattivarlo.

Esempio"rectangle"

mask?View | null

View per la maschera alfa. Centrata senza modificare il layout; null disattiva la maschera.

Esempio<Circle width="fill" height="fill" background="white"/>

zIndex?number

Ordine tra elementi fratelli; valori più grandi appaiono davanti.

Esempio0

blur?number

Raggio della sfocatura in punti; 0 la disattiva.

Esempio4

innerShadow?DrawingEffect

Colore, opacità, raggio di sfocatura e offset x/y dell’effetto; distanze in punti.

Esempio{color: HDR("black"), opacity: 0.5, radius: 4, x: 0, y: 2}

glow?DrawingEffect

Colore, opacità, raggio di sfocatura e offset x/y dell’effetto; distanze in punti.

Esempio{color: HDR("cyan"), radius: 8, opacity: 0.8}

shadowColor?Color

Colore dell’ombra esterna.

EsempioHDR("black")

shadowOpacity?number

Opacità dell’ombra 0–1; 0 la nasconde.

Esempio0

shadowRadius?number

Raggio di sfocatura dell’ombra esterna in punti.

Esempio4

shadowX?number

Offset dell’ombra in punti: x a destra, y in basso.

Esempio0

shadowY?number

Offset dell’ombra in punti: x a destra, y in basso.

Esempio2

animations?ArcAnimation[]

Anima le modifiche alle proprietà. duration/delay in secondi; from/to sono estremi; repeat/autoreverse controllano le ripetizioni, wrap il periodo.

Esempio[{property: "opacity", duration: 0.25, curve: "easeInOut"}]

key?string | number

Identità stabile tra elementi fratelli.

Esempio pratico

function main() {
  return (
    <Arc
      width={180}
      height={100}
      startAngle={180}
      sweepAngle={180}
      background="clear"
      stroke={LinearGradient(['#30B3A2', '#A9E56F'])}
      lineWidth={8}
      strokePosition="inside"
      lineCap="round"
    />
  );
}

Animazione

widthheightxyopacitybackgroundblurshadowColorshadowOpacityshadowRadiusshadowXshadowYdashPhasestrokelineWidthstartAnglesweepAngletransform.translateXtransform.translateYtransform.scaleXtransform.scaleYtransform.rotationtransform.skewXtransform.skewYtransform.anchorXtransform.anchorY

Quando omesso

La tabella documenta omissioni verificate nell’implementazione. Gli esempi non sono valori predefiniti. Specifica valori per risultati fissi; misure e colori contestuali non sono costanti.

Proprietà	Quando omesso
`startAngle`	`-90`
`sweepAngle`	`270`
`lineWidth`	`2`
`strokePosition`	`"inside"`
`background`	`"clear"`
`stroke`	`HDR($env.dark ? 'white' : 'black')`

Esempio

Utilizzo

Proprietà

Esempio pratico

Animazione

Quando omesso

Circle

Ellipse

RadialLayout

Color / Gradient

In questa pagina

Arc

Esempio

Utilizzo

Proprietà

Esempio pratico

Animazione

Quando omesso

API correlate

Circle

Ellipse

RadialLayout

Color / Gradient

In questa pagina