Ember API 笔记-Ember.String

Emberjs API：http://emberjs.com/api/
定义于：packages/ember-runtime/lib/system/string.js:24
所属模块：ember-runtime

说明：定义了string助手方法，包括字符串格式化和本地化。除非Ember.EXTEND_PROTOTYPES的值为false，这些方法也会添加到Sting.prototype上。[推荐使用str.method()方式，比Ember.String.method(str)更方便]

继承的方法

-无

自有的方法

-camelize(str)

参数：
@str--待处理的字符串

返回：处理完成后的字符串

说明：将字符串改写为首字母小写的驼峰式命名法。Ember.String.camelize(str)等价于str.camelize()。

'innerHTML'.camelize() => 'innerHTML'
'action_name'.camelize() => 'actionName'
'css-class-name'.camelize() => 'cssClassName'
'my favorite items'.camelize() => 'myFavoriteItems'

-classify(str)

参数：
@str--待处理的字符串

返回：处理完成后的字符串

说明：将字符串改写为首字母大写的驼峰式命名法。Ember.String.classify(str)等价于str.classify()。

'innerHTML'.classify() => 'InnerHTML'
'action_name'.classify() => 'ActionName'
'css-class-name'.classify() => 'CssClassName'
'my favorite items'.classify() => 'MyFavoriteItems'

-dasherize(str)

参数：
@str--待处理的字符串

返回：处理完成后的字符串

说明：将空格或下划线替换为连接号。Ember.String.dasherize(str)等价于str.dasherize()。

'innerHTML'.dasherize() => 'inner-html'
'action_name'.dasherize() => 'action-name'
'css-class-name'.dasherize() => 'css-class-name'
'my favorite items'.dasherize() => 'my-favorite-items'

-decamelize(str)

参数：
@str--待处理的字符串

返回：处理完成后的字符串

说明：转换驼峰式命名格式的字符串为用下划线分割的全小写字符串。Ember.String.decamelize(str)等价于str.decamelizee()。

'innerHTML'.decamelize() => 'inner_html'
'action_name'.decamelize() => 'action_name'
'css-class-name'.decamelize() => 'css-class-name'
'my favorite items'.decamelize() => 'my favorite items'

-fmt(args)

参数：
@args--参数列表，第一个参数为待处理的字符串，第二个参数为替换内容，类型为数组

返回：处理完成后的字符串

说明：查找字符串中的“%@”，然后用参数数组的内容替换。可通过添加数字来定义替换的顺序。Ember.String.fmt(str,[args])等价于str.fmt(args)。

Ember.String.fmt('Hello %@ %@',['John', 'Doe']) => "Hello John Doe"
"Hello %@ %@".fmt('John', 'Doe') => "Hello John Doe"
"Hello %@2, %@1".fmt('John', 'Doe') => "Hello Doe, John"

-htmlSafe(str)

参数：
@str--待处理的字符串

返回：Handlebars对象

说明：不对字符串进行escape编码。Ember.String.htmlSafe(str)等价于str.htmlSafe()。该方法使用了Handlebars.SafeString()方法，Ember中的源代码如下，

Ember.String.htmlSafe = function(str) {
  return new Handlebars.SafeString(str);
};

-loc(str, formats)

参数：
@str--待处理的字符串
@formats--可选数组，要替换的内容

返回：处理完成后的字符串

说明：同fmt(args)类似，但首先查找Ember.STRINGS里的本地化字符串哈希表。为了与其他变量区别开来，通常在字符串前添加下划线，但这并不是必须的。Ember.String.loc(str, formats)等价于str.htmlSafe([formats])。[该功能类似于设置一个模板，在使用时替换可变内容]。

Ember.STRINGS = {
  '_Hello World': 'Bonjour le monde',
  '_Hello %@ %@': 'Bonjour %@ %@'
};
Ember.String.loc("_Hello World"); => 'Bonjour le monde';
Ember.String.loc("_Hello %@ %@", ["John", "Smith"]); => "Bonjour John Smith";
'_Hello %@ %@'.loc('John','Smith') => "Bonjour John Smith";

-underscore(str)

参数：
@str--待处理的字符串

返回：处理完成后的字符串

说明：将字符串改写为下划线分隔符形式，分割标识符包括驼峰式命名法、连接号、空格。Ember.String.underscore(str)等价于str.underscore()。

'innerHTML'.underscore() => 'inner_html'
'action_name'.underscore() => 'action_name'
'css-class-name'.underscore() => 'css_class_name'
'my favorite items'.underscore() => 'my_favorite_items'

-w(str)

参数：
@str--待处理的字符串

返回：数组。处理完成后的数组

说明：以空格为分割标识，将字符串分割为单独元素，最后组成数组。Ember.String.w(str)等价于str.w()。

Ember.String.w("alpha beta gamma").forEach(function(key) {
  console.log(key);
});
> alpha
> beta
> gamma
var strArray = "alpha beta gamma".w();
strArray => ["alpha", "beta", "gamma"];

继承的属性

-无

自有的属性

-无