chrome.input.ime

Mô tả

Sử dụng API chrome.input.ime để triển khai một IME tuỳ chỉnh cho Chrome OS. Điều này cho phép tiện ích của bạn xử lý thao tác nhấn phím, thiết lập thành phần và quản lý cửa sổ đề xuất.

Quyền

input

Bạn phải khai báo "dữ liệu đầu vào" quyền trong tệp kê khai tiện ích để sử dụng API input.ime. Ví dụ:

{
  "name": "My extension",
  ...
  "permissions": [
    "input"
  ],
  ...
}

Phạm vi cung cấp

Chỉ ChromeOS

Ví dụ

Đoạn mã sau đây sẽ tạo một IME để chuyển đổi các chữ cái đã nhập thành chữ in hoa.

var context_id = -1;

chrome.input.ime.onFocus.addListener(function(context) {
  context_id = context.contextID;
});

chrome.input.ime.onKeyEvent.addListener(
  function(engineID, keyData) {
    if (keyData.type == "keydown" && keyData.key.match(/^[a-z]$/)) {
      chrome.input.ime.commitText({"contextID": context_id,
                                    "text": keyData.key.toUpperCase()});
      return true;
    } else {
      return false;
    }
  }
);

Loại

AssistiveWindowButton

Chrome 85 trở lên

Mã nhận dạng của các nút trong cửa sổ hỗ trợ.

Enum

"hoàn tác"

"addToTừ điển"

AssistiveWindowProperties

Chrome 85 trở lên

Các thuộc tính của cửa sổ hỗ trợ.

Thuộc tính

  • announceString

    chuỗi không bắt buộc

    Các chuỗi dùng để thông báo của ChromeVox.

  • loại

    "hoàn tác"

  • hiển thị

    boolean

    Đặt true để hiện AsupportedWindow, đặt false để ẩn.

AssistiveWindowType

Chrome 85 trở lên

Loại cửa sổ hỗ trợ.

Giá trị

"hoàn tác"

AutoCapitalizeType

Chrome 69 trở lên

Loại tự động viết hoa của trường văn bản.

Enum

"ký tự"

"words"

"sentence"

InputContext

Mô tả Ngữ cảnh đầu vào

Thuộc tính

  • autoCapitalize
    Chrome 69 trở lên

    Loại tự động viết hoa của trường văn bản.

  • autoComplete

    boolean

    Liệu trường văn bản có muốn tự động hoàn tất hay không.

  • autoCorrect

    boolean

    Liệu trường văn bản có muốn tự động sửa lỗi hay không.

  • contextID

    số

    Trường này dùng để chỉ định mục tiêu của các thao tác đối với trường văn bản. Mã nhận dạng này sẽ không hợp lệ ngay khi onBlur được gọi.

  • shouldDoLearning

    boolean

    Chrome 68 trở lên

    Liệu có nên sử dụng văn bản đã nhập vào trường văn bản để cải thiện nội dung đề xuất nhập cho người dùng hay không.

  • spellCheck

    boolean

    Liệu trường văn bản có muốn kiểm tra lỗi chính tả hay không.

  • Loại giá trị mà trường văn bản này chỉnh sửa (Văn bản, Số, URL, v.v.)

InputContextType

Chrome 44 trở lên

Loại giá trị mà trường văn bản này chỉnh sửa (Văn bản, Số, URL, v.v.)

Enum

"text"

"tìm kiếm"

"tel"

"url"

"email"

"number"

"password"

"null"

KeyboardEvent

Xem http://www.w3.org/TR/DOM-level-3-Events/#events-KeyboardEvent

