برای ایجاد و ویرایش صفحه گسترده XLSX، کتابخانه روبی منبع باز کنید

شروع کار با Axlsx

روش توصیه شده برای نصب کتابخانه Axlsx استفاده از RubyGems است. لطفا برای نصب راحت از دستور زیر استفاده کنید.

$ gem install axlsx 

صفحه گسترده با نمودارها از طریق Ruby ایجاد کنید

کتابخانه Axlsx این امکان را برای برنامه نویسان نرم افزار ایجاد می کند که صفحات گسترده Excel را در برنامه های Ruby خود ایجاد کنند. این کتابخانه از افزودن نمودارها به صفحه گسترده خود تنها با چند خط کد پشتیبانی می کند. توسعه دهندگان را قادر می سازد تا نمودارهای سه بعدی پای، خط، پراکندگی و میله ای را به راحتی تولید کنند. این کتابخانه به کاربران اجازه می دهد تا نمودارهایی را بر اساس داده های سفارشی بسازند و همچنین نمودارهایی را بدون هیچ داده ای در کاربرگ خود تولید کنند. شما به راحتی می توانید خطوط شبکه، چرخش برچسب و موارد دیگر را سفارشی کنید.

از صفحه گسترده از طریق Ruby API محافظت کنید

کتابخانه منبع باز Axlsx به برنامه نویسان Ruby این امکان را می دهد که از صفحه گسترده با اعمال رمز عبور در برنامه های خود محافظت کنند. این یک تکنیک بسیار مفید است که از ایجاد هرگونه تغییر یا مشاهده، جابجایی یا حذف داده های مهم از کاربرگ توسط افراد دیگر جلوگیری می کند. این کتابخانه شامل پشتیبانی از ایجاد کاربرگ محافظت شده با رمز عبور و همچنین بدون رمز عبور تنها با چند خط کد است.

# Sheet Protection and excluding cells from locking.
if examples.include? :sheet_protection
  unlocked = wb.styles.add_style :locked => false
  wb.add_worksheet(:name => 'Sheet Protection') do |sheet|
    sheet.sheet_protection do |protection|
      protection.password = 'fish'
      protection.auto_filter = false
    end
    sheet.add_row [1, 2 ,3],  :style => unlocked # These cells will be locked
    sheet.add_row [4, 5, 6]
    sheet.add_row [7, 8, 9]
    sheet.auto_filter = "A1:C3"
  end
end

اعمال سبک های سفارشی در کاربرگ ها

سبک های سفارشی یک راه بسیار راحت برای صرفه جویی در وقت کاربران هنگام قالب بندی کاربرگ های خود هستند. کتابخانه Axlsx عملکرد کاملی را برای اعمال سبک و قالب بندی سفارشی در صفحه گسترده اکسل با استفاده از کد Ruby ارائه کرده است. این کتابخانه قالب بندی ثابتی را در طیف وسیعی از سلول ها ارائه کرده است. توسعه‌دهندگان به راحتی می‌توانند به حاشیه‌ها استایل بدهند، از تراز استفاده کنند، پرشده‌ها را اعمال کنند، فونت‌ها و قالب‌های اعداد را در یک خط کد Ruby انتخاب کنند.

#```ruby
if examples.include? :format_dates
  require 'date'
  wb.styles do |s|
    date = s.add_style(:format_code => "yyyy-mm-dd", :border => Axlsx::STYLE_THIN_BORDER)
    padded = s.add_style(:format_code => "00#", :border => Axlsx::STYLE_THIN_BORDER)
    percent = s.add_style(:format_code => "0000%", :border => Axlsx::STYLE_THIN_BORDER)
    # wb.date1904 = true # Use the 1904 date system (Used by Excel for Mac < 2011)
    wb.add_worksheet(:name => "Formatting Data") do |sheet|
      sheet.add_row ["Custom Formatted Date", "Percent Formatted Float", "Padded Numbers"], :style => Axlsx::STYLE_THIN_BORDER
      sheet.add_row [Date::strptime('2012-01-19','%Y-%m-%d'), 0.2, 32], :style => [date, percent, padded]
    end
  end
end
#```

درج تصاویر و پیوندها به صفحات گسترده

کتابخانه رایگان Axlsx تنها با چند دستور Ruby پشتیبانی کاملی را برای افزودن و اصلاح تصاویر در برگه های خود ارائه کرده است. شما می توانید از فرمت های تصویری محبوب مانند تصاویر JPG، GIF و PNG در داخل یک کاربرگ استفاده کنید. شما همچنین می توانید تصاویر را با لینک ها درج کنید. این کتابخانه همچنین امکان جایگزینی یک تصویر موجود یا تغییر اندازه و مکان آن را می دهد.

##Add an Image with a hyperlink
#```ruby
if examples.include? :images
  wb.add_worksheet(:name => "Image with Hyperlink") do |sheet|
    img = File.expand_path('../image1.jpeg', __FILE__)
    # specifying the :hyperlink option will add a hyper link to your image.
    #
    # @note - Numbers does not support this part of the specification.
    sheet.add_image(:image_src => img, :noSelect => true, :noMove => true, :hyperlink=>"http://axlsx.blogspot.com") do |image|
      image.width=720
      image.height=666
      image.hyperlink.tooltip = "Labeled Link"
      image.start_at 0, 0
    end