کتابخانه سوئیفت منبع باز برای صفحات گسترده مایکروسافت^® Excel

شروع به کار با CoreXLSX

روش توصیه شده برای نصب CoreXLSX استفاده از CocoaPods است. لطفا از دستور زیر برای نصب راحت استفاده کنید.

 pod 'CoreXLSX', '~> 0.14.1'

pod install
 می‌توانید آن را مستقیماً از GitHub دانلود کنید. 

خواندن فایل اکسل XLSX داده از طریق Swift API

کتابخانه منبع باز CoreXLSX به توسعه دهندگان Swift اجازه می دهد تا یک سند اکسل XLSX موجود را باز کنند، با استفاده از دستورات Swift داده ها را از آن بخوانند و دریافت کنند. برای دریافت داده ها از یک فایل اکسل، ابتدا باید فایل را بارگیری کنید و سپس با استفاده از روش sheet(named:) به کاربرگ های جداگانه در فایل دسترسی داشته باشید. پس از دسترسی به برگه، می‌توانید روی ردیف‌ها و ستون‌های آن تکرار کنید تا مقادیر سلول‌ها را بخوانید. مثال زیر نحوه خواندن اولین کاربرگ فایل اکسل در مسیر مشخص شده را نشان می دهد و محتویات هر سلول در کاربرگ را چاپ می کند.

import CoreXLSX

guard let file = XLSXFile(filepath: "path/to/file.xlsx") else {
    fatalError("XLSX file not found")
}

do {
    let sheet = try file.parseWorksheet(at: 0)
    for row in sheet.data?.rows ?? [] {
        for cell in row.cells {
            print(cell)
        }
    }
} catch {
    print(error.localizedDescription)
}

جستجو و یافتن سلول با استفاده از Swift API

کتابخانه منبع باز CoreXLSX ویژگی بسیار مفیدی را ارائه کرده است که به توسعه دهندگان نرم افزار اجازه می دهد تا داده های سلولی یک کاربرگ را با استفاده از یک مرجع سلول در داخل برنامه Swift خود جستجو کنند. این کتابخانه ویژگی "worksheet.cells" را فراهم کرده است که به توسعه دهندگان اجازه می دهد به سلول های کاربرگ دسترسی داشته باشند. سپس، از روش «at» برای دریافت سلول با مرجع مشخص شده استفاده کنید. مثال زیر نحوه دسترسی به سلول‌های خاص در کاربرگ را با استفاده از کد Swift نشان می‌دهد.

import CoreXLSX

# Load Excel File 

guard let file = XLSXFile(filepath: "/path/to/your/file.xlsx") else {
    fatalError("XLSX file at path not found")
}

# Access the worksheet that contains the cell

guard let worksheet = try file.parseWorksheet(at: "/xl/worksheets/sheet1.xml") else {
    fatalError("Worksheet not found")
}

# access the cells in the worksheet
guard let cell = worksheet.cells[at: "B3"] else {
    fatalError("Cell not found")
}

# Display Cell Value

print(cell.value)

تجزیه اطلاعات سبک فایل XLSX از طریق Swift API

کتابخانه منبع باز CoreXLSX از نسخه 0.5.0 دارای ویژگی بسیار مفیدی برای تجزیه اطلاعات سبک فایل XLSX است. توسعه دهندگان نرم افزار می توانند از تابع جدید parseStyles() برای تجزیه اطلاعات سبک از آرشیو داخل برنامه Swift خود استفاده کنند. این کتابخانه به توسعه دهندگان این امکان را می دهد که لیستی از فونت های مورد استفاده را دریافت کنند، قالب بندی یک سلول معین را دریافت کنند، اطلاعات پر و حاشیه و غیره را دریافت کنند. کد زیر نشان می دهد که لیست فونت های استفاده شده و قالب بندی یک سلول معین را با استفاده از دستورات Swift دریافت می کند.

let styles = try file.parseStyles()
let fonts = styles.fonts?.items.compactMap { $0.name?.value }

//get formatting for a given cell

let styles = try file.parseStyles()
let format = worksheet.data?.rows.first?.cells.first?.format(in: styles)
let font = worksheet.data?.rows.first?.cells.first?.font(in: styles)