API komponen

Prop dan event kedua komponen, sebagaimana dideklarasikan di @edubeam/plot 0.2.0. Keduanya tidak memiliki slot. Nilai dalam satuan SI ditandai demikian; ukuran dalam piksel CSS.

StructurePlot

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

Menggambar struktur bidang beserta hasilnya. Panduan: StructurePlot.

Props

PropTipeBawaanKeterangan
solverSolver–Solver @edubeam/fem. Hasil digambar setelah kasus bebannya dihitung.
modelPlotModel–Atau data biasa yang dibuat modelFromSolver. Didahulukan daripada solver.
loadCasenumber0Indeks dalam solver.loadCases
revisionnumber0Ubah nilainya untuk menggambar ulang solver yang diubah di tempat
layersreadonly PlotLayer[]members, supports, loads, reactions and one resultApa yang digambar: 'nodes', 'nodeLabels', 'dimensions', 'members', 'supports', 'loads', 'reactions', 'N', 'V', 'M', 'w'
reservereadonly PlotLayer[]layersLapisan yang tempatnya disiapkan selagi tersembunyi
compactbooleanfalseGambar mini: simbol lebih kecil, paling banyak dua nilai per batang
unitsPartial<Units>KN_UNITSSatuan tampilan
numberFormatIntl.NumberFormatEnglish, at most 1 decimalMemformat setiap angka
colorsPartial<PlotColors>–Penggantian warna per rona: Tema dan warna
widthnumber640, compact 400Lebar sebelum kotak terukur, misalnya di server
heightnumber–Tinggi tetap. Tanpa nilai ini, tinggi mengikuti gambar.
maxHeightnumbermax(320, 0.75 × width), compact noneBatas atas tinggi otomatis
paddingnumber6Ruang di sekeliling gambar
fontSizenumber13, compact 11.5Ukuran teks
diagramSizenumber48, compact 26Panjang ordinat diagram terbesar
deformedSizenumber30, compact 18Perpindahan terbesar pada bentuk deformasi
diagramScalePartial<Record<ResultLayer, number>>–Skala tetap dalam px per satuan SI untuk suatu hasil, menggantikan diagramSize atau deformedSize
momentOnTensionSidebooleantrueM di sisi tarik; false untuk sisi tekan
resultLabelMode'horizontal' | 'axis''horizontal'Nilai ditulis tegak, atau diputar sejajar ordinatnya
reactionLabels'values' | 'names''values'Reaksi sebagaimana bekerja, dengan besarnya; atau, untuk soal, setiap arah yang ditahan diberi nama (Ax, MA) dan menunjuk ke arah positifnya. Nama tidak memerlukan hasil: Reaksi sebagai besaran yang dicari
reserveLabelModesreadonly ResultLabelMode[]–Mode label yang tempatnya disiapkan selain mode saat ini
reserveReactionLabelsreadonly ReactionLabels[]–Gaya label reaksi yang tempatnya disiapkan selain reactionLabels, agar gambar soal yang berubah menjadi penyelesaiannya tetap diam
animatebooleantrueLapisan muncul perlahan dan batang tergambar bertahap. Selalu nonaktif jika prefers-reduced-motion aktif.
hoverbooleanfalseMembaca nilai di bawah kursor, ditandai di ujung ordinat setiap diagram. Jika nonaktif, gambar sama sekali tidak menerima input pointer.
titlestringa description of what is shownNama aksesibel gambar

Tanpa layers, hasil yang ditampilkan adalah M untuk balok dan portal, N untuk rangka batang, dan w jika tidak ada batang yang memikul gaya (defaultResultLayer).

Event

EventPayloadKapan
readoutReadout | nullDengan hover: titik batang di bawah kursor dan hasilnya di titik itu; null saat kursor keluar
TypeScript
interface Readout {
  readonly member: string
  readonly x: number // m dari joint awal batang
  readonly px: number // titik di layar, px
  readonly py: number
  readonly values: Readonly<Record<'N' | 'V' | 'M' | 'w', SidedValue>> // satuan SI
  readonly u: number // perpindahan searah sumbu x lokal batang, m
}
interface SidedValue {
  readonly left: number
  readonly right: number // sama dengan left jika hasilnya kontinu
}

