SheetJS

توفّر إصدار SheetJS المجتمعي حلولاً مفتوحة المصدر مُجرّبة في المعارك لاستخراج بيانات مفيدة من أي جدول بيانات معقّد تقريبًا وإنشاء جداول بيانات جديدة ستعمل مع البرامج القديمة والحديثة على حدٍّ سواء.

يوفّر SheetJS Pro حلولًا تتجاوز معالجة البيانات: حرّر القوالب المعقّدة بسهولة؛ أطلِق العنان لبيكاسو بداخلك عبر التنسيقات؛ أنشئ أوراقًا مخصصة بالصور/الرسوم البيانية/الجداول المحورية؛ قيّم تعبيرات الصيغ وانقل الحسابات إلى تطبيقات الويب؛ أتمتة مهام جداول البيانات الشائعة، والمزيد!

مصفوفة اختبار ودعم المتصفح

صيغ الملفات المدعومة

جدول المحتويات

قم بالتوسيع لعرض جدول المحتويات

• بدء الاستخدام
  • التثبيت
  • الاستخدام
  • فلسفة SheetJS
  • عروض توضيحية للنظام البيئي لجافاسكربت
• الحصول على البيانات واستخراجها
  • تحليل ملفات العمل
  • معالجة بيانات JSON وJS
  • معالجة جداول HTML
• معالجة البيانات
  • تعديل بنية ملف العمل
  • تعديل قيم الخلايا
  • تعديل خصائص أخرى لورقة العمل / ملف العمل / الخلية
• تجميع البيانات وإصدارها
  • كتابة ملفات العمل
  • أمثلة على الكتابة
  • الكتابة بالتدفق
  • توليد بيانات JSON وJS
  • توليد جداول HTML
  • توليد لقطات لورقة عمل مفردة
• الواجهة
  • دوال التحليل
  • دوال الكتابة
  • الأدوات المساعدة
• صيغة الجداول الممتدة الشائعة
  • البنى العامة
  • كائن الخلية
    • أنواع البيانات
    • التواريخ
  • كائنات الأوراق
    • كائن ورقة العمل
    • كائن ورقة المخططات
    • كائن ورقة الماكرو
    • كائن ورقة الحوار
  • كائن ملف العمل
    • خصائص ملف العمل
  • سمات على مستوى ملف العمل
    • الأسماء المعرّفة
    • عروض ملف العمل
    • خصائص ملف العمل المتنوعة
  • ميزات المستند
    • الصيغ
    • خصائص الصفوف والأعمدة
    • تنسيقات الأرقام
    • الروابط التشعبية
    • تعليقات الخلايا
    • رؤية الأوراق
    • VBA والماكرو
• خيارات التحليل
  • نوع الإدخال
  • تخمين نوع الملف
• خيارات الكتابة
  • صيغ الإخراج المدعومة
  • نوع الإخراج
• الدوال المساعدة
  • إدخال مصفوفة من المصفوفات
  • إدخال مصفوفة من الكائنات
  • إدخال جدول HTML
  • إخراج الصيغ
  • إخراج مفصول بمحددات
    • نص يونيكود UTF-16
  • إخراج HTML
  • JSON
• صيغ الملفات
• الاختبار
  • Node
  • المتصفح
  • البيئات المختبرة
  • ملفات الاختبار
• المساهمة
  • OSX/Linux
  • ويندوز
  • الاختبارات
• الترخيص
• المراجع

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

التثبيت

نصوص المتصفح المستقلة

النسخة الكاملة المستقلة للمتصفح محفوظة في dist/xlsx.full.min.js ويمكن إضافتها مباشرة إلى صفحة باستخدام وسم script:```html

<details>
  <summary><b>توفر CDN</b> (انقر للعرض)</summary>

|    CDN     | URL                                        |
|-----------:|:-------------------------------------------|
|    `unpkg` | <https://unpkg.com/xlsx/>                  |
| `jsDelivr` | <https://jsdelivr.com/package/npm/xlsx>    |
|    `CDNjs` | <https://cdnjs.com/libraries/xlsx>         |

على سبيل المثال، يتيح `unpkg` أحدث إصدار على:```html
<script src="https://unpkg.com/xlsx/dist/xlsx.full.min.js"></script>

إصدارات المتصفح (انقر للعرض)

يتم إنشاء إصدار الملف الواحد الكامل في dist/xlsx.full.min.js

dist/xlsx.core.min.js يستبعد مكتبة صفحات الترميز (لا دعم لترميزات XLS)

يتم إنشاء إصدار أخف في dist/xlsx.mini.min.js. مقارنة بالإصدار الكامل:

• يتم تخطي مكتبة صفحات الترميز (لا دعم لترميزات XLS)
• لا دعم لـ XLSB / XLS / Lotus 1-2-3 / SpreadsheetML 2003 / Numbers
• تمت إزالة أدوات دفق node

مع bower:```bash $ bower install js-xlsx

**وحدات ECMAScript**

يتم حفظ نسخة وحدة ECMAScript في `xlsx.mjs` ويمكن إضافتها مباشرة إلى
صفحة باستخدام وسم `script` مع `type=module`:```html
<script type="module">
import { read, writeFileXLSX } from "./xlsx.mjs";

/* load the codepage support library for extended support with older formats  */
import { set_cptable } from "./xlsx.mjs";
import * as cptable from './dist/cpexcel.full.mjs';
set_cptable(cptable);
</script>

حزمة npm تعرض أيضًا الوحدة النمطية باستخدام معامل module، المدعوم في Angular والمشاريع الأخرى:```ts import { read, writeFileXLSX } from "xlsx";

/* load the codepage support library for extended support with older formats */ import { set_cptable } from "xlsx"; import * as cptable from 'xlsx/dist/cpexcel.full.mjs'; set_cptable(cptable);

**Deno**

يمكن استيراد `xlsx.mjs` في Deno. وهو متوفر من `unpkg`:```ts
// @deno-types="https://unpkg.com/xlsx/types/index.d.ts"
import * as XLSX from 'https://unpkg.com/xlsx/xlsx.mjs';

/* load the codepage support library for extended support with older formats  */
import * as cptable from 'https://unpkg.com/xlsx/dist/cpexcel.full.mjs';
XLSX.set_cptable(cptable);

NodeJS

مع npm:```bash $ npm install xlsx

افتراضيًا، تدعم الوحدة `require`:```js
var XLSX = require("xlsx");

توفر الوحدة أيضًا xlsx.mjs للاستخدام مع import:```js import * as XLSX from 'xlsx/xlsx.mjs';

/* load 'fs' for readFile and writeFile support */ import * as fs from 'fs'; XLSX.set_fs(fs);

/* load 'stream' for stream support */ import { Readable } from 'stream'; XLSX.stream.set_readable(Readable);