Repository navigation
Documentation in places like hovers does not render HTML tags like b, i, blockquote #3782
Description
Describe the bug
The content between blockquote tags isn't shown in the hover documentation.
image screenshot taken from: analyzer-3.1.0/lib/dart/element/element.dart
Steps To Reproduce
Sample documentation shown in the photo above that can be used for reproduction:
/// Return the element representing the setter that results from looking up
/// the given [setterName] in this class with respect to the given [library],
/// or `null` if the look up fails. The behavior of this method is defined by
/// the Dart Language Specification in section 16.15.2:
/// <blockquote>
/// The result of looking up getter (respectively setter) <i>m</i> in class
/// <i>C</i> with respect to library <i>L</i> is: If <i>C</i> declares an
/// instance getter (respectively setter) named <i>m</i> that is accessible to
/// <i>L</i>, then that getter (respectively setter) is the result of the
/// lookup. Otherwise, if <i>C</i> has a superclass <i>S</i>, then the result
/// of the lookup is the result of looking up getter (respectively setter)
/// <i>m</i> in <i>S</i> with respect to <i>L</i>. Otherwise, we say that the
/// lookup has failed.
/// </blockquote>
PropertyAccessorElement? lookUpSetter(
String setterName, LibraryElement library);
// source: https://github.com/dart-lang/sdk/blob/main/pkg/analyzer/lib/dart/element/element.dart#L343Expected behavior
The complete documentation should be shown.
Versions:
- VS Code version:
1.63.2 - Dart extension version:
3.32.0 - Dart/Flutter SDK version:
Flutter 2.8.1 • channel stable • https://github.com/flutter/flutter.git
Framework • revision 77d935af4d (4 weeks ago) • 2021-12-16 08:37:33 -0800
Engine • revision 890a5fca2e
Tools • Dart 2.15.1
Activity
osaxma commentedon Jan 15, 2022
It looks like html tags are not rendered in general such as
<b>and<i>but their content is still shown.DanTup commentedon Jan 17, 2022
I think we need LSP support for this. There's an issue at microsoft/language-server-protocol#1344 suggesting we have it from the next LSP version, although I'm not certain how it works (I've asked for clarification).
[-]The hover Documentation isn't showing the complete documentation when there's `blockquote` [/-][+]Documentation in places like hovers does not render HTML tags like `b`, `i`, `blockquote` [/+]Support HTML in DartDocs