Skip to content

Commit

Permalink
Merge pull request MicrosoftDocs#4912 from MicrosoftDocs/main63835058…
Browse files Browse the repository at this point in the history
…5570538033sync_temp

For protected branch, push strategy should use PR and merge to target branch method to work around git push error
  • Loading branch information
learn-build-service-prod[bot] authored Nov 8, 2023
2 parents 1716f0f + 3d6c06e commit 76891e3
Show file tree
Hide file tree
Showing 10 changed files with 163 additions and 73 deletions.
40 changes: 21 additions & 19 deletions powerapps-docs/maker/TOC.yml
Original file line number Diff line number Diff line change
Expand Up @@ -508,43 +508,45 @@
href: ./canvas-apps/show-images-text-gallery-sort-filter.md
- name: Use modern themes (preview)
href: ./canvas-apps/controls/modern-controls/modern-theming.md
- name: Modern control reference (preview)
- name: Modern control reference
items:
- name: Overview
href: ./canvas-apps/controls/modern-controls/overview-modern-controls.md
- name: List of modern controls and properties
href: ./canvas-apps/controls/modern-controls/modern-controls-reference.md
- name: Limitations of modern controls
href: ./canvas-apps/controls/modern-controls/limitations-modern-controls.md
- name: Badge
href: ./canvas-apps/controls/modern-controls/modern-controls-badge.md
- name: Button
href: ./canvas-apps/controls/modern-controls/modern-control-button.md
- name: Checkbox
- name: Link
href: ./canvas-apps/controls/modern-controls/modern-control-link.md
- name: Progress bar
href: ./canvas-apps/controls/modern-controls/modern-control-progress-bar.md
- name: Slider
href: ./canvas-apps/controls/modern-controls/modern-control-slider.md
- name: Tabs or tab list
href: ./canvas-apps/controls/modern-controls/modern-control-tabs-or-tabs-list.md
- name: Badge (preview)
href: ./canvas-apps/controls/modern-controls/modern-controls-badge.md
- name: Checkbox (preview)
href: ./canvas-apps/controls/modern-controls/modern-control-checkbox.md
- name: Date picker
- name: Date picker (preview)
href: ./canvas-apps/controls/modern-controls/modern-controls-date-picker.md
- name: Dropdown
- name: Dropdown (preview)
href: ./canvas-apps/controls/modern-controls/modern-control-dropdown.md
- name: Header
- name: Header (preview)
href: ./canvas-apps/controls/modern-controls/modern-controls-header.md
- name: Info button
- name: Info button (preview)
href: ./canvas-apps/controls/modern-controls/modern-control-info-button.md
- name: Link
href: ./canvas-apps/controls/modern-controls/modern-control-link.md
- name: Progress bar
href: ./canvas-apps/controls/modern-controls/modern-control-progress-bar.md
- name: Radio group
- name: Radio group (preview)
href: ./canvas-apps/controls/modern-controls/modern-controls-radio-group.md
- name: Spinner
- name: Spinner (preview)
href: ./canvas-apps/controls/modern-controls/modern-control-spinner.md
- name: Table
- name: Table (preview)
href: ./canvas-apps/controls/modern-controls/modern-control-table.md
- name: Tabs or tab list
href: ./canvas-apps/controls/modern-controls/modern-control-tabs-or-tabs-list.md
- name: Text
- name: Text (preview)
href: ./canvas-apps/controls/modern-controls/modern-control-text.md
- name: Text input
- name: Text input (preview)
href: ./canvas-apps/controls/modern-controls/modern-control-text-input.md
- name: Control reference
items:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,12 @@
title: Limitations of modern controls in canvas apps
description: Learn about limitations and known issue of modern controls in canvas apps.
author: yogeshgupta698

ms.topic: reference
ms.custom: canvas
ms.reviewer: mkaur-msft
ms.date: 03/22/2023
ms.subservice: canvas-maker
ms.author: yogupt


