/ember-cli-string-helpers

Set of the String helpers extracted from DockYard's ember-composable-helpers.

Primary LanguageJavaScriptOtherNOASSERTION

ember-cli-string-helpers

Download count all time CircleCI npm version Ember Observer Score

String helpers for Ember. Extracted from the great DockYard's ember-composable-helpers.

To install:

ember install ember-cli-string-helpers

Configuration

This addon performs optional tree-shaking – you can specify which helpers to whitelist or blacklist using only or except within your config/environment.js:

module.exports = function(environment) {
  var ENV = {
    'ember-cli-string-helpers': {
      only: ['dasherize', 'underscore'],
      except: ['titleize', 'capitalize']
    }
  };

Both only and except can be safely used together (the addon computes the diff), although it's best if you only use one for your own sanity.

except: ['camelize'] // imports all helpers except `camelize`
only: ['camelize'] // imports only `camelize`

Available helpers

Usage

camelize

Camelizes a string using Ember.String.camelize.

{{camelize "hello jim bob"}}
{{camelize stringWithDashes}}

⬆️ back to top

capitalize

Capitalizes a string using Ember.String.capitalize.

{{capitalize "hello jim bob"}}
{{capitalize fullName}}

⬆️ back to top

classify

Classifies a string using Ember.String.classify.

{{classify "hello jim bob"}}
{{classify stringWithDashes}}

⬆️ back to top

dasherize

Dasherizes a string using Ember.String.dasherize.

{{dasherize "whatsThat"}}
{{dasherize phrase}}

⬆️ back to top

html-safe

Mark a string as safe for unescaped output with Ember templates using Ember.String.htmlSafe.

{{html-safe "<div>someString</div>"}}
{{html-safe unsafeString}}

⬆️ back to top

humanize

Removes dashes and underscores from a string, capitalizes the first letter and makes the rest of the string lower case.

{{humanize "some-string"}}
{{humanize phrase}}

⬆️ back to top

lowercase

Lowercases a string

{{lowercase "People Person's Paper People"}}
{{lowercase phrase}}

⬆️ back to top

titleize

Titleizes a string

{{titleize "my big fat greek wedding"}}
{{titleize phrase}}

⬆️ back to top

truncate

Truncates a string with a characterLimit.

{{truncate "Lorem ipsum dolor sit amet, consectetur adipiscing elit." 20}}
{{truncate phrase}}

⬆️ back to top

underscore

Capitalizes a string using Ember.String.underscore.

{{underscore "whatsThat"}}
{{underscore phrase}}

⬆️ back to top

uppercase

Uppercases a string

{{uppercase "loud noises"}}
{{uppercase phrase}}

⬆️ back to top

w

Splits a string on whitespace and/or turns multiple words into an array

{{#each (w "First" "Second" "Last") as |rank|}}
  Our {{rank}} place winner is ...
{{/each}}

or:

{{#each (w "First Second Last") as |rank|}}
  Our {{rank}} place winner is ...
{{/each}}

See also: Ember w documentation

⬆️ back to top

See also:

Legal

Licensed under the MIT license