Thuộc tính

  • altKey

    boolean không bắt buộc

    Liệu có nhấn phím ALT hay không.

  • altgrKey

    boolean không bắt buộc

    Chrome 79 trở lên

    Liệu có nhấn phím ALTGR hay không.

  • capsLock

    boolean không bắt buộc

    Liệu CAPS_LOCK có được bật hay không.

  • string

    Giá trị của phím vật lý đang được nhấn. Giá trị này không chịu ảnh hưởng của trạng thái bố cục bàn phím hoặc đối tượng sửa đổi hiện tại.

  • ctrlKey

    boolean không bắt buộc

    Liệu có nhấn phím Ctrl hay không.

  • extensionId

    chuỗi không bắt buộc

    Mã tiện ích của người gửi sự kiện chính này.

  • phím

    string

    Giá trị của phím đang được nhấn

  • keyCode

    số không bắt buộc

    KeyCode HTML không dùng nữa là mã số phụ thuộc vào hệ thống và việc triển khai biểu thị giá trị nhận dạng chưa sửa đổi được liên kết với phím đã nhấn.

  • requestId

    chuỗi không bắt buộc

    (Không dùng nữa) Mã của yêu cầu. Thay vào đó, hãy sử dụng tham số requestId từ sự kiện onKeyEvent.

  • shiftKey

    boolean không bắt buộc

    Liệu có nhấn phím SHIFT hay không.

  • Một trong hai phím keyup hoặc keydown.

KeyboardEventType

Chrome 44 trở lên

Enum

"keyup"

"keydown"

MenuItem

Mục trong trình đơn mà phương thức nhập sử dụng để tương tác với người dùng từ trình đơn ngôn ngữ.

Thuộc tính

  • đã chọn

    boolean không bắt buộc

    Cho biết mục này sẽ được vẽ bằng dấu kiểm.

  • đang bật

    boolean không bắt buộc

    Cho biết mục này đã được bật.

  • id

    string

    Chuỗi sẽ được truyền đến lệnh gọi lại tham chiếu đến Mục trình đơn này.

  • nhãn

    chuỗi không bắt buộc

    Văn bản hiển thị trong trình đơn cho mục này.

  • kiểu

    MenuItemStyle không bắt buộc

    Loại mục trong trình đơn.

  • hiển thị

    boolean không bắt buộc

    Cho biết mục này đang hiển thị.

MenuItemStyle

Chrome 44 trở lên

Loại mục trong trình đơn. Các nút chọn giữa các dòng phân cách được coi là được nhóm lại.

Enum

"kiểm tra"

"radio"

"phân cách"

MenuParameters

Chrome 88 trở lên

Thuộc tính

  • engineID

    string

    Mã nhận dạng của công cụ cần sử dụng.

  • mục

    Các mục trong trình đơn để thêm hoặc cập nhật. Các thành phần này sẽ được thêm theo thứ tự tồn tại trong mảng.

MouseButton

Chrome 44 trở lên

Nút chuột nào đã được nhấp vào.

Enum

"trái"

"ở giữa"

"phải"

ScreenType

Chrome 44 trở lên

Loại màn hình kích hoạt IME.

Enum

"normal" (bình thường)

"login"

"khoá"

"đăng nhập phụ"

UnderlineStyle

Chrome 44 trở lên

Loại dấu gạch dưới để sửa đổi đoạn này.

Enum

"dấu gạch dưới"

"2Gạch dưới"

"không gạch dưới"

WindowPosition

Chrome 44 trở lên

Vị trí hiển thị cửa sổ ứng viên. Nếu bạn đặt thành "con trỏ", thì cửa sổ sẽ theo sau con trỏ. Nếu bạn đặt thành "thành phần", cửa sổ sẽ bị khoá ở phần đầu của cấu trúc.

Enum

"con trỏ"

"composition"

Phương thức

clearComposition()

Lời hứa
chrome.input.ime.clearComposition(
  parameters: object,
  callback?: function,
)

Xoá thành phần kết hợp hiện tại. Nếu tiện ích này không sở hữu IME đang hoạt động, thì không thành công.

Tham số

  • thông số

    đối tượng

    • contextID

      số

      Mã của bối cảnh trong đó bố cục sẽ bị xoá

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    (success: boolean) => void

    • thành công

      boolean

Giá trị trả về

  • Promise<boolean>

    Chrome 111 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

