API dei componenti

Le props e gli eventi dei due componenti, così come sono dichiarati in @edubeam/plot 0.2.0. Nessuno dei due ha slot. I valori in unità SI sono indicati come tali; le dimensioni sono in pixel CSS.

StructurePlot

TypeScript
import { StructurePlot } from '@edubeam/plot'

Disegna una struttura piana e i suoi risultati. Guida: StructurePlot.

Props

PropTipoPredefinitoDescrizione
solverSolver–Un solutore di @edubeam/fem. I risultati vengono disegnati quando il suo caso di carico è risolto.
modelPlotModel–In alternativa, i dati semplici prodotti da modelFromSolver. Ha la precedenza su solver.
loadCasenumber0Indice in solver.loadCases
revisionnumber0Cambialo per ridisegnare un solutore modificato senza sostituirlo
layersreadonly PlotLayer[]aste, vincoli, carichi, reazioni e un risultatoChe cosa disegnare: 'nodes', 'nodeLabels', 'dimensions', 'members', 'supports', 'loads', 'reactions', 'N', 'V', 'M', 'w'
reservereadonly PlotLayer[]layersLivelli per cui lasciare spazio mentre sono nascosti
compactbooleanfalseDisegno per miniature: simboli più piccoli, al massimo due valori per asta
unitsPartial<Units>KN_UNITSUnità di visualizzazione
numberFormatIntl.NumberFormatinglese, al massimo 1 decimaleFormatta ogni numero
colorsPartial<PlotColors>–Colori personalizzati per tono: Temi e colori
widthnumber640, compact 400Larghezza prima che il contenitore sia misurato, ad esempio sul server
heightnumber–Altezza fissa. Senza, l’altezza segue il disegno.
maxHeightnumbermax(320, 0.75 × width), compact nessunoLimite superiore dell’altezza automatica
paddingnumber6Spazio attorno al disegno
fontSizenumber13, compact 11.5Dimensione del testo
diagramSizenumber48, compact 26Lunghezza dell’ordinata maggiore di un diagramma
deformedSizenumber30, compact 18Spostamento massimo sulla deformata
diagramScalePartial<Record<ResultLayer, number>>–Scala fissa in px per unità SI per un risultato; sostituisce diagramSize o deformedSize
momentOnTensionSidebooleantrueM dal lato teso; false per il lato compresso
resultLabelMode'horizontal' | 'axis''horizontal'Valori diritti, oppure ruotati lungo la loro ordinata
reactionLabels'values' | 'names''values'Reazioni come agiscono, con il loro valore; oppure, per un esercizio, ogni direzione vincolata con il suo nome (Ax, MA) e orientata nel verso considerato positivo. I nomi non richiedono risultati: Reazioni come incognite
reserveLabelModesreadonly ResultLabelMode[]–Modalità delle etichette per cui lasciare spazio oltre a quella corrente
reserveReactionLabelsreadonly ReactionLabels[]–Stili delle etichette delle reazioni per cui lasciare spazio oltre a reactionLabels, così un esercizio che diventa la sua soluzione mantiene fermo il disegno
animatebooleantrueFa comparire i livelli in dissolvenza e disegna le aste progressivamente. Sempre disattivato con prefers-reduced-motion.
hoverbooleanfalseLegge i valori sotto il puntatore, segnati all’estremità dell’ordinata di ogni diagramma. Se è disattivato, la figura non riceve alcun input dal puntatore.
titlestringuna descrizione di ciò che è mostratoNome accessibile della figura

Senza layers, il risultato è M per travi e telai, N per una travatura reticolare e w quando nulla è sollecitato (defaultResultLayer).

Eventi

EventoPayloadQuando
readoutReadout | nullCon hover: il punto dell’asta sotto il puntatore e i suoi risultati; null quando il puntatore esce
TypeScript
interface Readout {
  readonly member: string
  readonly x: number // m dal nodo iniziale dell’asta
  readonly px: number // il punto sullo schermo, px
  readonly py: number
  readonly values: Readonly<Record<'N' | 'V' | 'M' | 'w', SidedValue>> // unità SI
  readonly u: number // spostamento lungo l’asse x locale dell’asta, m
}
interface SidedValue {
  readonly left: number
  readonly right: number // uguale a left dove il risultato è continuo
}

