Microsoft.Common.TextBox felhasználói felületi elem

A TextBox felhasználói felület (UI) elem használható formázatlan szöveg hozzáadására. Az elem egy egysoros beviteli mező, de támogatja a többsoros bemenetet a multiLine tulajdonsággal.

Felhasználói felületi minta

Az TextBox elem egysoros vagy többsoros szövegdobozt használ.

Példa egysoros szövegdobozra.

Példa többsoros szövegdobozra.

Séma

{
  "name": "nameInstance",
  "type": "Microsoft.Common.TextBox",
  "label": "Name",
  "defaultValue": "contoso123",
  "toolTip": "Use only allowed characters",
  "placeholder": "",
  "multiLine": false,
  "constraints": {
    "required": true,
    "validations": [
      {
        "regex": "^[a-z0-9A-Z]{1,30}$",
        "message": "Only alphanumeric characters are allowed, and the value must be 1-30 characters long."
      },
      {
        "isValid": "[startsWith(steps('resourceConfig').nameInstance, 'contoso')]",
        "message": "Must start with 'contoso'."
      }
    ]
  },
  "visible": true
}

Példakimenet

"contoso123"

Megjegyzések

• toolTip A tulajdonság használatával megjelenítheti az elem szövegét, ha az egérmutató az információs szimbólum fölé van húzva.
• A placeholder tulajdonság olyan súgószöveg, amely eltűnik, amikor a felhasználó elkezdi a szerkesztést. Ha mindkettő placeholder defaultValue definiálva van, az defaultValue elsőbbséget élvez, és megjelenik.
• A multiLine tulajdonság logikai vagy true false. Többsoros szövegmező használatához állítsa a tulajdonságot a következőre true: . Ha nincs szükség többsoros szövegmezőre, állítsa a tulajdonságot a tulajdonságra false , vagy zárja ki azt. Új sorok esetén a JSON-kimenet a vonalcsatorna esetében jelenik meg \n . A többsoros szövegmező a kocsivisszaúthoz \r (CR) és \n a vonalcsatornához (LF) is használható. Az alapértelmezett érték például a kocsivissza és a sorcsatorna (CRLF) megadását is tartalmazhatja \r\n .
• Ha constraints.required be van állítva true, akkor a szövegmezőnek rendelkeznie kell egy sikeres ellenőrzéshez szükséges értékkel. Az alapértelmezett érték false.
• A validations tulajdonság egy tömb, ahol feltételeket adhat a szövegmezőben megadott érték ellenőrzéséhez.
• A regex tulajdonság egy JavaScript-reguláris kifejezésminta. Ha meg van adva, a szövegdoboz értékének meg kell egyeznie a mintával a sikeres ellenőrzéshez. Az alapértelmezett érték null. A regex szintaxissal kapcsolatos további információkért tekintse meg a Reguláris kifejezés rövid útmutatót.
• A isValid tulajdonság egy olyan kifejezést tartalmaz, amely kiértékeli a true következőt: vagy false. A kifejezésen belül megadhatja azt a feltételt, amely meghatározza, hogy a szövegdoboz érvényes-e.
• A message tulajdonság egy sztring, amely akkor jelenik meg, ha a szövegdoboz értéke nem érvényesíthető.
• Megadhatja, hogy mikor required van beállítva falseértékregex. Ebben az esetben a szövegmező sikeres érvényesítéséhez nincs szükség értékre. Ha van megadva, annak meg kell egyeznie a reguláris kifejezésmintával.

Példák

A példák bemutatják, hogyan használható egysoros és többsoros szövegdoboz.

Egysoros

Az alábbi példa egy szövegmezőt használ a Microsoft.Solutions.ArmApiControl vezérlővel az erőforrásnév rendelkezésre állásának ellenőrzéséhez.

Ebben a példában, amikor megad egy tárfióknevet, és kilép a szövegmezőből, a vezérlő ellenőrzi, hogy a név érvényes-e, és hogy elérhető-e. Ha a név érvénytelen vagy már létezik, hibaüzenet jelenik meg. A kimenetben megjelenik egy érvényes és elérhető tárfióknév.

{
  "$schema": "https://schema.management.azure.com/schemas/0.1.2-preview/CreateUIDefinition.MultiVm.json#",
  "handler": "Microsoft.Azure.CreateUIDef",
  "version": "0.1.2-preview",
  "parameters": {
    "basics": [
      {
        "name": "nameApi",
        "type": "Microsoft.Solutions.ArmApiControl",
        "request": {
          "method": "POST",
          "path": "[concat(subscription().id, '/providers/Microsoft.Storage/checkNameAvailability?api-version=2021-09-01')]",
          "body": {
            "name": "[basics('txtStorageName')]",
            "type": "Microsoft.Storage/storageAccounts"
          }
        }
      },
      {
        "name": "txtStorageName",
        "type": "Microsoft.Common.TextBox",
        "label": "Storage account name",
        "constraints": {
          "validations": [
            {
              "isValid": "[basics('nameApi').nameAvailable]",
              "message": "[basics('nameApi').message]"
            }
          ]
        }
      }
    ],
    "steps": [],
    "outputs": {
      "textBox": "[basics('txtStorageName')]"
    }
  }
}

Többsoros

Ez a példa a multiLine tulajdonság használatával hoz létre egy többsoros szövegdobozt helyőrző szöveggel.

{
  "$schema": "https://schema.management.azure.com/schemas/0.1.2-preview/CreateUIDefinition.MultiVm.json#",
  "handler": "Microsoft.Azure.CreateUIDef",
  "version": "0.1.2-preview",
  "parameters": {
    "basics": [
      {
        "name": "demoTextBox",
        "type": "Microsoft.Common.TextBox",
        "label": "Multi-line text box",
        "defaultValue": "",
        "toolTip": "Use 1-60 alphanumeric characters, hyphens, spaces, periods, and colons.",
        "placeholder": "This is a multi-line text box:\nLine 1.\nLine 2.\nLine 3.",
        "multiLine": true,
        "constraints": {
          "required": true,
          "validations": [
            {
              "regex": "^[a-z0-9A-Z -.:\n]{1,60}$",
              "message": "Only 1-60 alphanumeric characters, hyphens, spaces, periods, and colons are allowed."
            }
          ]
        },
        "visible": true
      }
    ],
    "steps": [],
    "outputs": {
      "textBox": "[basics('demoTextBox')]"
    }
  }
}

Következő lépések

• A felhasználói felületi definíciók létrehozásának bemutatása: CreateUiDefinition.json az Azure által felügyelt alkalmazás létrehozási felületéhez.
• A felhasználói felület elemeinek gyakori tulajdonságairól a CreateUiDefinition elemek című témakörben olvashat.
• A függvényekről további információt a CreateUiDefinition függvények című témakörben talál.