漢字轉拼音是個很實用的線上小工具,無論是做搜尋索引、姓名排序還是輸入輔助都用得上。自己維護一份對照表非常辛苦,好在 jQuery.Hz2Py.js 這個外掛已經把對應關係打包好了,呼叫時只需要一個方法。
這個外掛把大量漢字與拼音的對應關係預先收錄在函式庫中,對外只暴露一個 jQuery 方法 toPinyin()。你把一段文字傳進去,它就回傳對應的拼音字串。因為是純前端的查表加規則處理,不需要任何伺服器請求,延遲極低。
頁面只需要兩個 textarea:上面那個 id 為 content 用來輸入中文,下面那個 id 為 show 用來顯示結果。腳本部分在文件就緒後,對 content 掛上一組事件:
$("#content").live("keyup keydown change blur", function(){
$("#show").val($(this).toPinyin());
});
也就是說,只要輸入內容有任何變動——打字、刪除、貼上、失焦——就立刻重新轉換一次,達到即時預覽的效果。
第一,務必確認 jQuery 的引入路徑正確,且 jQuery 必須排在外掛之前,否則會出現 toPinyin is not a function 這類錯誤。第二,外掛檔有壓縮版(jQuery.Hz2Py-min.js)與開發版,正式環境用壓縮版即可。
樣式上,範例給了兩個 textarea 相同的寬高與邊框,並讓輸入區的字距(letter-spacing)拉寬一些,因為中文字要對齊拼音時需要更多空間;顯示區則用紅字、字距收緊,並加上 overflow-y:auto 以便內容過長時捲動。
範例中的 .live() 在 jQuery 1.7 之後已被移除,請改用 .on():$("#content").on("keyup keydown change blur", function(){ ... })。若你確實需要事件委派(例如元素是動態產生的),寫成 $(document).on("keyup", "#content", handler) 即可。
另外,其實這個場景只監聽 input 事件就足夠了,它能涵蓋打字、貼上、剪貼、以滑鼠右鍵選單變更等所有情況,比列舉四個事件更準確也更省資源。
多音字是這類查表式轉換最難處理的部分,例如「重」可以是 zhong 或 chong,單靠詞典很難判斷,通常需要搭配詞庫或人工校正。此外,若轉換結果要用於正式資料(如身分證字、地址比對),建議保留原始輸入,把拼音當成輔助欄位而非唯一依據。