blockly > ब्लॉक करें

ब्लॉक क्लास

एक ब्लॉक के लिए क्लास. आम तौर पर, इसे सीधे तौर पर नहीं बुलाया जाता. इसके बजाय, workspace.newBlock() को प्राथमिकता दी जाती है.

हस्ताक्षर:

export declare class Block 

निर्माता

निर्माता मॉडिफ़ायर ब्यौरा
(constructor)(workspace, prototypeName, opt_id) Block क्लास का नया इंस्टेंस बनाता है

प्रॉपर्टी

प्रॉपर्टी मॉडिफ़ायर टाइप ब्यौरा
childBlocks_ protected this[]
collapsed_ protected बूलियन
COLLAPSED_FIELD_NAME

static

readonly

स्ट्रिंग छोटा किया गया फ़ील्ड, किसी भी भाषा में मौजूद आईडी हो सकता है.
COLLAPSED_INPUT_NAME

static

readonly

स्ट्रिंग छोटा किया गया इनपुट, भाषा के हिसाब से नहीं दिखाया जाता.
colour_ protected स्ट्रिंग ब्लॉक का रंग, '#RRGGBB' फ़ॉर्मैट में.
लिखें? (rootBlock: Block) => void (ज़रूरी नहीं) यह एक वैकल्पिक तरीका है, जो म्यूटेटर डायलॉग के कॉन्टेंट के आधार पर ब्लॉक को फिर से कॉन्फ़िगर करता है.
contextMenu बूलियन
data string | null ज़रूरी नहीं है कि टेक्स्ट डेटा, ब्लॉक और एक्सएमएल के बीच राउंड-ट्रिप करे. इसका कोई असर नहीं पड़ता. तीसरे पक्ष, मेटा जानकारी के लिए इसका इस्तेमाल कर सकते हैं.
decompose? (workspace: Workspace) => ब्लॉक करें (ज़रूरी नहीं) यह एक वैकल्पिक फ़ंक्शन है, जो म्यूटेटर फ़्लाईआउट में इस ब्लॉक के कॉन्फ़िगरेशन को दिखाने वाले ब्लॉक से पॉप्युलेट करता है.
क्या आपको इसे मिटाना है? () => void (ज़रूरी नहीं) यह एक वैकल्पिक तरीका है, जिसे आइटम को हटाने के दौरान इस्तेमाल किया जाता है.
disposing protected बूलियन क्या मौजूदा ब्लॉक को हटाने की प्रोसेस चल रही है?
domToMutation? (p1: Element) => void (ज़रूरी नहीं) एक्सएमएल से म्यूटेशन स्टेटस को डिससिरियलाइज़ करने का तरीका तय करने के लिए, डिससिरियलाइज़ेशन का वैकल्पिक तरीका. इसे mutationToDom तय करने के साथ जोड़ा जाना चाहिए.
getDeveloperVariables? () => string[] (ज़रूरी नहीं) डेवलपर वैरिएबल का एलान करने का एक वैकल्पिक तरीका, जिसका इस्तेमाल जनरेटर करते हैं. डेवलपर वैरिएबल, उपयोगकर्ता को कभी नहीं दिखाए जाते. हालांकि, जनरेट किए गए कोड में इन्हें ग्लोबल वैरिएबल के तौर पर दिखाया जाता है.
हैट? स्ट्रिंग (ज़रूरी नहीं) टोपी के टाइप का नाम.
helpUrl string | (() => string) | null ब्लॉक करने से जुड़ी सहायता के लिए स्ट्रिंग या यूआरएल दिखाने वाला फ़ंक्शन. अगर कोई मदद नहीं मिली है, तो शून्य डालें.
आइकॉन IIcon[]
id स्ट्रिंग
init? () => void (ज़रूरी नहीं) यह एक वैकल्पिक तरीका है, जिसे शुरू करने के दौरान कॉल किया जाता है.
inputList इनपुट[]
inputsInline? बूलियन (ज़रूरी नहीं)
inputsInlineDefault? बूलियन (ज़रूरी नहीं)
isInFlyout बूलियन
isInMutator बूलियन
isInsertionMarker_ protected बूलियन अगर यह ब्लॉक, इंसर्शन मार्कर है, तो यह वैल्यू 'सही' होगी.
loadExtraState? (p1: any) => void (ज़रूरी नहीं) JSON के साथ काम करने वाले किसी ब्लॉक से, ब्लॉक की अतिरिक्त स्थिति (जैसे, म्यूटेशन स्टेटस) को डिससिरियलाइज़ करने का तरीका तय करने के लिए, सीरियलाइज़ेशन का एक वैकल्पिक तरीका. इसे saveExtraState तय करने के साथ जोड़ा जाना चाहिए.
mutationToDom? (...p1: any[]) => एलिमेंट (ज़रूरी नहीं) म्यूटेशन स्टेटस को एक्सएमएल में सीरियलाइज़ करने का तरीका तय करने के लिए, सीरियलाइज़ेशन का वैकल्पिक तरीका. इसे domToMutation तय करने के साथ जोड़ा जाना चाहिए.
nextConnection कनेक्शन | null
onchange? ((p1: Abstract) => void) | null (ज़रूरी नहीं) ब्लॉक के पैरंट वर्कस्पेस में बदलाव होने पर इस्तेमाल करने के लिए, कॉलबैक का वैकल्पिक तरीका. आम तौर पर, इसे सिर्फ़ कंस्ट्रक्टर, ब्लॉक टाइप के इनिशलाइज़र फ़ंक्शन या एक्सटेंशन इनिशलाइज़र फ़ंक्शन से कॉल किया जाता है.
outputConnection कनेक्शन | null
outputShape_ protected number | null
parentBlock_ protected this | null
previousConnection कनेक्शन | null
रेंडर किया गया readonly बूलियन क्या यह ब्लॉक BlockSVG है?
RTL बूलियन
saveExtraState? (doFullSerialization?: boolean) => any (ज़रूरी नहीं) ब्लॉक के अतिरिक्त स्टेटस (जैसे, म्यूटेशन स्टेटस) को JSON फ़ॉर्मैट में सीरियलाइज़ करने का तरीका तय करने के लिए, सीरियलाइज़ेशन का एक वैकल्पिक तरीका. इसे loadExtraState तय करने के साथ जोड़ा जाना चाहिए.
styleName_ protected स्ट्रिंग ब्लॉक स्टाइल का नाम.
suppressPrefixSuffix boolean | null जनरेट किए गए कोड में STATEMENT_PREFIX और STATEMENT_SUFFIX जोड़ने से रोकने के लिए, वैकल्पिक प्रॉपर्टी.
टूलटिप Tooltip.TipInfo
type स्ट्रिंग
फ़ाइल फ़ोल्डर Workspace

