OpenAPI查询参数描述未设置为文本框作为占位符

Question

我使用了描述来为查询参数添加详细信息，如

"parameters": [                 
                {
                    "name": "role",
                    "in": "query",
                    "required": true,
                    "schema": {
                        "type": "string"
                    },
                    "description": "This is test description to reproduce placeholder not fit to textbox"                       
                }]

当我将openapi.json加载到swagger时，它会显示描述以及文本框占位符。是否有任何方法为占位符添加单独的文本或修复占位符中的所有文本？这里的文字被剥夺了

​

​

Answer 1

如果参数具有example或default值(或OpenAPI 2.0中的x-example )，Swagger将使用此值作为占位符。

​

​

否则，正如您已经注意到的，占位符文本将与参数的description相同。

存在一个删除或改进默认占位符文本的现有功能请求：

https://github.com/swagger-api/swagger-ui/issues/3920