@pollyou/angularjs
v0.1.0
Published
AngularJS (1.x) component for PollYou polls and surveys (wraps the <pollyou-survey> web component).
Downloads
330
Maintainers
Readme
@pollyou/angularjs
AngularJS (1.5+) module pollyou with the component <pollyou-survey-js>, which wraps the
<pollyou-survey> web component of @pollyou/embed-core. The tag ends in -js because
<pollyou-survey> is the custom element itself.
Bundler (ESM)
npm install @pollyou/angularjsimport angular from 'angular' // first: the package uses window.angular
import pollyou from '@pollyou/angularjs' // also registers <pollyou-survey> (embed-core)
angular.module('app', [pollyou])Script tags (UMD)
The UMD build does not contain embed-core; load the CDN embed.js for <pollyou-survey>:
<script src="https://cdn.jsdelivr.net/npm/[email protected]/angular.min.js"></script>
<script
src="https://cdn.pollyou.app/v1/embed.js"
data-api-base="https://app.pollyou.app"
async
></script>
<script src="https://cdn.jsdelivr.net/npm/@pollyou/angularjs/dist/umd/pollyou-angularjs.umd.js"></script>
<script>
angular.module('app', ['pollyou'])
</script>Usage
Values are one-way bindings (<, expressions: quote strings), callbacks are & bindings with
the locals $event (the event detail) and $originalEvent (the CustomEvent); they run
inside a digest.
<pollyou-survey-js
survey-id="'AbC123xyz0'"
locale="vm.locale"
hidden="{ ref: 'newsletter' }"
on-complete="vm.done($event)"
></pollyou-survey-js>Bindings: survey-id, embed-id, api-base, mode, locale, theme, show-results,
live-results, identity-token, meta (object), hidden (object → hidden-<key>
attributes), channel (default angularjs), open (popup). Callbacks: on-ready,
on-start, on-answer, on-complete, on-close, on-error.
Defaults for the whole app:
angular.module('app').config([
'pollYouConfigProvider',
(provider) => {
provider.set({ apiBase: 'https://app.pollyou.app', locale: 'de' })
},
])User documentation (German): docs/frameworks/angularjs.md.
Development
pnpm --filter @pollyou/angularjs test # Vitest + jsdom with angular and angular-mocks (ngMock)
pnpm --filter @pollyou/angularjs build # dist/esm (ESM), dist/umd (UMD), dist/typesOverlay modes and triggers
mode popup, slider or fullpage renders an overlay that is visible while open is set. Triggers (delay, scroll depth, exit intent, page views) and frequency rules come from the embed configuration (embedId); the wrapper has no trigger props – the app controls open. See @pollyou/embed-core README, "Overlay modes". Listen to pollyou:shown on the element (it bubbles) for host analytics.
