如何移除Swagger UI中的「Send Empty Value」复选框?
移除Swagger UI中「Send Empty Value」复选框的方法
方法一:通过Swagger UI初始化配置禁用
如果是直接用Swagger UI的JS库搭建文档页面,初始化时添加showMutatedRequest: false配置项,就能隐藏包括「Send Empty Value」在内的所有请求修改类复选框:
const ui = SwaggerUIBundle({ url: "你的OpenAPI规范文件路径.json", dom_id: '#swagger-ui', showMutatedRequest: false, // 核心配置,隐藏请求修改相关选项 // 其他原有配置... });
方法二:用自定义CSS强制隐藏
要是没法修改Swagger UI的初始化配置,可以加一段自定义CSS来定位并隐藏这个复选框:
/* 隐藏Send Empty Value复选框,不同版本可能需要调整选择器 */ .swagger-ui .parameters-col_description label:nth-child(2) { display: none !important; } /* 或者更精准的选择器,根据实际页面DOM结构调整 */ .swagger-ui .checkbox.send-empty-value { display: none !important; }
注意:Swagger UI不同版本的DOM结构可能有区别,需要根据实际页面的元素结构微调CSS选择器。
方法三:针对特定参数,通过OpenAPI规范设置
如果只想要部分参数不显示这个复选框,可以在OpenAPI规范里给对应参数加上allowEmptyValue: false,这样该参数的「Send Empty Value」选项会自动消失:
paths: /你的接口路径: post: parameters: - name: 目标参数名 in: query schema: type: string allowEmptyValue: false # 设置后该参数不再显示Send Empty Value复选框
内容的提问来源于stack exchange,提问作者Kunal Badole
相关产品推荐
相关产品推荐

