Skip to content

Commit f775481

Browse files
Merge pull request #280 from syncfusion-content/popupUGWork
Updating popup-positioning.md file
2 parents 8cdb471 + 408fe79 commit f775481

File tree

1 file changed

+24
-24
lines changed

1 file changed

+24
-24
lines changed

maui-toolkit/Popup/popup-positioning.md

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -18,31 +18,31 @@ Following are the list of options available to show SfPopup at various positions
1818
<th>Methods / Properties</th>
1919
<th>Description</th></tr>
2020
<tr>
21-
<td>{{'`IsOpen`'| markdownify }}</td>
21+
<td>{{'[IsOpen](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_IsOpen)'| markdownify }}</td>
2222
<td>Show the <code>SfPopup</code> at the center.</td></tr>
2323
<tr>
24-
<td>{{'`Show`'| markdownify }}</td>
24+
<td>{{'[Show](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_Show_System_Boolean_)'| markdownify }}</td>
2525
<td>Similar as <code>SfPopup.IsOpen</code> property.</td></tr>
2626
<tr>
27-
<td>{{'`Show(x-position, y-position)`'| markdownify }}</td>
27+
<td>{{'[Show(x-position, y-position)](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_Show_System_Double_System_Double_)'| markdownify }}</td>
2828
<td>Show the <code>SfPopup</code> at the specified X and y positions.</td></tr>
2929
<tr>
30-
<td>{{'`ShowRelativeToView(View, RelativePosition)`'| markdownify }}</td>
30+
<td>{{'[ShowRelativeToView(View, RelativePosition)](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_ShowRelativeToView_Microsoft_Maui_Controls_View_Syncfusion_Maui_Toolkit_Popup_PopupRelativePosition_System_Double_System_Double_)'| markdownify }}</td>
3131
<td>Show the <code>SfPopup</code> at the position relative to the specified view.</td></tr>
3232
<tr>
33-
<td>{{'`ShowRelativeToView(View, RelativePosition, x-position, y-position)`'| markdownify }}</td>
33+
<td>{{'[ShowRelativeToView(View, RelativePosition, x-position, y-position)](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_ShowRelativeToView_Microsoft_Maui_Controls_View_Syncfusion_Maui_Toolkit_Popup_PopupRelativePosition_System_Double_System_Double_)'| markdownify }}</td>
3434
<td>Show the <code>SfPopup</code> at an absolute x, y coordinate from the relative position of the specified view.</td></tr>
3535
<tr>
36-
<td>{{'`IsFullScreen`'| markdownify }}</td>
36+
<td>{{'[IsFullScreen](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_IsFullScreen)'| markdownify }}</td>
3737
<td>Show the <code>SfPopup</code> in full width and height of the screen.</td></tr>
3838
<tr>
39-
<td>{{'`Show(bool)`'| markdownify }}</td>
39+
<td>{{'[Show(bool)](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_Show_System_Boolean_)'| markdownify }}</td>
4040
<td>Similar as <code>SfPopup.IsFullScreen</code> property.</td></tr>
4141
<tr>
42-
<td>{{'`SfPopup.Show(string title, string message)`'| markdownify }}</td>
42+
<td>{{'[SfPopup.Show(string title, string message)](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_Show_System_String_System_String_System_Int32_)'| markdownify }}</td>
4343
<td>Static method to show a popup with the title and message.</td></tr>
4444
<tr>
45-
<td>{{'`SfPopup.Show(string title, string message, string acceptText)`'| markdownify }}</td>
45+
<td>{{'[SfPopup.Show(string title, string message, string acceptText)](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_Show_System_String_System_String_System_String_System_Int32_)'| markdownify }}</td>
4646
<td>Static method to show a popup with the title, message and acceptText.</td></tr>
4747
</table>
4848

@@ -53,7 +53,7 @@ The `SfPopup` can be shown at the center by using the following options.
5353
* IsOpen property
5454
* SfPopup.Show
5555

56-
To open the `SfPopup`, use the `IsOpen` property as in the following code sample.
56+
To open the `SfPopup`, use the [IsOpen](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_IsOpen) property as in the following code sample.
5757

5858
{% tabs %}
5959
{% highlight xaml tabtitle="MainPage.xaml" %}
@@ -81,7 +81,7 @@ private void ClickToShowPopup_Clicked(object sender, EventArgs e)
8181
{% endhighlight %}
8282
{% endtabs %}
8383

84-
To open the SfPopup, use the `SfPopup.Show` method as in the following code sample.
84+
To open the SfPopup, use the [SfPopup.Show](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_Show_System_Boolean_) method as in the following code sample.
8585

8686
{% tabs %}
8787
{% highlight xaml tabtitle="MainPage.xaml" %}
@@ -113,7 +113,7 @@ private void ClickToShowPopup_Clicked(object sender, EventArgs e)
113113

