ایجاد کتاب کار اکسل، افزودن صفحات و تصاویر با کتابخانه رایگان Swift

کتابخانه منبع باز Swift که به توسعه‌دهندگان نرم‌افزار امکان ایجاد و صادرات کتاب کار اکسل را می‌دهد. افزودن صفحات کاری جدید، جاسازی تصاویر پیکسل‌پرفکت، داده‌های CSV/TSV، اعمال قالب‌بندی و استایل سلول‌ها به‌صورت رایگان.

XLKit چیست؟

در دنیای سریع توسعه iOS، بهره‌وری بسیار مهم است. نوشتن کدهای تکراری برای کارهای معمولی مانند شبکه‌های واکنش‌گرا، تشخیص دستگاه یا بازخورد حسی می‌تواند حتی توسعه‌دهندگان باتجربه را نیز کند کند. اینجاست که XLKit وارد می‌شود؛ بسته‌ای منبع باز Swift که توسط آمیتاب پاندهی ساخته شده و هدف آن افزایش سرعت کار با SwiftUI از طریق یک جعبه ابزار قدرتمند و انتخاب‌شده از افزونه‌ها و مؤلفه‌هاست. یکی از ویژگی‌های برجسته XLKit، API بدون‌دردسر آن است. این API با در نظر گرفتن تجربه توسعه‌دهنده طراحی شده و یک رابط کاربری روان و قابل زنجیری را فراهم می‌کند که کد شما را تمیز، قابل خواندن و به‌راحتی قابل نگهداری می‌سازد. با خداحافظی از سینتکس پیچیده و خوش‌آمدگویی به روشی طبیعی‌تر برای ساختن صفحات گسترده‌تان، می‌توانید به سرعت کارهای خود را پیش ببرید.

XLKit کتابخانه مدرن و منبع باز Swift است که برای ساده‌سازی ایجاد و دستکاری فایل‌های Excel (.xlsx) در macOS و iOS طراحی شده است. با API روان و قابل زنجیر شدن، امکان وارد کردن تصویر، وارد/صادر کردن CSV/TSV، قالب‌بندی ایمن نوعی و سازگاری بالا با Excel را فراهم می‌کند. XLKit به توسعه‌دهندگان نرم‌افزار این امکان را می‌دهد که به‌راحتی صفحات گسترده حرفه‌ای تولید کنند. این کتابخانه با Swift خالص (Swift 6.0+) ساخته شده و برای macOS 12+ و iOS 15+ هدف‌گذاری شده است و امنیت، عملکرد و طراحی قابل نگهداری را در اولویت دارد. XLKit گواهی بر توان جامعه منبع باز در حل چالش‌های رایج توسعه است. این کتابخانه سعی نمی‌کند یک چارچوب عظیم و همه‌جانبه باشد، بلکه بر ارائه مجموعه‌ای از ابزارهای خوب‌طراحی و عملی تمرکز دارد که توسعه‌دهندگان SwiftUI به‌صورت روزانه از آن استفاده می‌کنند.

Previous Next

شروع کار با XLKit

روش پیشنهادی برای نصب XLKit استفاده از CocoaPods است. لطفاً برای نصب بدون مشکل، فرمان زیر را استفاده کنید.

نصب XLKit از طریق CocoaPods

  // Add XLKit to your Package.swift dependencies:

dependencies: [
    .package(url: "https://github.com/TheAcharya/XLKit.git", from: "1.0.8")
]

نصب XLKit از طریق GitHub

 git clone https://github.com/TheAcharya/XLKit.git

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

ساخت و کار با صفحات گسترده Excel با استفاده از Swift

کتابخانه منبع باز XLKit قابلیت‌های قدرتمندی برای ایجاد و مدیریت فایل‌های صفحه‌گسترده Excel داخل برنامه‌های Swift فراهم کرده است. ابتدا باید یک شیء Workbook ایجاد کنید که تمام برگه‌های کاری شما را شامل می‌شود. یک Workbook می‌تواند چندین برگه کاری داشته باشد. می‌توانید یکی را ایجاد کنید و داده‌ها را به‌صورت مشبه‌جدولی با استفاده از یک آرایه دو بُعدی ([[Cell]]) اضافه کنید. مثال زیر نشان می‌دهد که چگونه توسعه‌دهندگان می‌توانند به‌راحتی یک workbook جدید ایجاد کرده و سپس برگه‌های کاری را داخل آن با استفاده از کد Swift اضافه کنند.

