Hướng dẫn excel functions in javascript - hàm excel trong javascript

Chuyển đến nội dung chính

Trình duyệt này không còn được hỗ trợ nữa.

Hãy nâng cấp lên Microsoft Edge để tận dụng các tính năng mới nhất, bản cập nhật bảo mật và hỗ trợ kỹ thuật.

Tổng quan về API JavaScript Excel

• Bài viết
• 25/03/2022
• 2 Phú

Trong bài viết nào

Một bổ trợ Excel tương tác với các đối tượng trong Excel bằng cách sử dụng API JavaScript Office, bao gồm hai mô hình đối tượng JavaScript:

• API JavaScript Excel: Đây là các API dành riêng cho ứng dụng cho Excel. Được giới thiệu với Office 2016, API JavaScript Excel cung cấp các đối tượng được gõ mạnh mà bạn có thể sử dụng để truy cập bảng tính, phạm vi, bảng, biểu đồ, v.v.: These are the application-specific APIs for Excel. Introduced with Office 2016, the Excel JavaScript API provides strongly-typed objects that you can use to access worksheets, ranges, tables, charts, and more.

• API thông thường: Được giới thiệu với Office 2013, API phổ biến có thể được sử dụng để truy cập các tính năng như UI, hộp thoại và cài đặt máy khách phổ biến trên nhiều loại ứng dụng Office.: Introduced with Office 2013, the Common API can be used to access features such as UI, dialogs, and client settings that are common across multiple types of Office applications.

Phần này của tài liệu tập trung vào API JavaScript Excel, mà bạn sẽ sử dụng để phát triển phần lớn chức năng trong các phần bổ sung mà mục tiêu Excel trên web hoặc Excel 2016 trở lên. Để biết thông tin về API phổ biến, hãy xem mô hình đối tượng API JavaScript thông thường.

Tìm hiểu các khái niệm mô hình đối tượng

Xem mô hình đối tượng Excel JavaScript trong các tiện ích bổ sung văn phòng để biết thông tin về các khái niệm mô hình đối tượng quan trọng.

Để có trải nghiệm thực hành bằng cách sử dụng API JavaScript Excel để truy cập các đối tượng trong Excel, hãy hoàn thành hướng dẫn bổ trợ Excel.

Tìm hiểu khả năng API

Mỗi tính năng API Excel chính có một bài viết hoặc bộ bài viết khám phá những gì tính năng đó có thể làm và mô hình đối tượng có liên quan.

• Biểu đồ
• Bình luận
• Định dạng có điều kiện
• Chức năng tùy chỉnh
• Xác nhận dữ liệu
• Loại dữ liệu
• Sự kiện
• Pivottables
• Phạm vi và tế bào
• RangeAs (nhiều phạm vi)
• Hình dạng
• Những cái bàn
• Sách bài tập và API cấp ứng dụng
• Bảng tính

Để biết thông tin chi tiết về mô hình đối tượng API JavaScript Excel, hãy xem Tài liệu tham khảo API JavaScript Excel.

Thử các mẫu mã trong phòng thí nghiệm tập lệnh

Sử dụng Script Lab để bắt đầu nhanh chóng với một bộ sưu tập các mẫu tích hợp cho thấy cách hoàn thành các tác vụ với API. Bạn có thể chạy các mẫu trong phòng thí nghiệm tập lệnh để thấy kết quả ngay lập tức trong ngăn tác vụ hoặc bảng tính, kiểm tra các mẫu để tìm hiểu cách thức hoạt động của API và thậm chí sử dụng các mẫu để tạo mẫu cho bổ trợ của riêng bạn.

Xem thêm

• Tài liệu bổ trợ Excel
• Tổng quan bổ sung Excel
• Tham chiếu API JavaScript Excel
• Ứng dụng khách hàng văn phòng và tính khả dụng của nền tảng cho các tiện ích bổ sung văn phòng
• Sử dụng mô hình API dành riêng cho ứng dụng

Phản HồI

Gửi và xem ý kiến ​​ph

Chuyển đến nội phân

Trình Duyệt nào Không CNn Đan Hỗ trợ nữa.

Hãy nâng cấp lênn microsoft ed

Gọi API excel javascript từ một chức năng tùy chỉnh

