萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

LigerUI 開發避坑:謹慎引入 common.css 導致的載入動畫干擾調試

LigerUI 框架的 common.css 包含頁面載入遮罩動畫(.loading),若在開發調試階段引入,會導致頁面長時間白屏、元素不可點擊、控制台報錯誤導致定位困難。

現象


<!-- 引入後頁面會顯示「正在載入...」遮罩,JS 報錯時遮罩不消失,嚴重阻礙調試 -->
<link href="../lib/css/common.css" rel="stylesheet" type="text/css" />

建議策略

  1. 開發環境註釋掉:<!-- <link ... common.css /> -->
  2. 生產構建時自動注入:構建腳本根據環境變量決定是否包含。
  3. 按需引入核心樣式:僅引入 ligerui.css 等組件樣式,common.css 多為演示頁公共樣式,非運行時必需。

原理分析

common.css 通常包含:


/* 載入遮罩 */
body > .loading { position:fixed; top:0; left:0; width:100%; height:100%; background:#fff url(loading.gif) center no-repeat; z-index:9999; }
/* JS 初始化完成後移除 */
$(window).on('load', () => $('.loading').remove());

若 JS 執行報錯導致 load 事件不觸發或選擇器失效,遮罩永久殘留,頁面看似「死機」。

通用教訓

  • UI 框架的「演示/輔助樣式」與「核心組件樣式」務必分離。
  • 全局遮罩類組件需提供 hideLoading() 手動關閉 API,並捕獲全局錯誤自動關閉。
  • 開發調試時保持頁面「裸奔」狀態,盡早暴露問題。
copyright © 萬盛學電腦網 all rights reserved