API của component

Prop và sự kiện của hai component, đúng như khai báo trong @edubeam/plot 0.2.0. Cả hai đều không có slot. Giá trị theo đơn vị SI được ghi rõ; kích thước tính bằng pixel CSS.

StructurePlot

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

Vẽ một kết cấu phẳng cùng kết quả tính. Hướng dẫn: StructurePlot.

Props

PropKiểuMặc địnhMô tả
solverSolver–Một bộ giải @edubeam/fem. Kết quả được vẽ khi trường hợp tải của nó đã giải.
modelPlotModel–Hoặc dữ liệu thuần do modelFromSolver tạo. Được ưu tiên hơn solver.
loadCasenumber0Chỉ số trong solver.loadCases
revisionnumber0Đổi giá trị này để vẽ lại một bộ giải đã bị sửa trực tiếp
layersreadonly PlotLayer[]members, supports, loads, reactions and one resultNhững gì cần vẽ: 'nodes', 'nodeLabels', 'dimensions', 'members', 'supports', 'loads', 'reactions', 'N', 'V', 'M', 'w'
reservereadonly PlotLayer[]layersCác lớp cần dành chỗ trong khi còn ẩn
compactbooleanfalseKiểu vẽ ảnh thu nhỏ: ký hiệu nhỏ hơn, nhiều nhất hai giá trị trên mỗi thanh
unitsPartial<Units>KN_UNITSĐơn vị hiển thị
numberFormatIntl.NumberFormatEnglish, at most 1 decimalĐịnh dạng mọi con số
colorsPartial<PlotColors>–Ghi đè màu theo tông: Màu sắc và chủ đề
widthnumber640, compact 400Chiều rộng khi chưa đo được khối chứa, như khi render trên server
heightnumber–Chiều cao cố định. Nếu không có, chiều cao đi theo hình vẽ.
maxHeightnumbermax(320, 0.75 × width), compact noneGiới hạn trên của chiều cao tự động
paddingnumber6Khoảng trống quanh hình vẽ
fontSizenumber13, compact 11.5Cỡ chữ
diagramSizenumber48, compact 26Độ dài tung độ lớn nhất của biểu đồ
deformedSizenumber30, compact 18Chuyển vị lớn nhất trên sơ đồ biến dạng
diagramScalePartial<Record<ResultLayer, number>>–Tỷ lệ cố định, px trên một đơn vị SI, cho một kết quả; thay cho diagramSize hoặc deformedSize
momentOnTensionSidebooleantrueM vẽ về phía thớ chịu kéo; false để vẽ về phía thớ chịu nén
resultLabelMode'horizontal' | 'axis''horizontal'Giá trị viết nằm ngang, hoặc xoay dọc theo tung độ
reactionLabels'values' | 'names''values'Phản lực theo chiều tác dụng thực, kèm độ lớn; hoặc, cho bài tập, mỗi phương bị chặn được gọi tên (Ax, MA) và chỉ theo chiều quy ước dương. Tên không cần kết quả tính: Phản lực là ẩn số
reserveLabelModesreadonly ResultLabelMode[]–Các cách ghi nhãn cần dành chỗ ngoài cách hiện tại
reserveReactionLabelsreadonly ReactionLabels[]–Các kiểu nhãn phản lực cần dành chỗ ngoài reactionLabels, để hình của bài tập đứng yên khi chuyển sang đáp án
animatebooleantrueCho các lớp hiện dần và thanh tự vẽ ra. Luôn tắt khi có prefers-reduced-motion.
hoverbooleanfalseĐọc giá trị dưới con trỏ, đánh dấu ở đầu tung độ của từng biểu đồ. Khi tắt, hình hoàn toàn không nhận thao tác con trỏ.
titlestringa description of what is shownTên truy cập (accessible name) của hình

Khi không có layers, kết quả được vẽ là M cho dầm và khung, N cho dàn, và w khi không có nội lực nào (defaultResultLayer).

Sự kiện

Sự kiệnPayloadKhi nào
readoutReadout | nullVới hover: điểm trên thanh nằm dưới con trỏ và kết quả tại đó; null khi con trỏ rời đi
TypeScript
interface Readout {
  readonly member: string
  readonly x: number // m tính từ nút đầu của thanh
  readonly px: number // điểm trên màn hình, px
  readonly py: number
  readonly values: Readonly<Record<'N' | 'V' | 'M' | 'w', SidedValue>> // đơn vị SI
  readonly u: number // chuyển vị theo trục x địa phương của thanh, m
}
interface SidedValue {
  readonly left: number
  readonly right: number // bằng left ở chỗ kết quả liên tục
}

