Màu nền ô exceljs

Các ô riêng lẻ [hoặc nhiều nhóm ô] có thể được gán tên cho chúng. Tên có thể được sử dụng trong công thức và xác thực dữ liệu [và có thể hơn thế nữa]

var workbook = new Excel.Workbook[];

5

Xác thực dữ liệu

Các ô có thể xác định giá trị nào hợp lệ hoặc không và cung cấp lời nhắc cho người dùng để giúp hướng dẫn họ

Các loại xác thực có thể là một trong những loại sau

TypeDescriptionlistXác định một tập hợp các giá trị hợp lệ riêng biệt. Excel sẽ cung cấp những giá trị này trong danh sách thả xuống để dễ dàng nhập toàn bộ Giá trị phải là số nguyên thập phân Giá trị phải là số thập phân văn bản Độ dài Giá trị có thể là văn bản nhưng độ dài được kiểm soát tùy chỉnh Một công thức tùy chỉnh kiểm soát các giá trị hợp lệ

Đối với các loại không phải danh sách hoặc tùy chỉnh, các toán tử sau ảnh hưởng đến việc xác thực

Toán tử Mô tảbetweenValues ​​phải nằm giữa các kết quả công thứckhông phảiBetweenValues ​​không được nằm giữa các kết quả của công thứcrequalValue phải bằng công thức resultnotEqualValue không được bằng công thức resultgreaterThanValue phải lớn hơn công thức resultlessThanValue phải nhỏ hơn công thức resultGreaterThanOrEqualValue phải lớn hơn hoặc bằng công thức resultlessThanOrEqualValue phải nhỏ hơn hoặc bằng công thức

var workbook = new Excel.Workbook[];

6

phong cách

Mỗi ô, hàng và cột hỗ trợ một tập hợp phong phú các kiểu và định dạng ảnh hưởng đến cách các ô được hiển thị

Các kiểu được đặt bằng cách gán các thuộc tính sau

• numFmt
• nét chữ
• căn chỉnh
• biên giới
• lấp đầy

var workbook = new Excel.Workbook[];

7

Khi một kiểu được áp dụng cho một hàng hoặc cột, nó sẽ được áp dụng cho tất cả các ô hiện có trong hàng hoặc cột đó. Ngoài ra, bất kỳ ô mới nào được tạo sẽ kế thừa các kiểu ban đầu của nó từ hàng và cột mà ô đó thuộc về

Nếu cả hàng và cột của một ô đều xác định một kiểu cụ thể [e. g. phông chữ], ô sẽ sử dụng kiểu hàng trên kiểu cột. Tuy nhiên, nếu hàng và cột xác định các kiểu khác nhau [e. g. cột. numFmt và hàng. phông chữ], ô sẽ kế thừa phông chữ từ hàng và numFmt từ cột

báo trước. Tất cả các thuộc tính trên [ngoại trừ numFmt, là một chuỗi], là các cấu trúc đối tượng JS. Nếu cùng một đối tượng kiểu được gán cho nhiều thực thể bảng tính thì mỗi thực thể sẽ chia sẻ cùng một đối tượng kiểu. Nếu đối tượng kiểu được sửa đổi sau đó trước khi bảng tính được đánh số thứ tự, thì tất cả các thực thể tham chiếu đến đối tượng kiểu đó cũng sẽ được sửa đổi. Hành vi này nhằm ưu tiên hiệu suất bằng cách giảm số lượng đối tượng JS được tạo. Nếu bạn muốn các đối tượng kiểu độc lập, bạn cần sao chép chúng trước khi gán chúng. Ngoài ra, theo mặc định, khi tài liệu được đọc từ tệp [hoặc luồng] nếu các thực thể bảng tính có chung kiểu, thì chúng cũng sẽ tham chiếu cùng một đối tượng kiểu

định dạng số

var workbook = new Excel.Workbook[];

8

Phông chữ

var workbook = new Excel.Workbook[];

9

Thuộc tính phông chữ Mô tả Ví dụ Giá trị tên Tên phông chữ. 'Arial', 'Calibri', v.v. gia đìnhGia đình phông chữ. Một giá trị số nguyên. 1,2,3, v.v. sơ đồ lược đồ phông chữ. 'phụ', 'chính', 'không'bộ ký tựBộ ký tự phông chữ. Một giá trị số nguyên. 1, 2, v.v. mô tả colorColour, một đối tượng chứa giá trị ARGB. { argb. 'FFFF0000'}Trọng lượng phông chữ đậmtrue, falseitalicPhông chữ độ dốctrue, falseunderlineKiểu gạch chân phông chữtrue, false, 'none', 'single', 'double', 'singleAccounting', 'doubleAccounting'strikeFont gạch ngangtrue, falseoutlinePhông ngoài phông chữtrue, false

