blockly > ตัวแปร

เนมสเปซของตัวแปร

ฟังก์ชัน

ฟังก์ชัน คำอธิบาย
allDeveloperVariables(workspace)

ค้นหาตัวแปรนักพัฒนาซอฟต์แวร์ทั้งหมดที่บล็อกใช้ในเวิร์กスペース

ตัวแปรของนักพัฒนาแอปจะไม่แสดงต่อผู้ใช้ แต่จะมีการประกาศเป็นตัวแปรส่วนกลางในโค้ดที่สร้างขึ้น หากต้องการประกาศตัวแปรของนักพัฒนาแอป ให้กําหนดฟังก์ชัน getDeveloperVariables ในบล็อกและแสดงรายการชื่อตัวแปร สำหรับใช้กับเครื่องกำเนิดไฟฟ้า

allUsedVarModels(ws)

ค้นหาตัวแปรทั้งหมดที่ผู้ใช้สร้างขึ้นซึ่งใช้งานอยู่ในเวิร์กスペース สำหรับใช้กับเครื่องกำเนิดไฟฟ้า

หากต้องการดูรายการตัวแปรทั้งหมดในพื้นที่ทํางาน รวมถึงตัวแปรที่ไม่ได้ใช้ ให้เรียกใช้ getAllVariables

createVariableButtonHandler(workspace, opt_callback, opt_type)

จัดการปุ่ม "สร้างตัวแปร" ในหมวดหมู่กล่องเครื่องมือตัวแปรเริ่มต้น ระบบจะแจ้งให้ผู้ใช้ป้อนชื่อตัวแปร รวมถึงแจ้งอีกครั้งหากมีการใช้ชื่อนั้นอยู่แล้วในตัวแปรของพื้นที่ทำงาน

แฮนเดิลปุ่มที่กําหนดเองสามารถมอบสิทธิ์ให้ฟังก์ชันนี้ ซึ่งจะอนุญาตประเภทตัวแปรและการประมวลผลหลังการสร้าง การปรับแต่งที่ซับซ้อนมากขึ้น (เช่น การแจ้งให้ระบุประเภทตัวแปร) อยู่นอกเหนือขอบเขตของฟังก์ชันนี้

deleteVariable(workspace, variable, triggeringBlock) ลบตัวแปรและการใช้งานทั้งหมดออกจากพื้นที่ทํางานหนึ่งๆ อาจแจ้งให้ผู้ใช้ยืนยัน
flyoutCategory(workspace, useXml)
flyoutCategory(workspace, useXml)
flyoutCategoryBlocks(workspace) สร้างบล็อกที่จําเป็นสําหรับเมนูแบบเลื่อนลงสําหรับหมวดหมู่ตัวแปร
generateUniqueName(workspace) แสดงชื่อตัวแปรใหม่ที่ยังไม่เคยใช้ ซึ่งจะพยายามสร้างชื่อตัวแปรแบบตัวอักษรเดียวในช่วง "i" ถึง "z" ไว้เป็นชื่อเริ่มต้น หากไม่พบชื่อที่ไม่ซ้ำกัน ระบบจะลองใช้ชื่อตั้งแต่ "i" ถึง "z", "a" ถึง "h" จากนั้น "i2" ถึง "z2" เป็นต้น โดยข้าม "l"
generateUniqueNameFromOptions(startChar, usedNames) แสดงผลชื่อที่ไม่ซ้ำกันซึ่งไม่มีอยู่ในอาร์เรย์ usedNames ซึ่งจะพยายามสร้างชื่อแบบตัวอักษรเดียวในช่วง a - z (ข้าม l) โดยจะเริ่มด้วยอักขระที่ส่งไปยัง startChar
generateVariableFieldDom(variableModel) สร้างออบเจ็กต์ DOM ที่แสดงถึงช่องตัวแปร
getOrCreateVariablePackage(workspace, id, opt_name, opt_type) ฟังก์ชันตัวช่วยในการค้นหาหรือสร้างตัวแปรในพื้นที่ทํางานที่ระบุ หากไม่มีตัวแปร ระบบจะสร้างและแสดงผล
getVariable(workspace, id, opt_name, opt_type) ค้นหาตัวแปรในพื้นที่ทํางานที่ระบุ ค้นหาในพื้นที่ทํางานหลักก่อนเสมอก่อนที่จะค้นหาในพื้นที่ทํางานแบบเลื่อนลง ค้นหาตามรหัสจะดีกว่าการค้นหาตามชื่อ + ประเภทเสมอ
getVariableUsesById(workspace, id) ค้นหาการใช้ตัวแปรที่มีชื่อทั้งหมด
nameUsedWithAnyType(name, workspace) ตรวจสอบว่ามีตัวแปรที่มีชื่อที่ระบุของประเภทใดประเภทหนึ่งหรือไม่
promptName(promptText, defaultText, callback) แจ้งให้ผู้ใช้ป้อนชื่อตัวแปรใหม่
renameVariable(workspace, variable, opt_callback) เปิดพรอมต์ที่อนุญาตให้ผู้ใช้ป้อนชื่อใหม่สำหรับตัวแปร ทริกเกอร์การเปลี่ยนชื่อหากชื่อใหม่ถูกต้อง หรือแสดงข้อความแจ้งอีกครั้งหากมีการทับซ้อน

ตัวแปร

ตัวแปร คำอธิบาย
CATEGORY_NAME สตริงสําหรับใช้ในแอตทริบิวต์ "custom" ของหมวดหมู่ใน XML ของกล่องเครื่องมือ สตริงนี้ระบุว่าควรป้อนข้อมูลหมวดหมู่แบบไดนามิกด้วยบล็อกตัวแปร โปรดดู Blockly.Procedures.CATEGORY_NAME และ Blockly.VariablesDynamic.CATEGORY_NAME ด้วย
TEST_ONLY
VAR_LETTER_OPTIONS