commitText()

Lời hứa
chrome.input.ime.commitText(
  parameters: object,
  callback?: function,
)

Xác nhận văn bản đã cung cấp cho dữ liệu đầu vào hiện tại.

Tham số

  • thông số

    đối tượng

    • contextID

      số

      Mã nhận dạng của ngữ cảnh nơi văn bản sẽ được cam kết

    • văn bản

      string

      Văn bản cần cam kết

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    (success: boolean) => void

    • thành công

      boolean

Giá trị trả về

  • Promise<boolean>

    Chrome 111 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

deleteSurroundingText()

Lời hứa
chrome.input.ime.deleteSurroundingText(
  parameters: object,
  callback?: function,
)

Xoá văn bản xung quanh dấu nháy.

Tham số

  • thông số

    đối tượng

    • contextID

      số

      Mã của ngữ cảnh trong đó văn bản xung quanh sẽ bị xoá.

    • engineID

      string

      Mã của công cụ nhận sự kiện.

    • chiều dài

      số

      Số ký tự cần xoá

    • bù trừ

      số

      Mức chênh lệch so với vị trí con nháy nơi bắt đầu quy trình xoá. Giá trị này có thể là số âm.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    () => void

Giá trị trả về

  • Lời hứa<vô hiệu>

    Chrome 111 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

hideInputView()

chrome.input.ime.hideInputView()

Ẩn cửa sổ chế độ xem nhập dữ liệu do hệ thống tự động bật lên. Nếu cửa sổ chế độ xem nhập dữ liệu đã bị ẩn, hàm này sẽ không hoạt động.

keyEventHandled()

chrome.input.ime.keyEventHandled(
  requestId: string,
  response: boolean,
)

Cho biết rằng sự kiện chính mà onKeyEvent nhận được đã được xử lý. Bạn chỉ nên gọi lệnh này nếu trình nghe onKeyEvent không đồng bộ.

Tham số

  • requestId

    string

    Mã yêu cầu của sự kiện đã được xử lý. Mã này phải được lấy từ keyEvent.requestId

  • phản hồi

    boolean

    True nếu thao tác nhấn phím đã được xử lý, false nếu không xử lý được thao tác nhấn phím

sendKeyEvents()

Lời hứa
chrome.input.ime.sendKeyEvents(
  parameters: object,
  callback?: function,
)

Gửi các sự kiện chính. Bàn phím ảo dự kiến sẽ sử dụng hàm này. Khi người dùng nhấn(các) phím trên bàn phím ảo, hàm này được dùng để truyền sự kiện đó đến hệ thống.

Tham số

  • thông số

    đối tượng

    • contextID

      số

      Mã của ngữ cảnh mà sự kiện chính sẽ được gửi, hoặc bằng 0 để gửi các sự kiện chính đến trường không phải dữ liệu đầu vào.

    • keyData

      Dữ liệu về sự kiện chính.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    () => void

Giá trị trả về

  • Lời hứa<vô hiệu>

    Chrome 111 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

setAssistiveWindowButtonHighlighted()

Lời hứa Chrome 86 trở lên
chrome.input.ime.setAssistiveWindowButtonHighlighted(
  parameters: object,
  callback?: function,
)

Đánh dấu/Bỏ đánh dấu một nút trong cửa sổ hỗ trợ.

Tham số

  • thông số

    đối tượng

    • announceString

      chuỗi không bắt buộc

      Văn bản để trình đọc màn hình thông báo.

    • Mã nhận dạng của nút

    • contextID

      số

      Mã nhận dạng của ngữ cảnh sở hữu cửa sổ hỗ trợ.

    • được làm nổi bật

      boolean

      Liệu có nên làm nổi bật nút này hay không.

    • windowType

      "hoàn tác"

      Loại cửa sổ chứa nút này.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    () => void

Giá trị trả về

  • Lời hứa<vô hiệu>

    Chrome 111 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

setAssistiveWindowProperties()