• Bài viết
• 30/08/2022
• 2 Phú

Trong bài viết nào

Gọi API JavaScript Excel từ các chức năng tùy chỉnh của bạn để nhận dữ liệu phạm vi và có thêm bối cảnh cho các tính toán của bạn. Gọi API JavaScript Excel thông qua một chức năng tùy chỉnh có thể hữu ích khi:

• Một chức năng tùy chỉnh cần lấy thông tin từ Excel trước khi tính toán. Thông tin này có thể bao gồm các thuộc tính tài liệu, định dạng phạm vi, các bộ phận XML tùy chỉnh, tên sổ làm việc hoặc thông tin cụ thể khác của Excel.
• Một hàm tùy chỉnh sẽ đặt định dạng số của ô cho các giá trị trả về sau khi tính toán.

Mẫu mã

Để gọi API JavaScript Excel từ một hàm tùy chỉnh, trước tiên bạn cần một ngữ cảnh. Sử dụng đối tượng Excel.RequestContext để có ngữ cảnh. Sau đó sử dụng bối cảnh để gọi API bạn cần trong sổ làm việc.

Mẫu mã sau đây cho thấy cách sử dụng Excel.RequestContext để nhận giá trị từ một ô trong sổ làm việc. Trong mẫu này, tham số address được chuyển vào bảng tính API JavaScript Excel.GetRange và phải được nhập dưới dạng chuỗi. Ví dụ, hàm tùy chỉnh được nhập vào UI Excel phải tuân theo mẫu =CONTOSO.GETRANGEVALUE("A1"), trong đó "A1" là địa chỉ của ô để lấy lại giá trị.

/** * @customfunction * @param {string} address The address of the cell from which to retrieve the value. * @returns The value of the cell at the input address. **/ async function getRangeValue(address) { // Retrieve the context object. const context = new Excel.RequestContext(); // Use the context object to access the cell at the input address. const range = context.workbook.worksheets.getActiveWorksheet().getRange(address); range.load("values"); await context.sync(); // Return the value of the cell at the input address. return range.values[0][0]; }

Hạn chế của việc gọi API JavaScript Excel thông qua một chức năng tùy chỉnh

Một bổ trợ chức năng tùy chỉnh có thể gọi API JavaScript Excel, nhưng bạn nên thận trọng về việc API mà nó gọi. Đừng gọi API JavaScript Excel từ một chức năng tùy chỉnh thay đổi các ô bên ngoài ô chạy chức năng tùy chỉnh. Thay đổi các ô khác hoặc môi trường Excel có thể dẫn đến hiệu suất kém, thời gian ra và các vòng vô hạn trong ứng dụng Excel. Điều này có nghĩa là các chức năng tùy chỉnh của bạn không nên thực hiện bất kỳ điều nào sau đây:

• Chèn, xóa hoặc định dạng các ô trên bảng tính.
• Thay đổi giá trị của một ô khác.
• Di chuyển, đổi tên, xóa hoặc thêm tờ vào sổ làm việc.
• Thêm tên vào sổ làm việc.
• Đặt thuộc tính.
• Thay đổi bất kỳ tùy chọn môi trường Excel, chẳng hạn như chế độ tính toán hoặc chế độ xem màn hình.

Các chức năng tùy chỉnh của bạn bổ sung có thể đọc thông tin từ các ô bên ngoài ô chạy chức năng tùy chỉnh, nhưng nó không nên thực hiện các hoạt động ghi cho các ô khác. Thay vào đó, hãy thay đổi các ô khác hoặc môi trường Excel từ bối cảnh của nút Ribbon hoặc khung nhiệm vụ. Ngoài ra, các tính toán chức năng tùy chỉnh không nên chạy trong khi tính toán lại Excel đang diễn ra, vì kịch bản này tạo ra kết quả không thể đoán trước.

Bước tiếp theo

• Các khái niệm lập trình cơ bản với API JavaScript Excel

Xem thêm

• Chia sẻ dữ liệu và sự kiện giữa các chức năng tùy chỉnh Excel và Hướng dẫn khung nhiệm vụ
• Định cấu hình bổ trợ văn phòng của bạn để sử dụng thời gian chạy chung

Phản HồI

Gửi và xem ý kiến ​​ph