Nascondi intestazione Swagger (Swashbuckle)

Question

Uso Swashbuckle per aggiungere la documentazione di Swagger al progetto API Web ASP.NET. Come posso nascondere l'intestazione predefinita (con logo swagger) dalla pagina di documentazione senza iniettare CSS?

Answer 1

Purtroppo penso che tu possa farlo olny da javascript adesso.

Nei tuoi SwaggerConfig.cs si può iniettare un file .js come questo:

.EnableSwaggerUi(c => 
{       
    c.InjectJavaScript(thisAssembly, "yournamespace.yourscript.js"); 
}); 

Quindi, in questo script è possibile fare quello che vuoi, come nascondere l'intestazione:

document.querySelector("#header").style.display = "none"; 

Questo post mostra come personalizzare l'intestazione inserendo due caselle di testo.

Answer 2

Quando ho iniettato JS come suggerito sopra, l'intestazione lampeggiava al caricamento della pagina. È stato mostrato per un secondo e poi è stato disabilitato per script. C'è un approccio che funziona meglio per me. https://github.com/domaindrivendev/Swashbuckle/issues/476

È possibile iniettare CSS invece di JS:

#header { 
display:none; 
} 

Answer 3

Quando ho incontrato questo ho iniziato a iniettare css/js ma ogni volta è stata una lotta e sorta di "hacker" per nascondere cose con iniettato css. Quindi dopo un po 'ho semplicemente sostituito il file indice con una versione modificata di questo index.html Puoi modificarlo come preferisci. Rimuovendo il div con id = header si rimuoverà l'intestazione. Anche questo rende molto più semplici cose come la sostituzione del logo ecc. Per la parte relativa al logo è possibile impostare il logo src su en 64-bit encode come mostrato qui encode image. Anche rimuovere la favicon collegata nella scheda è semplice come rimuovere la linea. Anche l'aggiunta di link ad altre pagine è banale. Iniettando l'indice in voi swaggerconfig come questo

c.CustomAsset("index", thisAssembly, "Path.To.index.html"); 

Ricordate di impostare l'indice di risorsa incorporata.