Skip to content

Commit f8e8757

Browse files
authored
Merge pull request #3915 from syncfusion-content/Added-liquid-glass-images
Added liquid glass images to UG
2 parents 1249226 + 01ce35e commit f8e8757

File tree

26 files changed

+123
-107
lines changed

26 files changed

+123
-107
lines changed
78.7 KB
Loading

MAUI/Autocomplete/LiquidGlassSupport.md

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,9 @@ control: SfAutocomplete
77
documentation: ug
88
---
99

10-
# Liquid glass support
10+
# Liquid Glass Support for .NET MAUI Autocomplete
1111

12-
The [SfAutocomplete](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.Inputs.SfAutocomplete.html) supports a liquid `glass` appearance by hosting the control inside the Syncfusion [SfGlassEffectsView](). You can customize the effect using properties such as [EffectType](), [EnableShadowEffect](), and round the corners using [CornerRadius](). This approach improves visual depth and readability when SfAutocomplete is placed over images or colorful layouts. Additionally, the dropdown portion of SfAutocomplete applies the glass effect only when the [EnableLiquidGlassEffect]() property is set to true.
12+
The [SfAutocomplete](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.Inputs.SfAutocomplete.html) supports a `liquid glass` appearance by hosting the control inside the Syncfusion [SfGlassEffectView](). You can customize the effect using properties such as [EffectType](), [EnableShadowEffect](), and round the corners using [CornerRadius](). This approach improves visual depth and readability when SfAutocomplete is placed over images or colorful layouts. Additionally, the dropdown portion of SfAutocomplete applies the glass effect only when the [EnableLiquidGlassEffect]() property is set to true.
1313

1414
## Availability
1515

