API компонентів

Пропси й події обох компонентів, як їх оголошено в @edubeam/plot 0.2.0. Слотів не має жоден. Значення в одиницях СІ позначено окремо; розміри задано в пікселях CSS.

StructurePlot

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

Малює плоску конструкцію та її результати. Посібник: StructurePlot.

Пропси

ПропТипТиповоОпис
solverSolver–Розв’язувач @edubeam/fem. Результати малюються, щойно його випадок навантаження розраховано.
modelPlotModel–Або звичайні дані, які створює modelFromSolver. Має перевагу над solver.
loadCasenumber0Індекс у solver.loadCases
revisionnumber0Змініть його, щоб перемалювати розв’язувач, змінений на місці
layersreadonly PlotLayer[]стрижні, опори, навантаження, реакції та один результатЩо малювати: 'nodes', 'nodeLabels', 'dimensions', 'members', 'supports', 'loads', 'reactions', 'N', 'V', 'M', 'w'
reservereadonly PlotLayer[]layersШари, для яких треба залишити місце, поки вони приховані
compactbooleanfalseРисунок-мініатюра: менші символи, щонайбільше два значення на стрижень
unitsPartial<Units>KN_UNITSОдиниці відображення
numberFormatIntl.NumberFormatанглійський, щонайбільше 1 десятковий знакФорматує всі числа
colorsPartial<PlotColors>–Зміна кольорів за тонами: Теми та кольори
widthnumber640, compact 400Ширина, доки контейнер не виміряно, наприклад на сервері
heightnumber–Фіксована висота. Без неї висота залежить від рисунка.
maxHeightnumbermax(320, 0.75 × width), compact без обмеженняВерхня межа автоматичної висоти
paddingnumber6Відступ навколо рисунка
fontSizenumber13, compact 11.5Розмір тексту
diagramSizenumber48, compact 26Довжина найбільшої ординати епюри
deformedSizenumber30, compact 18Найбільше переміщення на деформованій схемі
diagramScalePartial<Record<ResultLayer, number>>–Фіксований масштаб результату в px на одиницю СІ; замінює diagramSize чи deformedSize
momentOnTensionSidebooleantrueM з боку розтягнутих волокон; false — з боку стиснутих
resultLabelMode'horizontal' | 'axis''horizontal'Значення горизонтально або повернуті вздовж ординати
reactionLabels'values' | 'names''values'Реакції так, як вони діють, з величиною; або, для вправи, кожен закріплений напрямок з назвою (Ax, MA), спрямований у бік, що вважається додатним. Для назв результати не потрібні: Реакції як невідомі
reserveLabelModesreadonly ResultLabelMode[]–Режими підписів, для яких треба залишити місце, крім поточного
reserveReactionLabelsreadonly ReactionLabels[]–Стилі підписів реакцій, для яких треба залишити місце, крім reactionLabels, щоб рисунок вправи, яка перетворюється на свій розв’язок, лишався нерухомим
animatebooleantrueПлавна поява шарів і прокреслювання стрижнів. За prefers-reduced-motion завжди вимкнено.
hoverbooleanfalseЗчитування значень під курсором, позначених на кінці ординати кожної епюри. Якщо вимкнено, рисунок взагалі не реагує на вказівник.
titlestringопис того, що показаноДоступна назва рисунка

Якщо layers не задано, результатом буде M для балок і рам, N для ферми й w, коли жоден стрижень не зазнає зусиль (defaultResultLayer).

Події

ПодіяДаніКоли
readoutReadout | nullЗ hover: точка стрижня під курсором і результати в ній; null, коли курсор залишає рисунок
TypeScript
interface Readout {
  readonly member: string
  readonly x: number // m від початкового вузла стрижня
  readonly px: number // точка на екрані, px
  readonly py: number
  readonly values: Readonly<Record<'N' | 'V' | 'M' | 'w', SidedValue>> // одиниці СІ
  readonly u: number // переміщення вздовж локальної осі x стрижня, m
}
interface SidedValue {
  readonly left: number
  readonly right: number // дорівнює left там, де результат неперервний
}

