當您無法產生 CSS 切換開關時,解決方式是修正幾何與顏色輸入,然後使用 CSS Toggle Switch Generator 輸出以原生核取方塊為基礎且彼此同步的 CSS 與 HTML。當尺寸無法相互配合、內距未留出旋鈕空間、持續時間超出可接受範圍,或顏色不是完整的六位數 HEX 值時,就可能發生產生失敗。修正這些輸入可解決產生階段的問題,但不會自動修好轉換開關之後無法移動、失去焦點可見性或無法儲存的問題。這些屬於整合問題,涉及標記、框架狀態、CSS 對比與應用程式邏輯。產生器處理的是可重複使用的呈現層:計算旋鈕直徑與移動距離、呈現真正的互動式預覽,並讓控制項以原生 HTML 核取方塊為基礎。它不會建立設定持久化、網路請求、待處理狀態、錯誤復原或分析追蹤。請將「無法產生」視為兩項separate任務:先讓配置有效到足以產生程式碼,再確保該程式碼在將使用它的產品中運作正確。

what should i do if i cannot generate css toggle switch
無法產生 CSS 切換開關時該怎麼辦

將產生失敗與執行階段失敗分開處理

變更程式碼之前,請先找出問題發生在哪個階段。產生器純粹透過邏輯拒絕不相容的幾何配置與無效格式,而不會產生負數尺寸或將旋鈕放在軌道外側。這項拒絕表示需要修正配置。若切換開關可以產生,但將程式碼貼到頁面後沒有反應,那就是另一個問題,涉及 CSS 選取器、由框架控制的狀態或事件處理。

您觀察到的情況受影響的階段後續動作
輸入值遭到拒絕產生器配置修正尺寸、內距、持續時間或 HEX 顏色,然後再次預覽兩種狀態。
複製的切換開關看起來沒有變化CSS 整合確認目的地使用產生的選取器,並在 React 或 Vue 中需要時將 class 轉換為 className。
視覺狀態改變了,但設定重設應用程式行為加入持久化與使用者回饋,因為產生的控制項不會儲存設定。
點擊不會更新由框架控制的輸入勾選狀態連結檢查 checked 與 change 事件處理器,確保原生輸入與應用程式狀態保持同步。

產生器中的所有內容都會在瀏覽器本機執行。其設定與程式碼不會上傳、持久化或傳送至元件產生服務。這讓樣式設定工作流程保持獨立,但也表示最終外觀與原生互動必須與您自己的產品邏輯連接。

檢查每個會影響輸出的值

請使用下列限制修正配置,然後再試一次。除了以整數毫秒表示的持續時間之外,每個測量值都必須是整數像素。顏色不接受縮寫形式或非 HEX 表示法。

輸入可接受的值必要的關係
軌道寬度36–120 像素至少比軌道高度大 8 像素。
軌道高度20–64 像素用於計算圓形旋鈕的直徑。
內距2–8 像素必須在軌道內留下正數的旋鈕空間。
轉場持續時間0–2,000 毫秒零會移除可見的插值,但不會阻止狀態變更。
關閉、開啟與旋鈕顏色完整的六位數 HEX 值每種顏色都必須使用必要的格式並通過嚴格驗證。

寬度與高度不能分別選擇。寬度必須留下足夠距離,讓開啟與關閉位置有明顯差異,而高度與內距的組合則決定旋鈕是否合適。這些是產生器公開的本機尺寸規則,而非通用的設計規則。

產生並複製切換開關

  1. 開啟 CSS Toggle Switch Generator 並設定外觀。輸入軌道寬度、軌道高度、內距、轉場持續時間、關閉顏色、開啟顏色與旋鈕顏色。工具會根據選定的幾何配置計算旋鈕直徑與勾選時的移動距離,並準備好彼此同步的 CSS 與 HTML。
  2. 修正任何遭拒絕的值。讓寬度維持在 36 到 120 像素之間,高度維持在 20 到 64 像素之間,內距維持在 2 到 8 像素之間。寬度必須至少比高度大 8 像素,持續時間則須介於 0 到 2,000 毫秒之間。若某種組合無效,請調整該關係,而不是設法繞過計算結果。
  3. 將全部三種顏色輸入為完整的六位數 HEX 值。檢查關閉狀態、開啟狀態、旋鈕位置與焦點處理方式。點擊軌道或其標籤以切換真正的預覽,讓您在複製前能檢視兩種配置。
  4. 複製 CSS 與 HTML。「Copy CSS」與「Copy HTML」動作會各自要求剪貼簿權限。成功狀態訊息會指出已複製的輸出。若剪貼簿存取遭拒,顯示的程式碼仍可供手動選取,而不會消失。
  5. 替換範例文字。將範例標籤「Enable feature」改成簡潔且真實的二進位設定,例如「Email notifications」或「Dark mode」。讓可見標籤與輸入保持關聯,因為巢狀標籤會使標示區域可點擊,並為控制項提供無障礙名稱。
  6. 讓輸入維持為原生核取方塊。產生的 HTML 會保留 input type="checkbox",因為切換開關代表二進位表單狀態。除非您同時實作缺少的互動與無障礙行為,否則不要將它替換成裝飾性元素。
  7. 整合兩項輸出並連接狀態。將 CSS 貼到目的地樣式表,將 HTML 貼到適當的元件或表單中。框架使用者可以將 class 改成 className,但語意的輸入與標籤關係應維持完整。程式碼片段不包含 JavaScript,因為基本核取方塊狀態不需要它;應用程式的持久化與網路行為仍由您負責。

