Komponenten-API

Die Props und Events der beiden Komponenten, wie sie in @edubeam/plot 0.2.0 deklariert sind. Slots haben beide nicht. Werte in SI-Einheiten sind als solche gekennzeichnet; Größen sind CSS-Pixel.

StructurePlot

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

Zeichnet ein ebenes Tragwerk und seine Ergebnisse. Anleitung: StructurePlot.

Props

PropTypStandardBeschreibung
solverSolver–Ein Solver von @edubeam/fem. Ergebnisse werden gezeichnet, sobald sein Lastfall berechnet ist.
modelPlotModel–Oder die einfachen Daten, die modelFromSolver erzeugt. Hat Vorrang vor solver.
loadCasenumber0Index in solver.loadCases
revisionnumber0Ändern Sie den Wert, um einen direkt veränderten Solver neu zu zeichnen
layersreadonly PlotLayer[]Stäbe, Lager, Lasten, Auflagerreaktionen und ein ErgebnisWas gezeichnet wird: 'nodes', 'nodeLabels', 'dimensions', 'members', 'supports', 'loads', 'reactions', 'N', 'V', 'M', 'w'
reservereadonly PlotLayer[]layersEbenen, für die auch im ausgeblendeten Zustand Platz freigehalten wird
compactbooleanfalseDarstellung als Vorschaubild: kleinere Symbole, höchstens zwei Werte pro Stab
unitsPartial<Units>KN_UNITSAnzeigeeinheiten
numberFormatIntl.NumberFormatenglisch, höchstens 1 NachkommastelleFormatiert jede Zahl
colorsPartial<PlotColors>–Abweichende Farben je Farbton: Farben und Farbschemata
widthnumber640, kompakt 400Breite, bevor der Container gemessen ist, etwa auf dem Server
heightnumber–Feste Höhe. Ohne sie richtet sich die Höhe nach der Zeichnung.
maxHeightnumbermax(320, 0.75 × width), kompakt keineObergrenze der automatischen Höhe
paddingnumber6Abstand um die Zeichnung
fontSizenumber13, kompakt 11.5Schriftgröße
diagramSizenumber48, kompakt 26Länge der größten Ordinate eines Verlaufs
deformedSizenumber30, kompakt 18Größte Verschiebung in der Verformungsfigur
diagramScalePartial<Record<ResultLayer, number>>–Fester Maßstab in px pro SI-Einheit für ein Ergebnis, ersetzt diagramSize bzw. deformedSize
momentOnTensionSidebooleantrueM auf der Zugseite; false für die Druckseite
resultLabelMode'horizontal' | 'axis''horizontal'Werte aufrecht oder entlang ihrer Ordinate gedreht
reactionLabels'values' | 'names''values'Auflagerreaktionen so, wie sie wirken, mit ihrem Wert; oder, für eine Übungsaufgabe, jede gehaltene Richtung benannt (Ax, MA) und in die als positiv geltende Richtung zeigend. Namen brauchen keine Ergebnisse: Auflagerreaktionen als Unbekannte
reserveLabelModesreadonly ResultLabelMode[]–Beschriftungsmodi, für die zusätzlich zum aktuellen Platz freigehalten wird
reserveReactionLabelsreadonly ReactionLabels[]–Beschriftungsarten der Reaktionen, für die zusätzlich zu reactionLabels Platz freigehalten wird, damit die Zeichnung einer Aufgabe stillsteht, wenn daraus die Lösung wird
animatebooleantrueEbenen einblenden und Stäbe zeichnen lassen. Bei prefers-reduced-motion immer aus.
hoverbooleanfalseWerte unter dem Zeiger ablesen, markiert an der Ordinatenspitze jedes Verlaufs. Ausgeschaltet verarbeitet die Grafik überhaupt keine Zeigereingaben.
titlestringeine Beschreibung des DargestelltenBarrierefreier Name der Abbildung

Ohne layers ist das Ergebnis M für Träger und Rahmen, N für ein Fachwerk und w, wenn keine Kraft übertragen wird (defaultResultLayer).

Events

EventNutzdatenWann
readoutReadout | nullMit hover: die Stelle des Stabs unter dem Zeiger und ihre Ergebnisse; null, wenn der Zeiger die Grafik verlässt
TypeScript
interface Readout {
  readonly member: string
  readonly x: number // m vom Anfangsknoten des Stabs
  readonly px: number // der Punkt auf dem Bildschirm, px
  readonly py: number
  readonly values: Readonly<Record<'N' | 'V' | 'M' | 'w', SidedValue>> // SI-Einheiten
  readonly u: number // Verschiebung in lokaler x-Richtung des Stabs, m
}
interface SidedValue {
  readonly left: number
  readonly right: number // gleich left, wo das Ergebnis stetig ist
}

