Skip to content

Commit 7ce6d5a

Browse files
Merge pull request #6911 from syncfusion-content/BLAZ-983104-predefineddialog
Updated the UG Documentation for Predefined-dialogs
2 parents f0c9077 + d826d30 commit 7ce6d5a

File tree

7 files changed

+97
-97
lines changed

7 files changed

+97
-97
lines changed

blazor/predefined-dialogs/animation.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,9 +9,9 @@ documentation: ug
99

1010
# Animation in Predefined Dialogs in Blazor
1111

12-
The predefined dialogs can be animated during the open and close actions. You can customize the `Delay`, `Duration`, and `Effect` of animation by using the [DialogOptions.AnimationSettings](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_AnimationSettings) property.
12+
The predefined dialogs (Alert, Confirm, and Prompt) support animation on open and close. Customize the animation `Delay` (ms), `Duration` (ms), and `Effect` using the [DialogOptions.AnimationSettings](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_AnimationSettings) property of type [DialogAnimationSettings](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogAnimationSettings.html). The `Effect` accepts values from the [DialogEffect](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogEffect.html) enumeration. If not specified, the dialog uses its default animation settings.
1313

14-
In the following sample, the zoom effect is enabled. So, the dialog will open with the zoom in and close with the zoom out effect.
14+
In the following sample, the zoom effect (`DialogEffect.Zoom`) is used. The dialog opens with a zoom-in animation and closes with a zoom-out animation.
1515

1616
{% tabs %}
1717

@@ -27,4 +27,4 @@ In the following sample, the zoom effect is enabled. So, the dialog will open wi
2727
{% include_relative code-snippet/prompt-animation.razor %}
2828
{% endhighlight %}
2929

30-
{% endtabs %}
30+
{% endtabs %}

blazor/predefined-dialogs/customization.md

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -11,17 +11,17 @@ documentation: ug
1111

1212
## Customize action buttons
1313

14-
You can customize the predefined dialogs buttons by using below properties.
15-
* [DialogOptions.PrimaryButtonOptions](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_PrimaryButtonOptions) - Use this property to customize **OK** button text and appearence.
16-
* [DialogOptions.CancelButtonOptions](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_CancelButtonOptions) - Use this property to customize **Cancel** button text and appearence.
14+
Customize predefined dialog buttons using the following properties:
15+
* [DialogOptions.PrimaryButtonOptions](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_PrimaryButtonOptions) - Customizes the primary (OK) button text and appearance.
16+
* [DialogOptions.CancelButtonOptions](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_CancelButtonOptions) - Customizes the secondary (Cancel) button text and appearance.
1717

18-
Use the following code snippet for **alert.razor**, **confirm.razor** and **prompt.razor** to customize the predefined dialog action buttons.
18+
Use the following code snippet for **alert.razor**, **confirm.razor**, and **prompt.razor** to customize predefined dialog action buttons.
1919

