標(biāo)示注釋

理想上，任何?CSS 規(guī)則集之前都應(yīng)該使用 C 風(fēng)格注釋來(lái)解釋 CSS 塊的核心。這個(gè)注釋也要記錄對(duì)規(guī)則集特定部分編號(hào)的解釋。比如：

/**
 * Helper class to truncate and add ellipsis to a string too long for it to fit
 * on a single line.
 * 1\. Prevent content from wrapping, forcing it on a single line.
 * 2\. Add ellipsis at the end of the line.
 */
.ellipsis {
  white-space: nowrap; /* 1 */
  text-overflow: ellipsis; /* 2 */
  overflow: hidden;
}

基本上，任何不能明顯看出意義的地方都應(yīng)該注釋，但不要隨處注釋。記住不要注釋太多，掌握尺度讓每一處注釋都有意義。

當(dāng)注釋 Sass 的一個(gè)特定部分時(shí)，應(yīng)該使用 Sass 單行注釋而不是 C 風(fēng)格的注釋塊。這么做將不會(huì)輸出注釋，即使是在開(kāi)發(fā)時(shí)的擴(kuò)展模式。

// Add current module to the list of imported modules.
// `!global` flag is required so it actually updates the global variable.
$imported-modules: append($imported-modules, $module) !global;

擴(kuò)展閱讀

• CSS Guidelines’ Commenting section