search.audienceType:
- maker
contributors:
Expand All @@ -19,29 +16,24 @@ contributors:
---

# Limitations of modern controls in canvas apps (preview)

[This article is pre-release document and is subject to change.]

In this article, learn about the general limitations of the modern controls used in canvas apps.

1. If you add items through an array such as PowerFx bar or advance properties. Then, you'll need to additionally select the **Value** field from the properties panel.

> [!div class="mx-imgBorder"]
> ![List in items](media/array-list.png)
> [!div class="mx-imgBorder"]
> ![Enable value field](media/select-value-field.png)
2. While updating properties of controls in property panel, some of the property value updates in format of:
1. While updating properties of controls in property panel, some of the property value updates in format of:

`PowerApps.CoreControls.<Control name>.<Property name>` `.<Value>`

This is a valid format, or you can update to value only. Both approaches will work for configuration of the control.
This is a valid format, or you can update to value only. Both approaches work for configuration of the control.

3. The property sets for new controls are different than property sets of original controls. Not all scenarios are supported on new controls. We're consistently trying to make improvements for new scenarios.
2. The property sets for new controls are different than property sets of original controls. Not all scenarios are supported on new controls. We're consistently trying to make improvements for new scenarios.

4. The modern controls don’t have support for properties that show up in command bar. Currently we only support property value updated through the property panel.
3. The modern controls don’t have support for properties that show up in command bar. Currently we only support property value updated through the property panel.

5. All app checker rules such as accessibility and formulas, currently don’t run on modern controls. We'll try to offer support as the feature develops.
4. Not all app checker rules such as accessibility and formulas run on modern controls currently. We offer support when the feature matures.

5. Test Studio and Test engine compatibility with modern controls is under development and modern controls aren't fully supported on these tools.



Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,7 @@ contributors:
- yogeshgupta698

---
# Button modern control in Power Apps (preview)

[This article is pre-release document and is subject to change.]
# Button modern control in Power Apps

A control that the user can select to interact with the app.

Expand All @@ -32,20 +30,31 @@ With the modern button you can set a button to be primary or secondary. Configur

**[Text](../properties-core.md)** – Text that appears on a component.

**Base palette color** - The color palette applied to a control. This impacts all surfaces of the control that render a theme color.
**BasePaletteColor** - The color palette applied to a control. This impacts all surfaces of the control that render a theme color. If the value is null or zero, then the color is driven by selected Fluent theme.

**Type** – Primary and Secondary. Primary emphasizes the button as a primary action. Secondary gives emphasis to the button in such a way that it indicates a secondary action.
**Appearance** – A button can have its content and borders styled for greater emphasis or to be subtle. Below are the options available:
* Primary: Emphasizes the button as a primary action.
* Secondary: Gives emphasis to the button in such a way that it indicates a secondary action.
* Outline: Removes background styling.
* Subtle: Minimizes emphasis to blend into the background until hovered or focused.
* Transparent: Removes background and border styling.

**Display mode** – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).
**FontSize** - The font size of the text that appears on a control. If the value is null or zero, then the font size is driven by selected Fluent theme.

## Additional properties
**Accessible label** – Label for screen readers.
**AccessibleLabel** – Label for screen readers.

**DisplayMode** – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

**Visible** - Whether a control appears or is hidden.

**[X](../properties-size-location.md)** – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

**[Y](../properties-size-location.md)** – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

**[Size](../properties-text.md)** – The size of the control on the canvas.
**[Size](../properties-text.md)** – The size of the control on the canvas





Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,7 @@ contributors:
- yogeshgupta698

---
# Link modern control in Power Apps (preview)

[This article is pre-release document and is subject to change.]
# Link modern control in Power Apps

Open hyperlinks in new tab.

Expand All @@ -32,14 +30,27 @@ Use **Link** control to provide links that can be defined with accessibility com