तरीके

तरीका मॉडिफ़ायर ब्यौरा
addIcon(icon) ब्लॉक में दिया गया आइकॉन जोड़ता है.
allInputsFilled(opt_shadowBlocksAreFilled) बार-बार यह जांच करता है कि सभी स्टेटमेंट और वैल्यू इनपुट, ब्लॉक से भरे गए हैं या नहीं. यह इस स्टैक में मौजूद सभी स्टेटमेंट ब्लॉक की भी जांच करता है.
appendDummyInput(name) डमी इनपुट लाइन जोड़ता है.
appendEndRowInput(name) पंक्ति को खत्म करने वाला इनपुट जोड़ता है.
appendInput(input)

दी गई इनपुट लाइन को जोड़ता है.

इससे ब्लॉक में कस्टम इनपुट जोड़े जा सकते हैं.

appendStatementInput(name) स्टेटमेंट की इनपुट लाइन जोड़ता है.
appendValueInput(name) वैल्यू इनपुट की लाइन जोड़ता है.
bumpNeighbours() अलाइनमेंट से बाहर के ब्लॉक को बंप करें. दो ऐसे ब्लॉक जो असल में कनेक्ट नहीं हैं, वे स्क्रीन पर एक साथ नहीं होने चाहिए.
dispose(healStack) इस ब्लॉक को हटाएं.
disposeInternal() protected टॉप ब्लॉक के लिए ज़रूरी काम किए बिना, इस ब्लॉक को हटा देता है. उदाहरण के लिए, इवेंट ट्रिगर नहीं करता, ब्लॉक को अनप्लग करता है वगैरह.
doInit_() protected init() फ़ंक्शन को कॉल करता है और उससे जुड़े इवेंट ट्रिगर करने वगैरह को मैनेज करता है.
getChildren(ordered) इस ब्लॉक में नेस्ट किए गए सभी ब्लॉक ढूंढें. इसमें वैल्यू और स्टेटमेंट इनपुट के साथ-साथ, कोई भी स्टेटमेंट शामिल होता है. इसमें आउटपुट टैब या उससे पहले के किसी स्टेटमेंट में मौजूद कोई भी कनेक्शन शामिल नहीं होता. ब्लॉक को ऊपर से नीचे की ओर, पोज़िशन के हिसाब से क्रम में लगाया जा सकता है. हालांकि, ऐसा करना ज़रूरी नहीं है.
getColour() किसी ब्लॉक का रंग पाएं.
getCommentText() इस ब्लॉक पर की गई टिप्पणी दिखाता है. अगर कोई टिप्पणी नहीं है, तो यह शून्य दिखाता है.
getDescendants(ordered) ऐसे सभी ब्लॉक ढूंढें जो सीधे या किसी दूसरे ब्लॉक में नेस्ट किए गए हैं. इस ब्लॉक को सूची में शामिल करता है. इसमें वैल्यू और स्टेटमेंट इनपुट के साथ-साथ, इसके बाद के स्टेटमेंट भी शामिल होते हैं. इसमें आउटपुट टैब या पहले के किसी भी स्टेटमेंट पर मौजूद कोई भी कनेक्शन शामिल नहीं होता. ब्लॉक को ऊपर से नीचे की ओर, पोज़िशन के हिसाब से क्रम में लगाया जा सकता है. हालांकि, ऐसा करना ज़रूरी नहीं है.
getDisabledReasons() अगर ब्लॉक करने की सुविधा फ़िलहाल बंद है, तो इसकी वजहें जानें. ब्लॉक चालू होने पर, यह सेट खाली रहेगा.
getField(name) किसी ब्लॉक से नाम वाला फ़ील्ड दिखाता है.
getFields()

