คุณสามารถสร้างพื้นที่ทำงานและแทรกลงใน DOM ได้ในการเรียกใช้ครั้งเดียว หรือ จะสร้างพื้นที่ทำงานอย่างเดียวก็ได้
การแทรก
คุณสร้างพื้นที่ทำงาน Blockly และแทรกลงใน DOM ได้ด้วยการเรียกใช้
Blockly.inject(location, options) อาร์กิวเมนต์แรกจะบอก Blockly ว่าจะ
แทรกพื้นที่ทำงานใน DOM ที่ใด อาร์กิวเมนต์ที่ 2 คือออบเจ็กต์ที่มี
ตัวเลือกการกำหนดค่า
ดูข้อมูลเพิ่มเติมได้ที่สร้าง พื้นที่ทำงาน
การสร้างโดยตรง
คุณสร้างพื้นที่ทำงานได้โดยตรงด้วยการเรียกใช้ new Blockly.WorkspaceSvg(new
Blockly.Options(options)) เมื่อโทร ให้ส่งตัวเลือกการกำหนดค่าในสายไปยัง new Blockly.Options(options) -- ตัวสร้าง WorkspaceSvg จะรับออบเจ็กต์ตัวเลือกการกำหนดค่าของคุณโดยตรงไม่ได้
ตัวเลือกการกำหนดค่า
ออบเจ็กต์การกำหนดค่าจะใช้
Blockly.BlocklyOptions
และมีตัวเลือกต่อไปนี้ โปรดทราบว่าตัวเลือกเหล่านี้บางตัวเลือกจะเปลี่ยน
ค่าเริ่มต้นตามว่ากล่องเครื่องมือที่ระบุมีหมวดหมู่หรือไม่
| ชื่อ | ประเภท | คำอธิบาย |
|---|---|---|
collapse
|
บูลีน | ไม่ว่าจะบล็อกเมนูตามบริบทที่มีรายการเพื่อยุบหรือ
ขยายบล็อก ค่าเริ่มต้นจะเป็น true หากกล่องเครื่องมือมีหมวดหมู่
หรือ false ในกรณีอื่นๆ |
comments
|
บูลีน | ไม่ว่าจะบล็อกเมนูบริบทที่มีรายการเพื่อเพิ่มหรือ
นำความคิดเห็นออก ค่าเริ่มต้นจะเป็น true หากกล่องเครื่องมือมี
หมวดหมู่false |
css
|
บูลีน | หากเป็นเท็จ ไม่ต้องแทรก CSS (การระบุ CSS จะเป็นความรับผิดชอบของเอกสาร) ค่าเริ่มต้นคือ true |
disable
|
บูลีน | ระบุว่าเมนูตามบริบทของบล็อกมีรายการเพื่อปิดใช้หรือ
เปิดใช้บล็อกหรือไม่ ค่าเริ่มต้นจะเป็น true หากกล่องเครื่องมือมีหมวดหมู่
หรือ false ในกรณีอื่นๆ |
grid |
ออบเจ็กต์ | กำหนดค่าตารางกริดที่บล็อกอาจสแนป ดูตารางกริด |
horizontalLayout
|
บูลีน | หากtrueกล่องเครื่องมือเป็นแนวนอน หากfalseกล่องเครื่องมือเป็นแนวตั้ง ค่าเริ่มต้นคือ false |
maxBlocks
|
ตัวเลข | จำนวนบล็อกสูงสุดที่สร้างได้ มีประโยชน์สำหรับ
แบบฝึกหัดของนักเรียน ค่าเริ่มต้นคือ Infinity |
maxInstances
|
ออบเจ็กต์ | แมปจากประเภทบล็อกไปยังจำนวนบล็อกสูงสุดของประเภทนั้นที่อาจสร้างได้ ประเภทที่ไม่ได้ประกาศจะมีค่าเริ่มต้นเป็น
Infinity ตัวอย่าง
maxInstances: {'controls_if': 3, 'math_number': 42} |
maxTrashcanContents
|
ตัวเลข | จำนวนสูงสุดของรายการที่ถูกลบซึ่งจะปรากฏใน
เมนูถังขยะ '0' จะปิดใช้ฟีเจอร์นี้ ค่าเริ่มต้นคือ
'32' |
media
|
สตริง | เส้นทางจากหน้าเว็บ (หรือเฟรม) ไปยังไดเรกทอรีสื่อของ Blockly
ค่าเริ่มต้นคือ
'https://blockly-demo.appspot.com/static/media/' ดูโฟลเดอร์สื่อ |
modalInputs
|
บูลีน | หาก true แสดงเอดิเตอร์แบบโมดอลสำหรับช่องป้อนข้อความและ
คลาสย่อยเมื่ออยู่ในอุปกรณ์เคลื่อนที่ และเอดิเตอร์ในบรรทัด
บนเดสก์ท็อป หาก false แสดงเครื่องมือแก้ไขในหน้าทั้งบนเดสก์ท็อปและอุปกรณ์เคลื่อนที่ ค่าเริ่มต้นคือ true |
move
|
ออบเจ็กต์ | กำหนดค่าลักษณะการทำงานสำหรับวิธีที่ผู้ใช้จะไปยังส่วนต่างๆ ของ พื้นที่ทำงานได้ ดูย้าย |
oneBasedIndex
|
บูลีน | หากtrueการดำเนินการกับลิสต์และสตริงควรจัดทำดัชนีจาก 1
หากfalseจัดทำดัชนีจาก 0 ค่าเริ่มต้นคือ true |
plugins
|
ออบเจ็กต์ | ชื่อประเภทรีจิสทรีการแมปออบเจ็กต์กับคลาสการแทนที่ หรือชื่อที่ลงทะเบียนของคลาสการแทนที่ ดูหัวข้อ แทรกคลาสแทน |
readOnly
|
บูลีน | หาก true ให้ป้องกันไม่ให้ผู้ใช้แก้ไข ซ่อน
กล่องเครื่องมือและถังขยะ ค่าเริ่มต้นคือ false ดูเพิ่มเติม
setIsReadOnly และ
isReadOnly |
renderer
|
สตริง | กำหนดตัวแสดงผลที่ Blockly ใช้ โปรแกรมแสดงผลที่แพ็กเกจไว้ล่วงหน้า ได้แก่ 'geras' (ค่าเริ่มต้น), 'thrasos' และ'zelos' (โปรแกรมแสดงผลที่คล้ายกับ Scratch) ดูข้อมูลเกี่ยวกับ
เครื่องมือแสดงผลที่กำหนดเองได้ที่สร้างเครื่องมือแสดงผลที่กำหนดเอง |
rtl
|
บูลีน | หาก true ให้มิเรอร์เอดิเตอร์ (สำหรับภาษาอาหรับหรือฮีบรู)
ดูการสาธิต RTL ค่าเริ่มต้นคือ false |
scrollbars
|
ออบเจ็กต์หรือ บูลีน | ตั้งค่าว่าพื้นที่ทำงานจะมีแถบเลื่อนแนวตั้งหรือแนวนอน
รับออบเจ็กต์ที่พร็อพเพอร์ตี้ horizontal
กำหนดว่าจะเปิดใช้การเลื่อนแนวนอนหรือไม่ และพร็อพเพอร์ตี้
vertical กำหนดว่าจะเปิดใช้การเลื่อนแนวตั้งหรือไม่
หากส่งบูลีน ระบบจะถือว่าเป็นการส่งออบเจ็กต์ที่มีทั้งพร็อพเพอร์ตี้ horizontal และ vertical
ซึ่งตั้งค่าเป็นค่านั้น ค่าเริ่มต้นจะเป็น true หากกล่องเครื่องมือมีหมวดหมู่ |
sounds |
บูลีน | หาก false จะปิดเสียง ค่าเริ่มต้นคือ true |
theme
|
ธีม | ค่าเริ่มต้นจะเป็นธีมคลาสสิกหากไม่ได้ระบุธีม ดูธีม |
toolbox
|
สตริง XML หรือ JSON | โครงสร้างแบบต้นไม้ของหมวดหมู่และบล็อกที่ผู้ใช้ใช้ได้ ดูข้อมูลเพิ่มเติมได้ที่การกำหนดกล่องเครื่องมือ |
toolboxPosition
|
สตริง | หาก'start'กล่องเครื่องมืออยู่ด้านบน (หากเป็นแนวนอน) หรือด้านซ้าย (หากเป็นแนวตั้งและ LTR) หรือด้านขวา (หากเป็นแนวตั้งและ RTL) หาก'end'กล่องเครื่องมืออยู่ฝั่งตรงข้าม ค่าเริ่มต้นคือ 'start' |
trashcan
|
บูลีน | แสดงหรือซ่อนถังขยะ ค่าเริ่มต้นจะเป็น true หากกล่องเครื่องมือมีหมวดหมู่ หรือ false ในกรณีอื่นๆ |
zoom |
ออบเจ็กต์ | กำหนดค่าลักษณะการทำงานของการซูม ดูข้อมูลที่ Zoom |