DiagramStack

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

Vẽ một dầm thẳng phía trên các biểu đồ của nó, trên cùng một trục x. Các thanh phải tạo thành một đường nằm ngang, vẽ từ trái sang phải; mọi trường hợp khác đều báo lỗi. Hướng dẫn: DiagramStack.

Props

PropKiểuMặc địnhMô tả
solverSolver–Dầm đã giải
modelPlotModel–Hoặc dữ liệu thuần từ modelFromSolver; được ưu tiên
loadCasenumber0Chỉ số trong solver.loadCases
revisionnumber0Đổi giá trị này để vẽ lại một bộ giải đã bị sửa trực tiếp
membersreadonly string[]all membersCác thanh thuộc đường dầm
rowsreadonly StackRow[]['V', 'M', 'w']Các hàng biểu đồ, từ trên xuống, chọn trong 'N', 'V', 'M', 'w'
loadRowbooleantrueDầm cùng gối tựa, tải trọng và phản lực phía trên các hàng
rangesPartial<Record<StackRow, readonly [number, number]>>each row's ownKhoảng giá trị của từng hàng, đơn vị SI
rowHeightsPartial<Record<StackRow, number>>N 100, V 116, M 128, w 76; below 560 px wide 88, 96, 104, 64Chiều cao các hàng trước khi maxHeight co chúng lại
maxHeightnumber–Các hàng co lại, nhiều nhất còn 60 %, để hình không vượt quá chiều cao này. Chữ giữ nguyên cỡ.
unitsPartial<Units>KN_UNITSĐơn vị hiển thị
numberFormatIntl.NumberFormatEnglish, at most 1 decimalĐịnh dạng mọi con số
colorsPartial<PlotColors>–Ghi đè màu
widthnumber720Chiều rộng khi chưa đo được khối chứa; nhỏ nhất là 320
fontSizenumber12.5Cỡ chữ
hoverbooleantrueCon trỏ đọc giá trị. Khi tắt, hình không nhận thao tác con trỏ.
loadAtnumber–Vị trí (m dọc theo đường dầm) của lực tập trung mà người đọc có thể kéo; dùng với v-model:load-at
loadLabelstringP = … with the load's magnitudeDòng chữ cạnh tải trọng kéo được
loadStepnumber0.05Khi kéo, vị trí được làm tròn theo bước này, m; phím mũi tên dịch đúng một bước
titlestringa description of the rowsTên truy cập (accessible name) của hình

Sự kiện

Sự kiệnPayloadKhi nào
update:loadAtnumberNgười đọc đã di chuyển tải trọng: vị trí mới, m. Điều khiển v-model:load-at.
readoutStackReadout | nullGiá trị tại con trỏ trên các hàng; null khi con trỏ rời đi
TypeScript
interface StackReadout {
  readonly x: number // m dọc theo đường dầm
  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) // đăng ký <StructurePlot> và <DiagramStack> cho toàn ứng dụng

Plugin không bắt buộc: import các component theo tên thì nhẹ hơn, và bundler sẽ bỏ plugin khỏi bản build không dùng đến nó.

Kiểu

Để viết wrapper có kiểu quanh các component, gói export sẵn prop và sự kiện của chúng:

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

const figure: StructurePlotProps = { layers: ['members', 'supports', 'M'] satisfies PlotLayer[], compact: true }
KiểuLà
StructurePlotProps, StructurePlotEmitsProp và sự kiện của StructurePlot
DiagramStackProps, DiagramStackEmitsProp và sự kiện của DiagramStack
Readout, ReadoutQuantity, SidedValue, StackReadoutPayload của sự kiện
PlotLayer, ResultLayer, ResultLabelMode, ReactionLabels, StackRowTên lớp, kết quả, cách ghi nhãn, kiểu nhãn phản lực và hàng
Units, Unit, UnitKindĐơn vị hiển thị: { symbol, scale } cho mỗi loại
PlotColorsMàu theo tông
PlotModelMô hình dữ liệu thuần: Mô hình vẽ

Các export còn lại, trong đó có structureSvg để ghi tệp SVG và các hàm đứng sau việc vẽ, có ở trang Hàm.