API komponentów

Propsy i zdarzenia obu komponentów, tak jak deklaruje je @edubeam/plot 0.2.0. Żaden z nich nie ma slotów. Wartości w jednostkach SI są tak oznaczone; rozmiary są w pikselach CSS.

StructurePlot

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

Rysuje konstrukcję płaską i jej wyniki. Przewodnik: StructurePlot.

Props

PropTypDomyślnieOpis
solverSolver–Solver @edubeam/fem. Wyniki są rysowane, gdy jego przypadek obciążenia zostanie obliczony.
modelPlotModel–Albo zwykłe dane, które tworzy modelFromSolver. Ma pierwszeństwo przed solver.
loadCasenumber0Indeks w solver.loadCases
revisionnumber0Zmień go, aby przerysować solver zmieniony w miejscu
layersreadonly PlotLayer[]pręty, podpory, obciążenia, reakcje i jeden wynikCo narysować: 'nodes', 'nodeLabels', 'dimensions', 'members', 'supports', 'loads', 'reactions', 'N', 'V', 'M', 'w'
reservereadonly PlotLayer[]layersWarstwy, dla których trzeba zostawić miejsce, choć są ukryte
compactbooleanfalseRysunek miniatury: mniejsze symbole, najwyżej dwie wartości na pręt
unitsPartial<Units>KN_UNITSJednostki wyświetlania
numberFormatIntl.NumberFormatangielski, najwyżej 1 miejsce po przecinkuFormatuje każdą liczbę
colorsPartial<PlotColors>–Własne kolory według tonów: Motywy i kolory
widthnumber640, compact 400Szerokość, dopóki kontener nie zostanie zmierzony, np. na serwerze
heightnumber–Stała wysokość. Bez niej wysokość wynika z rysunku.
maxHeightnumbermax(320, 0.75 × width), compact brakGórna granica automatycznej wysokości
paddingnumber6Odstęp wokół rysunku
fontSizenumber13, compact 11.5Wielkość tekstu
diagramSizenumber48, compact 26Długość największej rzędnej wykresu
deformedSizenumber30, compact 18Największe przemieszczenie na postaci odkształconej
diagramScalePartial<Record<ResultLayer, number>>–Stała liczba px na jednostkę SI dla danego wyniku; zastępuje diagramSize lub deformedSize
momentOnTensionSidebooleantrueM po stronie rozciąganej; false po stronie ściskanej
resultLabelMode'horizontal' | 'axis''horizontal'Wartości zapisane poziomo albo obrócone wzdłuż rzędnej
reactionLabels'values' | 'names''values'Reakcje tak, jak działają, z wartością; albo, do zadania, każdy zablokowany kierunek z nazwą (Ax, MA) i strzałką zwróconą w stronę dodatnią. Nazwy nie wymagają wyników: Reakcje jako niewiadome
reserveLabelModesreadonly ResultLabelMode[]–Tryby etykiet, dla których trzeba zostawić miejsce oprócz bieżącego
reserveReactionLabelsreadonly ReactionLabels[]–Style etykiet reakcji, dla których trzeba zostawić miejsce oprócz reactionLabels, aby rysunek zadania zamieniającego się w rozwiązanie się nie przesuwał
animatebooleantruePłynne pojawianie się warstw i rysowanie prętów. Zawsze wyłączone przy prefers-reduced-motion.
hoverbooleanfalseOdczyt wartości pod kursorem, zaznaczonych na końcu rzędnej każdego wykresu. Gdy jest wyłączony, rysunek w ogóle nie reaguje na kursor.
titlestringopis tego, co jest pokazaneNazwa dostępna (accessible name) rysunku

Bez layers wynikiem jest M dla belek i ram, N dla kratownicy i w, gdy nic nie przenosi sił (defaultResultLayer).

Zdarzenia

ZdarzenieDaneKiedy
readoutReadout | nullZ hover: punkt pręta pod kursorem i wyniki w nim; null, gdy kursor opuści rysunek
TypeScript
interface Readout {
  readonly member: string
  readonly x: number // m od węzła początkowego pręta
  readonly px: number // punkt na ekranie, px
  readonly py: number
  readonly values: Readonly<Record<'N' | 'V' | 'M' | 'w', SidedValue>> // jednostki SI
  readonly u: number // przemieszczenie wzdłuż lokalnej osi x pręta, m
}
interface SidedValue {
  readonly left: number
  readonly right: number // równe left tam, gdzie wynik jest ciągły
}

