Giter Club home page Giter Club logo

countrypicker.pcf's Introduction

CountryPicker.PCF GitHub all releases

Country Picker PCF (PowerApps Component framework) Control that turns a PowerApps text field into a Combobox displaying country names and flags.

IMPORTANT : DON'T USE VERSION PRIOR TO v1.0.0.9 , THE API ROOT AS CHANGED FOR FETCHING THE COUNTRY DATA

Features:

  • Promote some countries to appear first in the combobox.

  • Limit the available countries to show only the one that matters to your use case

  • Country names available in several languages. (English, German, Spanish, French, Japanese, Italian, Portuguese, Dutch, Persian)

  • Country information comes from this public API project : https://restcountries.com/

DISCLAIMER : The author of the project is not responsible for the accuracy of the content of the API

Dependencies

FluentUI : https://github.com/microsoft/fluentui

react-query : https://react-query.tanstack.com/

axios: https://axios-http.com/

Parameters

Parameter Description Default
CountryCode REQUIRED: Bound Country field (represents ISO 3166-1 3-letter country code)
CountryName OPTIONAL OUTPUT: Country name in the chosen language
Language Base language for country names. Available languages (English, German, Spanish, French, Japanese, Italian, Portuguese, Dutch, Persian) en
Promoted Promoted countries (Will appear first) Use comma separated list of ISO 3166-1 3-letter country code (Ex. 'USA,CAN,MEX')
Limit Limit to these countries Use comma separated list of ISO 3166-1 3-letter country code (Ex. 'USA,CAN,MEX'). Leave blank to include all countries
DisplayInfo Display Info Panel true
CountryCodeIso2 OPTIONAL OUTPUT: Bound field to store the 2 character Country Code ISO2

Screenshots

alt text

Country info panel

alt text

Different configurations

alt text

Languages

alt text

Installation

You can install the component directly from solution files containes in the 'Release' section https://github.com/drivardxrm/CountryPicker.PCF/releases

Get required tools

To use Microsoft PowerApps CLI, do the following:

  • Install Npm (comes with Node.js) or install Node.js (comes with npm). We recommend LTS (Long Term Support) version 10.15.3 LTS as it seems to be most stable.

  • Install .NET Framework 4.6.2 Developer Pack.

  • If you don’t already have Visual Studio 2017 or later, follow one of the options below:

    • Option 1: Install Visual Studio 2017 or later.
    • Option 2: Install .NET Core 2.2 SDK and then install Visual Studio Code.
  • Install Microsoft PowerApps CLI.

Be sure to update your Microsoft PowerApps CLI to the latest version:

pac install latest

Build the control

  • Clone the repo/ download the zip file.
  • Navigate to ./IconTwoOption/ folder.
  • Copy the folder path and open it in visual studio code.
  • Open the terminal, and run the command the following command to install the project dependencies:
npm install

Then run the command:

npm run start

Build the solution

  • Create a new solution folder and open the Developer command prompt.
  • Change the directory to the newly created folder in previous step.
  • Init the future solution:
pac solution init --publisherName someName --customizationPrefix someSolutionPrefix
  • Add the control to your future solution:
pac solution add-reference --path provide path of control project folder where the pcf.proj is available
  • Build 1/2:
msbuild /t:restore
  • Build 2/2:
msbuild
  • You will have the solution file in SolutionFolder/bin/debug folder!

If you want to change the solution type you have to edit the .cdsproj file:

Solution Packager overrides, un-comment to use: SolutionPackagerType (Managed, Unmanaged, Both)
  <PropertyGroup>
    <SolutionPackageType>Managed</SolutionPackageType>
  </PropertyGroup>

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.