**URL** - URL for the users to navigate through the link.

**Base palette color** - The color palette applied to a control. This impacts all surfaces of the control that render a theme color.
**Align** - The location of text in relation to the horizontal center of its control. The options are updated to Start, End, Center and Justify to better accomodate left to right languages.

**VerticalAlign** - – The location of text on a control in relation to the vertical center of that control.

**BasePaletteColor** - The color palette applied to a control. This impacts all surfaces of the control that render a theme color.

**Wrap** - Whether the text should ever wrap to multiple lines.

**Display mode** Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).
**AutoHeight** - Whether a label automatically increases its Height property if its Text property contains more characters than the control can show at one time.

**BasePaletteColor** - The color palette applied to a control. This impacts all surfaces of the control that render a theme color. If the value is null or zero, then the color is driven by selected Fluent theme.

**FontSize** - The font size of the text that appears on a control. If the value is null or zero, then the font size is driven by selected Fluent theme.

## Additional properties
**Accessible label** – Label for screen readers.

**DisplayMode** – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

**Visible** - Whether a control appears or is hidden.

**[X](../properties-size-location.md)** – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

**[Y](../properties-size-location.md)** – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Progress bar modern control in Power Apps
description: Learn about the details, properties and examples of the progress bar modern control in Power Apps.
description: Learn about the details, properties, and examples of the progress bar modern control in Power Apps.
author: yogeshgupta698

ms.topic: reference
Expand All @@ -18,34 +18,38 @@ contributors:
- yogeshgupta698

---
# Progress bar modern control in Power Apps (preview)

[This article is pre-release document and is subject to change.]
# Progress bar modern control in Power Apps

Displays the progress, can be configured as determinate showcasing exact progress or indeterminate for ongoing progress.

## Description
The progress bar can be configured to show various states of progress in the apps. This versatile control can be used to inform users on their progress as they work on the app or can be used to show loading scenarios.

## Key properties
**Thickness** – The thickness of the progress bar.

**Shape**The shape of the bar and track. The shape property affects the corners of the bar.
**[OnChange](../properties-core.md)**Actions to perform when the value of control gets updated.

**Indeterminate** – Set the bar to determinate or indeterminate.
**Value** – Number between 0 and 'max', which specifies how much of the task is completed. Only applicable for determinate state.

**Max** - The maximum value, which indicates the task is complete. The ProgressBar bar is full when value equals max. This is useful for instances where you want to show capacity, or how much of a total has been uploaded or downloaded.

**Color** – The color prop can be used to indicate a "brand" state (default), "error" state (red), "warning" state (orange), or "success" state (green).
**Thickness** – The thickness of the progress bar. Current options are only medium and large.

**Base palette color** - The color palette applied to a control. This impacts all surfaces of the control that render a theme color. This property is on in effect if the **Color** property has a value of **None**.
**Shape** The shape of the bar and track. The shape property affects the corners of the bar.

**Value**A decimal number between 0 and 'max', which specifies how much of the task has been completed. Only applicable for determinate state.
**Indeterminate**Set the bar to determinate or indeterminate.

**Max** - The maximum value, which indicates the task is complete. The ProgressBar bar will be full when value equals max. This is useful for instances where you want to show capacity, or how much of a total has been uploaded/downloaded.
**ProgressColor** – For determinate state only, the color prop can be used to indicate a "brand" state (default), "error" state (red), "warning" state (orange), or "success" state (green). For indeterminate state, ProgressColor falls back to BasePaletteColor regardless of selected color.

**BasePaletteColor** - The color palette applied to a control. This impacts all surfaces of the control that render a theme color. If the value is null or zero, then the color is driven by selected Fluent theme.

## Additional properties
**Accessible label** – Label for screen readers.

**DisplayMode** – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

**Visible** - Whether a control appears or is hidden.

**[X](../properties-size-location.md)** – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