Lời hứa Chrome 85 trở lên
chrome.input.ime.setAssistiveWindowProperties(
  parameters: object,
  callback?: function,
)

Ẩn/hiện một cửa sổ hỗ trợ có các thuộc tính cho trước.

Tham số

  • thông số

    đối tượng

    • contextID

      số

      Mã nhận dạng của ngữ cảnh sở hữu cửa sổ hỗ trợ.

    • các tài sản

      Các thuộc tính của cửa sổ hỗ trợ.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    (success: boolean) => void

    • thành công

      boolean

Giá trị trả về

  • Promise&lt;boolean&gt;

    Chrome 111 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

setCandidates()

Lời hứa
chrome.input.ime.setCandidates(
  parameters: object,
  callback?: function,
)

Thiết lập danh sách ứng viên hiện tại. Thao tác này không thành công nếu tiện ích này không sở hữu IME đang hoạt động

Tham số

  • thông số

    đối tượng

    • ứng viên

      object[]

      Danh sách đề xuất sẽ hiển thị trong cửa sổ ứng viên

      • chú thích

        chuỗi không bắt buộc

        Văn bản bổ sung mô tả ứng cử viên

      • đề xuất

        string

        Ứng cử viên

      • id

        số

        Mã của ứng viên

      • nhãn

        chuỗi không bắt buộc

        Chuỗi ngắn hiển thị bên cạnh đề xuất, thường là phím tắt hoặc chỉ mục

      • parentId

        số không bắt buộc

        Mã để thêm các đề xuất này

      • mức sử dụng

        đối tượng không bắt buộc

        Cách sử dụng hoặc mô tả chi tiết của từ.

        • cơ thể

          string

          Chuỗi nội dung của nội dung mô tả chi tiết.

        • tiêu đề

          string

          Chuỗi tiêu đề của nội dung mô tả chi tiết.

    • contextID

      số

      Mã nhận dạng của ngữ cảnh sở hữu cửa sổ đề xuất.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    (success: boolean) => void

    • thành công

      boolean

Giá trị trả về

  • Promise&lt;boolean&gt;

    Chrome 111 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

setCandidateWindowProperties()

Lời hứa
chrome.input.ime.setCandidateWindowProperties(
  parameters: object,
  callback?: function,
)

Đặt thuộc tính của cửa sổ ứng viên. Thao tác này không thành công nếu tiện ích không sở hữu IME đang hoạt động

Tham số

  • thông số

    đối tượng

    • engineID

      string

      Mã của công cụ để đặt thuộc tính.

    • các tài sản

      đối tượng

      • auxiliaryText

        chuỗi không bắt buộc

        Văn bản xuất hiện ở cuối cửa sổ ứng viên.

      • auxiliaryTextVisible

        boolean không bắt buộc

        "True" để hiển thị văn bản phụ trợ, "false" để ẩn văn bản phụ.

      • currentCandidateIndex

        số không bắt buộc

        Chrome 84 trở lên

        Chỉ mục của ứng cử viên hiện đã chọn trong tổng số ứng viên.

      • cursorVisible

        boolean không bắt buộc

        True để hiển thị con trỏ, false để ẩn con trỏ.

      • pageSize

        số không bắt buộc

        Số lượng đề xuất hiển thị trên mỗi trang.

      • totalCandidates

        số không bắt buộc

        Chrome 84 trở lên

        Tổng số ứng viên trong cửa sổ ứng viên.

      • ngành dọc

        boolean không bắt buộc

        "True" nếu cửa sổ đề xuất hiển thị theo chiều dọc, "false" để chuyển cửa sổ sang chiều ngang.

      • hiển thị

        boolean không bắt buộc

        "True" để hiển thị cửa sổ Ứng viên, "false" để ẩn cửa sổ này.

      • windowPosition

        WindowPosition không bắt buộc

        Vị trí hiển thị cửa sổ ứng viên.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    (success: boolean) => void

    • thành công

      boolean

Giá trị trả về

  • Promise&lt;boolean&gt;

    Chrome 111 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

