שדות להזנת טקסט

בשדה להזנת טקסט נשמרים מחרוזת כערך שלה ומחרוזת כטקסט. שלו הוא תמיד מחרוזת חוקית, בעוד שהטקסט יכול להיות כל מחרוזת שהוזנה העורך שלו.

שדה להזנת טקסט

שדה להזנת טקסט כשהעורך פתוח

שדה להזנת טקסט בבלוק מכווץ

יצירה

JSON

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

JavaScript

Blockly.Blocks['example_textinput'] = {
  init: function() {
    this.appendDummyInput()
        .appendField("text input:")
        .appendField(new Blockly.FieldTextInput('default text'),
            'FIELDNAME');
  }
};

ה-constructor של קלט הטקסט מקבל ערך אופציונלי, כלי התיקוף. הערך צריך להמיר String. אם הערך הוא null או undefined, המערכת תשתמש במחרוזת ריקה.

ההגדרה של JSON מאפשרת גם להגדיר את האפשרות spellcheck.

הצגה בהמשכים ו-XML

JSON

ה-JSON של שדה להזנת טקסט נראה כך:

{
  "fields": {
    "FIELDNAME": "text"
  }
}

כאשר FIELDNAME הוא מחרוזת שמפנה לשדה להזנת קלט טקסט, הערך הוא הערך שיש להחיל על השדה. הערך תואם לאותם כללים כמו ערך ה-constructor.

XML

ה-XML של שדה להזנת טקסט נראה כך:

<field name="FIELDNAME">text</field>

כאשר המאפיין name של השדה מכיל מחרוזת שמפנה לקלט טקסט. בשדה, והטקסט הפנימי הוא הערך שצריך להחיל על השדה. התוכן הפנימי טקסט תואם לאותם כללים כמו ערך ה-constructor.

התאמה אישית

בדיקת איות

setSpellcheck אפשר להשתמש בפונקציה כדי להגדיר אם השדה בודק את האיות של טקסט הקלט שלו או לא.

שדות להזנת טקסט עם ובלי בדיקת איות

בדיקת האיות מופעלת כברירת מחדל.

הכלל הזה חל על שדות בודדים. אם רוצים לשנות את כל השדות, צריך לשנות את נכס Blockly.FieldTextInput.prototype.spellcheck_.

יצירת כלי לאימות קלט טקסט

הערה: מידע כללי על מאמתים זמין במאמר תיקוף.

הערך של שדה להזנת קלט טקסט הוא מחרוזת, כך שכל כלי האימות חייב לקבל מחרוזת ומחזירה את המחרוזת null או undefined.

הנה דוגמה לכלי אימות שמסיר את כל האות a תווים מתוך string:

function(newValue) {
  return newValue.replace(/a/g, '');
}