@@ -19,12 +19,12 @@ The [SfAutocomplete](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.Inputs.
1919

2020
## Prerequisites
2121

22-
- Add the Syncfusion.Maui.Core package (for SfGlassEffectsView) and Syncfusion.Maui.Inputs (for SfAutocomplete).
22+
- Add the Syncfusion.Maui.Core package (for SfGlassEffectView) and Syncfusion.Maui.Inputs (for SfAutocomplete).
2323

24-
XAML example Wrap the SfAutocomplete in an SfGlassEffectsView, then enable the dropdown’s glass effect with `EnableLiquidGlassEffect`.
24+
XAML example Wrap the SfAutocomplete in an SfGlassEffectView, then enable the dropdown’s glass effect with `EnableLiquidGlassEffect`.
2525

2626
{% tabs %}
27-
{% highlight xaml hl_lines="49 52" %}
27+
{% highlight xaml hl_lines="19 22" %}
2828

2929
<?xml version="1.0" encoding="utf-8" ?>
3030
<ContentPage
@@ -37,29 +37,30 @@ XAML example Wrap the SfAutocomplete in an SfGlassEffectsView, then enable the d
3737
<Grid>
3838
<!-- Background to make acrylic blur visible -->
3939
<Image Source="wallpaper.jpg" Aspect="AspectFill" />
40-
<core:SfGlassEffectsView
40+
<core:SfGlassEffectView
4141
CornerRadius="20"
4242
HeightRequest="40"
4343
EffectType="Regular"
4444
EnableShadowEffect="True">
4545

4646
<inputs:SfAutocomplete
4747
EnableLiquidGlassEffect="True"
48+
Background="Transparent"
4849
ItemsSource="{Binding Employees}"
4950
DisplayMemberPath="Name"
5051
DropDownBackground="Transparent"
5152
Placeholder="Select employee"/>
52-
</core:SfGlassEffectsView>
53+
</core:SfGlassEffectView>
5354
</Grid>
5455
</ContentPage>
5556

5657
{% endhighlight %}
57-
{% highlight c# hl_lines="74 77" %}
58+
{% highlight c# hl_lines="14 17" %}
5859

5960
using Syncfusion.Maui.Core;
6061
using Syncfusion.Maui.Inputs;
6162

62-
var glassEffects = new SfGlassEffectsView
63+
var glassEffects = new SfGlassEffectView
6364
{
6465
CornerRadius=20,
6566
HeightRequest=40,
@@ -72,6 +73,7 @@ var Autocomplete = new SfAutocomplete
7273
EnableLiquidGlassEffect = true, // Dropdown glass effect
7374
ItemsSource = viewModel.Employees,
7475
DisplayMemberPath = "Name",
76+
Background=Colors.Transparent,
7577
DropDownBackground= Colors.Transparent,
7678
Placeholder = "Select employee",
7779
};
@@ -82,4 +84,6 @@ glassEffects.Content = Autocomplete;
8284
{% endtabs %}
8385

8486

85-
The following screenshot illustrates SfAutocomplete within an acrylic container, with the dropdown using the glass effect.
87+
The following screenshot illustrates SfAutocomplete within an acrylic container, with the dropdown using the glass effect.
88+
89+
![Autocomplete editor with liquid glass support](Images/UICustomization/Autocomplete_liquidglass.png)
72.3 KB
Loading

MAUI/Button/LiquidGlassSupport.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ control: SfButton
77
documentation: ug
88
---
99

10-
# Liquid glass support
10+
# Liquid Glass Support for .NET MAUI Buttons
1111

1212
The [SfButton](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.Buttons.SfButton.html) provides `liquid glass` effect that gives the button a frosted, translucent appearance blending with the content behind it. When the glass effect is enabled, the button also scales while it is pressed, delivering a subtle, responsive interaction cue. This enhances visual depth and interactivity, especially when the button is placed over images or colorful layouts.
1313

@@ -20,7 +20,7 @@ The [SfButton](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.Buttons.SfBut
2020
XAML example Enable the glass effect on `SfButton`. When pressed, the button will `scale` while the effect is enabled.
2121

2222
{% tabs %}
23-
{% highlight xaml hl_lines="49 52" %}
23+
{% highlight xaml hl_lines="16 17" %}
2424

2525
<?xml version="1.0" encoding="utf-8" ?>
2626
<ContentPage
@@ -38,6 +38,7 @@ XAML example Enable the glass effect on `SfButton`. When pressed, the button wil
3838
x:Name="GlassButton"
3939
Text="Continue"
4040
EnableLiquidGlassEffect="True"
41+
Background="Transparent"
4142
WidthRequest="180"
4243
CornerRadius="24"
4344
HeightRequest="48" />
@@ -46,7 +47,7 @@ XAML example Enable the glass effect on `SfButton`. When pressed, the button wil
4647
</ContentPage>
4748

4849
{% endhighlight %}
49-
{% highlight c# hl_lines="74 77" %}
50+
{% highlight c# hl_lines="7 9" %}
5051

5152
using Syncfusion.Maui.Buttons;
5253

@@ -56,10 +57,13 @@ var glassButton = new SfButton
5657
AutomationId = "Acrylic Button",
5758
EnableLiquidGlassEffect = true, // Enables glass look and press-time scaling
5859
WidthRequest = 180,
60+
Background=Colors.Transparent;
5961
HeightRequest = 48
6062
};
6163

6264
{% endhighlight %}
6365
{% endtabs %}
6466

65-
The following screenshot illustrates SfButton with the glass effect enabled and the pressed-state scaling behavior over a wallpaper background.
67+
The following screenshot illustrates SfButton with the glass effect enabled and the pressed-state scaling behavior over a wallpaper background.
68+
69+
![button with liquid glass support](Images/customization-images/Button_liquidglass.png)

MAUI/Chips/LiquidGlassSupport.md

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ documentation: ug
88
---
99

1010

11-
# Liquid glass support
11+
# Liquid Glass Support for .NET MAUI Chips
1212

1313
The [Chips](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.Core.SfChip.html) provides `liquid glass` effect that can be enabled directly on the control using the public API [EnableLiquidGlassEffect](). When enabled, each chip surface adopts a frosted, translucent appearance that blends with the content behind it, improving visual depth and readability over images or colorful layouts.
1414

@@ -19,7 +19,7 @@ The [Chips](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.Core.SfChip.html
1919
3. On platforms/versions below these requirements, the glass effect is not applied and the chips render with the standard background.
2020

2121
{% tabs %}
22-
{% highlight xaml hl_lines="49 52" %}
22+
{% highlight xaml hl_lines="17" %}
2323

2424
XAML example Enable the glass effect on SfChipGroup by setting EnableLiquidGlassEffect to True.
2525

@@ -41,19 +41,19 @@ XAML example Enable the glass effect on SfChipGroup by setting EnableLiquidGlass
4141
x:Name="FilterChips"
4242
EnableLiquidGlassEffect="True">
4343
<chip:SfChipGroup.Items>
44-
<chip:SfChip Text="Extra Small" Background="Blue"/>
45-
<chip:SfChip Text="Small" Background="Blue"/>
46-
<chip:SfChip Text="Medium" Background="Blue"/>
47-
<chip:SfChip Text="Large" Background="Blue"/>
48-
<chip:SfChip Text="Extra Large" Background="Blue"/>
44+
<chip:SfChip Text="Extra Small"/>
45+
<chip:SfChip Text="Small" />
46+
<chip:SfChip Text="Medium" />
47+
<chip:SfChip Text="Large"/>
48+
<chip:SfChip Text="Extra Large"/>
4949
</chip:SfChipGroup.Items>
5050
</core:SfChipGroup>
5151
</StackLayout>
5252
</Grid>
5353
</ContentPage>
5454

5555
{% endhighlight %}
56-
{% highlight c# hl_lines="74 77" %}
56+
{% highlight c# hl_lines="5" %}
5757

5858
using Syncfusion.Maui.Core;
5959

@@ -72,4 +72,6 @@ chipGroup.Items.Add(new SfChip(){Text="Extra Large", Background = Colors.Blue })
7272
{% endtabs %}
7373

7474

75-
The following screenshot illustrates SfChipGroup with the built-in glass effect enabled via EnableLiquidGlassEffect, displayed over a wallpaper background.
75+
The following screenshot illustrates SfChipGroup with the built-in glass effect enabled via EnableLiquidGlassEffect, displayed over a wallpaper background.
76+
77+
![chips with liquid glass support](images/customization-images/Chip_liquidglass.png)
55.7 KB
Loading
53.1 KB
Loading

MAUI/ComboBox/LiquidGlassSupport.md

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,9 @@ control: SfComboBox
77
documentation: ug
88
---
99

10-
# Liquid glass support
10+
# Liquid Glass Support for .NET MAUI ComboBox
1111

12-
The [SfComboBox](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.Inputs.SfComboBox.html) supports a `liquid glass` appearance by hosting the control inside the Syncfusion [SfGlassEffectsView](). You can customize the effect using properties such as [EffectType](), [EnableShadowEffect](), and round the corners using [CornerRadius](). This approach improves visual depth and readability when SfComboBox is placed over images or colorful layouts. Additionally, the dropdown portion of SfComboBox applies the glass effect only when the [EnableLiquidGlassEffect]() property is set to true.
12+
The [SfComboBox](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.Inputs.SfComboBox.html) supports a `liquid glass` appearance by hosting the control inside the Syncfusion [SfGlassEffectView](). You can customize the effect using properties such as [EffectType](), [EnableShadowEffect](), and round the corners using [CornerRadius](). This approach improves visual depth and readability when SfComboBox is placed over images or colorful layouts. Additionally, the dropdown portion of SfComboBox applies the glass effect only when the [EnableLiquidGlassEffect]() property is set to true.
1313

1414
## Availability
1515

@@ -19,12 +19,12 @@ The [SfComboBox](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.Inputs.SfCo
1919

2020
## Prerequisites
2121

22-
- Add the Syncfusion.Maui.Core package (for SfGlassEffectsView) and Syncfusion.Maui.Inputs (for SfComboBox).
22+
- Add the Syncfusion.Maui.Core package (for SfGlassEffectView) and Syncfusion.Maui.Inputs (for SfComboBox).
2323

24-
XAML example Wrap the SfComboBox in an SfGlassEffectsView, then enable the dropdown’s glass effect with `EnableLiquidGlassEffect`.
24+
XAML example Wrap the SfComboBox in an SfGlassEffectView, then enable the dropdown’s glass effect with `EnableLiquidGlassEffect`.
2525

2626
{% tabs %}
27-
{% highlight xaml hl_lines="49 52" %}
27+
{% highlight xaml hl_lines="19 20 23" %}
2828

2929
<?xml version="1.0" encoding="utf-8" ?>
3030
<ContentPage
@@ -37,29 +37,30 @@ XAML example Wrap the SfComboBox in an SfGlassEffectsView, then enable the dropd
3737
<Grid>
3838
<!-- Background to make acrylic blur visible -->
3939
<Image Source="wallpaper.jpg" Aspect="AspectFill" />
40-
<core:SfGlassEffectsView
40+
<core:SfGlassEffectView
4141
CornerRadius="20"
4242
HeightRequest="40"
4343
EffectType="Regular"
4444
EnableShadowEffect="True">
4545

4646
<inputs:SfComboBox
4747
EnableLiquidGlassEffect="True"
48+
Background="Transparent"
4849
ItemsSource="{Binding Employees}"
4950
DisplayMemberPath="Name"
5051
DropDownBackground="Transparent"
5152
Placeholder="Select employee"/>
52-
</core:SfGlassEffectsView>
53+
</core:SfGlassEffectView>
5354
</Grid>
5455
</ContentPage>
5556

5657
{% endhighlight %}
57-
{% highlight c# hl_lines="74 77" %}
58+
{% highlight c# hl_lines="14 17 18" %}
5859

5960
using Syncfusion.Maui.Core;
6061
using Syncfusion.Maui.Inputs;
6162

62-
var glassEffects = new SfGlassEffectsView
63+
var glassEffects = new SfGlassEffectView
6364
{
6465
CornerRadius=20,
6566
HeightRequest=40,
@@ -72,6 +73,7 @@ var Combobox = new SfComboBox
7273
EnableLiquidGlassEffect = true, // Dropdown glass effect
7374
ItemsSource = viewModel.Employees,
7475
DisplayMemberPath = "Name",
76+
Background = Colors.Transparent,
7577
DropDownBackground= Colors.Transparent,
7678
Placeholder = "Select employee",
7779
};
@@ -81,4 +83,6 @@ glassEffects.Content = Combobox;
8183
{% endhighlight %}
8284
{% endtabs %}
8385

84-
The following screenshot illustrates SfComboBox within an acrylic container, with the dropdown using the glass effect.
86+
The following screenshot illustrates SfComboBox within an acrylic container, with the dropdown using the glass effect.
87+
88+
![combo box editor with liquid glass support](Images/UICustomization/Combobox_liquidglass.png)

MAUI/DateTime-Range-Selector/LiquidGlassSupport.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ documentation: ug
88
---
99

1010

11-
# Liquid glass support:
11+
# Liquid Glass Support for .NET MAUI DateTime Range Selector
1212

1313
The [SfDateTimeRangeSelector](https://help.syncfusion.com/cr/maui/Syncfusion.Maui.Sliders.SfDateTimeRangeSelector.html) provides `liquid glass` effect for its thumbs when [EnableLiquidGlassEffect]() is enabled. The frosted, translucent effect is applied only while the user is pressing/dragging the thumb, creating a subtle, responsive visual that blends with the content behind it. This enhances visual feedback without altering the slider’s appearance at rest, and works well over images or colorful layouts.
1414

@@ -21,7 +21,7 @@ The [SfDateTimeRangeSelector](https://help.syncfusion.com/cr/maui/Syncfusion.Ma
2121
XAML example The thumb’s glass effect appears only while it is pressed/dragged.
2222

2323
{% tabs %}
24-
{% highlight xaml hl_lines="49 52" %}
24+
{% highlight xaml hl_lines="20" %}
2525

2626
<?xml version="1.0" encoding="utf-8" ?>
2727
<ContentPage
@@ -48,7 +48,7 @@ XAML example The thumb’s glass effect appears only while it is pressed/dragged
4848
</ContentPage>
4949

5050
{% endhighlight %}
51-
{% highlight c# hl_lines="74 77" %}
51+
{% highlight c# hl_lines="8" %}
5252

5353
using Syncfusion.Maui.Sliders;
5454

@@ -66,4 +66,6 @@ SfDateTimeRangeSelector rangeSelector = new SfDateTimeRangeSelector()
6666

6767
The following screenshot illustrates SfRangeSlider with the glass effect visible on the thumb while it is pressed.
6868

69+
![date time range selector with liquid glass support](images/getting-started/rangeslider_liquidglass.gif)
70+
6971
N> The glass effect is applied to the thumb only while it is pressed/dragged.
316 KB
Loading

0 commit comments

Comments
 (0)