คําจํากัดความของบล็อกคือออบเจ็กต์ที่กําหนดบล็อกที่กําหนดเอง เช่น กำหนดรูปลักษณ์ของบล็อก (ข้อความ ช่อง การเชื่อมต่อ สี ฯลฯ) รวมถึงลักษณะการทํางาน (ตัวแฮนเดิลเหตุการณ์ระดับบล็อก ฯลฯ)
เช่น บล็อกนี้
กำหนดได้ใน JSON หรือ JavaScript ดังนี้
JSON
Blockly.common.defineBlocksWithJsonArray([{
"type": "string_length",
"message0": 'length of %1',
"args0": [
{
"type": "input_value",
"name": "VALUE",
"check": "String"
}
],
"output": "Number",
"colour": 160,
"tooltip": "Returns number of letters in the provided text.",
"helpUrl": "http://www.w3schools.com/jsref/jsref_length_string.asp"
}]);
defineBlocksWithJsonArray
สร้างคำจำกัดความของบล็อกจากออบเจ็กต์ JSON
JavaScript
Blockly.Blocks['string_length'] = {
init: function() {
this.appendValueInput('VALUE')
.setCheck('String')
.appendField('length of');
this.setOutput(true, 'Number');
this.setColour(160);
this.setTooltip('Returns number of letters in the provided text.');
this.setHelpUrl('http://www.w3schools.com/jsref/jsref_length_string.asp');
}
};
เมื่อใช้ JavaScript คุณจะสร้างคําจํากัดความของบล็อกโดยตรง
วิธีการทำงานของคําจํากัดความของบล็อก
คําจํากัดความของบล็อกคือ mixin ที่มีพร็อพเพอร์ตี้ที่มีค่าเป็นฟังก์ชัน เมื่อสร้างบล็อกใหม่ ระบบจะคัดลอกพร็อพเพอร์ตี้เหล่านี้ไปยังออบเจ็กต์บล็อกที่สร้างขึ้นใหม่ Blockly จะเรียกใช้ฟังก์ชันเหล่านี้เพื่อเรียกใช้ลักษณะการทำงานที่กำหนดเอง
เนื่องจากฟังก์ชันการกําหนดค่าจะรวมอยู่ในออบเจ็กต์บล็อก
- คีย์เวิร์ด
this
ในฟังก์ชันการกําหนดหมายถึงออบเจ็กต์บล็อก กล่าวคือ สามารถใช้เพื่อเข้าถึงเมธอดและพร็อพเพอร์ตี้สาธารณะในคลาสBlock
(หรือBlockSvg
)
Blockly จะกำหนดฟังก์ชันจำนวนเล็กน้อยที่คุณสามารถใช้เพื่อปรับแต่งบล็อก รายการที่พบบ่อยที่สุดคือ init
ซึ่ง Blockly จะเรียกใช้เพื่อเริ่มต้นบล็อกและใช้ในการกำหนดรูปลักษณ์ของบล็อก ดูรายการทั้งหมดได้ที่พร็อพเพอร์ตี้ที่มีค่าเป็นฟังก์ชันในคลาส Block
และ BlockSvg
พร็อพเพอร์ตี้เหล่านี้จะสร้างอินเทอร์เฟซที่มีประสิทธิภาพสําหรับการใช้คําจํากัดความของบล็อก โดยคุณเลือกใช้พร็อพเพอร์ตี้เหล่านี้หรือไม่ก็ได้
คําจํากัดความของบล็อกอาจมีฟังก์ชันที่กําหนดเองด้วย แต่ Blockly จะไม่เรียกใช้ฟังก์ชันเหล่านี้โดยตรง แต่จะใช้เพื่อติดตั้งใช้งานฟังก์ชันอื่นๆ แทนได้ ตัวอย่างเช่น ตัวแฮนเดิลเหตุการณ์ระดับบล็อก (พร็อพเพอร์ตี้ Block.onchange
) อาจมอบหมายเหตุการณ์ต่างๆ ให้กับฟังก์ชันที่กําหนดเองที่แตกต่างกัน
วิธีสร้างคําจํากัดความของบล็อก
การสร้างคําจํากัดความของบล็อกมีหลายวิธีดังนี้
- ใช้เครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ Blockly เพื่อกำหนดรูปลักษณ์ของบล็อก คัดลอก JSON หรือ JavaScript ที่สร้างขึ้นลงในโค้ด แล้วเพิ่มโค้ดที่กำหนดเองตามต้องการ ดูข้อมูลเพิ่มเติมได้ที่เครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ Blockly
- ค้นหาบล็อกที่คล้ายกัน คัดลอกคําจํากัดความ แล้วแก้ไขตามต้องการ ดูข้อมูลเพิ่มเติมได้ที่แก้ไขคำจำกัดความที่มีอยู่
- เขียนคําจํากัดความของบล็อกด้วยตนเอง ดูข้อมูลเพิ่มเติมได้ที่ JSON และ JavaScript