KeyboardEvent: charCode 屬性

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

KeyboardEvent 介面的只讀屬性 charCode 返回在 keypress 事件期間按下字元鍵的 Unicode 值。

警告: 請不要使用此屬性,因為它已棄用。請使用 key 屬性來獲取字元的 Unicode 值。

一個數字,表示按下字元鍵的 Unicode 值。

示例

HTML

html
<p>Type anything into the input box below to log a <code>charCode</code>.</p>
<input type="text" />
<p id="log"></p>

JavaScript

js
const input = document.querySelector("input");
const log = document.querySelector("#log");

input.addEventListener("keypress", (e) => {
  log.innerText = `Key pressed: ${String.fromCharCode(e.charCode)}\ncharCode: ${
    e.charCode
  }`;
});

結果

注意

  • keypress 事件中,按下鍵的 Unicode 值儲存在 keyCodecharCode 屬性中,但絕不會同時儲存在兩者中。如果按下的鍵生成一個字元(例如,“a”),則 charCode 設定為該字元的程式碼;charCode 會區分字母大小寫(換句話說,charCode 會考慮是否按下了 shift 鍵)。否則,按下鍵的程式碼儲存在 keyCode 中。
  • charCode 屬性在 keydownkeyup 事件中永遠不會被設定。在這些情況下,會設定 keyCode
  • 要獲取鍵的程式碼,無論它儲存在 keyCode 還是 charCode 中,請查詢 which 屬性。
  • 透過 輸入法編輯器輸入的字元不會透過 keyCodecharCode 註冊。
  • 有關與特定鍵關聯的 charCode 值列表,請執行 顯示事件物件屬性 並檢視生成的 HTML 表。

規範

規範
UI 事件
# dom-keyboardevent-charcode

瀏覽器相容性