表单视图中支持的元素

本文是模板规格门户表单所使用的 表单 视图(uiFormDefinition.json)的元素支持列表。 Azure 托管应用程序时,使用 createUiDefinition.json 元素

表单视图重复使用与 CreateUiDefinition 相同的基线元素契约:诸如 、 nametypelabeldefaultValuetoolTipconstraintsoptions属性visible含义相同,除非表单视图特定文章另有说明。 为避免重复共享模式, 参考 列链接到当前的 CreateUiDefinition 元素页面,这些控件在两种格式下表现相同。 可用性由本页的支持列表决定,而非链接文章的实体文件夹。

支持的元素

以下列出的元素类型在表单视图中得到支持。

元素 Purpose 参考文献
Microsoft.Common.CheckBox 布尔复选框。 Microsoft。Common.CheckBox
Microsoft.Common.DropDown 单选或多选下拉菜单。 Microsoft。通用。下拉菜单
Microsoft.Common.EditableGrid 可编辑行和列。 输出一个数组。 Microsoft。Common.EditableGrid
Microsoft.Common.FileUpload 上传本地文件(文本内容或blob URL)。 Microsoft。Common.FileUpload
Microsoft.Common.Grid 只读表格显示,带有添加和编辑刀片。 Microsoft。Common.Grid
Microsoft.Common.InfoBox 内联信息、警告或错误横幅。 Microsoft。Common.InfoBox
Microsoft.Common.LocationSelector 独立的区域选择器。 Microsoft。Common.LocationSelector
Microsoft.Common.ManagementGroupSelector 独立的管理组选择器。 Microsoft。通用。管理组选择器
Microsoft.Common.OptionsGroup Pivot风格的电台团体。 Microsoft。Common.OptionsGroup
Microsoft.Common.PasswordBox 蒙面输入,可选确认字段。 Microsoft。Common.PasswordBox
Microsoft.Common.ResourceGroupSelector 独立的资源组选择器(现有或新建)。 Microsoft。Common.ResourceGroupSelector
Microsoft.Common.ResourceScope 部署范围的复合订阅、资源组和位置选择器。 Microsoft。Common.ResourceScope(资源范围)
Microsoft.Common.Section 儿童控制类别下的组别。 不稳定。 Microsoft。通用。部分
Microsoft.Common.ServicePrincipalSelector 选择一个 Microsoft Entra 服务主体。 Microsoft。通用服务首席选择器
Microsoft.Common.Slider 数字滑块覆盖范围。 Microsoft。Common.滑块
Microsoft.Common.SubscriptionSelector 独立订阅选择器。 Microsoft。Common.SubscriptionSelector
Microsoft.Common.TagsByResource 标准标签控制。 Microsoft。Common.标签按资源
Microsoft.Common.TenantSelector 当前租户的只读显示。 Microsoft。通用。租户选择器
Microsoft.Common.TextBlock 静态描述文本。 Microsoft。通用.文本块
Microsoft.Common.TextBox 单行或多行文本输入。 Microsoft。通用.TextBox
Microsoft.Compute.CredentialsCombo 用户名+(密码或SSH密钥)用于虚拟机创建。 需要判 osPlatform 别器("Linux""Windows");见下方注释。 Microsoft。Compute.CredentialsCombo
Microsoft.Compute.SizeSelector VM SKU 拣选器。 Microsoft。Compute.SizeSelector
Microsoft.Compute.UserNameTextBox 用户名文本框,带有Azure虚拟机用户名验证。 Microsoft。Compute.UserNameTextBox
Microsoft.KeyVault.KeyVaultCertificateSelector 从密钥保管库选取一张证书。 Microsoft。KeyVault.KeyVaultCertificateSelector
Microsoft.ManagedIdentity.IdentitySelector 系统和用户分配的托管身份。 Microsoft。ManagedIdentity.IdentitySelector
Microsoft.Network.PublicIpAddressCombo 现有或新建的公共IP。 Microsoft。网络.PublicIp地址组合
Microsoft.Network.VirtualNetworkCombo 现有或新建的虚拟网络和子网。 Microsoft。网络。虚拟网络Combo
Microsoft.Solutions.ArmApiControl 发起 Azure 资源管理器 调用,并将响应绑定到表单状态(无界面)。 Microsoft。解决方案.ArmApiControl
Microsoft.Solutions.BladeInvokeControl 打开一个 Azure 门户刀片,把返回的数据绑定到表单状态(无界面)。 Microsoft。解决方案.刀刃呼叫控制
Microsoft.Solutions.ResourceSelector 资源图支持的ARM资源选择器。 Microsoft。Solutions.ResourceSelector
Microsoft.Storage.MultiStorageAccountCombo 多个存储账户,并选择复制。 Microsoft。Storage.MultiStorageAccountCombo
Microsoft.Storage.StorageAccountSelector 现有或新建存储账户。 Microsoft。Storage.StorageAccountSelector
Microsoft.Storage.StorageBlobSelector 在存储账户里选一个blob。 Microsoft。Storage.StorageBlobSelector

与 CreateUiDefinition 元素的区别

这两种形式有重叠,但不能互换:

  • 表单视图有自己的支持列表。 不要仅仅因为某个元素出现在 CreateUiDefinition 引用中就认为它在 uiFormDefinition.json 中有效,或者仅仅因为出现在本页上就认为它在 createUiDefinition.json 中有效。

  • 表单视图中没有 basics() 函数。 表单视图没有隐含的基础步骤;订阅、资源组和位置选择器是明确的元素(Microsoft.Common.SubscriptionSelectorMicrosoft.Common.ResourceGroupSelectorMicrosoft.Common.LocationSelector),放置在你选择的步骤中,它们的输出通过类似其他控制点被引用 steps(...)

  • 表单视图具有显式的范围选择器元素。Microsoft.Common.ResourceScopeMicrosoft.Common.SubscriptionSelectorMicrosoft.Common.ResourceGroupSelectorMicrosoft.Common.LocationSelectorMicrosoft.Common.ManagementGroupSelector, 均 Microsoft.Common.TenantSelector 为表单视图而有文档。 在 CreateUiDefinition 中,订阅、资源组和位置则通过隐式的 Basics 步骤提供。

  • Microsoft.Compute.CredentialsCombo 需要一个 osPlatform 鉴别器。type始终为字符串"Microsoft.Compute.CredentialsCombo";Linux 与 Windows 的变体通过元素上的设置"osPlatform": "Linux""osPlatform": "Windows"选择。 这两个变体 的模式并不 完全相同:

    • Linux 版本必须包含 label.authenticationTypelabel.passwordlabel.confirmPasswordlabel.sshPublicKey,并支持 SSH 密钥认证模式和标志 options.hidePassword
    • Windows 版本仅要求 label.passwordlabel.confirmPassword;它不接受与 SSH 相关的 labeltoolTipoptions 字段。

    内部 Microsoft.Compute.CredentialsCombo-Linux 模式定义名为 和 Microsoft.Compute.CredentialsCombo-Windows 是用于强制这些平台形状的 JSON 模式定义名称——它们不是你输入 type的值。

后续步骤