DiagramStack

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

Малює пряму балку над її епюрами на спільній осі x. Стрижні мають утворювати одну горизонтальну лінію, накреслену зліва направо; для всього іншого компонент видає помилку. Посібник: DiagramStack.

Пропси

ПропТипТиповоОпис
solverSolver–Розрахована балка
modelPlotModel–Або звичайні дані з modelFromSolver; має перевагу
loadCasenumber0Індекс у solver.loadCases
revisionnumber0Змініть його, щоб перемалювати розв’язувач, змінений на місці
membersreadonly string[]усі стрижніСтрижні, що утворюють балку
rowsreadonly StackRow[]['V', 'M', 'w']Рядки епюр згори вниз, із 'N', 'V', 'M', 'w'
loadRowbooleantrueБалка з опорами, навантаженням і реакціями над рядками
rangesPartial<Record<StackRow, readonly [number, number]>>власний для кожного рядкаДіапазон значень для кожного рядка, одиниці СІ
rowHeightsPartial<Record<StackRow, number>>N 100, V 116, M 128, w 76; за ширини менше ніж 560 px 88, 96, 104, 64Висоти рядків до масштабування за maxHeight
maxHeightnumber–Рядки зменшуються, щонайбільше до 60 %, щоб рисунок умістився. Текст зберігає розмір.
unitsPartial<Units>KN_UNITSОдиниці відображення
numberFormatIntl.NumberFormatанглійський, щонайбільше 1 десятковий знакФорматує всі числа
colorsPartial<PlotColors>–Зміна кольорів
widthnumber720Ширина, доки контейнер не виміряно; використовується щонайменше 320
fontSizenumber12.5Розмір тексту
hoverbooleantrueКурсор для зчитування. Якщо вимкнено, рисунок не реагує на вказівник.
loadAtnumber–Положення (m уздовж лінії) зосередженої сили, яку читач може перетягувати; використовуйте з v-model:load-at
loadLabelstringP = … з величиною силиТекст біля сили, яку можна перетягувати
loadStepnumber0.05Крок, до якого округлюється перетягування, m; на цей крок силу зсувають клавіші зі стрілками
titlestringопис рядківДоступна назва рисунка

Події

ПодіяДаніКоли
update:loadAtnumberЧитач перемістив силу: її нове положення, m. Забезпечує роботу v-model:load-at.
readoutStackReadout | nullЗначення під курсором у всіх рядках; null, коли вказівник залишає рисунок
TypeScript
interface StackReadout {
  readonly x: number // m уздовж лінії балки
  readonly values: Partial<Record<'N' | 'V' | 'M' | 'w', { readonly left: number; readonly right: number }>> // СІ
}

Плагін

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

app.use(EduBeamPlot) // глобально реєструє <StructurePlot> і <DiagramStack>

Він необов’язковий: іменований імпорт компонентів дає меншу збірку, а бандлер вилучає плагін зі збірки, яка його не використовує.

Типи

Для типізованих обгорток навколо компонентів пакет експортує їхні пропси й події:

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

const figure: StructurePlotProps = { layers: ['members', 'supports', 'M'] satisfies PlotLayer[], compact: true }
ТипЩо це
StructurePlotProps, StructurePlotEmitsПропси й події StructurePlot
DiagramStackProps, DiagramStackEmitsПропси й події DiagramStack
Readout, ReadoutQuantity, SidedValue, StackReadoutДані подій
PlotLayer, ResultLayer, ResultLabelMode, ReactionLabels, StackRowНазви шарів, результатів, режимів підписів, підписів реакцій і рядків
Units, Unit, UnitKindОдиниці відображення: { symbol, scale } для кожного виду
PlotColorsКольори за тонами
PlotModelЗвичайна модель: Модель рисунка

Решту експортів, серед них structureSvg для файлів SVG і функції, на яких побудовано малювання, описано на сторінці Функції.