20-
For alert dialog , customized the default dialog button content as `Okay` by using the [DialogButtonOptions.Content](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogButtonOptions.html#Syncfusion_Blazor_Popups_DialogButtonOptions_Content) property.
20+
For the alert dialog, the default button content is customized to `Okay` using the [DialogButtonOptions.Content](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogButtonOptions.html#Syncfusion_Blazor_Popups_DialogButtonOptions_Content) property.
2121

22-
For confirm dialog, customized the default dialog buttons content as `Yes` and `No` by using the `DialogButtonOptions.Content` property and also customized the dialog button icons by using [DialogButtonOptions.IconCss](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogButtonOptions.html#Syncfusion_Blazor_Popups_DialogButtonOptions_IconCss) property.
22+
For the confirm dialog, the default button content is customized to `Yes` and `No` using the `DialogButtonOptions.Content` property, and the button icons are customized using the [DialogButtonOptions.IconCss](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogButtonOptions.html#Syncfusion_Blazor_Popups_DialogButtonOptions_IconCss) property (provide CSS class names for icons).
2323

24-
For prompt dialog , customized the default dialog buttons content as `Connect` and `Close` by using [DialogButtonOptions.Content](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogButtonOptions.html#Syncfusion_Blazor_Popups_DialogButtonOptions_Content) property.
24+
For the prompt dialog, the default button content is customized to `Connect` and `Close` using the [DialogButtonOptions.Content](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogButtonOptions.html#Syncfusion_Blazor_Popups_DialogButtonOptions_Content) property.
2525

2626
{% tabs %}
2727

@@ -43,21 +43,21 @@ For prompt dialog , customized the default dialog buttons content as `Connect` a
4343

4444
**Alert**
4545

46-
![Alert action buttons Dialog](./images/blazor-alert-action-button.png)
46+
![Alert dialog with customized action button](./images/blazor-alert-action-button.png)
4747

4848
**Confirm**
4949

50-
![Confirm action buttons Dialog](./images/blazor-confirm-action-button.png)
50+
![Confirm dialog with customized buttons](./images/blazor-confirm-action-button.png)
5151

5252
**Prompt**
5353

54-
![Prompt action buttons Dialog](./images/blazor-prompt-action-button.png)
54+
![Prompt dialog with customized Connect and Close buttons](./images/blazor-prompt-action-button.png)
5555

5656
## Show or hide dialog close button
5757

58-
You can show or hide close button in dialog using the [DialogOptions.ShowCloseIcon](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_ShowCloseIcon) property.The default value is `false`.
58+
Show or hide the close button in predefined dialogs using the [DialogOptions.ShowCloseIcon](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_ShowCloseIcon) property. The default value is `false`.
5959

60-
Use the following code snippet for **alert.razor**, **confirm.razor** and **prompt.razor** to customize the show or hide dialog close button.
60+
Use the following code snippet for **alert.razor**, **confirm.razor**, and **prompt.razor** to show or hide the dialog close button.
6161

6262
{% tabs %}
6363

@@ -79,21 +79,21 @@ Use the following code snippet for **alert.razor**, **confirm.razor** and **prom
7979

8080
**Alert**
8181

82-
![Alert close icon Dialog](./images/blazor-alert-close-button.png)
82+
![Alert dialog showing the close icon](./images/blazor-alert-close-button.png)
8383

8484
**Confirm**
8585

86-
![Confirm close icon Dialog](./images/blazor-confirm-close-button.png)
86+
![Confirm dialog showing the close icon](./images/blazor-confirm-close-button.png)
8787

8888
**Prompt**
8989

90-
![Prompt close icon Dialog](./images/blazor-prompt-close-button.png)
90+
![Prompt dialog showing the close icon](./images/blazor-prompt-close-button.png)
9191

9292
### Customize dialog content
9393

94-
You can load custom content in predefined dialogs using the [DialogOptions.ChildContent](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_ChildContent) property.
94+
Load custom content in predefined dialogs using the [DialogOptions.ChildContent](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_ChildContent) property.
9595

96-
Use the following code to customize the dialog content and render the custom TextBox component inside the prompt dialog to obtain the username from the user using the `@bind-Value` property.
96+
Use the following code to customize the dialog content and render a custom TextBox component inside the prompt dialog to obtain a username from the user using the `@bind-Value` property.
9797

9898
{% tabs %}
9999
{% highlight razor %}
@@ -103,4 +103,4 @@ Use the following code to customize the dialog content and render the custom Tex
103103
{% endhighlight %}
104104
{% endtabs %}
105105

106-
![Customize Prompt Dialog](./images/blazor-customize-dialog.png)
106+
![Prompt dialog with custom content for username input](./images/blazor-customize-dialog.png)

blazor/predefined-dialogs/dimension.md

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

1010
# Dimension in Predefined Dialogs in Blazor
1111

12-
Customize the predefined dialogs dimensions using the [DialogOptions.Height](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_Height) and [DialogOptions.Width](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_Width) properties.
12+
Customize predefined dialog dimensions using the [DialogOptions.Height](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_Height) and [DialogOptions.Width](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_Width) properties.
1313

14-
By default, the predefined dialogs `Width` and `Height` property value is set as `auto`. Depends on the dialog content the width and height values are automatically adjust. You can specify the dimension values in both pixels and percentage format to change the default dialog width and height values.
14+
By default, the `Width` and `Height` properties are set to `auto`. The dialog size adapts to its content when these values are not specified. Dimensions can be provided in pixels (for example, `300px`) or percentages (for example, `50%`) to override the default sizing.
1515

16-
Use the following code snippet for **alert.razor**, **confirm.razor** and **prompt.razor** to customize the dialog dimensions.
16+
Use the following code snippet for **alert.razor**, **confirm.razor**, and **prompt.razor** to customize dialog dimensions.
1717

1818
{% tabs %}
1919

@@ -35,21 +35,21 @@ Use the following code snippet for **alert.razor**, **confirm.razor** and **prom
3535

3636
**Alert**
3737

38-
![Alert dimension Dialog](./images/blazor-alert-dimension.png)
38+
![Alert dialog with custom width and height](./images/blazor-alert-dimension.png)
3939

4040
**Confirm**
4141

42-
![confirm dimension Dialog](./images/blazor-confirm-dimension.png)
42+
![Confirm dialog with custom width and height](./images/blazor-confirm-dimension.png)
4343

4444
**Prompt**
4545

46-
![prompt dimension Dialog](./images/blazor-prompt-dimension.png)
46+
![Prompt dialog with custom width and height](./images/blazor-prompt-dimension.png)
4747

4848
## Max-width and max-height
4949

50-
To have a restricted max-width and max-height dialog dimension, you need to specify the max-width, max-height CSS properties for the component’s container element by using the [CssClass](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_CssClass) property. The max-height value is calculated in source level and set to the dialog. so, need to override the max-height property.
50+
To constrain the dialog’s maximum size, specify `max-width` and `max-height` CSS properties for the component’s container using the [CssClass](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_CssClass) property. The component may apply an inline `max-height`; to override it, use a higher-specificity selector (or `!important` if necessary).
5151

52-
Use the following code to customize the max-width and max-height for alert dialog:
52+
Use the following code to customize the max-width and max-height for the alert dialog:
5353

5454
{% tabs %}
5555
{% highlight razor %}
@@ -59,13 +59,13 @@ Use the following code to customize the max-width and max-height for alert dialo
5959
{% endhighlight %}
6060
{% endtabs %}
6161

62-
![Max width and height](./images/blazor-max-width-height.png)
62+
![Dialog constrained with max width and max height](./images/blazor-max-width-height.png)
6363

6464
## Min-width and min-height
6565

66-
To have a restricted min-width and min-height dialog dimension, you need to specify the min-width, min-height CSS properties for the component’s container element by using the [CssClass](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_CssClass) property.
66+
To ensure a minimum dialog size (for example, to keep action buttons visible), specify `min-width` and `min-height` CSS properties for the component’s container using the [CssClass](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_CssClass) property.
6767

68-
Use the following code to customize the min-width and min-height for alert dialog:
68+
Use the following code to customize the min-width and min-height for the alert dialog:
6969

7070
{% tabs %}
7171
{% highlight razor %}
@@ -75,4 +75,4 @@ Use the following code to customize the min-width and min-height for alert dialo
7575
{% endhighlight %}
7676
{% endtabs %}
7777

78-
![Min width and height](./images/blazor-min-width-height.png)
78+
![Dialog constrained with min width and min height](./images/blazor-min-width-height.png)

blazor/predefined-dialogs/draggable.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,17 @@
11
---
22
layout: post
33
title: Draggable in the Predefined Dialogs in Blazor | Syncfusion
4-
description: Check out and learn here all about draggable in the predefined dialogs and much more details.
4+
description: Learn how to enable draggable behavior for predefined dialogs in Blazor, including alert, confirm, and prompt dialog examples.
55
platform: Blazor
66
control: Predefined Dialogs
77
documentation: ug
88
---
99

1010
# Draggable in Predefined Dialogs
1111

12-
The predefined dialogs supports dragging within its target container by grabbing the dialog header, which allows the user to reposition the dialog dynamically by using the [DialogOptions.AllowDragging](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_AllowDragging) property.
12+
Predefined dialogs support dragging by the dialog header, allowing users to reposition the dialog within its target container. Enable this behavior using the [DialogOptions.AllowDragging](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Popups.DialogOptions.html#Syncfusion_Blazor_Popups_DialogOptions_AllowDragging) property. The default value is `false`. Dragging requires a visible header; if the header is hidden or replaced, dragging behavior may be affected.
13+
14+
The following examples demonstrate enabling dragging for Alert, Confirm, and Prompt dialogs.
1315

1416
{% tabs %}
1517

@@ -25,4 +27,4 @@ The predefined dialogs supports dragging within its target container by grabbing
2527
{% include_relative code-snippet/prompt-drag.razor %}
2628
{% endhighlight %}
2729

28-
{% endtabs %}
30+
{% endtabs %}

0 commit comments

Comments
 (0)