DiagramStack

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

Zeichnet einen geraden Träger über seinen Verläufen auf einer gemeinsamen x-Achse. Die Stäbe müssen eine horizontale Linie bilden, von links nach rechts gezeichnet; alles andere löst einen Fehler aus. Anleitung: DiagramStack.

Props

PropTypStandardBeschreibung
solverSolver–Der berechnete Träger
modelPlotModel–Oder einfache Daten aus modelFromSolver; hat Vorrang
loadCasenumber0Index in solver.loadCases
revisionnumber0Ändern Sie den Wert, um einen direkt veränderten Solver neu zu zeichnen
membersreadonly string[]alle StäbeDie Stäbe der Trägerlinie
rowsreadonly StackRow[]['V', 'M', 'w']Zeilen mit Verläufen, von oben nach unten, aus 'N', 'V', 'M', 'w'
loadRowbooleantrueDer Träger mit Lagern, Lasten und Auflagerreaktionen über den Zeilen
rangesPartial<Record<StackRow, readonly [number, number]>>je Zeile der eigeneWertebereich je Zeile, SI-Einheiten
rowHeightsPartial<Record<StackRow, number>>N 100, V 116, M 128, w 76; unter 560 px Breite 88, 96, 104, 64Zeilenhöhen, bevor maxHeight sie skaliert
maxHeightnumber–Die Zeilen schrumpfen auf höchstens 60 %, damit die Abbildung hineinpasst. Die Schrift behält ihre Größe.
unitsPartial<Units>KN_UNITSAnzeigeeinheiten
numberFormatIntl.NumberFormatenglisch, höchstens 1 NachkommastelleFormatiert jede Zahl
colorsPartial<PlotColors>–Abweichende Farben
widthnumber720Breite, bevor der Container gemessen ist; mindestens 320 werden verwendet
fontSizenumber12.5Schriftgröße
hoverbooleantrueDer Ablese-Cursor. Ausgeschaltet verarbeitet die Abbildung keine Zeigereingaben.
loadAtnumber–Position (m entlang der Linie) einer Einzellast, die Lesende verschieben dürfen; zusammen mit v-model:load-at
loadLabelstringP = … mit dem Betrag der LastText neben der verschiebbaren Last
loadStepnumber0.05Schrittweite, auf die beim Ziehen gerundet wird, m; um sie bewegen auch die Pfeiltasten die Last
titlestringeine Beschreibung der ZeilenBarrierefreier Name der Abbildung

Events

EventNutzdatenWann
update:loadAtnumberDie Last wurde verschoben: ihre neue Position, m. Steuert v-model:load-at.
readoutStackReadout | nullDie Werte des Cursors über alle Zeilen; null, wenn der Zeiger die Abbildung verlässt
TypeScript
interface StackReadout {
  readonly x: number // m entlang der Trägerlinie
  readonly values: Partial<Record<'N' | 'V' | 'M' | 'w', { readonly left: number; readonly right: number }>> // SI
}

Das Plugin

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

app.use(EduBeamPlot) // registriert <StructurePlot> und <DiagramStack> global

Es ist optional: Benannte Importe der Komponenten sind schlanker, und ein Bundler entfernt das Plugin aus einem Build, der es nicht verwendet.

Typen

Für typisierte Wrapper um die Komponenten exportiert das Paket deren Props und Events:

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

const figure: StructurePlotProps = { layers: ['members', 'supports', 'M'] satisfies PlotLayer[], compact: true }
TypBeschreibt
StructurePlotProps, StructurePlotEmitsDie Props und Events von StructurePlot
DiagramStackProps, DiagramStackEmitsDie Props und Events von DiagramStack
Readout, ReadoutQuantity, SidedValue, StackReadoutNutzdaten der Events
PlotLayer, ResultLayer, ResultLabelMode, ReactionLabels, StackRowNamen von Ebenen, Ergebnissen, Beschriftungsmodi, Reaktionsbeschriftungen und Zeilen
Units, Unit, UnitKindAnzeigeeinheiten: { symbol, scale } je Art
PlotColorsFarben je Farbton
PlotModelDas einfache Modell: Zeichenmodell

Die übrigen Exporte, darunter structureSvg für SVG-Dateien und die Funktionen hinter der Zeichnung, finden Sie unter Funktionen.