x-spreadsheet-xiangzi v1.3.4

x-spreadsheet

基于x-spread进行二次开发

1.x-spreadsheet实例在外层有滚动条时 会直接跟着父级滚动下去 x-spreadsheet-xiangzi修复了这个问题

2.对于部分事件绑定 使用passive 减少了一些违规操作

3.取消了selector默认挂载自动获取焦点功能 避免导致外层滚动条滚动

Document

• en
• zh-cn 中文

CDN

<link rel="stylesheet" href="https://unpkg.com/x-data-spreadsheet@1.1.5/dist/xspreadsheet.css" />
<script src="https://unpkg.com/x-data-spreadsheet@1.1.5/dist/xspreadsheet.js"></script>

<script>
  x_spreadsheet('#xspreadsheet')
</script>

NPM

npm i x-spreadsheet-xiangzi

<div id="x-spreadsheet-demo"></div>

import Spreadsheet from 'x-spreadsheet-xiangzi'
// If you need to override the default options, you can set the override
// const options = {};
// new Spreadsheet('#x-spreadsheet-demo', options);
const s = new Spreadsheet('#x-spreadsheet-demo')
  .loadData({}) // load data
  .change(data => {
    // save data to db
  })

// data validation
s.validate()

// default options
{
  mode: 'edit', // edit | read
  showToolbar: true,
  showGrid: true,
  showContextmenu: true,
  view: {
    height: () => document.documentElement.clientHeight,
    width: () => document.documentElement.clientWidth,
  },
  row: {
    len: 100,
    height: 25,
  },
  col: {
    len: 26,
    width: 100,
    indexWidth: 60,
    minWidth: 60,
  },
  style: {
    bgcolor: '#ffffff',
    align: 'left',
    valign: 'middle',
    textwrap: false,
    strike: false,
    underline: false,
    color: '#0a0a0a',
    font: {
      name: 'Helvetica',
      size: 10,
      bold: false,
      italic: false,
    },
  },
}

import | export xlsx

https://github.com/SheetJS/sheetjs/tree/master/demos/xspreadsheet#saving-data

thanks https://github.com/SheetJS/sheetjs

Bind events

const s = new Spreadsheet('#x-spreadsheet-demo')
// event of click on cell
s.on('cell-selected', (cell, ri, ci) => {})
s.on('cells-selected', (cell, { sri, sci, eri, eci }) => {})
// edited on cell
s.on('cell-edited', (text, ri, ci) => {})

update cell-text

const s = new Spreadsheet('#x-spreadsheet-demo')
// cellText(ri, ci, text, sheetIndex = 0)
s.cellText(5, 5, 'xxxx').cellText(6, 5, 'yyy').reRender()

get cell and cell-style

const s = new Spreadsheet('#x-spreadsheet-demo')
// cell(ri, ci, sheetIndex = 0)
s.cell(ri, ci)
// cellStyle(ri, ci, sheetIndex = 0)
s.cellStyle(ri, ci)

Internationalization

// npm
import Spreadsheet from 'x-data-spreadsheet'
import 'x-spreadsheet-xiangzi/dist/locale/zh-cn'
Spreadsheet.locale("zh-cn", (window.x_spreadsheet as any).$messages["zh-cn"]);
new Spreadsheet(document.getElementById('xss-demo'))

<!-- Import via CDN -->
<link rel="stylesheet" href="https://unpkg.com/x-data-spreadsheet@1.1.5/dist/xspreadsheet.css" />
<script src="https://unpkg.com/x-data-spreadsheet@1.1.5/dist/xspreadsheet.js"></script>
<script src="https://unpkg.com/x-data-spreadsheet@1.1.5/dist/locale/zh-cn.js"></script>

<script>
  x_spreadsheet.locale('zh-cn')
</script>

Features

• Undo & Redo
• Paint format
• Clear format
• Format
• Font
• Font size
• Font bold
• Font italic
• Underline
• Strike
• Text color
• Fill color
• Borders
• Merge cells
• Align
• Text wrapping
• Freeze cell
• Functions
• Resize row-height, col-width
• Copy, Cut, Paste
• Autofill
• Insert row, column
• Delete row, column
• hide row, column
• multiple sheets
• print
• Data validations

Development

git clone https://github.com/LianXiaoxiang/x-spreadsheet-xiangzi
cd x-spreadsheet
npm install
npm run dev

Open your browser and visit http://127.0.0.1:8080.

Browser Support

Modern browsers(chrome, firefox, Safari).

LICENSE

MIT