Sınıfı engelleme
Bir blok için sınıf. Genellikle doğrudan çağrılmaz. workspace.newBlock() tercih edilir.
İmza:
export declare class Block
Markalar
Marka | Değiştiriciler | Açıklama |
---|---|---|
(constructor)(workspace, prototypeName, opt_id) | Block sınıfının yeni bir örneğini oluşturur |
Özellikler
Mülk | Değiştiriciler | Tür | Açıklama |
---|---|---|---|
childBlocks_ | protected |
this[] | |
collapsed_ | protected |
boolean | |
COLLAPSED_FIELD_NAME |
|
dize | Daraltılmış alana verilen dilsiz kimlik. |
COLLAPSED_INPUT_NAME |
|
dize | Daraltılmış girişe verilen dilsiz kimlik. |
colour_ | protected |
dize | Bloğun "#RRGGBB" biçimindeki rengi. |
compose? | (rootBlock: Block) => void | (İsteğe bağlı) Değiştirici iletişim kutusunun içeriğine göre bloğu yeniden yapılandıran isteğe bağlı bir yöntem. | |
contextMenu | boolean | ||
data | string | null | Bloklar ile XML arasında gidip gelen isteğe bağlı metin verileri. Etkisi yoktur. Meta bilgiler için üçüncü taraflarca kullanılabilir. | |
decompose? | (workspace: Workspace) => Engelle | (İsteğe bağlı) Değiştirici pop-up'ını bu bloğun yapılandırmasını temsil eden bloklarla dolduran isteğe bağlı bir işlev. | |
destroy? | () => void | (İsteğe bağlı) İmha sırasında çağrılan isteğe bağlı bir yöntem. | |
disposing | protected |
boolean | Mevcut blok şu anda bertaraf edilme sürecinde mi? |
domToMutation? | (p1: Öğe) => void | (İsteğe bağlı) Mutasyon durumunun XML'den nasıl serileştirileceğini tanımlamak için isteğe bağlı bir seri dışılaştırma yöntemi. Bu, mutationToDom değerinin tanımlanmasıyla birlikte yapılmalıdır. |
|
getDeveloperVariables? | () => string[] | (İsteğe bağlı) Oluşturucular tarafından kullanılacak geliştirici değişkenlerini beyan etmek için isteğe bağlı bir yöntem. Geliştirici değişkenleri hiçbir zaman kullanıcıya gösterilmez ancak oluşturulan kodda genel değişken olarak bildirilir. | |
şapka? | dize | (İsteğe bağlı) Şapka türünün adı. | |
helpUrl | string | (() => string) | null | Engelleme yardımı için dize veya URL döndüren işlev. Yardım almadığınızı belirtmek için boş bırakın. | |
simgeler | IIcon[] | ||
id | dize | ||
init? | () => void | (İsteğe bağlı) İlklendirme sırasında çağrılan isteğe bağlı bir yöntem. | |
inputList | Giriş[] | ||
inputsInline? | boolean | (İsteğe bağlı) | |
inputsInlineDefault? | boolean | (İsteğe bağlı) | |
isInFlyout | boolean | ||
isInMutator | boolean | ||
isInsertionMarker_ | protected |
boolean | Bu blok bir ekleme işaretçisiyse doğru değerini döndürür. |
loadExtraState? | (p1: any) => void | (İsteğe bağlı) JSON uyumlu bir öğeden bloğun ek durumunun (ör. mutasyon durumu) nasıl serileştirileceğini tanımlamak için isteğe bağlı bir serileştirme yöntemi. Bu, saveExtraState 'ün tanımlanmasıyla birlikte yapılmalıdır. |
|
mutationToDom? | (...p1: any[]) => Öğe | (İsteğe bağlı) Mutasyon durumunun XML olarak nasıl serileştirileceğini tanımlamak için isteğe bağlı bir serileştirme yöntemi. Bu, domToMutation değerinin tanımlanmasıyla birlikte yapılmalıdır. |
|
nextConnection | Bağlantı | null | ||
onchange? | ((p1: Abstract) => void) | null | (İsteğe bağlı) Bloğun üst çalışma alanı değiştiğinde kullanılacak isteğe bağlı geri çağırma yöntemi. Bu işlev genellikle yalnızca kurucudan, blok türü başlatıcı işlevinden veya bir uzantı başlatıcı işlevinden çağrılır. | |
outputConnection | Bağlantı | null | ||
outputShape_ | protected |
number | null | |
parentBlock_ | protected |
this | null | |
previousConnection | Bağlantı | null | ||
rendered | readonly |
boolean | Bu blok bir BlockSVG mi? |
RTL | boolean | ||
saveExtraState? | (doFullSerialization?: boolean) => any | (İsteğe bağlı) Bloğun ek durumunun (ör. mutasyon durumu) JSON uyumlu bir şekilde nasıl serileştirileceğini tanımlamak için isteğe bağlı bir serileştirme yöntemi. Bu, loadExtraState değerinin tanımlanmasıyla birlikte yapılmalıdır. |
|
styleName_ | protected |
dize | Blok stilinin adı. |
suppressPrefixSuffix | boolean | null | Oluşturulan koda STATEMENT_PREFIX ve STATEMENT_SUFFIX eklenmesini engellemek için isteğe bağlı bir özellik. | |
tooltip | Tooltip.TipInfo | ||
type | dize | ||
workspace | Workspace |
Yöntemler
Yöntem | Değiştiriciler | Açıklama |
---|---|---|
addIcon(icon) | Belirtilen simgeyi bloğa ekler. | |
allInputsFilled(opt_shadowBlocksAreFilled) | Tüm ifade ve değer girişlerinin bloklarla doldurulup doldurulmadığını yinelemeli olarak kontrol eder. Ayrıca bu yığıntaki tüm ifade bloklarını da kontrol eder. | |
appendDummyInput(name) | Sanal bir giriş satırı ekler. | |
appendEndRowInput(name) | Satırı sonlandıran bir giriş ekler. | |
appendInput(input) | Belirtilen giriş satırını ekler. Bloğa özel girişlerin eklenmesine izin verir. |
|
appendStatementInput(name) | Bir hesap ekstresi giriş satırı ekler. | |
appendValueInput(name) | Bir değer girişi satırı ekler. | |
bumpNeighbours() | Bağlantısı olmayan blokları hizadan çıkarın. Gerçekte bağlı olmayan iki blok ekranda tesadüfen hizalanmamalıdır. | |
dispose(healStack) | Bu bloğu çıkarın. | |
disposeInternal() | protected |
Üst blok tarafından gereken işlemleri yapmadan bu bloğu kaldırır. Örneğin, etkinlikleri tetiklemez, bloğu prizden çıkarır vb. |
doInit_() | protected |
init() işlevini çağırır ve ilişkili etkinlik tetiklemeyi vb. işler. |
getChildren(ordered) | Doğrudan bu blokun içine yerleştirilmiş tüm blokları bulun. Değer ve ifade girişlerinin yanı sıra aşağıdaki ifadeleri içerir. Çıkış sekmesindeki veya önceki ifadelerdeki bağlantıları hariç tutar. Bloklar isteğe bağlı olarak yukarıdan aşağıya doğru konuma göre sıralanır. | |
getColour() | Bir bloğun rengini alın. | |
getCommentText() | Bu bloktaki yorumu döndürür (yorum yoksa null değerini döndürür). | |
getDescendants(ordered) | Doğrudan veya dolaylı olarak bu blok içine yerleştirilmiş tüm blokları bulun. Bu bloğu listeye dahil eder. Değer ve ifade girişlerinin yanı sıra aşağıdaki ifadeleri içerir. Çıkış sekmesindeki bağlantıları veya önceki ifadeleri hariç tutar. Bloklar isteğe bağlı olarak yukarıdan aşağıya doğru konuma göre sıralanır. | |
getDisabledReasons() | Engellemenin şu anda devre dışı bırakılmasının nedenlerini (varsa) öğrenin. Engelleme etkinse bu grup boş olur. | |
getField(name) | Bir bloktaki adlandırılmış alanı döndürür. | |
getFields() | Bloktaki her alanı sağlayan bir jeneratör döndürür. Bloktaki alanları iterasyonla işlemek için kullanılabilecek bir üreteç. |
|
getFieldValue(name) | Belirtilen alanın dilsiz değerini döndürür. | |
getHue() | Bir bloğun HSV tonu değerini alın. Tonu ayarlanmamışsa null değerini döndürür. | |
getIcon(type) | ||
getIcons() | ||
getInheritedDisabled() | Engellemenin ebeveynler nedeniyle devre dışı olup olmadığını öğrenin. Blokun kendi devre dışı bırakılmış mülkü dikkate alınmaz. | |
getInput(name) | Adlandırılmış giriş nesnesini getirir. | |
getInputsInline() | Değer girişlerinin yatay mı yoksa dikey mi düzenlendiğini alın. | |
getInputTargetBlock(name) | Adlandırılmış girişe bağlı bloğu getirir. | |
getInputWithBlock(block) | Belirtilen bloğa bağlanan girişi döndürür. | |
getNextBlock() | Doğrudan bu bloğa bağlı bir sonraki ifade bloğunu döndürme. | |
getOutputShape() | Bloğun çıkış şeklini alın. | |
getParent() | Üst bloğu veya bu blok üst düzeydeyse null değerini döndürür. Üst blok, önceki bağlantıya bağlı bloktur (ifade bloğu için) veya çıkış bağlantısına bağlı bloktur (değer bloğu için). | |
getPreviousBlock() | Önceki bağlantıya bağlı bloğu döndürür. | |
getRelativeToSurfaceXY() | Bu bloğun sol üst köşesinin,çizim yüzeyinin orijinine (0,0) göre koordinatlarını çalışma alanı birimlerinde döndürme | |
getRootBlock() | Bu bloğun ağacındaki en üstteki bloğu döndürür. Bu blok en üst düzeydeyse kendisini döndürür. | |
getStyleName() | Blok stilinin adını alın. | |
getSurroundParent() | Geçerli bloğu çevreleyen üst bloğu döndürür veya bu bloğun çevreleyen bir bloğu yoksa null değerini döndürür. Üst blok, önceki ifade olabilir. Çevresindeki blok ise bir if ifadesi, while döngüsü vb. olabilir. | |
getTooltip() | Bu bloğun ipucu metnini döndürür. | |
getVars() | Bu bloğun referans verdiği tüm değişkenleri döndürür. | |
hasDisabledReason(reason) | Engellemenin şu anda belirtilen nedenden dolayı devre dışı olup olmadığını öğrenin. | |
hasIcon(type) | ||
initModel() | Bloktaki tüm alanlarda initModel'i çağırın. Birden fazla kez çağrılabilir. initModel veya initSvg, bir blok oluşturulduktan sonra ve blokla ilk etkileşimden önce çağrılmalıdır. Etkileşimler arasında kullanıcı arayüzü işlemleri (ör. tıklama ve sürükleme) ve etkinleştirme etkinlikleri (ör. oluşturma, silme ve değiştirme) yer alır. | |
isCollapsed() | Bloğun daraltılıp daraltılmadığını alın. | |
isDeletable() | Bu bloğun silinip silinemeyeceğini öğrenin. | |
isDisposed() | Bu bloğun elden çıkarılıp çıkarılmadığını / silinip silinmediğini döndürür. | |
isDuplicatable() | Bloğun kopyalanıp kopyalanamayacağını öğrenin. Bu blok ve alt öğelerinin kopyalanması, bu bloğu çalışma alanının kapasitesinin üzerine çıkaracaksa bu blok kopyalanamaz. Bu bloğun ve alt öğelerinin kopyalanması, herhangi bir türün maxInstances değerlerini aşmasına neden oluyorsa bu blok kopyalanamaz. | |
isEnabled() | Bu bloğun etkin olup olmadığını alın. Engellemenin devre dışı bırakılmasının herhangi bir nedeni yoksa engelleme etkin olarak kabul edilir. Kullanıcı, engellemeyi manuel olarak etkinleştirmeye çalışsa bile engel, geçersiz bir konumda olduğunda olduğu gibi başka nedenlerle devre dışı kalabilir. | |
isInsertionMarker() | Bu bloğun bir ekleme işaretçisi bloğu olup olmadığını alın. | |
isOwnDeletable() | Bu bloğun kendi silinebilir özelliğinin doğru mu yanlış mı olduğunu döndürür. | |
isOwnEditable() | Bu bloğun kendi düzenlenebilir özelliğinin doğru veya yanlış olup olmadığını döndürür. | |
isShadow() | Bu bloğun gölge blok olup olmadığını öğrenin. | |
jsonInit(json) | Bu bloğu, platformlar arası ve uluslararasılaştırmaya uygun bir JSON açıklaması kullanarak başlatın. | |
mixin(mixinObj, opt_disableCheck) | mixinObj'deki anahtar/değer çiftlerini bu blok nesnesine ekleyin. Varsayılan olarak bu yöntem, mixinObj'deki anahtarların prototip değerleri dahil olmak üzere bloktaki mevcut değerlerin üzerine yazmayacağını kontrol eder. Bu, gelecekteki blok özellikleriyle karıştırma / uzantı uyumsuzluklarına karşı bir miktar güvence sağlar. Bu denetim, ikinci bağımsız değişken olarak true değeri iletilerek devre dışı bırakılabilir. | |
moveBy(dx, dy, reason) | Bir bloğu göreli bir ofsetle taşıma | |
moveInputBefore(name, refName) | Adlandırılmış bir girişi bu bloktaki farklı bir konuma taşıyabilirsiniz. | |
moveNumberedInputBefore(inputIndex, refIndex) | Numaralı bir girişi bu bloktaki farklı bir konuma taşıyın. | |
removeIcon(type) | getType özelliği belirtilen türle (iconType) eşleşen simgeyi bloktan kaldırır. | |
removeInput(name, opt_quiet) | Bu bloktaki bir girişi kaldırın. | |
renameVarById(oldId, newId) | Bir değişkenin yeniden adlandırıldığına dair bildirim. Kimlik, bu bloğun değişkenlerinden biriyle eşleşiyorsa kimliği yeniden adlandırın. | |
setCollapsed(collapsed) | Bloğun daraltılıp daraltılmayacağını ayarlayın. | |
setColour(colour) | Bir bloğun rengini değiştirme | |
setCommentText(text) | Bu bloğun yorum metnini ayarlayın. | |
setDeletable(deletable) | Bu bloğun silinebilir olup olmadığını ayarlayın. | |
setDisabledReason(disabled, reason) | Engellemenin devre dışı bırakılma nedenini ekleyin veya kaldırın. Bir bloğun devre dışı bırakılması için herhangi bir neden varsa bloğun kendisi devre dışı kabul edilir. Bir engelleme, kullanıcının manuel olarak devre dışı bırakması veya engellemenin geçersiz olması gibi birden fazla bağımsız nedenden dolayı aynı anda devre dışı bırakılabilir. | |
setEditable(editable) | Bu bloğun düzenlenebilir olup olmadığını ayarlayın. | |
setFieldValue(newValue, name) | Bu blok için belirli bir alanın değerini ayarlar. | |
setHelpUrl(url) | Bu bloğun yardım sayfasının URL'sini ayarlayın. | |
setInputsInline(newBoolean) | Değer girişlerinin yatay mı yoksa dikey mi düzenleneceğini ayarlayın. | |
setMovable(movable) | Bu bloğun taşınabilir olup olmadığını ayarlayın. | |
setMutator(_mutator) | Bu bloğa bir değiştirici iletişim kutusu ekleyin. | |
setNextStatement(newBoolean, opt_check) | Başka bir bloğun bu bloğun alt kısmına zincirlenip bağlanamayacağını ayarlayın. | |
setOnChange(onchangeFn) | Önceki onchange işleyicinin yerini alarak, bloğun üst çalışma alanı değiştiğinde kullanılacak bir geri çağırma işlevi ayarlar. Bu işlev genellikle yalnızca kurucudan, blok türü başlatıcı işlevinden veya bir uzantı başlatıcı işlevinden çağrılır. | |
setOutput(newBoolean, opt_check) | Bu bloğun değer döndürüp döndürmeyeceğini ayarlayın. | |
setOutputShape(outputShape) | Bloğun çıkış şeklini ayarlayın. | |
setPreviousStatement(newBoolean, opt_check) | Bu bloğun başka bir bloğun alt kısmına zincirlenip bağlanamayacağını ayarlayın. | |
setStyle(blockStyleName) | Bir bloğun stilini ve renk değerlerini ayarlayın. | |
setTooltip(newTip) | Bu bloğun ipucunu belirler. | |
setWarningText(_text, _opt_id) | Bu bloğun uyarı metnini ayarlayın. | |
toDevString() | Bu yöntem, bu bloğu geliştirici terimleriyle açıklayan bir dize döndürür (tür adı ve kimliği; yalnızca İngilizce). Konsol günlüklerinde ve hatalarında kullanılmak üzere tasarlanmıştır. Kullanıcının ana dilini kullanan bir dizeye (blok metni, alan değerleri ve alt bloklar dahil) ihtiyacınız varsa toString() işlevini kullanın. |
|
toString(opt_maxLength, opt_emptyToken) | Bu bloğun ve alt öğelerinin kullanıcılar tarafından okunabilen bir metin temsilini oluşturun. | |
unplug(opt_healStack) | Bu bloğu üstteki bloktan çıkarın. Bu blok bir ifadeyse isteğe bağlı olarak alttaki bloğu üstteki blokla yeniden bağlayın. |