مكتبة Swift مفتوحة المصدر لجداول بيانات Microsoft^® Excel

البدء باستخدام CoreXLSX

الطريقة الموصى بها لتثبيت CoreXLSX هي استخدام CocoaPods. الرجاء استخدام الأمر التالي للتثبيت السلس.

 pod 'CoreXLSX', '~> 0.14.1'

pod install
 يمكنك تنزيله مباشرةً من GitHub. 

قراءة بيانات ملف Excel XLSX عبر Swift API

تسمح مكتبة CoreXLSX مفتوحة المصدر لمطوري Swift بفتح مستند Excel XLSX موجود وقراءته والحصول على البيانات منه باستخدام أوامر Swift. للحصول على بيانات من ملف Excel، تحتاج أولاً إلى تحميل الملف ومن ثم يمكنك الوصول إلى أوراق العمل الفردية في الملف باستخدام طريقة الورقة (المسماة:). بعد الوصول إلى الورقة، يمكنك التكرار على صفوفها وأعمدتها لقراءة قيم الخلية. يوضح المثال التالي كيفية قراءة ورقة العمل الأولى في ملف Excel في المسار المحدد وطباعة محتويات كل خلية في ورقة العمل.

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 مفتوحة المصدر ميزة مفيدة جدًا لتحليل معلومات النمط لملف XLSX منذ الإصدار 0.5.0. يمكن لمطوري البرامج استخدام وظيفة 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)