114114
## Absolute positioning
115115

116-
To open the `SfPopup` in specific X and Y coordinates, use the `SfPopup.Show(x-position, y-position)` method as in the following code sample.
116+
To open the `SfPopup` in specific X and Y coordinates, use the [SfPopup.Show(x-position, y-position)](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_Show_System_Double_System_Double_) method as in the following code sample.
117117

118118
{% tabs %}
119119
{% highlight xaml tabtitle="MainPage.xaml" %}
@@ -141,7 +141,7 @@ private void ClickToShowPopup_Clicked(object sender, EventArgs e)
141141
{% endhighlight %}
142142
{% endtabs %}
143143

144-
The `StartX` and `StartY` properties of the `SfPopup` control are used to define the coordinates for the popup to display.
144+
The [StartX](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_StartX) and [StartY](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_StartY) properties of the `SfPopup` control are used to define the coordinates for the popup to display.
145145

146146
{% tabs %}
147147
{% highlight xaml tabtitle="MainPage.xaml" hl_lines="11 12" %}
@@ -178,7 +178,7 @@ private void ClickToShowPopup_Clicked(object sender, EventArgs e)
178178

179179
### Display popup relative to a view
180180

181-
To open the `SfPopup` relative to a view, use the `SfPopup.ShowRelativeToView(View, RelativePosition)` method.
181+
To open the `SfPopup` relative to a view, use the [SfPopup.ShowRelativeToView(View, RelativePosition)](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_ShowRelativeToView_Microsoft_Maui_Controls_View_Syncfusion_Maui_Toolkit_Popup_PopupRelativePosition_System_Double_System_Double_) method.
182182

183183
{% tabs %}
184184
{% highlight xaml tabtitle="MainPage.xaml" %}
@@ -207,7 +207,7 @@ private void ClickToShowPopup_Clicked(object sender, EventArgs e)
207207

208208
The `SfPopup` can be displayed at an absolute x, y coordinate from the relative position of the specified view by using the following method.
209209

210-
To open the `SfPopup` in the specific x and y coordinate relative to a view, use the `SfPopup.ShowRelativeToView(View, RelativePosition, x-position, y-position)` method.
210+
To open the `SfPopup` in the specific x and y coordinate relative to a view, use the [SfPopup.ShowRelativeToView(View, RelativePosition, x-position, y-position)](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_ShowRelativeToView_Microsoft_Maui_Controls_View_Syncfusion_Maui_Toolkit_Popup_PopupRelativePosition_System_Double_System_Double_) method.
211211

212212
{% tabs %}
213213
{% highlight xaml tabtitle="MainPage.xaml" %}
@@ -232,12 +232,12 @@ private void ClickToShowPopup_Clicked(object sender, EventArgs e)
232232

233233
![Displaying a .NET MAUI Popup at Absolute Relative position.](Images/popup-positioning/maui-popup-absolute-relative-positioning.png)
234234