DiagramStack

TypeScript
import { DiagramStack } from '@edubeam/plot'

Disegna una trave rettilinea sopra i suoi diagrammi, su un unico asse x. Le aste devono formare un’unica linea orizzontale, disegnata da sinistra a destra; in tutti gli altri casi il componente solleva un errore. Guida: DiagramStack.

Props

PropTipoPredefinitoDescrizione
solverSolver–La trave risolta
modelPlotModel–In alternativa, i dati semplici di modelFromSolver; ha la precedenza
loadCasenumber0Indice in solver.loadCases
revisionnumber0Cambialo per ridisegnare un solutore modificato senza sostituirlo
membersreadonly string[]tutte le asteLe aste della linea della trave
rowsreadonly StackRow[]['V', 'M', 'w']Righe dei diagrammi, dall’alto verso il basso, tra 'N', 'V', 'M', 'w'
loadRowbooleantrueLa trave con vincoli, carichi e reazioni sopra le righe
rangesPartial<Record<StackRow, readonly [number, number]>>quello di ogni rigaIntervallo di valori per riga, unità SI
rowHeightsPartial<Record<StackRow, number>>N 100, V 116, M 128, w 76; sotto i 560 px di larghezza 88, 96, 104, 64Altezze delle righe prima che maxHeight le riduca
maxHeightnumber–Le righe si riducono, fino al 60 % al massimo, perché la figura ci stia. Il testo mantiene la sua dimensione.
unitsPartial<Units>KN_UNITSUnità di visualizzazione
numberFormatIntl.NumberFormatinglese, al massimo 1 decimaleFormatta ogni numero
colorsPartial<PlotColors>–Colori personalizzati
widthnumber720Larghezza prima che il contenitore sia misurato; si usano almeno 320
fontSizenumber12.5Dimensione del testo
hoverbooleantrueIl cursore di lettura. Se è disattivato, la figura non riceve alcun input dal puntatore.
loadAtnumber–Posizione (m lungo la linea) di un carico concentrato che il lettore può trascinare; da usare con v-model:load-at
loadLabelstringP = … con l’intensità del caricoTesto accanto al carico trascinabile
loadStepnumber0.05Il passo a cui si arrotonda il trascinamento, m; i tasti freccia spostano il carico di questo passo
titlestringuna descrizione delle righeNome accessibile della figura

Eventi

EventoPayloadQuando
update:loadAtnumberIl lettore ha spostato il carico: la sua nuova posizione, m. Alimenta v-model:load-at.
readoutStackReadout | nullI valori del cursore su tutte le righe; null quando il puntatore esce
TypeScript
interface StackReadout {
  readonly x: number // m lungo la linea della trave
  readonly values: Partial<Record<'N' | 'V' | 'M' | 'w', { readonly left: number; readonly right: number }>> // SI
}

Il plugin

TypeScript
import { EduBeamPlot } from '@edubeam/plot'

app.use(EduBeamPlot) // registra <StructurePlot> e <DiagramStack> a livello globale

È facoltativo: importare i componenti per nome è più leggero, e un bundler elimina il plugin da una build che non lo usa.

Tipi

Per scrivere wrapper tipizzati attorno ai componenti, il pacchetto esporta le loro props e i loro eventi:

TypeScript
import type { PlotLayer, StructurePlotProps } from '@edubeam/plot'

const figure: StructurePlotProps = { layers: ['members', 'supports', 'M'] satisfies PlotLayer[], compact: true }
TipoChe cos’è
StructurePlotProps, StructurePlotEmitsLe props e gli eventi di StructurePlot
DiagramStackProps, DiagramStackEmitsLe props e gli eventi di DiagramStack
Readout, ReadoutQuantity, SidedValue, StackReadoutPayload degli eventi
PlotLayer, ResultLayer, ResultLabelMode, ReactionLabels, StackRowNomi di livelli, risultati, modalità delle etichette, etichette delle reazioni e righe
Units, Unit, UnitKindUnità di visualizzazione: { symbol, scale } per tipo di grandezza
PlotColorsColori per tono
PlotModelIl modello semplice: Modello di disegno

Gli altri export, tra cui structureSvg per i file SVG e le funzioni su cui si basa il disegno, sono in Funzioni.