สร้างพื้นที่ทำงาน

คุณสามารถสร้างพื้นที่ทำงานและแทรกลงใน 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