căn chỉnh

workbook.creator = 'Me';
workbook.lastModifiedBy = 'Her';
workbook.created = new Date[1985, 8, 30];
workbook.modified = new Date[];

0

Giá trị thuộc tính căn chỉnh hợp lệ

ngang dọc bao bọc Văn bản thụt lề đọc Thứ tựvăn bảnXoay tráitrên cùngđúngsố nguyênrtl0 đến 90trung tâmfalstr-1 đến -90phảidưới cùngdọcđiềnphân phốibiện minhbiện minhtrung tâmLiên tụcphân phối

biên giới

workbook.creator = 'Me';
workbook.lastModifiedBy = 'Her';
workbook.created = new Date[1985, 8, 30];
workbook.modified = new Date[];

1

Kiểu viền hợp lệ

• gầy
• say mê
• đi thẳng
• tóc
• dấu gạch ngangDotDot
• nghiêngDashDot
• trung bìnhDashed
• trung bìnhDashDotDot
• trung bìnhDashDot
• vừa phải
• kép
• đặc

lấp đầy

workbook.creator = 'Me';
workbook.lastModifiedBy = 'Her';
workbook.created = new Date[1985, 8, 30];
workbook.modified = new Date[];

2

Điền mẫu

PropertyRequiredDescriptiontypeYValue. 'pattern'
Chỉ định cách tô màu này sử dụng các mẫupatternYSchỉ định loại mẫu [xem Các loại mẫu hợp lệ bên dưới]fgColorNSchỉ định màu nền trước của mẫu. Mặc định là màu đen. bgColorNSChỉ định màu nền của mẫu. Mặc định là màu trắng

Các loại mẫu hợp lệ

• không ai
• chất rắn
• tốiDọc
• màu xám đen
• trung bìnhXám
• xám nhạt
• xám125
• xám0625
• tốiNgang
• tốiDọc
• bóng tối
• tốiUp
• lưới tối
• bóng tốiTrellis
• ánh sáng Ngang
• ánh sángDọc
• ánh sáng xuống
• chiếu sáng
• ánh sángLưới
• ánh sángTrellis
• ánh sángLưới

Đổ dốc màu

PropertyRequiredDescriptiontypeYValue. 'gradient'
Chỉ định màu tô này sử dụng gradientsgradientYSChỉ định loại gradient. Một trong ['góc', 'đường dẫn']độ gócĐối với độ dốc 'góc', chỉ định hướng của độ dốc. 0 là từ trái sang phải. Các giá trị từ 1 - 359 xoay hướng theo chiều kim đồng hồđường dẫn trung tâmĐối với độ dốc 'đường dẫn'. Chỉ định tọa độ tương đối cho điểm bắt đầu của đường dẫn. Các giá trị 'trái' và 'trên cùng' nằm trong khoảng từ 0 đến 1 điểm dừngYChỉ định chuỗi màu gradient. Là một mảng các đối tượng chứa vị trí và màu sắc bắt đầu từ vị trí 0 và kết thúc bằng vị trí 1. Các vị trí trung gian có thể được sử dụng để chỉ định các màu khác trên đường dẫn.

Hãy cẩn thận

Sử dụng giao diện ở trên, có thể tạo các hiệu ứng tô màu chuyển sắc không thể thực hiện được bằng chương trình soạn thảo XLSX. Ví dụ: Excel chỉ hỗ trợ độ dốc góc là 0, 45, 90 và 135. Tương tự, chuỗi các điểm dừng cũng có thể bị giới hạn bởi giao diện người dùng với các vị trí [0,1] hoặc [0,0. 5,1] là tùy chọn duy nhất. Hãy cẩn thận với phần điền này để đảm bảo nó được người xem XLSX mục tiêu hỗ trợ

Văn bản phong phú

Các ô riêng lẻ hiện hỗ trợ văn bản có định dạng hoặc định dạng trong ô. Các giá trị văn bản có định dạng có thể kiểm soát các thuộc tính phông chữ của bất kỳ số lượng chuỗi con nào trong giá trị văn bản. Xem Phông chữ để biết danh sách chi tiết đầy đủ về những thuộc tính phông chữ nào được hỗ trợ

workbook.creator = 'Me';
workbook.lastModifiedBy = 'Her';
workbook.created = new Date[1985, 8, 30];
workbook.modified = new Date[];