setComposition()

Lời hứa
chrome.input.ime.setComposition(
  parameters: object,
  callback?: function,
)

Đặt thành phần kết hợp hiện tại. Nếu tiện ích này không sở hữu IME đang hoạt động, thì không thành công.

Tham số

  • thông số

    đối tượng

    • contextID

      số

      Mã nhận dạng của ngữ cảnh nơi văn bản sáng tác sẽ được đặt

    • con trỏ

      số

      Vị trí trong văn bản của con trỏ.

    • phân đoạn

      đối tượng[] không bắt buộc

      Danh sách phân khúc và các loại phân khúc có liên quan.

      • end

        số

        Chỉ mục của ký tự để kết thúc phân đoạn này sau đó.

      • bắt đầu

        số

        Chỉ mục của ký tự để bắt đầu phân đoạn này

      • Loại dấu gạch dưới để sửa đổi đoạn này.

    • selectionEnd

      số không bắt buộc

      Vị trí trong văn bản mà vùng chọn kết thúc.

    • selectionStart

      số không bắt buộc

      Vị trí trong văn bản mà vùng chọn sẽ bắt đầu.

    • văn bản

      string

      Văn bản cần đặt

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    (success: boolean) => void

    • thành công

      boolean

Giá trị trả về

  • Promise&lt;boolean&gt;

    Chrome 111 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

setCursorPosition()

Lời hứa
chrome.input.ime.setCursorPosition(
  parameters: object,
  callback?: function,
)

Đặt vị trí của con trỏ trong cửa sổ ứng viên. Đây là tiện ích không hoạt động nếu tiện ích này không sở hữu IME đang hoạt động.

Tham số

  • thông số

    đối tượng

    • candidateID

      số

      Mã của ứng cử viên cần chọn.

    • contextID

      số

      Mã nhận dạng của ngữ cảnh sở hữu cửa sổ đề xuất.

  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    (success: boolean) => void

    • thành công

      boolean

Giá trị trả về

  • Promise&lt;boolean&gt;

    Chrome 111 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

setMenuItems()

Lời hứa
chrome.input.ime.setMenuItems(
  parameters: MenuParameters,
  callback?: function,
)

Thêm các mục trong trình đơn được cung cấp vào trình đơn ngôn ngữ khi IME này đang hoạt động.

Tham số

  • thông số
  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    () => void

Giá trị trả về

  • Lời hứa<vô hiệu>

    Chrome 111 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

updateMenuItems()

Lời hứa
chrome.input.ime.updateMenuItems(
  parameters: MenuParameters,
  callback?: function,
)

Cập nhật trạng thái của MenuItems được chỉ định

Tham số

  • thông số
  • số gọi lại

    hàm không bắt buộc

    Tham số callback sẽ có dạng như sau:

    () => void

Giá trị trả về

  • Lời hứa<vô hiệu>

    Chrome 111 trở lên

    Lời hứa được hỗ trợ trong Manifest V3 trở lên nhưng lệnh gọi lại được cung cấp cho khả năng tương thích ngược. Bạn không thể sử dụng cả hai trong cùng một lệnh gọi hàm. Chiến lược phát hành đĩa đơn Promise phân giải cùng loại được truyền đến lệnh gọi lại.

Sự kiện

onActivate

chrome.input.ime.onActivate.addListener(
  callback: function,
)

Sự kiện này được gửi khi IME được kích hoạt. Phương thức này báo hiệu rằng IME sẽ nhận các sự kiện onKeyPress.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (engineID: string, screen: ScreenType) => void

onAssistiveWindowButtonClicked

Chrome 85 trở lên
chrome.input.ime.onAssistiveWindowButtonClicked.addListener(
  callback: function,
)

Sự kiện này được gửi khi người dùng nhấp vào một nút trong cửa sổ hỗ trợ.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (details: object) => void

onBlur

chrome.input.ime.onBlur.addListener(
  callback: function,
)