DiagramStack

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

Rysuje prostą belkę nad jej wykresami na wspólnej osi x. Pręty muszą tworzyć jedną poziomą linię, zdefiniowaną od lewej do prawej; w każdym innym przypadku komponent zgłasza wyjątek. Przewodnik: DiagramStack.

Props

PropTypDomyślnieOpis
solverSolver–Obliczona belka
modelPlotModel–Albo zwykłe dane z modelFromSolver; ma pierwszeństwo
loadCasenumber0Indeks w solver.loadCases
revisionnumber0Zmień go, aby przerysować solver zmieniony w miejscu
membersreadonly string[]wszystkie prętyPręty tworzące linię belki
rowsreadonly StackRow[]['V', 'M', 'w']Wiersze wykresów od góry do dołu, z 'N', 'V', 'M', 'w'
loadRowbooleantrueBelka z podporami, obciążeniem i reakcjami nad wierszami
rangesPartial<Record<StackRow, readonly [number, number]>>własny zakres każdego wierszaZakres wartości poszczególnych wierszy, jednostki SI
rowHeightsPartial<Record<StackRow, number>>N 100, V 116, M 128, w 76; przy szerokości poniżej 560 px 88, 96, 104, 64Wysokości wierszy, zanim zmniejszy je maxHeight
maxHeightnumber–Wiersze zmniejszają się, najwyżej do 60 %, aby rysunek się zmieścił. Tekst zachowuje rozmiar.
unitsPartial<Units>KN_UNITSJednostki wyświetlania
numberFormatIntl.NumberFormatangielski, najwyżej 1 miejsce po przecinkuFormatuje każdą liczbę
colorsPartial<PlotColors>–Własne kolory
widthnumber720Szerokość, dopóki kontener nie zostanie zmierzony; używane jest co najmniej 320
fontSizenumber12.5Wielkość tekstu
hoverbooleantrueKursor do odczytu. Gdy jest wyłączony, rysunek w ogóle nie reaguje na kursor.
loadAtnumber–Położenie (w m wzdłuż linii) siły skupionej, którą czytelnik może przesuwać; używaj z v-model:load-at
loadLabelstringP = … z wartością siłyTekst obok przesuwanej siły
loadStepnumber0.05Krok w m, do którego zaokrąglane jest przeciąganie; o tyle przesuwają siłę klawisze strzałek
titlestringopis wierszyNazwa dostępna (accessible name) rysunku

Zdarzenia

ZdarzenieDaneKiedy
update:loadAtnumberCzytelnik przesunął siłę: jej nowe położenie, m. Obsługuje v-model:load-at.
readoutStackReadout | nullWartości pod kursorem we wszystkich wierszach; null, gdy kursor opuści rysunek
TypeScript
interface StackReadout {
  readonly x: number // m wzdłuż linii belki
  readonly values: Partial<Record<'N' | 'V' | 'M' | 'w', { readonly left: number; readonly right: number }>> // SI
}

Plugin

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

app.use(EduBeamPlot) // rejestruje <StructurePlot> i <DiagramStack> globalnie

Jest opcjonalny: importowanie komponentów po nazwie jest lżejsze, a bundler usuwa plugin z buildu, który go nie używa.

Typy

Do typowanych nakładek na komponenty pakiet eksportuje ich propsy i zdarzenia:

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

const figure: StructurePlotProps = { layers: ['members', 'supports', 'M'] satisfies PlotLayer[], compact: true }
TypOpis
StructurePlotProps, StructurePlotEmitsPropsy i zdarzenia StructurePlot
DiagramStackProps, DiagramStackEmitsPropsy i zdarzenia DiagramStack
Readout, ReadoutQuantity, SidedValue, StackReadoutDane zdarzeń
PlotLayer, ResultLayer, ResultLabelMode, ReactionLabels, StackRowNazwy warstw, wyników, trybów etykiet, stylów etykiet reakcji i wierszy
Units, Unit, UnitKindJednostki wyświetlania: { symbol, scale } dla każdego rodzaju
PlotColorsKolory według tonów
PlotModelZwykły model: Model rysunku

Pozostałe eksporty, w tym structureSvg do plików SVG i funkcje, na których opiera się rysowanie, opisuje strona Funkcje.