**[Y](../properties-size-location.md)** – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
---
title: Slider modern control in Power Apps
description: Learn about the details, properties, and examples of the slider modern control in Power Apps.
author: yogeshgupta698
ms.topic: reference
ms.component: canvas
ms.date: 11/6/2023
ms.subservice: canvas-maker
ms.author: yogupt
ms.reviewer: mkaur
search.audienceType:
- maker
contributors:
- mduelae
- yogeshgupta698

---
# Slider modern control in Power Apps

A control with which the user can specify a value by dragging a handle.

## Description
The user can indicate a value, between a minimum and a maximum value that you specify, by dragging the handle of a slider left-right or up-down, depending on the direction that you choose.

## Key properties

**[OnChange](../properties-core.md)** – Actions to perform when the user changes the value of a control such as by adjusting a slider.

**Value** – The default and current value of slider control. Many modern controls use single property to manage default and the output updated by users.

**Min** - The minimum value to which the user can set a slider.

**Max** - The maximum value to which the user can set a slider or a rating.

**Layout** - Whether the user scrolls through a gallery or adjusts a slider top to bottom (Vertical) or left to right (Horizontal).

**BasePaletteColor** - The color palette applied to a control. This impacts all surfaces of the control that render a theme color. If the value is null or zero, then the color is driven by selected Fluent theme.

## Additional properties
**AccessibleLabel** – Label for screen readers.

**DisplayMode** – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

**Visible** - Whether a control appears or is hidden.

**[X](../properties-size-location.md)** – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

**[Y](../properties-size-location.md)** – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

**[Size](../properties-text.md)** – The size of the control on the canvas












Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,7 @@ contributors:
- yogeshgupta698

---
# Tabs or tab list modern control in Power Apps (preview)

[This article is pre-release document and is subject to change.]
# Tabs or tab list modern control in Power Apps

Select a tab to move between screens or take action on app.

Expand All @@ -31,21 +29,31 @@ A **Tab** is a navigation control which can help users switch between different

**Items** – List of items to be shown in tabs. This can be array (select value in field) or this can be a data column from a table.

**Base palette color** - The color palette applied to a control. This impacts all surfaces of the control that render a theme color.
**DefaultSelectedItems** - The default value of a control before the user specifies a different value. This value should be specified as a table with first value as applicable value.

**Render size**Choose tabs to be shown as small, medium or large
**[OnChange](../properties-core.md)**Actions to perform when the user changes the value of a control.

**Alignment** – Option for tabs to be displayed as vertical or horizontal
**[OnSelect](../properties-core.md)** – Actions to perform when the user taps or clicks a control.

**BasePaletteColor** - The color palette applied to a control. This impacts all surfaces of the control that render a theme color. If the value is null or zero, then the color is driven by selected Fluent theme.

**FontSize** - The font size of the text that appears on a control. If the value is null or zero, then the font size is driven by selected Fluent theme.

**Size** – Choose tabs to be shown as small, medium or large

**Alignment** – Option for tabs to be displayed as vertical or horizontal

## Additional properties
**Accessible label** – Label for screen readers.

**DisplayMode** – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

**Visible** - Whether a control appears or is hidden.

**[X](../properties-size-location.md)** – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

**[Y](../properties-size-location.md)** – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

**[Size](../properties-text.md)** – The size of the control on the canvas.



Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,8 @@ Configure the behavior of a modern control by setting one of its properties. Eac

**[Spinner](modern-control-spinner.md)** – Displays state in motion, for exmaple, loading a page or table.

**[Slider](modern-control-slider.md)** - A control with which the user can specify a value by dragging a handle.

**[Table](modern-control-table.md)** – A control that shows a set of data in a tabular or list format.

**[Tabs or tab list](modern-control-tabs-or-tabs-list.md)** – Select a tab to move screens or take action on app.
Expand Down
Loading

0 comments on commit 76891e3

Please sign in to comment.