एक जनरेटर दिखाता है, जो ब्लॉक पर हर फ़ील्ड उपलब्ध कराता है.

एक जनरेटर, जिसका इस्तेमाल ब्लॉक पर फ़ील्ड को दोहराने के लिए किया जा सकता है.

getFieldValue(name) दिए गए फ़ील्ड की ऐसी वैल्यू दिखाता है जो किसी भी भाषा में हो सकती है.
getHue() किसी ब्लॉक की एचएसवी ह्यू वैल्यू पाएं. अगर ह्यू सेट नहीं है, तो यह वैल्यू शून्य होगी.
getIcon(type)
getIcons()
getInheritedDisabled() यह पता लगाएं कि माता-पिता की वजह से, ब्लॉक की सुविधा बंद है या नहीं. ब्लॉक की बंद की गई प्रॉपर्टी को ध्यान में नहीं रखा जाता.
getInput(name) नाम वाले इनपुट ऑब्जेक्ट को फ़ेच करता है.
getInputsInline() यह पता लगाएं कि वैल्यू इनपुट, हॉरिज़ॉन्टल या वर्टिकल तौर पर व्यवस्थित किए गए हैं या नहीं.
getInputTargetBlock(name) नाम वाले इनपुट से जुड़ा ब्लॉक फ़ेच करता है.
getInputWithBlock(block) उस इनपुट को दिखाता है जो तय किए गए ब्लॉक से कनेक्ट होता है.
getNextBlock() इस ब्लॉक से सीधे तौर पर जुड़ा अगला स्टेटमेंट ब्लॉक दिखाता है.
getOutputShape() ब्लॉक का आउटपुट आकार पाएं.
getParent() अगर यह ब्लॉक सबसे ऊपर के लेवल पर है, तो पैरंट ब्लॉक दिखाएं या शून्य दिखाएं. पैरंट ब्लॉक, स्टेटमेंट ब्लॉक के लिए पिछले कनेक्शन से कनेक्ट किया गया ब्लॉक या वैल्यू ब्लॉक के लिए आउटपुट कनेक्शन से कनेक्ट किया गया ब्लॉक होता है.
getPreviousBlock() पिछले कनेक्शन से जुड़ा ब्लॉक दिखाता है.
getRelativeToSurfaceXY() ड्रॉइंग प्लैटफ़ॉर्म के ऑरिजिन (0,0) के हिसाब से, इस ब्लॉक के सबसे ऊपर बाएं कोने के निर्देशांक, फ़ाइल फ़ोल्डर की इकाइयों में दिखाता है.
getRootBlock() इस ब्लॉक के ट्री में सबसे ऊपर मौजूद ब्लॉक दिखाता है. अगर यह ब्लॉक सबसे ऊपर के लेवल पर है, तो यह अपने-आप दिखेगा.
getStyleName() ब्लॉक स्टाइल का नाम पाएं.
getSurroundParent() मौजूदा ब्लॉक के आस-पास मौजूद पैरंट ब्लॉक दिखाता है. अगर इस ब्लॉक के आस-पास कोई ब्लॉक नहीं है, तो यह शून्य दिखाता है. पैरंट ब्लॉक, पिछला स्टेटमेंट हो सकता है, जबकि आस-पास मौजूद ब्लॉक, if स्टेटमेंट, while लूप वगैरह हो सकता है.
getTooltip() इस ब्लॉक के लिए टूलटिप टेक्स्ट दिखाता है.
getVars() इस ब्लॉक से रेफ़र किए गए सभी वैरिएबल दिखाएं.
hasDisabledReason(reason) यह पता लगाएं कि दी गई वजह से, फ़िलहाल ब्लॉक की सुविधा बंद है या नहीं.
hasIcon(type)
initModel() ब्लॉक के सभी फ़ील्ड पर initModel को कॉल करें. इसे एक से ज़्यादा बार कॉल किया जा सकता है. ब्लॉक बनाने के बाद और उससे पहली बार इंटरैक्ट करने से पहले, initModel या initSvg में से किसी एक को कॉल किया जाना चाहिए. इंटरैक्शन में यूज़र इंटरफ़ेस (यूआई) ऐक्शन (जैसे, क्लिक करना और खींचकर छोड़ना) और ट्रिगर होने वाले इवेंट (जैसे, बनाना, मिटाना, और बदलना) शामिल हैं.
isCollapsed() यह पता लगाएं कि ब्लॉक को छोटा किया गया है या नहीं.
isDeletable() यह पता लगाएं कि इस ब्लॉक को मिटाया जा सकता है या नहीं.
isDisposed() यह बताता है कि इस ब्लॉक को हटा दिया गया है या मिटा दिया गया है.
isDuplicatable() यह पता लगाएं कि ब्लॉक को डुप्लीकेट किया जा सकता है या नहीं. अगर इस ब्लॉक और उसके वंशजों को डुप्लीकेट करने से, यह ब्लॉक वर्कस्पेस की क्षमता से ज़्यादा हो जाता है, तो इस ब्लॉक को डुप्लीकेट नहीं किया जा सकता. अगर इस ब्लॉक और उसके वंशजों को डुप्लीकेट करने पर, उनके ज़्यादा से ज़्यादा इंस्टेंस से ज़्यादा इंस्टेंस बन जाते हैं, तो इस ब्लॉक को डुप्लीकेट नहीं किया जा सकता.
isEnabled() यह पता लगाएं कि यह ब्लॉक चालू है या नहीं. अगर किसी ब्लॉक को बंद करने की कोई वजह नहीं है, तो उसे चालू माना जाता है. उपयोगकर्ता मैन्युअल तरीके से ब्लॉक को चालू करने की कोशिश कर सकता है, लेकिन ब्लॉक किसी दूसरी वजह से बंद रह सकता है. जैसे, ब्लॉक किसी अमान्य जगह पर होना.
isInsertionMarker() यह पता लगाएं कि यह ब्लॉक, इंसर्शन मार्कर ब्लॉक है या नहीं.
isOwnDeletable() यह बताता है कि इस ब्लॉक की, मिटाई जा सकने वाली प्रॉपर्टी की वैल्यू 'सही' है या 'गलत'.
isOwnEditable() यह बताता है कि इस ब्लॉक की, बदलाव की जा सकने वाली प्रॉपर्टी सही है या गलत.
isShadow() यह पता लगाएं कि यह ब्लॉक, शैडो ब्लॉक है या नहीं.
jsonInit(json) इस ब्लॉक को शुरू करने के लिए, अलग-अलग प्लैटफ़ॉर्म पर काम करने वाले और अंतरराष्ट्रीय स्तर पर इस्तेमाल किए जा सकने वाले JSON फ़ॉर्मैट में जानकारी दें.
mixin(mixinObj, opt_disableCheck) mixinObj से की/वैल्यू को इस ब्लॉक ऑब्जेक्ट में जोड़ें. डिफ़ॉल्ट रूप से, यह तरीका यह जांच करेगा कि mixinObj में मौजूद कुंजियां, ब्लॉक में मौजूद मौजूदा वैल्यू को ओवरराइट नहीं करेंगी. इनमें प्रोटोटाइप वैल्यू भी शामिल हैं. इससे, आने वाले समय में ब्लॉक की सुविधाओं के साथ मिक्सिन / एक्सटेंशन के काम न करने की समस्या से बचा जा सकता है. इस जांच को बंद करने के लिए, दूसरे आर्ग्युमेंट के तौर पर true डालें.
moveBy(dx, dy, reason) किसी ब्लॉक को रिलेटिव ऑफ़सेट से दूसरी जगह ले जाना.
moveInputBefore(name, refName) नाम वाले इनपुट को इस ब्लॉक की किसी दूसरी जगह पर ले जाएं.
moveNumberedInputBefore(inputIndex, refIndex) नंबर वाले इनपुट को इस ब्लॉक में किसी दूसरी जगह पर ले जाएं.
removeIcon(type) ब्लॉक से वह आइकॉन हटाता है जिसका getType, दिए गए टाइप iconType से मेल खाता है.
removeInput(name, opt_quiet) इस ब्लॉक से कोई इनपुट हटाएं.
renameVarById(oldId, newId) किसी वैरिएबल का नाम बदलने की सूचना. अगर आईडी, इस ब्लॉक के किसी वैरिएबल से मेल खाता है, तो उसका नाम बदलें.
setCollapsed(collapsed) सेट करें कि ब्लॉक को छोटा किया गया है या नहीं.
setColour(colour) ब्लॉक का रंग बदलना.
setCommentText(text) इस ब्लॉक के लिए टिप्पणी का टेक्स्ट सेट करें.
setDeletable(deletable) सेट करें कि इस ब्लॉक को मिटाया जा सकता है या नहीं.
setDisabledReason(disabled, reason) ब्लॉक करने की वजह जोड़ें या हटाएं. अगर किसी ब्लॉक को बंद करने की कोई वजह है, तो उसे बंद माना जाएगा. ब्लॉक को एक साथ कई वजहों से बंद किया जा सकता है. जैसे, जब उपयोगकर्ता उसे मैन्युअल तरीके से बंद करता है या ब्लॉक अमान्य हो जाता है.
setEditable(editable) सेट करें कि इस ब्लॉक में बदलाव किया जा सकता है या नहीं.
setFieldValue(newValue, name) इस ब्लॉक के लिए दिए गए फ़ील्ड की वैल्यू सेट करता है.
setHelpUrl(url) इस ब्लॉक के सहायता पेज का यूआरएल सेट करें.
setInputsInline(newBoolean) सेट करें कि वैल्यू इनपुट को हॉरिज़ॉन्टल या वर्टिकल तौर पर व्यवस्थित किया जाए.
setMovable(movable) सेट करें कि इस ब्लॉक को एक जगह से दूसरी जगह ले जाया जा सकता है या नहीं.
setMutator(_mutator) इस ब्लॉक को म्यूटेट करने वाला डायलॉग दें.
setNextStatement(newBoolean, opt_check) सेट करें कि कोई दूसरा ब्लॉक, इस ब्लॉक के नीचे चेन कर सकता है या नहीं.
setOnChange(onchangeFn) जब भी ब्लॉक के पैरंट वर्कस्पेस में बदलाव होता है, तब इस्तेमाल करने के लिए कॉलबैक फ़ंक्शन सेट करता है. साथ ही, किसी भी पुराने onchange हैंडलर की जगह लेता है. आम तौर पर, इसे सिर्फ़ कंस्ट्रक्टर, ब्लॉक टाइप के इनिशलाइज़र फ़ंक्शन या एक्सटेंशन इनिशलाइज़र फ़ंक्शन से कॉल किया जाता है.
setOutput(newBoolean, opt_check) सेट करें कि यह ब्लॉक कोई वैल्यू दिखाता है या नहीं.
setOutputShape(outputShape) ब्लॉक के आउटपुट का आकार सेट करें.
setPreviousStatement(newBoolean, opt_check) सेट करें कि यह ब्लॉक, किसी दूसरे ब्लॉक के नीचे चेन किया जा सकता है या नहीं.
setStyle(blockStyleName) ब्लॉक की स्टाइल और कलर वैल्यू सेट करें.
setTooltip(newTip) इस ब्लॉक के लिए टूलटिप सेट करता है.
setWarningText(_text, _opt_id) इस ब्लॉक के लिए चेतावनी वाला टेक्स्ट सेट करें.
toDevString()

यह तरीका, डेवलपर की शर्तों (टाइप का नाम और आईडी; सिर्फ़ अंग्रेज़ी) में इस ब्लॉक के बारे में बताने वाली स्ट्रिंग दिखाता है.

इसका इस्तेमाल, कंसोल लॉग और गड़बड़ियों में किया जाना चाहिए. अगर आपको उपयोगकर्ता की मूल भाषा (इसमें ब्लॉक टेक्स्ट, फ़ील्ड वैल्यू, और चाइल्ड ब्लॉक शामिल हैं) का इस्तेमाल करने वाली स्ट्रिंग चाहिए, तो toString() का इस्तेमाल करें.

toString(opt_maxLength, opt_emptyToken) इस ब्लॉक और उसके सभी चाइल्ड एलिमेंट का ऐसा टेक्स्ट वर्शन बनाएं जिसे कोई भी पढ़ सके.
unplug(opt_healStack) इस ब्लॉक को उसके सुपीरियर ब्लॉक से अनप्लग करें. अगर यह ब्लॉक कोई स्टेटमेंट है, तो नीचे दिए गए ब्लॉक को ऊपर दिए गए ब्लॉक से फिर से कनेक्ट करें. हालांकि, ऐसा करना ज़रूरी नहीं है.