چگونه یک کتاب کار Excel جدید ایجاد کنیم و یک شیت داخل آن اضافه کنیم با استفاده از کتابخانه Swift؟

import XLKit

// Create a new Excel workbook
let workbook = Workbook()

// Add a worksheet named "Sales Report"
let sheet = workbook.addWorksheet("Sales Report")

// Define your data as a 2D array of Cell objects
let data: [[Cell]] = [
    [Cell("Product"), Cell("Q1 Sales"), Cell("Q2 Sales"), Cell("Total")],
    [Cell("Widget A"), Cell(2450), Cell(3105), Cell(5555)],
    [Cell("Widget B"), Cell(1800), Cell(2100), Cell(3900)],
    [Cell("Widget C"), Cell(975), Cell(1225), Cell(2200)]
]

// Add the data to the worksheet starting at cell A1
try? sheet.addData(data, startCell: CellReference(column: 0, row: 0))

جاسازی تصویر پیکسل‌پرفکت با Swift

کتابخانه XLKit مدیریت تصویر را به سطح بالاتری می‌برد با قابلیت‌های تعبیه تصویر بی‌نقص. به‌طور خودکار نسبت ابعاد تصاویر شما را حفظ می‌کند تا در صفحه‌گسترده‌های شما واضح و حرفه‌ای ظاهر شوند. علاوه بر این، کتابخانه دارای قابلیت تنظیم خودکار اندازه سلول‌هاست که عرض ستون‌ها و ارتفاع ردیف‌ها را به‌طور خودکار تنظیم می‌کند تا به‌دقت با تصاویر شما مطابقت داشته باشد. مثال زیر نشان می‌دهد که چگونه توسعه‌دهندگان می‌توانند به‌راحتی یک GIF را داخل یک سلول صفحه‌گسترده با استفاده از API Swift تعبیه کنند.

چگونه یک تصویر GIF را به داخل یک سلول صفحه گسترده وارد کنیم با استفاده از کتابخانه Swift؟

let gifData = try Data(contentsOf: URL(fileURLWithPath: "alice.gif"))
try await sheet.embedImageAutoSized(gifData, at: "B2", of: workbook)

قالب‌بندی جامع سلول‌ها با کتابخانه Swift

یک صفحه‌گسترده حرفه‌ای تماماً به جزئیات بستگی دارد. کتابخانه XLKit مجموعه‌ای غنی از ویژگی‌های فرمت‌بندی سلول ارائه می‌دهد که به توسعه‌دهندگان امکان می‌دهد همه چیز را از رنگ فونت و پس‌زمینه تا حاشیه‌ها و تراز متن کنترل کنند. این امر به کاربران اجازه می‌دهد گزارش‌ها و خروجی‌های داده‌ای جذاب و قابل‌خواندن ایجاد کنند. در اینجا یک مثال مفید آورده شده است که نشان می‌دهد چگونه می‌توان فرمت‌بندی را به یک سلول برگه کاری داخل برنامه‌های Swift اعمال کرد.

چگونه قالب‌بندی را بر روی سلول‌های شیت در برنامه‌های Swift اعمال کنیم؟

sheet.setCell("A1", string: "Name", format: CellFormat.header())
sheet.setCell("B1", string: "Photo", format: CellFormat.header())
sheet.setCell("C1", string: "Age", format: CellFormat.coloredText(color: "#FF0000"))

واردات و صادرات داده‌های CSV/TSV با کتابخانه Swift

در جهان امروز که داده‑محور است، توانایی کار با انواع فرمت‌های داده‌ای بسیار مهم است. کتابخانه منبع باز XLKit چندین ویژگی مهم برای بارگذاری و کار با داده‌های CSV و TSV با استفاده از دستورات Swift را شامل می‌شود. این کتابخانه با پشتیبانی داخلی از واردات و صادرات داده‌های CSV و TSV عرضه شده است، که ادغام گردش کارهای Excel شما با سایر منابع داده و برنامه‌ها را به‌طرزی فوق‌العاده آسان می‌کند.

 فارسی