Sự kiện này được gửi khi tiêu điểm rời khỏi một hộp văn bản. Lệnh này được gửi đến tất cả tiện ích đang nghe sự kiện này và do người dùng bật.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (contextID: number) => void

    • contextID

      số

onCandidateClicked

chrome.input.ime.onCandidateClicked.addListener(
  callback: function,
)

Sự kiện này sẽ được gửi nếu tiện ích này sở hữu IME đang hoạt động.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (engineID: string, candidateID: number, button: MouseButton) => void

onDeactivated

chrome.input.ime.onDeactivated.addListener(
  callback: function,
)

Sự kiện này được gửi khi IME bị huỷ kích hoạt. Phương thức này báo hiệu rằng IME sẽ không nhận được các sự kiện onKeyPress nữa.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (engineID: string) => void

    • engineID

      string

onFocus

chrome.input.ime.onFocus.addListener(
  callback: function,
)

Sự kiện này được gửi khi tiêu điểm nhập vào một hộp văn bản. Lệnh này được gửi đến tất cả tiện ích đang nghe sự kiện này và do người dùng bật.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (context: InputContext) => void

onInputContextUpdate

chrome.input.ime.onInputContextUpdate.addListener(
  callback: function,
)

Sự kiện này được gửi khi các thuộc tính của InputContext hiện tại thay đổi, chẳng hạn như loại. Lệnh này được gửi đến tất cả tiện ích đang nghe sự kiện này và do người dùng bật.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (context: InputContext) => void

onKeyEvent

chrome.input.ime.onKeyEvent.addListener(
  callback: function,
)

Được kích hoạt khi một sự kiện chính được gửi từ hệ điều hành. Sự kiện sẽ được gửi đến tiện ích nếu tiện ích này sở hữu IME đang hoạt động. Hàm trình nghe phải trả về giá trị true nếu sự kiện được xử lý là false (nếu sự kiện không được xử lý là false). Nếu sự kiện được đánh giá không đồng bộ, hàm này phải trả về giá trị không xác định và sau đó IME phải gọi keyEventHandled() với kết quả.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (engineID: string, keyData: KeyboardEvent, requestId: string) => boolean | undefined

    • returns

      boolean | chưa xác định

onMenuItemActivated

chrome.input.ime.onMenuItemActivated.addListener(
  callback: function,
)

Được gọi khi người dùng chọn một mục trong trình đơn

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (engineID: string, name: string) => void

    • engineID

      string

    • tên

      string

onReset

chrome.input.ime.onReset.addListener(
  callback: function,
)

Sự kiện này được gửi khi Chrome chấm dứt phiên nhập văn bản đang diễn ra.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (engineID: string) => void

    • engineID

      string

onSurroundingTextChanged

chrome.input.ime.onSurroundingTextChanged.addListener(
  callback: function,
)

Được gọi khi chuỗi có thể chỉnh sửa xung quanh con nháy thay đổi hoặc khi vị trí con nháy bị di chuyển. Độ dài văn bản được giới hạn trong 100 ký tự cho mỗi hướng qua lại.

Tham số

  • số gọi lại

    hàm

    Tham số callback sẽ có dạng như sau:

    (engineID: string, surroundingInfo: object) => void

    • engineID

      string

    • surroundingInfo

      đối tượng

      • liên kết

        số

        Vị trí bắt đầu của phần đã chọn. Giá trị này cho biết vị trí con nháy nếu không có lựa chọn.

      • tiêu điểm

        số

        Vị trí kết thúc của lựa chọn. Giá trị này cho biết vị trí con nháy nếu không có lựa chọn.

      • bù trừ

        số

        Chrome 46 trở lên

        Vị trí bù trừ của text. Vì text chỉ bao gồm một tập hợp con văn bản xung quanh con trỏ, độ lệch cho biết vị trí tuyệt đối của ký tự đầu tiên trong text.

      • văn bản

        string

        Văn bản xung quanh con trỏ. Đây chỉ là tập con của tất cả văn bản trong trường nhập dữ liệu.