Use this Xamarin.Forms plugin to display HTML content into a label.
- Available on NuGet
- Install it in every Xamarin.Forms project.
- iOS: AppDelegate.cs
HtmlLabelRenderer.Initialize(); global::Xamarin.Forms.Forms.Init();
- Android: MainActivity.cs
HtmlLabelRenderer.Initialize(); global::Xamarin.Forms.Forms.Init(this, bundle);
- UWP: App.xaml.cs
var rendererAssemblies = new[] { typeof(HtmlLabelRenderer).GetTypeInfo().Assembly }; Xamarin.Forms.Forms.Init(e, rendererAssemblies); HtmlLabelRenderer.Initialize();
On iOS and Android it uses the native HTML rendering capabilities of iOS's UILabel and Android's TextView.
UWP's TextBlock cannot renders HTML so the library parses the HTML and uses Inlines to display: <a>, <b>, <br>, <em>, <i>, <p>, <strong>, <u>, <ul> <li>, <div>.
FontAttributes, FontFamily, FontSize, TextColor, HorizontalTextAlignment are converted into inline CSS in a wrapping <div> for iOS and Android. UWP supports them natively.
If you need to customize something in Android or iOS you can use inline CSS, for example:
<span style="color: green">...</span>
For underlined text use the <u> tag:
<u>Some underlined text</u>
For links: remember to add the schema (http:// https:// tel:// mailto:// ext...)
WARNING: not all styles are supported by each platform!
- Text
- FontAttributes
- FontFamily
- FontSize
- TextColor
- HorizontalTextAlignment
- LineHeight (iOS, UWP)
- UnderlineText
- LinkColor
- BrowserLaunchOptions
- AndroidLegacyMode
Navigating Navigated
xmlns:htmlLabel="clr-namespace:LabelHtml.Forms.Plugin.Abstractions;assembly=HtmlLabel.Forms.Plugin"
<htmlLabel:HtmlLabel Text="{Binding HtmlString}"/>var label = new HtmlLabel();
label.Text = "..htmlstring.."It is possible to customize links:
- Color
- Underline
- Browser options
Browser options are applied with the following schemas: http, https, mailto, tel, sms and geo.
WARNING: This project uses Xamarin.Essentials to provide native Email, Phone Dial, SMS and Maps support. Please check the getting started page.
iOS WARNING: Changing the style of iOS links is not supported by iOS intentionally and this plugin use a workaround. From Apple:
To promote consistency, the intended behavior is for ranges that represent links (specified via NSLinkAttributeName) to be drawn using the default link appearance.
UWP WARNING: The minimum target for UWP is 17763. If set to an older version, it won't find the assembly.
Settings the property AndroidLegacyMode to True the renderer separates block-level elements with blank lines.
- XF Label's TextType="HTML" disables this implementation.
- Adding GestureRecognizers will disabled links.
- List of Android's supported tags here.
Contributions are welcome!
Under MIT, see LICENSE file.