Git Product home page Git Product logo

powercat-code-components's Introduction

Power CAT code components

The Power CAT code components are a set of Power Apps component framework (PCF) controls that can be used to enhance power apps.

These code components are available as part of Creator-Kit and can be downloaded from latest release.

There are two types of components:

  • User interface components - controls that have a user interface and are styled using properties.
  • Utility components - controls that have no user interface, but provide functionality such as keyboard shortcut handling.

The following table provides an index to the code components in this repository:

Code component Type Overview Fluent UI Canvas apps Custom pages Model-driven apps Power Apps Portal
Auto width label User interface This code component acts similar to the standard canvas app label, but will expand dynamically in width to accommodate the text. This functionality is currently not supported in canvas apps today.
Breadcrumb User interface This code component provides a wrapper around the Fluent UI Breadcrumb control for use in canvas & custom pages.
Calendar User interface This code component provides a wrapper around the Fluent UI Calendar control for use in canvas & custom pages.
Command Bar User Interface This code component provides a wrapper around the Fluent UI Command Bar control for use in canvas & custom pages.
Context Menu User Interface This code component provides a wrapper around the Fluent UI Context Menu control bound to a button for use in canvas & custom pages.
DetailsList User Interface The DetailsList code component allows using of the Fluent UI DetailsList component from inside canvas apps and custom pages.
Elevation User Interface Fluent UI elevation support with mouse hover events.
Facepile User interface This code component provides a wrapper around the Fluent UI Facepile control for use in canvas & custom pages.
Icon User Interface Fluent UI Font Icon/ Icon Button & Action Button with custom styling.
Keyboard shortcuts Utility Registers key press event handlers to allow keyboard short cuts to be used inside canvas apps.
Nav User Interface This code component provides a wrapper around the Fluent UI Nav Menu control bound to a button for use in canvas & custom pages.
PeoplePicker User Interface Fluent UI PeoplePicker control for use in canvas & custom pages.
Persona User Interface Fluent UI Persona control for use in canvas & custom pages.
Picker User Interface Fluent UI Tag Picker support with custom item styling to allow for color/icons tags.
ProgressIndicator User Interface The DetailsList code component allows using of the Fluent UI ProgressIndicator component from inside canvas apps and custom pages.
Pivot User Interface This code component wraps the Fluent Pivot control for use in canvas & custom pages.
Resizable text area User interface A text area control that can be resized by the user using handle on the bottom right corner. Can be styled to look like either the classic, fluent or model-driven text field controls.
SearchBox User Interface Fluent UI SearchBox control for use in canvas & custom pages.
Shimmer User Interface This code component wraps the Fluent Shimmer control for use in canvas & custom pages.
Spinner User Interface This code component wraps the Fluent Spinner control for use in canvas & custom pages.
TagList User Interface This code component provides a Tag List that provides flexible width rendering bound to a collection.

Building & Deploying

You may want to build and deploy the components using your own solution publisher. You can follow the steps below to build an deploy each code component to your environment so that it can then be added to your unmanaged solution for deployment, ideally as a managed solution.

First, you will need to decide on which solution publisher prefix you want to use. This is very important since once deployed, a code component cannot be changed to a different solution publisher prefix.

Pre-Requisites

To build and deploy the Resizable Text Area control you will first need to install the pre-requisites:

  1. Visual Studio Code (VSCode)

    • Ensure the Add to PATH option is selected:
      Add PATH
  2. node.js

    • Installing the LTS (long term support) version is recommended:
      LTS Version
    • You do not need to check the Automatically install the necessary tools option on the Tools for Native Modules step:
      image-20211207145216177
  3. Microsoft Power Platform VS Code extension

    1. Open Visual Studio Code (VSCode).
    2. Select Extensions icon from the Activity panel (Ctrl+Shift+X).
    3. In the search bar, enter Power Platform Tools.
    4. Select Install. Once the installation is finished, restart your Visual Studio Code to see the extension within the Terminal window.
  4. The .NET 5.x SDK - Select the most appropriate version for your development workstation. Important: If you have any existing VSCode terminal sessions open, you must close them before the dotnet sdk will be available.

Unit Testing the code components with code coverage

Each code component has a set of unit-tests that can be run from inside VS Code:

npm run test

This will run the unit tests and report any failing tests, and the code-coverage metrics. E.g.
image-20220201162444337

The target coverage is the default 80%.

Building and Linting the code components

To build and lint the code component locally you can use:

npm run build

This will first fix any auto-fixable linting issues (reporting others as warnings), and then re-build the code component. If there are any build errors, they will be reported.

You can also, build in watch mode to test using the test-harness using:

npm start watch

You can run the linter using:

npm run lint:fix

Deploying to your environment as an unmanaged component

  1. First authenticate against your environment using:

    pac auth create -u <YourOrgUrl>

    E.g.

    pac auth create -u https://org42901917.api.crm4.dynamics.com
  2. Deploy the code components using the the correct publisher prefix. This must match the publisher prefix of the solution that you want to add the code component into before exporting into a different environment.

    pac pcf push -pp <YourPublishPrefix>

    E.g.

    pac pcf push -pp cat

    In the above example, your solution publisher would need the publisher prefix of cat: image-20220201151348193

  3. Each time you deploy, you will need to increment the build (3rd component) of the control version in the ControlManifest.Input.xml file.

More information : Code component application lifecycle management

Deploying to your environment as a managed solution

You can build and package the code component as a managed solution directly if required using a Solution Project. More information - https://docs.microsoft.com/en-us/powerapps/developer/component-framework/import-custom-controls

Testing checklist

This list contains the aspects that should be tested for each component:

  1. Run-time behavior vs maker studio behavior
  2. Custom Pages vs Canvas Apps behavior
  3. Accessibility - tab order & aria labels
  4. Dynamic sizing behavior using responsive containers
  5. Upgrade experience when components are updated

powercat-code-components's People

Contributors

ramakrishnan24689 avatar slaouist avatar denise-msft avatar dependabot[bot] avatar microsoft-github-policy-service[bot] avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.