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

Egy legördülő listával rendelkező kijelölésvezérlő. Csak egy vagy több elem kijelölését engedélyezheti. Igény szerint leírást is megadhat az elemekhez.

Felhasználói felületi minta

Az DropDown elem különböző lehetőségekkel rendelkezik, amelyek meghatározzák annak megjelenését a portálon.

Ha csak egyetlen elem választható ki, a vezérlő a következő módon jelenik meg:

Ha leírásokat tartalmaz, a vezérlő a következő módon jelenik meg:

Ha a többszörös kijelölés engedélyezve van, a vezérlőelem hozzáad egy Select all (Minden kijelölése) lehetőséget, és bejelöli a több elem kijelöléséhez szükséges jelölőnégyzeteket:

A leírások belefoglalhatók a multi-select enabled funkcióba.

Ha a szűrés engedélyezve van, a vezérlő tartalmaz egy szövegdobozt a szűrési érték hozzáadásához.

Séma

{
  "name": "element1",
  "type": "Microsoft.Common.DropDown",
  "label": "Example drop down",
  "placeholder": "",
  "defaultValue": ["Value two"],
  "toolTip": "",
  "multiselect": true,
  "selectAll": true,
  "filter": true,
  "filterPlaceholder": "Filter items ...",
  "multiLine": true,
  "defaultDescription": "A value for selection",
  "constraints": {
    "allowedValues": [
      {
        "label": "Value one",
        "description": "The value to select for option 1.",
        "value": "one"
      },
      {
        "label": "Value two",
        "description": "The value to select for option 2.",
        "value": "two"
      }
    ],
    "required": true
  },
  "visible": true
}

Példakimenet

"two"

Megjegyzések

• Annak megadására használható multiselect , hogy a felhasználók több elemet is kijelölhetnek-e.
• Alapértelmezés szerint ez aztrue, selectAll amikor a többszörös kijelölés engedélyezve van.
• A filter tulajdonság lehetővé teszi a felhasználók számára a keresést a lehetőségek hosszú listájában.
• Az elem felirata constraints.allowedValues egy elem megjelenítendő szövege, értéke pedig az elem kimeneti értéke, ha ki van jelölve.
• Ha meg van adva, az alapértelmezett értéknek egy címkének kell lennie.constraints.allowedValues Ha nincs megadva, a rendszer constraints.allowedValues kijelöli az első elemet. Az alapértelmezett érték null.
• constraints.allowedValues legalább egy elemet tartalmaznia kell.
• Ha nem szükséges értéket emulálni, adjon hozzá egy címkét és egy (üres sztring) értéket "" tartalmazó elemet.constraints.allowedValues
• A defaultDescription tulajdonság olyan elemekhez használatos, amelyek nem rendelkeznek leírással.
• 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.

Példa

Az alábbi példában a defaultValue címkék helyett a allowedValues értékek alapján van definiálva. Az alapértelmezett érték több értéket is tartalmazhat, ha multiselect engedélyezve van.

{
  "name": "element1",
  "type": "Microsoft.Common.DropDown",
  "label": "Example drop down",
  "placeholder": "",
  "defaultValue": [{"value": "one"}, {"value": "two"}],
  "toolTip": "Multiple values can be selected",
  "multiselect": true,
  "selectAll": true,
  "filter": true,
  "filterPlaceholder": "Filter items ...",
  "multiLine": true,
  "defaultDescription": "A value for selection",
  "constraints": {
    "allowedValues": [
      {
        "label": "Value one",
        "description": "The value to select for option 1.",
        "value": "one"
      },
      {
        "label": "Value two",
        "description": "The value to select for option 2.",
        "value": "two"
      }
    ],
    "required": true
  },
  "visible": true
}

Következő lépések

• A felhasználói felületi definíciók létrehozásának bemutatása: A CreateUiDefinition használatának első lépései.
• A felhasználói felület elemeinek gyakori tulajdonságairól a CreateUiDefinition elemek című témakörben olvashat.