# ember-arcgis-portal-components

> Ember components that help when working with ArcGIS Online/Enterprise items

Latest version **1.3.5** (published 2019-06-10) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install ember-arcgis-portal-components
pnpm add ember-arcgis-portal-components
yarn add ember-arcgis-portal-components
bun add ember-arcgis-portal-components
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.3.5 |
| Published | 2019-06-10 |
| First published | 2017-04-20 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | ^4.5 \|\| 6.* \|\| >= 7.* |
| Dependencies | 5 |
| Unpacked size | 576.8 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 5 |
| Author | Dave Bouwman |
| Maintainers | bddavidson, benstoltz, dbouwman, mjuniper, tomwayson |
| Keywords | esri, arcgis, arcgisonline, emberjs, ember-addon |

## Links

- npm: https://www.npmjs.com/package/ember-arcgis-portal-components
- Repository: https://github.com/Esri/ember-arcgis-portal-components
- Homepage: https://github.com/Esri/ember-arcgis-portal-components#readme
- Issues: https://github.com/Esri/ember-arcgis-portal-components/issues
- npm.io page: https://npm.io/package/ember-arcgis-portal-components

## Dependencies (5)

- [bower](https://npm.io/package/bower.md) 1.8.2
- [ember-cli-sass](https://npm.io/package/ember-cli-sass.md) 7.2.0
- [ember-cli-babel](https://npm.io/package/ember-cli-babel.md) ^6.6.0
- [ember-cli-htmlbars](https://npm.io/package/ember-cli-htmlbars.md) ^2.0.1
- [ember-cli-string-helpers](https://npm.io/package/ember-cli-string-helpers.md) 1.5.0

## Alternatives

- [jsforce](https://npm.io/package/jsforce.md) — 851.2K weekly downloads
- [react-native-qrcode-svg](https://npm.io/package/react-native-qrcode-svg.md) — 693.5K weekly downloads
- [@salesforce/plugin-data](https://npm.io/package/@salesforce/plugin-data.md) — 394.9K weekly downloads
- [@backstage/plugin-search-common](https://npm.io/package/@backstage/plugin-search-common.md) — 308.5K weekly downloads
- [@chain-registry/types](https://npm.io/package/@chain-registry/types.md) — 38.4K weekly downloads

## Recent versions

- 1.3.5 (latest) — 2019-06-10
- 1.3.4 — 2019-05-22
- 1.3.3 — 2018-12-11
- 1.3.2 — 2018-12-07
- 1.3.1 — 2018-12-06
- 1.3.0 — 2018-12-04
- 1.2.5 — 2018-12-04
- 1.2.4 — 2018-11-09
- 1.2.3 — 2018-10-16
- 1.2.2 — 2018-09-13
- 1.2.1 — 2018-08-29
- 1.2.0 — 2018-08-29
- 1.1.0 — 2018-07-31
- 1.0.8 — 2018-06-27
- 1.0.7 — 2018-06-13
- … 38 more at https://npm.io/package/ember-arcgis-portal-components/versions

## README

# ember-arcgis-portal-components

[![npm version][npm-img]][npm-url]
[![build status][travis-img]][travis-url]
[![apache licensed](https://img.shields.io/badge/license-Apache-green.svg?style=flat-square)](https://raw.githubusercontent.com/Esri/ember-arcgis-portal-components/master/LICENSE)

[npm-img]: https://img.shields.io/npm/v/ember-arcgis-portal-components.svg?style=flat-square
[npm-url]: https://www.npmjs.com/package/ember-arcgis-portal-components
[travis-img]: https://img.shields.io/travis/Esri/ember-arcgis-portal-components/master.svg?style=flat-square
[travis-url]: https://travis-ci.org/Esri/ember-arcgis-portal-components


> Ember Components for interacting with ArcGIS Online/Enterprise items.

This repository contains standalone components from [ArcGIS Hub](https://hub.arcgis.com) for interacting with ArcGIS Online and Enterprise items, making it extremely simple to include a responsive search dialog in your own Ember, [Bootstrap](https://getbootstrap.com/) application.

Check out the [live demo](https://esri.github.io/ember-arcgis-portal-components/#/itempicker)

![screenshot](screenshot.png)

## Installation

```
ember install ember-arcgis-portal-components
```

## Components

### Item Picker

The item picker component allows a user to search a portal for items, see a preview of the item, and then get the item returned. While commonly used in a modal, the component can be used in any context.

[Documentation](./docs/item-picker.md)

## Contributing
The components in this addon are used in MANY MANY places. As such, changes made to existing components, especially any external API surfaces is prone to having catastrophic downstream effects. Thus - before making any changes, please read and understand the [design document](./docs/design-docs.md). We are working on adding more unit and integration tests, but this will be an on-going process. Until we have a very high-level of coverage, modifications to these components should be considered a high-risk activity.


### Generating a New Component

When generating a new component, please structure your files in the following order. This will help standardize the files and keep everything in an organized format:

1. Injections
2. Component stuff (classNames, tagName, etc)
3. Component lifecycle hooks (init, didInsertElement)
    * roughly in the order they happen
4. Properties
5. Computed properties
6. Functions
7. Actions


### Examples

#### Default Usage (selectAction)

```hbs
{{item-picker
      selectAction=(action "onSelectItem")}}
```

The selectAction handler will be passed the selected item, and it may be passed a second `options` param which will contain contextually specific content. For example, if the item selected is a Feature Service, then the Preview will show a layer picker list. The selected layer will be pass in the options as `{layer: {...}}`

```js
actions: {
  onSelectItem(item, options) {
    ...
  }
}
```

### Setup

* `git clone https://github.com/Esri/ember-arcgis-portal-components`
* `cd ember-arcgis-portal-components`
* `npm install`
* `bower install`

### Running

* `ember serve`
* Visit your app at [http://localhost:4200](http://localhost:4200).

### Running Tests

* `npm test` (Runs `ember try:each` to test your addon against multiple Ember versions)
* `ember test`
* `ember test --server`

### Building

* `ember build`

For more information on using ember-cli, visit [https://ember-cli.com/](https://ember-cli.com/).

### Contributing

Esri welcomes contributions from anyone and everyone. Please see our [guidelines for contributing](https://github.com/Esri/contributing/blob/master/CONTRIBUTING.md).

### License

Copyright (c) 2018 Esri

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

> http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

See the License for the specific language governing permissions and limitations under the License.

A copy of the license is available in the repository's [LICENSE](./LICENSE) file.

---
_Source: https://npm.io/package/ember-arcgis-portal-components · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._