edsnider / htmllabel

HTML Label for Xamarin.Forms

HTML Label for Xamarin.Forms apps

Easily render HTML in your Xamarin.Forms apps.

Note: This control is intended for basic text formatting (e.g., bold, italic, hyperlinks, etc.). It is not intended for rendering complex HTML or webpages - use the WebView for that.

Dependency

• Xamarin.Forms >= 3.0.0.446417

Supported platforms

HtmlLabel is supported on the following Xamarin.Forms platforms:

• iOS
• Android

Usage

You use HtmlLabel just like any other control on a Xamarin.Forms ContentPage.

The value of the Text property will be rendered as HTML using the platform's native text formatting approach.

XAML example

<ContentPage 
    ...  
    xmlns:controls="clr-namespace:XamForms.HtmlLabel;assembly=XamForms.HtmlLabel">

    <StackLayout VerticalOptions="CenterAndExpand" HorizontalOptions="Center" WidthRequest="250">
        
        <Entry Text="" Placeholder="Username" />
        <Entry Text="" Placeholder="Password" />
        <Button Text="Sign in" BackgroundColor="Purple" TextColor="White" />
        
        <controls:HtmlLabel Text="Upon sign in you agree to our &lt;a href='http://www.infernored.com'&gt;Terms of Service&lt;/a&gt; and &lt;a href='http://www.infernored.com'&gt;Privacy Policy&lt;/a&gt;." />

        <!-- Or, with data binding -->
        <controls:HtmlLabel Text="{Binding SignInAgreementText}" />

    </StackLayout>

</ContentPage>

When using this control in XAML it is recommended you use XAMLC.

C# example

var signInLinks = new HtmlLabel
{
    Text = @"Upon sign in you agree to our <a href=""http://www.infernored.com"">Terms of Service</a> and <a href=""http://www.infernored.com"">Privacy Policy</a>."
};

License

Licensed under MIT. See License file

htmllabel's Issues

Click/Tap event

Hi,

Is there any way to add tap gestures?
I need a way to know it was tapped.
I was trying to use the tap from the control behind it but it is blocking all tap events...
Thanks

use css with this?

Is it possible in it's current form to have a css file linked to it?

im using this in my app because i needed more control over each of the formatting for each page but still simple enough they can all use the same xaml page, so using this to allow html formatting in each of the text blocks from my database is the only solution i could think of but without a css file i may have created a whole lot more work just so a couple pages could have an extra flair.

It accepts multiline text?

I need use multiline text with breaklines. Thanks.

Hyperlinks

Can you explain how hyperlinks work from the ContentPage?

MAUI

Is there a plan to port this beauty to MAUI?