Blockly Fields積木表單元素技术頭條網

Blockly Fields積木表單元素

2020-04-03 03:34:00 知晨創客

Fields用於定義積木的輸入類型。其中包括字符串，圖像，數據（例如字符串和數字）的輸入，以及豐富的選擇器（例如日期選擇器和角度選擇器）輸入。Fields就像HTML表單中元素，表單有多種元素，元素可以編寫各種驗證程序，判斷輸入正確性。

Blockly提供了幾種類型來處理各種用戶輸入。可以通過特定元素的配置或使用驗證程序來自定義這些積木，驗證程序可以告訴你元素如何在標準編輯器中處理特定內容。

元素組成

值（%1 %2）

所有元素都應該具有一個值，這是該元素數據的輸入來源。它可以是任何類型（字符串，數字，數組，日期等）。元素可以使用驗證器來限制值或轉換為機器可讀格式（例如，規範化日期格式）。

文本（message）

所有元素都包含文本，該文本是一個易於理解的簡單字符串，表示元素的值。這並不一定意味著它們相同。例如，布爾元素上的文本可能為“ On”或“ Off”，而其值為“ true”或“ false”。

通常，可編輯元素允許用戶更改代碼，而不可編輯元素則向用戶顯示有關積木的信息。單擊可編輯元素時，可能會顯示一個豐富的編輯器。

可編輯元素包括：Checkbox （複選框）Colour （顏色）Dropdown （下拉菜單）Number （數字）Text Input （文本輸入）不可編輯元素包括：Label（標籤）Label Serializable（標籤可序列化）Image（圖片）

1. Angle picker （角度選擇器）

角度元素存儲數字作為其值，並存儲字符串作為其文本。它的值是0到360之間的數字（可以更改此範圍），而其文本可以是輸入到其編輯器中的任何字符串。

<code>{
  "type": "example_angle",
  "message0": "angle: %1",
  "args0": [
    {
      "type": "field_angle",
      "name": "FIELDNAME",
      "angle": 90
    }
  ]
}
/<code>

Blockly.FieldAngle的重要屬性ROUND:角度使用某個數字進行四捨五入CLOCKWISE:角度增加的方向，true為順時針，false為逆時針OFFSET：0度開始位置，零度與正x軸（向右）對齊WRAP：值的範圍等於（ -360 + WRAP， WRAP）HALF：更改角度選擇器的大小，像素為單位定義圓的半徑

2. Checkbox （複選框）

複選框元素存儲一個字符串作為其值，以及一個字符串作為其文本。其值為"TRUE”或"FALSE"。

<code>{
  "type": "example_checkbox",
  "message0": "checkbox: %1",
  "args0": [
    {
      "type": "field_checkbox",
      "name": "FIELDNAME",
      "checked": true
    }
  ]
}
/<code>

Blockly.FieldCheckbox重要屬性CHECK_CHAR：更改選中標記的外觀

3. Colour picker （取色器）

顏色元素存儲一個字符串作為其值，並存儲一個字符串作為其文本。它的值為#rrggbb或#rgb的字符串。

<code>{
  "type": "example_colour",
  "message0": "colour: %1",
  "args0": [
    {
      "type": "field_colour",
      "name": "FIELDNAME",
      "colour": "#ff0000"
    }
  ]
}
/<code>

4. Date picker （日期選擇器）

日期元素存儲一個字符串作為其值，並存儲一個字符串作為其文本。其值和文本均具有YYYY-MM-DD格式。

<code>{
  "type": "example_date",
  "message0": "date: %1",
  "args0": [
    {
      "type": "field_date",
      "name": "FIELDNAME",
      "date": "2020-02-20"
    }
  ]
}
/<code>

5. Dropdown （下拉菜單）

下拉元素存儲一個字符串作為其值和一個字符串作為其文本。該值是與語言無關的鍵，將用於訪問文本，並且在語言之間切換Blockly時不會翻譯。下拉選項可以為文本、圖像、動態文本

<code>{
  "type": "example_dropdown",
  "message0": "drop down: %1",
  "args0": [
    {
      "type": "field_dropdown",
      "name": "FIELDNAME",
      "options": [
        [ "first item", "ITEM1" ],
        [ "second item", "ITEM2" ]
      ]
    }
  ]
}
/<code>

Blockly.FieldDropdown重要屬性ARROW_CHAR：箭頭圖標MAX_MENU_HEIGHT_VH:用於更改菜單的最大高度

6. Image （圖片）

圖像元素存儲一個字符串作為其值，並存儲一個字符串作為其文本。它的值是圖像的src，而其文本是描述/表示圖像的alt字符串。

<code>{
    "type": "example_image",
    "message0": "image: %1",
    "args0": [
        {
        "type": "field_image",
        "src": "https://www.gstatic.com/codesite/ph/images/star_on.gif",
        "width": 15,
        "height": 15,
        "alt": "*"
        }
]}
/<code>

7. Label （標籤）

標籤元素存儲字符串作為其值和字符串作為其文本。標籤元素的值和文本始終相同。

<code>{
  "type": "example_label",
  "message0": "a label %1 and another label",
  "args0": [
    {
      "type": "input_dummy"
    }
  ]
}
/<code>

8. Number （數字）

數字元素存儲數字作為其值，並存儲字符串作為其文本。它的值始終是有效的數字，該數字由創建時賦予該元素的約束定義；它的文本可以是輸入到其編輯器中的任何字符串。

<code>{
  "type": "example_number",
  "message0": "number: %1",
  "args0": [
    {
      "type": "field_number",
      "name": "FIELDNAME",
      "value": 100,
      "min": 0,
      "max": 100,
      "precision": 10
    }
  ]
}
/<code>

9. Text input （文本輸入）

文本輸入元素存儲字符串作為其值和字符串作為其文本。它的值始終是有效的字符串，而其文本可以是輸入到其編輯器中的任何字符串。

<code>{
  "type": "example_textinput",
  "message0": "text input: %1",
  "args0": [
    {
      "type": "field_input",
      "name": "FIELDNAME",
      "text": "default text",
      "spellcheck": false
    }
  ]
}
/<code>

10. Variables （變量）

變量元素存儲一個字符串作為其值，並存儲一個字符串作為其文本。值是變量的ID，而文本是變量的名稱。

<code>{
  "type": "example_variable_typed",
  "message0": "variable: %1",
  "args0": [
    {
      "type": "field_variable",
      "name": "FIELDNAME",
      "variable": "x",
      "variableTypes": ["Number", "String"],
      "defaultType": "Number"
    }
  ]
}
/<code>