DiagramStack

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

Menggambar balok lurus di atas diagram-diagramnya pada satu sumbu x. Batang-batangnya harus membentuk satu garis horizontal yang digambar dari kiri ke kanan; selain itu memunculkan galat. Panduan: DiagramStack.

Props

PropTipeBawaanKeterangan
solverSolver–Balok yang sudah dihitung
modelPlotModel–Atau data biasa dari modelFromSolver; didahulukan
loadCasenumber0Indeks dalam solver.loadCases
revisionnumber0Ubah nilainya untuk menggambar ulang solver yang diubah di tempat
membersreadonly string[]all membersBatang yang membentuk garis balok
rowsreadonly StackRow[]['V', 'M', 'w']Baris diagram dari atas ke bawah, dari 'N', 'V', 'M', 'w'
loadRowbooleantrueBalok dengan tumpuan, beban dan reaksinya di atas baris-baris diagram
rangesPartial<Record<StackRow, readonly [number, number]>>each row's ownRentang nilai per baris, satuan SI
rowHeightsPartial<Record<StackRow, number>>N 100, V 116, M 128, w 76; below 560 px wide 88, 96, 104, 64Tinggi baris sebelum diskalakan oleh maxHeight
maxHeightnumber–Baris menyusut, paling jauh sampai 60%, agar gambar muat. Ukuran teks tetap.
unitsPartial<Units>KN_UNITSSatuan tampilan
numberFormatIntl.NumberFormatEnglish, at most 1 decimalMemformat setiap angka
colorsPartial<PlotColors>–Penggantian warna
widthnumber720Lebar sebelum kotak terukur; lebar yang dipakai minimal 320
fontSizenumber12.5Ukuran teks
hoverbooleantrueKursor pembaca nilai. Jika nonaktif, gambar tidak menerima input pointer.
loadAtnumber–Posisi (m di sepanjang garis) beban terpusat yang dapat diseret pembaca; pakai bersama v-model:load-at
loadLabelstringP = … with the load's magnitudeTeks di samping beban yang dapat diseret
loadStepnumber0.05Posisi seretan dibulatkan ke langkah ini, m; tombol panah menggeser sejauh langkah ini
titlestringa description of the rowsNama aksesibel gambar

Event

EventPayloadKapan
update:loadAtnumberPembaca memindahkan beban: posisi barunya, m. Menggerakkan v-model:load-at.
readoutStackReadout | nullNilai kursor di semua baris; null saat kursor keluar
TypeScript
interface StackReadout {
  readonly x: number // m di sepanjang garis balok
  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) // mendaftarkan <StructurePlot> dan <DiagramStack> secara global

Plugin ini opsional: mengimpor komponen dengan nama lebih ringan, dan bundler membuang plugin dari build yang tidak memakainya.

Tipe

Untuk wrapper bertipe di sekitar komponen, paket ini mengekspor prop dan event-nya:

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

const figure: StructurePlotProps = { layers: ['members', 'supports', 'M'] satisfies PlotLayer[], compact: true }
TipeIsi
StructurePlotProps, StructurePlotEmitsProp dan event StructurePlot
DiagramStackProps, DiagramStackEmitsProp dan event DiagramStack
Readout, ReadoutQuantity, SidedValue, StackReadoutPayload event
PlotLayer, ResultLayer, ResultLabelMode, ReactionLabels, StackRowNama lapisan, hasil, mode label, label reaksi dan baris
Units, Unit, UnitKindSatuan tampilan: { symbol, scale } untuk setiap jenis
PlotColorsWarna per rona
PlotModelModel biasa: Model gambar

Ekspor lainnya, di antaranya structureSvg untuk file SVG dan fungsi-fungsi di balik penggambaran, tercantum di Fungsi.