bem core

BEM核心库

bem.info也可以提供有关bem-core的文档。它也可以在俄罗斯提供。

这是什么？

bem-core是Web接口开发的基础库。它提供了用于编码客户端JavaScript和模板的最小堆栈。

使用

使用bem-core运行项目的最简单方法是使用该项目播放器。

您可以使用熟悉的任何其他方式将库包括在项目中。

里面

水平

• common.blocks - 适用于任何设备和浏览器
• desktop.blocks - 应用于桌面浏览器
• touch.blocks - 实现一些触摸平台的细节

块

• i-bem - 带有JS和HTML的助手的基本块
• strings - JS弦的帮助者
• objects - JS-Objects的帮助者
• functions - JS功能的帮助者
• events - JS事件
• querystring - 工作的帮助者
• tick - 全球计时器
• idle - 空闲事件
• next-tick - nextTick / setTimeout(0, ...)
• inherit - oop助手
• jquery - jQuery
• clearfix - CSS clearfix技巧
• identify - 识别JS-Objects
• cookie - 与浏览器饼干一起工作的帮助者
• vow - 承诺/A+实施
• dom - 与DOM一起工作的帮助者
• loader - JS文件的加载程序
• ua - 浏览器功能检测
• keyboard - 键盘助手
• page - html/head/身体脚手架

技术

• Vanilla.js + browser.js
• Bemhtml
• 贝特里

API

可以在bem.info上找到自动基因的JSDOC API。例如， i-bem的JSDOC在这里https://en.bem.info/platform/libs/bem-core/current/current/desktop/i-bem/#jsdoc

ChangElog

您可以在ChangElog页面上检查ChangElog。

迁移

如果您之前使用过BEM，请检查迁移说明。

发展

工作副本

1. 获取所需的版本代码（例如v4 ）：

   $ git clone -b v4 git://github.com/bem/bem-core.git
   $ cd bem-core

2. 安装依赖项：

   $ npm install

   您需要export PATH=./node_modules/.bin:$PATH或一种运行本地安装的npm依赖关系的替代方法。

3. 安装所有必要的库：

   $ npm run deps

4. 构建和运行测试（规格）：

   $ npm test

5. 运行开发服务器：

   $ npm start

如何贡献

请参阅如何贡献指南。

模块化测试

functions__debounce的默认测试捆绑包：

$ magic make desktop.specs/functions__debounce

在建筑物过程完成后，您可以看到终端中测试的结果。

您也可以在浏览器加载desktop.specs/functions__debounce/spec-js+browser-js+bemhtml/spec-js+browser-js+bemhtml.html 。

以相同的方式对其他BEM实体进行测试。这将适用于配备.spec.js文件的人。

代码覆盖范围

要构建代码覆盖范围报告添加ISTANBUL_COVERAGE=yes环境变量，tests run命令：

$ ISTANBUL_COVERAGE=yes magic make desktop.specs && istanbul report html

如上所述，您也可以通过使用更多具体构建目标进行覆盖范围的模块化测试。

 $ ISTANBUL_COVERAGE=yes magic make desktop.specs/functions__debounce && istanbul report html

测试完成后，您可以通过在您喜欢的浏览器中打开coverage/index.html查看覆盖范围HTML报告。

整个代码覆盖统计信息可以在Coveralls上的BEM核心配置文件页面上找到。

测试是使用ENB-BEM规格库构建的。检查详细信息（仅在俄罗斯提供）。

支持的浏览器

我们的浏览器支持策略基于我们从Yandex服务获得的统计数据。

拥有超过2％用户的浏览器获得了全合规支持，超过0.5％ - 部分合规（这意味着数据是可访问的，但不是必需的100％功能）。我们没有为用户不到0.5％的浏览器提供新功能测试。

桌面

完全合规

• Google Chrome 29+
• Firefox 24+
• Yandex 1.7+
• 歌剧12.16
• MSIE 10.0
• MSIE 9.0
• MSIE 8.0
• 歌剧12.15

部分合规

• 歌剧17.0
• 歌剧16.0
• 歌剧12.14
• 歌剧12.2
• Firefox 23

触碰

完全合规

• iOS 6+
• Android 2.3+
• 歌剧手机12+
• Windows Phone 7+

部分合规

• iOS 5
• Android 2.2

执照

代码和文档版权2012 Yandex LLC。根据Mozilla公共许可证2.0发布的代码。