前言
想要用iOS原生直接导出xls文件,在网上查了下资料,发现iOS原生导出Excel文件的方法,在网上基本就两种方法:
-
使用LibXL库
这个库很强大,具有Excel上的所有属性设置,这个库也很贵:199刀。我知道国内没有多少人愿意买,免费版的也可以用,但是生成的文件第一行会有Created by LibXL trial version. Please buy the LibXL full version for removing this message.
字样,而且据说有行数限制。(光第一行有广告就不能忍了!) -
原生系统方法
在原生里可以利用Excel的换行格式,用系统方法直接写成xls文件,就可以生成Excel文件了。
但是本文介绍的是第三种方法:
-
libxlsxwriter开源库
这是在GitHub上无意间发现的一个很🐂✘的生成Excel文件的第三方开源库。
这个库是个C语言库,可以直接在iOS里使用,而且可以媲美那个收费的LibXL,功能强大,文档齐全,几乎包含Excel中的所有属性设置。本文要介绍的就是这个库的大致使用。
libxlsxwriter使用
libxlsxwriter
有非常齐全的文档,所有函数、属性的使用及参数的含义里面都有详细介绍。这里只大致介绍一下常用的属性设置。
生成xlsx
使用cocoapods
导入libxlsxwriter
,导入头文件:
#import <xlsxwriter.h>
保存文件的路径:
// 文件保存的路径
NSString *documentPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,NSUserDomainMask, YES) objectAtIndex:0];
NSString *filename = [documentPath stringByAppendingPathComponent:@"c_demo.xlsx"];
创建表格workbook
,和工作表worksheet
:
// 创建新xlsx文件,路径需要转成c字符串
lxw_workbook *workbook = workbook_new([filename UTF8String]);
// 创建sheet
lxw_worksheet *worksheet = workbook_add_worksheet(workbook, NULL);
保存生成文件:
workbook_close(workbook);
此时生成文件c_demo.xlsx
,但是没有写入内容,所以是个空的xlsx文件。
注:生成文件是在xlsx文件内的所有内容和单元格格式设置完毕后执行,此处只是介绍如何生成文件。
设置列宽
/* Change the column width for clarity.改变列宽
五个参数分别是:
worksheet Pointer to a lxw_worksheet instance to be updated.
first_col The zero indexed first column.
last_col The zero indexed last column.
width The width of the column(s).
format A pointer to a Format instance or NULL.
从第first_col到last_col的列的宽度为width,索引从0开始 */
worksheet_set_column(worksheet, 4, 5, 50, NULL);
worksheet_set_column(worksheet, COLS("B:D"), 5, NULL);
worksheet_set_column(worksheet, COLS("B:D"), 5, NULL);
此句等同于worksheet_set_column(worksheet, 1, 3, 5, NULL);
注:两个
worksheet_set_column
列宽设置里的列数不能重复,否则前面设置的列数全部无效单元格属性设置
设置单元格格式使用lxw_format
,可以设置字体、颜色、对齐方式、边框等等所有属性。具体属性可阅读参考格式文档。
- 新建单元格格式对象:
lxw_format *format = workbook_add_format(workbook);
- 字体设置:
format_set_bold(format);// 加粗
format_set_font_color(format, LXW_COLOR_RED);//颜色
- 设置对齐方式,所有对齐参数设置参阅:format_set_align
format_set_align(format, LXW_ALIGN_CENTER);// 水平居中
format_set_align(format, LXW_ALIGN_VERTICAL_CENTER);//垂直居中
- 设置边框,所有边框设置参阅:format_set_border
format_set_border(format, LXW_BORDER_MEDIUM);// 边框(四周):中宽边框
format_set_right(format, LXW_BORDER_DOUBLE);// 右边框:双线边框
- 设置数字格式,所有数字格式设置参阅:format_set_num_format
format_set_num_format(format, "¥#,##0.00");
单元格写入数据
- 写入文本和数字:
- 第一个参数是工作表
- 第二个参数是行数(索引从0开始)
- 第三个参数是列数(索引从0开始)
- 第四个参数是写入的内容
- 第五个参数是单元格样式,可为
NULL
。
// 写入文字
worksheet_write_string(worksheet, 1, 0, "Hello", format);
worksheet_write_string(worksheet, 1, 1, "World", NULL);
// 写入数字
worksheet_write_number(worksheet, 2, 0, 123.456, format);
worksheet_write_number(worksheet, 3, 0, 123.456, NULL);
- 数学公式,具体使用参阅:worksheet_write_formula
在(4,0)位置即A5上输出A3和A4的和:
worksheet_write_formula(worksheet, 4, 0, "=SUM(A3:A4)", format);
- 标题栏固定
worksheet_freeze_panes(worksheet, 1, 2);// 标题栏:前1行、前2列固定
这些属性差不多够平时使用的了,想要了解更多属性请阅读文档,里面介绍的都很详细,这里就不再细述了。
本文中所有设置的源码:
// 文件保存的路径
NSString *documentPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,NSUserDomainMask, YES) objectAtIndex:0];
NSString *filename = [documentPath stringByAppendingPathComponent:@"c_demo.xlsx"];
NSLog(@"filepath:%@",filename);
lxw_workbook *workbook = workbook_new([filename UTF8String]);// 创建新xlsx文件,路径需要转成c字符串
lxw_worksheet *worksheet = workbook_add_worksheet(workbook, NULL);// 创建sheet
// 添加格式
lxw_format *format = workbook_add_format(workbook);
//设置格式
format_set_bold(format);
format_set_font_color(format, LXW_COLOR_RED);
format_set_align(format, LXW_ALIGN_CENTER);// 水平居中
format_set_align(format, LXW_ALIGN_VERTICAL_CENTER);//垂直居中
format_set_border(format, LXW_BORDER_MEDIUM);// 边框(四周):中宽边框
format_set_right(format, LXW_BORDER_DOUBLE);// 右边框:双线边框
format_set_num_format(format, "¥#,##0.00");
// 设置列宽
worksheet_set_column(worksheet, 4, 5, 50, NULL);
worksheet_set_column(worksheet, COLS("B:D"), 5, NULL);
//写入数据
worksheet_write_string(worksheet, 1, 0, "Hello", format);
worksheet_write_string(worksheet, 1, 1, "World", NULL);
worksheet_write_number(worksheet, 2, 0, 123.456, format);
worksheet_write_number(worksheet, 3, 0, 123.456, NULL);
worksheet_write_formula(worksheet, 4, 0, "=SUM(A3:A4)", format);
worksheet_freeze_panes(worksheet, 1, 2);// 标题栏:前一行、前2列悬停固定
//关闭,保存文件
workbook_close(workbook);
我做的demo
用代码生成了一个报销表格供自己用,不用每个月去一行一行填了🌚
样子如下:
demo在此,需要的自己看下。