HighlightLabel.Maui

KO | EN

gitlite — search

#gpt #sql #deep-learning #monitoring #chatgpt #hacktoberfest #animation #web #agents #tailwindcss

HighlightLabel.Maui

(★ 9)

파일 탐색기

ZIP 다운로드

- funding.yml
- sample.jpeg
- - App.xaml
  - App.xaml.cs
  - AppShell.xaml
  - AppShell.xaml.cs
  - GlobalXmlns.cs
  - MainPage.xaml
  - MainPage.xaml.cs
  - MauiProgram.cs
  - Sample.HighlightLabel.Maui.csproj
- - HighlightLabel.Maui.csproj
.gitattributes
.gitignore
HighlightLabel.Maui.sln
LICENSE.txt
README.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# HighlightLabel.Maui 🚀

Is a powerful, lightweight, and high-performance .NET MAUI control designed to automatically highlight specific text matches within a string. Perfect for search autocomplete lists, filter systems, and real-time query suggestions. Features seamless data binding, case-insensitive evaluation via optimized Regex tokenization, custom highlight coloration, bold emphasis triggers, and cross-platform layout rendering without UI thread blocking or performance degradation in large text and large CollectionViews.

[![NuGet version](https://img.shields.io/nuget/v/HighlightLabel.Maui.svg)](https://www.nuget.org/packages/HighlightLabel.Maui)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

---

## Preview

![HighlightLabel.Maui Preview](https://raw.githubusercontent.com/jvicius/HighlightLabel.Maui/master/assets/sample.jpeg)

---

## Features ✨

* **Dynamic Text Highlighting** — Automatically search, tokenize, and highlight matching text sequences within any raw string input in real time.
* **Case-Insensitive Matching** — Robust, case-insensitive query processing ensures accurate visual feedback regardless of user typing style.
* **Custom Highlight Styling** — Full native support to define custom highlight colors for matched tokens.
* **Safe-Fail Tokenization** — Built-in Regex evaluation guardrails that sanitize text inputs and prevent application crashes caused by unexpected special characters or API string changes.
* **Native Property Inheritance** — Seamlessly inherits and respects standard .NET MAUI Label properties including custom FontFamilies, FontSize, and default TextColors for unmatched segments.

---

## Installation 📦

Add the NuGet package to your .NET MAUI project:

```bash
dotnet add package HighlightLabel.Maui
```

---

## Quick Start 🚀

### 1. Add the control to your XAML

```xml
<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="Sample.HighlightLabel.Maui.MainPage"
             xmlns:viewModels="clr-namespace:Sample.HighlightLabel.Maui.ViewModels"
             xmlns:highlightLabel="clr-namespace:HighlightLabel.Maui.Controls;assembly=HighlightLabel.Maui"
             xmlns:toolkit="http://schemas.microsoft.com/dotnet/2022/maui/toolkit"
             xmlns:local="clr-namespace:Sample.HighlightLabel.Maui.Models">

<ContentPage.BindingContext>
        <viewModels:MainPageViewmodel/>
    </ContentPage.BindingContext>

<SearchBar.TextColor>

<On Platform="Android">Black</On>

</OnPlatform>

</SearchBar.TextColor>

<SearchBar.PlaceholderColor>

<On Platform="Android">Black</On>

</OnPlatform>

</SearchBar.PlaceholderColor>

<SearchBar.Behaviors>

<toolkit:EventToCommandBehavior 
                        EventName="TextChanged" 
                        BindingContext="{Binding Path=BindingContext, Source={x:Reference SearchBarText}, x:DataType=SearchBar}"
                        Command="{Binding SearchCommand}"/>

</SearchBar.Behaviors>

</SearchBar>

</Grid>
        
    </ScrollView>

</ContentPage>

```

---

## 2. Setup your code behind or viewmodel 🛠️

Setup for MainPageViewmodel example:

```csharp
using System.Collections.ObjectModel;
using System.ComponentModel;
using System.Runtime.CompilerServices;
using System.Windows.Input;

namespace Sample.HighlightLabel.Maui.ViewModels
{

public class AddressItem
    {
        public string FullAddress { get; set; }
    }

public class MainPageViewmodel : INotifyPropertyChanged
    {
        public event PropertyChangedEventHandler? PropertyChanged;
        protected virtual void OnPropertyChanged([CallerMemberName] string propertyName = null)
        {
            PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));
        }

private string _SearchText = string.Empty;
        public string SearchText
        {
            get { return _SearchText; }
            set
            {
                if (_SearchText != value)
                {
                    _SearchText = value;
                    OnPropertyChanged();
                }
            }
        }

private ObservableCollection<AddressItem> _Addresses = new ObservableCollection<AddressItem>();
        public ObservableCollection<AddressItem> Addresses
        {
            get { return _Addresses; }
            set
            {
                if (_Addresses != value)
                {
                    _Addresses = value;
                    OnPropertyChanged();
                }
            }
        }

public ICommand? SearchCommand { get; set; }

public MainPageViewmodel()
        {
            SearchCommand = new Command(
            execute: async () =>
            {
                await OnSearchCommand();
            });
            LoadData();
        }

private async Task OnSearchCommand()
        {       
            try
            {

if (string.IsNullOrEmpty(SearchText))
                {
                    return;
                }

SearchText = SearchText.ToLower();

}
            catch (Exception e)
            {
                Console.WriteLine(e);
                throw;
            }

}

private void LoadData()
        {
            Addresses = new ObservableCollection<AddressItem>
            {
                new AddressItem { FullAddress = "742 Evergreen Terrace, Springfield, Sector 7G" },
                new AddressItem { FullAddress = "1600 Amphitheatre Parkway, Mountain View, California" },
                new AddressItem { FullAddress = "Main Street Convention Center, Suite 404, Austin" },
                new AddressItem { FullAddress = "Avenue of the Americas, Financial District, New York" },
                new AddressItem { FullAddress = "Sunset Boulevard 1020, Hollywood, Los Angeles" },
                new AddressItem { FullAddress = "Baker Street 221B, Marylebone, London Terminal" },
                new AddressItem { FullAddress = "Pacific Coast Highway, Malibu Beach Overlook, California" },
                new AddressItem { FullAddress = "Broadway Avenue Theater District, New York City" },
                new AddressItem { FullAddress = "Industrial Park Road, Tech Innovation Hub, Seattle" },
                new AddressItem { FullAddress = "Convention Road Intersection, Commercial Zone, Chicago" }
            };
        }
    }
}

```

---

## Contributing 🤝

Contributions, issues, and feature requests are welcome! Feel free to check the [issues page](https://github.com/jvicius/HighlightLabel.Maui/issues) or open a pull request.

## Support the Project ☕

If this package saved you development time or helped ship a production app, consider supporting the project!

HighlightLabel.Maui

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README