3

Cấp phác thảo

Excel hỗ trợ lập dàn ý;

Mức độ phác thảo có thể được xác định trong thiết lập cột

workbook.creator = 'Me';
workbook.lastModifiedBy = 'Her';
workbook.created = new Date[1985, 8, 30];
workbook.modified = new Date[];

4

Hoặc trực tiếp trên hàng hoặc cột

workbook.creator = 'Me';
workbook.lastModifiedBy = 'Her';
workbook.created = new Date[1985, 8, 30];
workbook.modified = new Date[];

5

Các mức phác thảo trang tính có thể được đặt trên trang tính

workbook.creator = 'Me';
workbook.lastModifiedBy = 'Her';
workbook.created = new Date[1985, 8, 30];
workbook.modified = new Date[];

6

Ghi chú. điều chỉnh mức đại cương trên hàng hoặc cột hoặc mức đại cương trên trang tính sẽ phát sinh tác dụng phụ của việc sửa đổi thuộc tính thu gọn của tất cả các hàng hoặc cột bị ảnh hưởng bởi thay đổi thuộc tính. e. g

workbook.creator = 'Me';
workbook.lastModifiedBy = 'Her';
workbook.created = new Date[1985, 8, 30];
workbook.modified = new Date[];

7

Tập tin vào/ra

XLSX

Đọc XLSX

workbook.creator = 'Me';
workbook.lastModifiedBy = 'Her';
workbook.created = new Date[1985, 8, 30];
workbook.modified = new Date[];

8

Viết XLSX

workbook.creator = 'Me';
workbook.lastModifiedBy = 'Her';
workbook.created = new Date[1985, 8, 30];
workbook.modified = new Date[];

9

CSV

Đọc CSV

var workbook = new Excel.Workbook[];

50

Trình phân tích cú pháp CSV sử dụng fast-csv để đọc tệp CSV. Các tùy chọn được chuyển vào các chức năng đọc ở trên cũng được chuyển tới fast-csv để phân tích cú pháp dữ liệu csv. Vui lòng tham khảo README nhanh csv. md để biết chi tiết

Ngày được phân tích cú pháp bằng thời điểm mô-đun npm. Nếu không có định dạng ngày tháng nào được cung cấp, những điều sau đây được sử dụng

• khoảng khăc. ISO_8601
• 'MM-DD-YYYY'
• 'YYYY-MM-DD'

Viết CSV

var workbook = new Excel.Workbook[];

51

Trình phân tích cú pháp CSV sử dụng fast-csv để ghi tệp CSV. Các tùy chọn được chuyển vào các hàm ghi ở trên cũng được chuyển tới fast-csv để ghi dữ liệu csv. Vui lòng tham khảo README nhanh csv. md để biết chi tiết

Ngày được định dạng bằng thời điểm mô-đun npm. Nếu không có dateFormat được cung cấp, thời điểm. ISO_8601 được sử dụng

Truyền I/O

Tệp I/O được ghi lại ở trên yêu cầu toàn bộ sổ làm việc được tạo trong bộ nhớ trước khi tệp có thể được ghi. Mặc dù thuận tiện nhưng nó có thể giới hạn kích thước của tài liệu do dung lượng bộ nhớ cần thiết

Trình ghi trực tuyến [hoặc trình đọc] xử lý dữ liệu sổ làm việc hoặc trang tính khi nó được tạo, chuyển đổi nó thành dạng tệp khi nó di chuyển. Thông thường, điều này hiệu quả hơn nhiều đối với bộ nhớ vì dung lượng bộ nhớ cuối cùng và thậm chí cả dung lượng bộ nhớ trung gian nhỏ gọn hơn nhiều so với phiên bản tài liệu, đặc biệt khi bạn xem xét rằng các đối tượng hàng và ô được xử lý sau khi chúng được cam kết

Giao diện của sổ làm việc và trang tính phát trực tuyến gần giống như các phiên bản tài liệu với một số khác biệt nhỏ về mặt thực tế

• Sau khi một trang tính được thêm vào sổ làm việc, nó không thể bị xóa
• Sau khi một hàng được cam kết, nó sẽ không thể truy cập được nữa vì nó sẽ bị xóa khỏi trang tính
• unMerge Cells[] không được hỗ trợ

Lưu ý rằng có thể xây dựng toàn bộ sổ làm việc mà không cần cam kết bất kỳ hàng nào. Khi sổ làm việc được cam kết, tất cả các trang tính đã thêm [bao gồm tất cả các hàng không được cam kết] sẽ tự động được cam kết. Tuy nhiên, trong trường hợp này, sẽ thu được rất ít so với phiên bản Tài liệu

