In Swagger Editor, UI Docs pane display for header parameters is incorrect

[jmalin-splunk]

Q&A (please complete the following information)

• OS: [macOS Big Sur 11.6.2]
• Browser: [Chrome Version 97.0.4692.71]
• Version: [Online editor]
• Method of installation: [cloud-based]
• Swagger-UI version: [most current]
• Swagger/OpenAPI version: [OpenAPI 3.0]

Content & configuration

1. Open the Swagger online system.
2. Create a new copy of the PetStore example and edit it. Ensure that the Editor, Nav, and UI Docs are visible.
3. Edit the definition of GET /pet/findByStatus.
4. Add the following query parameter definition to the parameters section. This definition is supposed to describe an optional query parameter that, if used, expands into one or two query entries encoded on the URI:

        - name: userParam
          in: query
          description: Test multiple occurrence of parameter
          required: false
          explode: true
          schema:
            type: array
            items:
              type: string
              enum:
              - creator
              - lastUpdatedBy
            uniqueItems: true

If you set the query parameter status to available the following URIs are valid:

• https://petstore.swagger.io/v2/pet/findByStatus?status=available
• https://petstore.swagger.io/v2/pet/findByStatus?status=available&userParam=creator
• https://petstore.swagger.io/v2/pet/findByStatus?status=available&userParam=creator&userParam=lastUpdatedBy

The following URIs are not valid.

• https://petstore.swagger.io/v2/pet/findByStatus?status=available&userParam=
• https://petstore.swagger.io/v2/pet/findByStatus?status=available&userParam=&userParam=creator
• https://petstore.swagger.io/v2/pet/findByStatus?status=available&userParam=&userParam=creator&userParam=lastUpdatedBy

Swagger-UI configuration options:
N/A

Describe the bug you're encountering

To reproduce...

Steps to reproduce the behavior:

1. Open the Swagger online system.
2. Create a new copy of the PetStore example and edit it. Ensure that the Editor, Nav, and UI Docs panes are visible.
3. Edit the definition of GET /pet/findByStatus.
4. Add the query parameter specified in Content & Configuration to the parameters attribute of GET /pet/findByStatus
5. In the UI Docs pane, expand GET pet/findByStatus.
6. Look at the options available for userParam.
7. One of the available options is --.
8. Click Try it out.
9. Select status available and userParam --, then click Execute.
10. The cURL (bash) tab displays the following URI: https://petstore.swagger.io/v2/pet/findByStatus?status=available&userParam=. This is an invalid URI.

Expected behavior

Swagger Editor should not display the -- option in the list of options for userParam. There should be no way to create the URI https://petstore.swagger.io/v2/pet/findByStatus?status=available&userParam=.

Screenshots

Additional context or thoughts

[hkosova]

In other words:

Given an optional query/header/cookie parameter that is an array of enum
if this parameter has minItems >= 1
then "try it out" behavior should be as follows:

• If -- and only -- is selected, the parameter MUST NOT be included in the generated request.

OR

• The rendered list box MUST NOT contain the -- item. Without --, list box selection can still be cleared using standard OS methods, e.g. Ctrl + click on Windows.

Related (or duplicate?): #5176 (also array of enums, but with allowEmptyValue: value rather than minItems)
Possibly related: #7450.

The image refers to the 2nd suggestion:

OAS 2 example:

swagger: '2.0'
info:
  title: Test
  version: 1.0.0
host: httpbin.org
schemes: [https]
paths:
  /get:
    get:
      parameters:
        - name: userParam
          in: query
          type: array
          items:
            type: string
            enum:
            - creator
            - lastUpdatedBy
          minItems: 1
      responses:
        '200':
          description: ''

OAS 3 example:

openapi: 3.0.0
info:
  title: Test
  version: 1.0.0
servers:
  - url: https://httpbin.org
paths:
  /get:
    get:
      parameters:
        - name: userParam
          in: query
          schema:
            type: array
            items:
              type: string
              enum:
              - creator
              - lastUpdatedBy
            minItems: 1
      responses:
        '200':
          description: ''