bem core

ห้องสมุด bem-core

เอกสารเกี่ยวกับ bem-core ด้วยวิธีที่ให้ข้อมูลมากขึ้นนั้นมีให้ที่ BEM.INFO นอกจากนี้ยังมีอยู่ในภาษารัสเซีย

นี่คืออะไร?

bem-core เป็นไลบรารีพื้นฐานสำหรับการพัฒนาเว็บอินเตอร์เฟส มันมีสแต็กน้อยที่สุดสำหรับการเข้ารหัส JavaScript และ templating ฝั่งไคลเอ็นต์

ใช้

วิธีที่ง่ายที่สุดในการเรียกใช้โครงการกับ bem-core คือการใช้ Project-Stub

คุณสามารถใช้วิธีอื่นใดที่คุณคุ้นเคยกับการรวมไลบรารีไว้ในโครงการ

ข้างใน

ระดับ

• common.blocks - เหมาะสำหรับอุปกรณ์และเบราว์เซอร์ใด ๆ
• desktop.blocks - ควรใช้สำหรับเบราว์เซอร์เดสก์ท็อป
• touch.blocks ใช้ข้อมูลเฉพาะบางส่วนแบบสัมผัส

ตึก

• i-bem บล็อกฐานพร้อมผู้ช่วยสำหรับ JS และ HTML
• strings -ผู้ช่วยสำหรับ JS-Strings
• objects -ผู้ช่วย js-bjects
• functions -ผู้ช่วยสำหรับ JS-functions
• events -เหตุการณ์ JS
• querystring - ผู้ช่วยทำงานกับ QueryString
• tick - ตัวจับเวลาทั่วโลก
• idle - เหตุการณ์ไม่ได้ใช้งาน
• next-tick -Polyfill สำหรับ nextTick / setTimeout(0, ...)
• inherit - ผู้ช่วย OOP
• jquery - jQuery
• clearfix - เคล็ดลับ CSS Clearfix
• identify -ระบุ js-bjects
• cookie - ผู้ช่วยทำงานกับคุกกี้เบราว์เซอร์
• vow - สัญญา/การใช้งาน
• dom - ผู้ช่วยทำงานกับ DOM
• loader - โหลดเดอร์สำหรับไฟล์ JS
• ua - การตรวจจับคุณสมบัติของเบราว์เซอร์
• keyboard - ผู้ช่วยแป้นพิมพ์
• page - html/head/body scaffold

เทคโนโลยี

• vanilla.js + browser.js
• bemhtml
• บัมทรี

API

JSDOC API Autogenerated สามารถพบได้ใน bem.info เช่น jsdoc สำหรับ i-bem อยู่ที่นี่ https://en.bem.info/platform/libs/bem-core/current/desktop/i-bem/#jsdoc

การเปลี่ยนแปลง

คุณสามารถตรวจสอบการเปลี่ยนแปลงที่หน้า 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 ตัวแปรสภาพแวดล้อมในคำสั่งการทดสอบ RUN:

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

คุณสามารถเรียกใช้การทดสอบแบบแยกส่วนด้วยความครอบคลุมได้เช่นกันโดยใช้เป้าหมายการสร้างคอนกรีตมากขึ้นตามที่อธิบายไว้ข้างต้น

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

หลังจากเสร็จสิ้นการทดสอบคุณสามารถดูรายงาน HTML ครอบคลุมได้โดยเปิด coverage/index.html ในเบราว์เซอร์ที่คุณชื่นชอบ

สถิติการครอบคลุมรหัสทั้งหมดสามารถพบได้ในหน้าโปรไฟล์ bem-core บน coveralls

การทดสอบถูกสร้างขึ้นด้วยไลบรารี ENB-BEM-Specs ตรวจสอบรายละเอียด (มีอยู่ในภาษารัสเซียเท่านั้น)

เบราว์เซอร์ที่รองรับ

นโยบายการสนับสนุนเบราว์เซอร์ของเราขึ้นอยู่กับสถิติที่เราได้รับจากบริการ 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+
• Opera Mobile 12+
• Windows Phone 7+

เป็นไปตามมาตรฐานบางส่วน

• iOS 5
• Android 2.2

ใบอนุญาต

รหัสและเอกสารลิขสิทธิ์ 2012 Yandex LLC รหัสที่เผยแพร่ภายใต้ใบอนุญาตสาธารณะ Mozilla 2.0