当前位置: 首页 > 软件库 > 程序开发 > >

ember-cli-clipboard

A simple ember wrapper around clipboard.js
授权协议 MIT License
开发语言 JavaScript
所属分类 程序开发
软件类型 开源软件
地区 不详
投 递 者 罗昱
操作系统 跨平台
开源组织
适用人群 未知
 软件概览

ember-cli-clipboard

Build Status

A simple ember wrapper around clipboard.js (no flash)

Demo Page

http://jkusa.github.io/ember-cli-clipboard

Usage

Angle Bracket Invocation

<!-- Set text directly -->
<CopyButton
  @clipboardText="text to be copied"
  @success={{this.onSuccess}}
  @error={{this.onError}}
>
  Click To Copy
</CopyButton>

<!-- Get text from action that returns a string -->
<CopyButton
  @clipboardText={{this.getClipboardText}}
  @success={{this.onSuccess}}
  @error={{this.onError}}
>
  Click To Copy
</CopyButton>

<!-- Get text from target element -->
<input id="url" type="text" value="https://github.com/jkusa/ember-cli-clipboard">
<CopyButton
  @clipboardTarget="#url"
  @success={{this.onSuccess}}
  @error={{this.onError}}
>
  Click To Copy
</CopyButton>

Classic Invocation

{{#copy-button
  clipboardText="text to be copied"
  success=(action "onSuccess")
  error=(action "onError")
}}
  Click To Copy
{{/copy-button}}

Arguments

  • clipboardText - string value or action that returns a string to be copied
  • clipboardTarget - selector string of element from which to copy text
  • clipboardAction - string value of operation: copy or cut (default is copy)
  • container - selector string or element object of containing element. "For use in Bootstrap Modals or with any other library that changes the focus you'll want to set the focused element as the container value".
  • delegateClickEvent - clipboard.js defaults event listeners to the body in order to reduce memory footprint if there are hundreds of event listeners on a page. If you want to scope the event listener to the copy button, set this property to false
  • buttonType - string value of the button's type attribute

Any HTML button attribute passed to the component will be "splatted" on the button element. The one exception to this is the type attribute due to this issue. The following legacy arguments are still supported:

Actions

The following clipboard.js custom events are sent as actions

  • success sent on successful copy
  • error sent on failed copy

More information about the clipboard.js events can be found here

Template Helper

The helper is-clipboard-supported can be used to check if clipboard.js is supported or not.

{{#if (is-clipboard-supported)}}
  <CopyButton @clipboardTarget="#url">
    Click To Copy
  </CopyButton>
{{/if}}

Test Helpers

Some browsers do not allow simulated clicks to fire execCommand('copy'). This makes testing difficult. To assist with integration testing, the following test helpers are available to test the wiring of the success and error action handlers.

Acceptance Test Helpers

  • triggerCopySuccess(selector='.copy-btn')
  • triggerCopyError(selector='.copy-btn')

If you are using the NEW Ember Testing API, available in ember-cli-qunit >= 4.2 and ember-cli-mocha >= 0.15.0, then you can simply import the test helpers where needed (for both acceptance and integration tests).

// tests/acceptance/my-test.js

import {
  triggerCopyError,
  triggerCopySuccess,
} from 'ember-cli-clipboard/test-support';

Otherwise, to use the helpers in acceptance tests you need to register them in the /tests/helpers/start-app.js file.

// tests/helpers/start-app.js

import registerClipboardHelpers from '../helpers/ember-cli-clipboard';

registerClipboardHelpers();

export default function startApp(attrs) {

...

Example:

// tests/acceptance/my-test.js

test('copy button message', async function (assert) {
  assert.expect(3);

  await visit('/');
  assert.dom('.alert').doesNotExist('no alert message is initially present');

  triggerCopySuccess();

  assert
    .dom('.alert.alert-success')
    .exists('a success message is displayed when a copy is successful');

  triggerCopyError();

  assert
    .dom('.alert.alert-info')
    .exists('an error message is displayed when a copy is unsuccessful');
});

Integration Test Helpers

  • New Testing API (ember-cli-qunit >= 4.2 or ember-cli-mocha >= 0.15.0)

    • triggerCopySuccess(selector='.copy-btn')
    • triggerCopyError(selector='.copy-btn')
  • Old Testing API

    • triggerSuccess(context, selector='.copy-btn')
    • triggerError(context, selector='.copy-btn')

Example:

// tests/integration/components/my-test.js

// if using NEW ember testing api
import {
  triggerCopyError,
  triggerCopySuccess
} from 'ember-cli-clipboard/test-support';

// if using OLD ember testing api
import {
  triggerError,
  triggerSuccess
} from '../../helpers/ember-cli-clipboard';

...

test('copy-button integration', async function(assert) {
  assert.expect(2);

  this.set('onSuccess', () => {
    assert.ok(true, '`success` action handler correctly fired');
  });

  this.set('onError', () => {
    assert.ok(true, '`error` action handler correctly fired');
  });

  await render(hbs`
    <CopyButton
      class="my-copy-btn"
      @clipboardText="text to be copied"
      @success={{this.onSuccess}}
      @error={{this.onError}}
    >
      Click To Copy
    </CopyButton>
  `);

  //If using NEW ember testing api
  triggerCopyError('.my-copy-btn');
  triggerCopySuccess('.my-copy-btn');

  //If using OLD ember testing api
  triggerError(this, '.my-copy-btn');
  triggerSuccess(this, '.my-copy-btn');
});

Browser Support

For browser support information, checkout the clipboard.js documentation:

https://github.com/zenorocha/clipboard.js/#browser-support

Contributing

Contributions are welcomed. Please read the contributing guidelines.

License

This project is licensed under the MIT License.

 相关资料
  • Ember CLI 是一个 Ember.js 命令行工具,提供了由 broccoli 提供的快速的资源管道和项目结构。 Ember CLI 基于 Ember App Kit Project 目前已经废弃。 Assets Compilation Ember CLI asset compilation is based on broccoli. Broccoli has support for: Ha

  • This repository is no longer maintained. As a replacement check out: https://github.com/sir-dunxalot/ember-tooltips Ember CLI Tooltipster An Ember CLI add-on that wraps Tooltipster into an ember compo

  • ember-cli-updater This ember-cli addon helps you update your ember-cli application or addon. The idea of this addon is to automate some parts of the upgrade process so it's simplified. Not every chang

  • Ember-cli-yadda This Ember CLI addon facilitates writing BDD tests in the Gherkin language and executing them against your Ember app. @mschinis (Micheal Schinis) Did a great talk at @emberlondon BDD a

  • Ember-cli-simditor Ember component wrapper for simditor. Changes 0.0.7 Different from previous version, you must wrap content in object. See issue 6 for why. Getting Started Installation In your ember

  • ember-cli-chai Chai assertions for Ember.js. Deprecated This package is deprecated. Please use ember-auto-import to use chai and chai plugins directly. If you'd like to use chai, or were previously us

  • ember-cli-storybook �� Ember storybook adapter Compatibility Ember.js v3.16 or above Ember CLI v2.13 or above Node.js v10 or above Installation ember install @storybook/ember-cli-storybook Usage This

  • ember-cli-daterangepicker Just a simple component to use daterangepicker. ❗ Important notice The use of this addon is no longer recommended. This addon is a very simplewrapper for another JS library t