Truyền trực tuyến XLSX

Trình ghi XLSX trực tuyến

Trình ghi XLSX phát trực tuyến có sẵn trong ExcelJS. dòng. không gian tên xlsx

Hàm tạo lấy một đối tượng tùy chọn tùy chọn với các trường sau

FieldDescriptionstreamChỉ định luồng có thể ghi để ghi sổ làm việc XLSX vào. tên tệpNếu luồng không được chỉ định, trường này chỉ định đường dẫn đến tệp để ghi sổ làm việc XLSX vào. useSharedStringsChỉ định xem có sử dụng chuỗi chia sẻ trong sổ làm việc hay không. Mặc định là falseuseStylesChỉ định có thêm thông tin kiểu dáng vào sổ làm việc hay không. Các kiểu có thể thêm một số chi phí hoạt động. Mặc định là sai

Nếu cả luồng và tên tệp đều không được chỉ định trong các tùy chọn, trình ghi sổ làm việc sẽ tạo một đối tượng StreamBuf sẽ lưu trữ nội dung của sổ làm việc XLSX trong bộ nhớ. Đối tượng StreamBuf này, có thể được truy cập thông qua sổ làm việc thuộc tính. luồng, có thể được sử dụng để truy cập trực tiếp các byte theo luồng. read[] hoặc chuyển nội dung sang luồng khác

var workbook = new Excel.Workbook[];

52

Nói chung, giao diện của trình ghi XLSX phát trực tuyến giống như sổ làm việc Tài liệu [và trang tính] được mô tả ở trên, trên thực tế, các đối tượng hàng, ô và kiểu đều giống nhau

Tuy nhiên có một số khác biệt

Sự thi công

Như đã thấy ở trên, WorkbookWriter thường sẽ yêu cầu luồng đầu ra hoặc tệp được chỉ định trong hàm tạo

Cam kết dữ liệu

Khi một hàng của trang tính đã sẵn sàng, nó phải được cam kết để có thể giải phóng đối tượng hàng và nội dung. Thông thường, điều này sẽ được thực hiện khi mỗi hàng được thêm vào

var workbook = new Excel.Workbook[];

53

Lý do WorksheetWriter không cam kết các hàng khi chúng được thêm vào là để cho phép các ô được hợp nhất trên các hàng

var workbook = new Excel.Workbook[];

54

Khi mỗi trang tính được hoàn thành, nó cũng phải được cam kết

var workbook = new Excel.Workbook[];

55

Để hoàn thành tài liệu XLSX, sổ làm việc phải được cam kết. Nếu bất kỳ trang tính nào trong sổ làm việc không được cam kết, chúng sẽ được cam kết tự động như một phần của cam kết sổ làm việc

var workbook = new Excel.Workbook[];

56

Các loại giá trị

Các loại giá trị sau được hỗ trợ

Enum Tên Enum Mô tả Ví dụ Giá trị Excel. Loại giá trị. Null0Không có giá trị. nullExcel. Loại giá trị. Hợp nhất/IN/Excel. Loại giá trị. Số2A giá trị số3. 14Excel. Loại giá trị. Giá trị văn bản String3A'Xin chào, Thế giới. 'xuất sắc. Loại giá trị. Date4A Giá trị ngày mới Ngày[] Excel. Loại giá trị. Hyperlink5A siêu liên kết{ văn bản. 'www. liên kết của tôi. com', siêu liên kết. 'http. //www. liên kết của tôi. com' }Excel. Loại giá trị. Công thức6A công thức{ công thức. 'A1+A2', kết quả. 7 }Thay đổi giao diện

Mọi nỗ lực được thực hiện để tạo ra một giao diện nhất quán tốt, không vượt qua các phiên bản nhưng rất tiếc, đôi khi một số thứ phải thay đổi để tốt hơn

Giao diện ngắt trong 0. 1. 0

bảng tính. từng hàng

Các đối số trong hàm gọi lại Worksheet. eachRow đã được hoán đổi và thay đổi; . each] và ưu tiên đối tượng hàng trên số hàng

bảng tính. getRow

Hàm này đã thay đổi từ trả về một mảng thưa thớt các giá trị ô thành trả về một đối tượng Row. Điều này cho phép truy cập các thuộc tính hàng và sẽ tạo điều kiện thuận lợi cho việc quản lý các kiểu hàng, v.v.