235-
You can pass both negative and positive values as parameters to the `SfPopup.ShowRelativeToView(View, RelativePosition, x-position, y-position)`. The popup will be positioned by considering the relative position as (0, 0) the center point. For example, if you have set the `RelativePosition` as `PopupRelativePosition.AlignBottomRight` and `RelativeView` as a button, bottom right corner of the button will be considered as the 0, 0 point and a negative x-position value will place the popup to the left of that point and a positive x-position value will place the popup to the right of that point. The same applies for y-position also.
235+
You can pass both negative and positive values as parameters to the [SfPopup.ShowRelativeToView(View, RelativePosition, x-position, y-position)](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_ShowRelativeToView_Microsoft_Maui_Controls_View_Syncfusion_Maui_Toolkit_Popup_PopupRelativePosition_System_Double_System_Double_). The popup will be positioned by considering the relative position as (0, 0) the center point. For example, if you have set the [RelativePosition](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_RelativePosition) as [PopupRelativePosition.AlignBottomRight](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.PopupRelativePosition.html#Syncfusion_Maui_Toolkit_Popup_PopupRelativePosition_AlignBottomRight) and [RelativeView](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_RelativeView) as a button, bottom right corner of the button will be considered as the 0, 0 point and a negative x-position value will place the popup to the left of that point and a positive x-position value will place the popup to the right of that point. The same applies for y-position also.
236236

237237
### Show relative to view in MVVM
238238

239-
To open the SfPopup relative to a view in MVVM assign values to the `SfPopup.RelativeView` and `SfPopup.RelativePosition` properties and use the `SfPopup.IsOpen` property to open or close the popup using binding.
240-
The `AbsoluteX` and `AbsoluteY` are used to display popup at the specified coordinates when positioning it relatively to the specified `RelativeView` based on the `RelativePosition`.
239+
To open the SfPopup relative to a view in MVVM assign values to the [SfPopup.RelativeView](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_RelativeView) and [SfPopup.RelativePosition](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_RelativePosition) properties and use the [SfPopup.IsOpen](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_IsOpen) property to open or close the popup using binding.
240+
The [AbsoluteX](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_AbsoluteX) and [AbsoluteY](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_AbsoluteY) are used to display popup at the specified coordinates when positioning it relatively to the specified [RelativeView](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_RelativeView) based on the [RelativePosition](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_RelativePosition).
241241

242242
{% tabs %}
243243
{% highlight xaml tabtitle="MainPage.xaml" hl_lines="19" %}
@@ -304,7 +304,7 @@ public class ViewModel : INotifyPropertyChanged
304304

305305
## Close the popup automatically after timeout
306306

307-
To close a popup automatically after a specified delay, you can use the `AutoCloseDuration` property, which allows you to give the duration in milliseconds for the popup to automatically close itself without any user interaction.
307+
To close a popup automatically after a specified delay, you can use the [AutoCloseDuration](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_AutoCloseDuration) property, which allows you to give the duration in milliseconds for the popup to automatically close itself without any user interaction.
308308

309309
{% tabs %}
310310
{% highlight xaml hl_lines="3" %}
@@ -324,7 +324,7 @@ popup.IsOpen = true;
324324

325325
## Position the popup over the action bar
326326

327-
The SfPopup can be positioned without considering the action bar by using the `SfPopup.IgnoreActionBar` property. When set to true, this allows the popup to be positioned over the action bar without any constraints.
327+
The SfPopup can be positioned without considering the action bar by using the [SfPopup.IgnoreActionBar](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_IgnoreActionBar) property. When set to true, this allows the popup to be positioned over the action bar without any constraints.
328328

329329
{% tabs %}
330330
{% highlight xaml hl_lines="2" %}
@@ -341,15 +341,15 @@ popup.Show(0,0);
341341

342342
![Positioning the popup without considering action bar](Images/popup-positioning/maui-popup-popsitioning-without-actionbar-consideration.png)
343343

344-
If `IgnoreActionBar` is set to false, the popup positioning will take the action bar into account, ensuring it does not overlap.
344+
If [IgnoreActionBar](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_IgnoreActionBar) is set to false, the popup positioning will take the action bar into account, ensuring it does not overlap.
345345

346346
This feature is useful when you want to display the popup freely across the screen, including over the action bar.
347347

348348
## How to
349349

350350
### Returning result
351351

352-
The `ShowAsync()` method of the Popup allows you to display the popup and returns `true` if the user closes it using the accept button, or `false` otherwise.
352+
The [ShowAsync()](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_ShowAsync) method of the Popup allows you to display the popup and returns `true` if the user closes it using the accept button, or `false` otherwise.
353353

354354
{% tabs %}
355355
{% highlight xaml %}
@@ -388,7 +388,7 @@ public partial class MainPage : ContentPage
388388
{% endhighlight %}
389389
{% endtabs %}
390390

391-
The `Show(string title, string message, string acceptText, string declineText)` static method of the Popup allows you to display the popup and returns `true` if the user closes it using the accept button, or `false` otherwise.
391+
The [Show(string title, string message, string acceptText, string declineText)](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_Show_System_String_System_String_System_String_System_String_System_Int32_) static method of the Popup allows you to display the popup and returns `true` if the user closes it using the accept button, or `false` otherwise.
392392

393393
{% tabs %}
394394
{% highlight xaml tabtitle="MainPage.xaml" %}
@@ -690,7 +690,7 @@ private void OnListViewItemTapped(object sender, Syncfusion.Maui.ListView.ItemTa
690690

691691
### Display popup when interacting with a switch
692692

693-
`SfPopup.IsOpen` is a bindable property and hence can be bind to any property and based on its value the popup will open or close. In the following code example, we have bound the `IsOpen` property with the `IsToggled` property of the switch, and the popup will be opened or closed as the switch toggles.
693+
[SfPopup.IsOpen](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_IsOpen) is a bindable property and hence can be bind to any property and based on its value the popup will open or close. In the following code example, we have bound the [IsOpen](https://help.syncfusion.com/cr/maui-toolkit/Syncfusion.Maui.Toolkit.Popup.SfPopup.html#Syncfusion_Maui_Toolkit_Popup_SfPopup_IsOpen) property with the `IsToggled` property of the switch, and the popup will be opened or closed as the switch toggles.
694694

695695
{% tabs %}
696696
{% highlight xaml tabtitle="MainPage.xaml" hl_lines="11" %}

0 commit comments

Comments
 (0)