Cấu hình
MathCanvas.init(target, options)
Mọi tuỳ chọn chỉ đọc tại thời điểm khởi tạo. Thay đổi sau đó yêu cầu
destroy() rồi khởi tạo lại; riêng nội dung dùng setDocument().
Bảng tuỳ chọn#
| Tuỳ chọn | Kiểu | Mặc định | Mô tả |
|---|---|---|---|
document |
object | string |
— | Tài liệu nạp sẵn, xem Dữ liệu |
height |
number | string |
'620px' |
Chiều cao khung; số hiểu là pixel |
width |
number | string |
'100%' |
Chiều rộng khung |
className |
string |
— | Lớp CSS bổ sung cho khung bao |
id |
string |
tự sinh | Định danh thực thể, đọc tại board.id |
storageKey |
string | null |
null |
Khoá localStorage để tự lưu; null là tắt |
autoLabel |
boolean |
true |
Tự đặt tên điểm A, B, C… |
showHints |
boolean |
true |
Dòng gợi ý thao tác |
canvasBg |
'cream' | 'white' |
'cream' |
Màu nền vùng vẽ |
fonts |
boolean |
true |
Tự nạp Archivo và Lora |
keyboard |
'container' | 'window' | false |
'container' |
Phạm vi nhận phím tắt |
autoFocus |
boolean |
false |
Nhận phím ngay sau khi khởi tạo |
exportMode |
'handoff' | 'download' |
suy diễn | Hành vi hai nút xuất hình |
exportLabels |
{ svg, png } |
{ svg: 'SVG', png: 'PNG' } |
Nhãn hai nút xuất hình |
onReady |
function |
— | Tương đương on('ready', fn) |
onChange |
function |
— | Tương đương on('change', fn) |
onExport |
function |
— | Tương đương on('export', fn), đồng thời bật exportMode: 'handoff' |
Ghi chú#
target#
string (bộ chọn CSS) hoặc Element. Không khớp phần tử nào thì init ném
Error. Khởi tạo lần hai trên cùng phần tử trả về thực thể đã có.
height, width#
Số hiểu là pixel; chuỗi số cũng hiểu là pixel (data-height="420"); chuỗi có
đơn vị giữ nguyên ('70vh'). Kích thước được đặt lên khung do gói tạo ra bên
trong target; bảng vẽ luôn lấp đầy khung đó và không co giãn theo nội dung.
storageKey#
Tắt theo mặc định. Bật thì bản vẽ được ghi vào localStorage sau mỗi thay đổi,
trễ 400 ms. Các thực thể dùng chung một khoá ghi đè lên nhau. Khi có cả
document lẫn storageKey, document thắng.
keyboard#
| Giá trị | Hành vi |
|---|---|
'container' |
Chỉ xử lý phím khi tiêu điểm nằm trong bảng vẽ |
'window' |
Xử lý phím ở phạm vi tài liệu |
false |
Tắt phím tắt |
exportMode#
Suy diễn: có onExport → 'handoff'; không có → 'download'. Trạng thái này
quyết định lúc dựng thanh công cụ, nên on('export', fn) đăng ký sau khởi tạo
không tự bật được chế độ chuyển giao. Xem Dữ liệu.