Axlsx：Office Open XML电子表格生成器

Axlsx：Office Open XML电子表格生成器

axlsx xlsx generation with charts, images, automated column width, customizable styles and full schema validation. Axlsx excels at helping you generate beautiful Office Open XML Spreadsheet documents without having to understand the entire ECMA specification. Check out the README for some examples of how easy it is. Best of all, you can validate your xlsx file before serialization so you know for sure that anything generated is going to load on your client's machine.项目地址:https://gitcode.com/gh_mirrors/ax/axlsx

项目介绍

Axlsx是一个用于Ruby编程语言的Office Open XML电子表格生成库。它使开发者能够轻松快捷地创建专业的xlsx报告，并支持图表、图片（含链接）、自动及固定列宽、自定义样式、函数、数据表、条件格式化、打印选项、评论、合并单元格、自动过滤器等特性。无需深入理解整个ECMA规范，即可生成符合标准且美观的Excel文档。此项目采用MIT许可证发布。

项目快速启动

要开始使用Axlsx，首先确保你的环境中安装了Ruby版本在2.2.7及以上。接下来，通过以下命令将Axlsx添加到你的项目中：

gem 'axlsx', '~> 3.0'

然后，在你的Ruby脚本中引入Axlsx并创建一个简单的电子表格：

require 'axlsx'

Axlsx::Package.new do |p|
  p.workbook.add_worksheet(name: "Sheet 1") do |sheet|
    sheet.add_row ['Column1', 'Column2']
    sheet.add_row ['Data1', 'Data2']
    sheet.styles do |style|
      style.font.b = true
      style.font.sz = 14
    end
  end
  p.serialize('example.xlsx')
end

这段代码将会生成一个名为example.xlsx的文件，其中包含一个带有两列标题和一行数据的简单工作表，并设置了字体加粗和大小。

应用案例和最佳实践

Axlsx非常适合于报告生成场景，比如月度销售数据分析。例如，利用其数据表和图表功能，可以自动化地从数据库抽取销售数据，绘制销售趋势图，并自动调整列宽以优化视图体验。最佳实践中，应充分利用Axlsx提供的验证功能，在序列化文件前检查文档的有效性，确保跨不同客户端的兼容性。

# 假设data是从数据库获取的数据数组
data = [...] # 数据填充
package = Axlsx::Package.new
 workbook = package.workbook
 workbook.add_worksheet(name: "Sales Data") do |sheet|
   # 添加数据和格式设置...
 end
 # 在这里你可以验证电子表格的内容和结构
 package.validate
 package.serialize("sales_report.xlsx")

典型生态项目

Axlsx作为主库，支持多种扩展场景。如需在Rails项目中集成，可以考虑使用acts_as_xlsx，这是一个简单的ActiveRecord混入，允许直接从模型生成Excel文件。此外，axlsx_rails提供了在Rails应用程序中嵌入Excel文件的功能，使得在视图层直接生成下载链接成为可能。

社区还维护了一个相关的组织caxlsx，包含更多围绕Axlsx生态的工具和扩展，适合那些寻求更广泛特性和支持的开发者。

Axlsx强大的生态系统和灵活的API设计，使其成为处理电子表格需求时的首选工具之一，无论是基本的数据导出还是复杂的报表制作。

---

以上即是对Axlsx项目的一个简明教程，包含了从基础使用到进一步探索的路径，希望对您有所帮助。

axlsx xlsx generation with charts, images, automated column width, customizable styles and full schema validation. Axlsx excels at helping you generate beautiful Office Open XML Spreadsheet documents without having to understand the entire ECMA specification. Check out the README for some examples of how easy it is. Best of all, you can validate your xlsx file before serialization so you know for sure that anything generated is going to load on your client's machine.项目地址:https://gitcode.com/gh_mirrors/ax/axlsx