API ของคอมโพเนนต์

props และอีเวนต์ของคอมโพเนนต์ทั้งสอง ตามที่ประกาศไว้ใน @edubeam/plot 0.2.0 ทั้งสองไม่มีสล็อต ค่าที่ใช้หน่วย SI มีระบุกำกับไว้ ส่วนขนาดเป็นพิกเซล CSS

StructurePlot

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

วาดโครงสร้างในระนาบและผลลัพธ์ คู่มือ: StructurePlot

Props

Propชนิดค่าเริ่มต้นคำอธิบาย
solverSolver–ตัวคำนวณของ @edubeam/fem ภาพจะวาดผลลัพธ์เมื่อกรณีแรงกระทำคำนวณแล้ว
modelPlotModel–หรือข้อมูลธรรมดาที่ modelFromSolver สร้าง ถ้าส่งมาทั้งคู่ จะใช้ค่านี้แทน solver
loadCasenumber0ดัชนีใน solver.loadCases
revisionnumber0เปลี่ยนค่านี้เพื่อวาดใหม่เมื่อแก้ตัวคำนวณตัวเดิมโดยตรง
layersreadonly PlotLayer[]members, supports, loads, reactions and one resultสิ่งที่จะวาด: 'nodes', 'nodeLabels', 'dimensions', 'members', 'supports', 'loads', 'reactions', 'N', 'V', 'M', 'w'
reservereadonly PlotLayer[]layersเลเยอร์ที่ต้องเว้นที่ไว้ขณะซ่อนอยู่
compactbooleanfalseวาดแบบภาพย่อ: สัญลักษณ์เล็กลง ไม่เกินสองค่าต่อชิ้นส่วน
unitsPartial<Units>KN_UNITSหน่วยที่แสดงผล
numberFormatIntl.NumberFormatEnglish, at most 1 decimalรูปแบบของตัวเลขทุกตัว
colorsPartial<PlotColors>–สีที่ใช้แทนตามโทน: ธีมและสี
widthnumber640, compact 400ความกว้างก่อนวัดกล่องได้ เช่น บนเซิร์ฟเวอร์
heightnumber–ความสูงคงที่ ถ้าไม่ระบุ ความสูงจะเป็นไปตามภาพที่วาด
maxHeightnumbermax(320, 0.75 × width), compact noneขีดจำกัดบนของความสูงอัตโนมัติ
paddingnumber6ระยะว่างรอบภาพ
fontSizenumber13, compact 11.5ขนาดตัวอักษร
diagramSizenumber48, compact 26ความยาวของออร์ดิเนตที่ยาวที่สุดในแผนภาพ
deformedSizenumber30, compact 18การกระจัดที่มากที่สุดบนรูปร่างที่เสียรูป
diagramScalePartial<Record<ResultLayer, number>>–มาตราส่วนคงที่เป็น px ต่อหน่วย SI ของผลลัพธ์ ใช้แทน diagramSize หรือ deformedSize
momentOnTensionSidebooleantrueM อยู่ทางด้านรับแรงดึง false คือด้านรับแรงอัด
resultLabelMode'horizontal' | 'axis''horizontal'ค่าตั้งตรง หรือหมุนไปตามออร์ดิเนต
reactionLabels'values' | 'names''values'แรงปฏิกิริยาตามที่กระทำจริงพร้อมขนาด หรือสำหรับโจทย์ ทุกทิศทางที่จุดรองรับยึดไว้จะมีชื่อ (Ax, MA) และชี้ไปทางที่นับเป็นบวก ชื่อไม่ต้องอาศัยผลลัพธ์: แรงปฏิกิริยาเป็นตัวไม่ทราบค่า
reserveLabelModesreadonly ResultLabelMode[]–รูปแบบป้ายค่าที่ต้องเว้นที่ไว้นอกจากแบบที่ใช้อยู่
reserveReactionLabelsreadonly ReactionLabels[]–รูปแบบป้ายแรงปฏิกิริยาที่ต้องเว้นที่ไว้นอกจาก reactionLabels โจทย์ที่เปลี่ยนเป็นเฉลยจึงคงภาพไว้กับที่
animatebooleantrueให้เลเยอร์ค่อย ๆ ปรากฏและเส้นของชิ้นส่วนค่อย ๆ ลากออกมา ปิดเสมอภายใต้ prefers-reduced-motion
hoverbooleanfalseอ่านค่าใต้ตัวชี้ และทำเครื่องหมายที่ปลายออร์ดิเนตของแต่ละแผนภาพ ถ้าปิด ภาพจะไม่รับ input จากตัวชี้เลย
titlestringa description of what is shownชื่อของภาพสำหรับการเข้าถึง (accessible name)

ถ้าไม่ระบุ layers ผลลัพธ์ที่วาดคือ M สำหรับคานและโครงข้อแข็ง N สำหรับโครงถัก และ w เมื่อไม่มีชิ้นส่วนใดรับแรง (defaultResultLayer)

อีเวนต์