檢查幾何配置與樣式

您可以直接檢查產生的值,而不必將其隱藏在元件相依性後面。旋鈕直徑等於軌道高度減去兩倍內距,勾選時的移動距離則等於軌道寬度減去軌道高度。未勾選時,旋鈕從選定的內距開始;勾選時,則使用水平 transform 將它移過軌道。軌道的半徑為高度的一半,呈藥丸形;旋鈕的半徑為自身大小的一半,呈圓形。

舉例來說,請使用寬 80 像素的軌道、高 40 像素的軌道,以及 4 像素的內距。旋鈕直徑為 40 − (2 × 4) = 32 像素,移動距離為 80 − 40 = 40 像素。端點檢查為 4 + 32 + 40 = 76 像素,等於 80 − 4 = 76 像素,因此計算出的旋鈕在兩端都會留下選定的內距。

選定的轉場持續時間會套用至背景顏色與旋鈕 transform,並使用 ease 時間關鍵字。將持續時間設為零會移除可見的插值,但不會改變勾選狀態。複製的基本程式碼不包含減少動態效果媒體查詢,因此當使用者要求減少動態效果時,可能需要覆寫目的地樣式表。若要進一步瞭解這項變更,請參閱如何移除產生的 CSS 切換開關中的轉場。

維持原生核取方塊語意

產生的外觀會使用 appearance: none 移除瀏覽器預設的核取方塊繪製,但不會取代原生輸入。底層核取方塊會繼續提供勾選狀態、Space 鍵啟用、焦點行為與表單提交語意。MDN 關於 appearance 屬性的文件會說明此樣式屬性,而CSS Basic User Interface Level 4 appearance 規則則提供標準規範的相關背景。

可見標籤是結構的一部分,而非可省略的裝飾。它為核取方塊提供無障礙名稱,並讓相關區域可點擊。請將範例文字替換成控制項實際代表的設定,並在該狀態的後果很重要時加入明確的狀態文字。開啟與關閉狀態除了顏色之外,也應能清楚區分,尤其是附近文字未讓目前狀態變得明確時。產生器不會為非原生小工具建立應用程式設定邏輯、持久化、API 呼叫、分析追蹤或 ARIA 同步。

測試整合控制項

在最終產品中執行最後檢查,此時頁面背景、樣式與應用程式行為都已確認。在貼上產生的程式碼後,請使用以下檢查清單:

  • 鍵盤操作: 使用 Tab 鍵切換至開關並按下 Space 鍵。確認勾選狀態有所變更,且控制項在鍵盤順序中維持合理位置。
  • 指標操作: 按一下軌道及其可見標籤。兩者都應啟動相同的原生輸入項目。
  • 狀態文字: 確認標籤確實表示實際的二進位設定,且任何可見的開或關文字都與輸入項目的狀態相符。
  • 焦點可見性: focus-visible 外框應保留在原生輸入項目上,使用所選的開啟顏色,並與軌道保持偏移。請對照實際頁面背景進行檢查,因為在預覽中醒目的顏色可能會在另一個主題中消失。
  • 縮放與目標大小: 以高倍率縮放檢視控制項,並確認其觸控目標仍可使用。
  • 強制色彩與高對比: 確認瀏覽器覆寫作者指定的顏色時,各種狀態與焦點指示仍能清楚辨識。
  • 減少動態效果: 確認轉換效果在目標產品減少動態效果的規則下運作適當,而不只是當產生器 duration 為零時。
  • 輔助科技: 檢查無障礙名稱、狀態播報與螢幕閱讀器輸出。
  • 應用程式狀態: 測試停用行為、相關錯誤或說明文字、進行中的作業、失敗與持續保存。

與 React、Vue 或其他框架整合後,請重新測試控制項。如果 checked 與 change 處理常式不相符,受控狀態的連接方式可能會破壞原生互動。產生器不會加入個別的 hover、active、disabled、invalid、loading 或 read-only 樣式,因此正式產品的設定畫面必須讓停用控制項易於理解,並讓錯誤或說明文字與相關欄位保持關聯。如果狀態變更會執行網路操作,請在 CSS 之外處理進行中與失敗狀態,並避免在使用者收到清楚回饋前變更伺服器狀態。產生的開關不包含持續保存、樂觀復原或復原邏輯;這些責任屬於使用它的產品。

視需要選擇其他控制項

切換開關表示開啟或關閉的二進位設定。請勿將它用於一次性動作,例如提交表單、刪除項目或執行命令;這些動作以按鈕呈現會更合適。開關也不能取代多選項選擇。產生控制項前,請確認介面只有兩種有意義的狀態,然後使用產生的外觀為原生二進位輸入項目設定樣式,而不是試圖讓它代表多個選項。

如果您正在權衡選項,產生 CSS 三角形時可能出現哪些問題?有詳細說明。