อีเวนต์Payloadเมื่อใด
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>> // หน่วย SI
  readonly u: number // การกระจัดตามแกน x ท้องถิ่นของชิ้นส่วน, m
}
interface SidedValue {
  readonly left: number
  readonly right: number // เท่ากับ left ในตำแหน่งที่ผลลัพธ์ต่อเนื่อง
}

DiagramStack

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

วาดคานตรงเหนือแผนภาพบนแกน x เดียวกัน ชิ้นส่วนต้องเรียงเป็นเส้นตรงแนวนอนเส้นเดียว และวาดจากซ้ายไปขวา แบบอื่นทั้งหมดจะ throw ข้อผิดพลาด คู่มือ: DiagramStack

Props

Propชนิดค่าเริ่มต้นคำอธิบาย
solverSolver–คานที่คำนวณแล้ว
modelPlotModel–หรือข้อมูลธรรมดาจาก modelFromSolver ถ้าส่งมาทั้งคู่ จะใช้ค่านี้
loadCasenumber0ดัชนีใน solver.loadCases
revisionnumber0เปลี่ยนค่านี้เพื่อวาดใหม่เมื่อแก้ตัวคำนวณตัวเดิมโดยตรง
membersreadonly string[]all membersชิ้นส่วนที่ประกอบเป็นแนวคาน
rowsreadonly StackRow[]['V', 'M', 'w']แถวแผนภาพจากบนลงล่าง เลือกจาก 'N', 'V', 'M', 'w'
loadRowbooleantrueคานพร้อมจุดรองรับ แรงกระทำ และแรงปฏิกิริยาเหนือแถวแผนภาพ
rangesPartial<Record<StackRow, readonly [number, number]>>each row's ownช่วงค่าของแต่ละแถว หน่วย SI
rowHeightsPartial<Record<StackRow, number>>N 100, V 116, M 128, w 76; below 560 px wide 88, 96, 104, 64ความสูงของแต่ละแถวก่อนที่ maxHeight จะย่อ
maxHeightnumber–แถวหดลงได้ถึง 60 % เพื่อให้ภาพพอดี ขนาดตัวอักษรคงเดิม
unitsPartial<Units>KN_UNITSหน่วยที่แสดงผล
numberFormatIntl.NumberFormatEnglish, at most 1 decimalรูปแบบของตัวเลขทุกตัว
colorsPartial<PlotColors>–สีที่ใช้แทน
widthnumber720ความกว้างก่อนวัดกล่องได้ ใช้อย่างน้อย 320
fontSizenumber12.5ขนาดตัวอักษร
hoverbooleantrueเส้นเคอร์เซอร์อ่านค่า ถ้าปิด ภาพจะไม่รับ input จากตัวชี้
loadAtnumber–ตำแหน่ง (m ตามแนวคาน) ของแรงกระทำเป็นจุดที่ผู้อ่านลากได้ ใช้กับ v-model:load-at
loadLabelstringP = … with the load's magnitudeข้อความข้างแรงกระทำที่ลากได้
loadStepnumber0.05ระยะที่ใช้ปัดตำแหน่งขณะลาก, m และเป็นระยะที่ปุ่มลูกศรเลื่อนแต่ละครั้ง
titlestringa description of the rowsชื่อของภาพสำหรับการเข้าถึง

อีเวนต์

อีเวนต์Payloadเมื่อใด
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 }>> // SI
}

ปลั๊กอิน

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

app.use(EduBeamPlot) // ลงทะเบียน <StructurePlot> และ <DiagramStack> แบบ global

ปลั๊กอินเป็นตัวเลือก การ import คอมโพเนนต์ตามชื่อทำให้เบากว่า และ bundler จะตัดปลั๊กอินออกจาก build ที่ไม่ได้ใช้

Type

สำหรับ wrapper ที่มี type ครอบคอมโพเนนต์ แพ็กเกจ export props และอีเวนต์ของคอมโพเนนต์ไว้

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

const figure: StructurePlotProps = { layers: ['members', 'supports', 'M'] satisfies PlotLayer[], compact: true }
Typeความหมาย
StructurePlotProps, StructurePlotEmitsprops และอีเวนต์ของ StructurePlot
DiagramStackProps, DiagramStackEmitsprops และอีเวนต์ของ DiagramStack
Readout, ReadoutQuantity, SidedValue, StackReadoutpayload ของอีเวนต์
PlotLayer, ResultLayer, ResultLabelMode, ReactionLabels, StackRowชื่อเลเยอร์ ผลลัพธ์ รูปแบบป้ายค่า รูปแบบป้ายแรงปฏิกิริยา และแถว
Units, Unit, UnitKindหน่วยที่แสดงผล: { symbol, scale } ของแต่ละชนิด
PlotColorsสีตามโทน
PlotModelโมเดลข้อมูลธรรมดา: โมเดลสำหรับวาดภาพ

export ที่เหลือ ซึ่งรวมถึง structureSvg สำหรับไฟล์ SVG และฟังก์ชันเบื้องหลังการวาด อยู่ในหน้า ฟังก์ชัน