확대/축소

SpreadJS를 사용하여 다양한 상세 수준의 워크시트 view를 확대/축소할 수 있습니다.

또한 ViewZooming 및 ViewZoomed 이벤트를 사용하여 줌 레벨을 제어할 수 있습니다.

설명
app.jsx
app-func.jsx
app-class.jsx
index.html
styles.css

확대/축소 수행

  • Ctrl + 마우스 휠
  • 상태 표시줄 확대/축소 표시기
  • 두 손가락으로 작동, 터치식만 가능
  • sheet.zoom(zoomFactor) API 사용

allowUserZoom의 스프레드 옵션

시트 뷰포트의 확대/축소 여부를 제어하는 스프레드 옵션을 제공합니다.

spread.options.allowUserZoom = true;

API를 통해 확대/축소 배율을 가져오거나 설정합니다.

// 확대/축소 배율을 가져옵니다.
sheet.zoom();
// 줌 배율을 0.25 ~ 4 사이로 설정합니다.
sheet.zoom(zoomFactor);

ViewZooming / ViewZoomed 이벤트

서로 다른 워크시트/ 스프레드 인스턴스의 확대/축소 프로세스에 개입하기 위해 두 가지 이벤트를 제공합니다.

GC.Spread.Sheets.Events.ViewZooming

handler 함수에 사용할 수 있는 인수는 다음과 같습니다.

  • sheet: 이벤트를 트리거한 시트
  • sheetName: 시트의 이름
  • newZoomFactor: 새로운 확대/축소 배율, 사용자는 실제 확대/축소 액션을 간섭하기 위해 약간의 변경을 할 수 있습니다.
  • oldZoomFactor: 이전 확대축소 배율
  • cancel: 작업을 취소할지 여부를 나타내는 값

GC.Spread.Sheets.Events.ViewZoomed

handler 함수에서 사용 가능한 인수

  • sheet: 이벤트를 트리거한 시트
  • sheetName: 시트의 이름
  • newZoomFactor: 새로운 확대/축소 배율, 사용자는 실제 확대/축소 액션을 간섭하기 위해 약간의 변경을 할 수 있습니다.
  • oldZoomFactor: 이전 확대축소 배율
// 샘플: 확대 비율을 1에서 2로 제한합니다.
spread.bind(GC.Spread.Sheets.Events.ViewZooming, function(e, args) {
    if (args.newZoomFactor >=2) {
        args.newZoomFactor = 2;
    }
    if (args.newZoomFactor <= 1) {
        args.newZoomFactor = 1;
    }
});
확대/축소 수행 Ctrl + 마우스 휠 상태 표시줄 확대/축소 표시기 두 손가락으로 작동, 터치식만 가능 sheet.zoom(zoomFactor) API 사용 allowUserZoom의 스프레드 옵션 시트 뷰포트의 확대/축소 여부를 제어하는 스프레드 옵션을 제공합니다. API를 통해 확대/축소 배율을 가져오거나 설정합니다. ViewZooming / ViewZoomed 이벤트 서로 다른 워크시트/ 스프레드 인스턴스의 확대/축소 프로세스에 개입하기 위해 두 가지 이벤트를 제공합니다. GC.Spread.Sheets.Events.ViewZooming handler 함수에 사용할 수 있는 인수는 다음과 같습니다. sheet: 이벤트를 트리거한 시트 sheetName: 시트의 이름 newZoomFactor: 새로운 확대/축소 배율, 사용자는 실제 확대/축소 액션을 간섭하기 위해 약간의 변경을 할 수 있습니다. oldZoomFactor: 이전 확대축소 배율 cancel: 작업을 취소할지 여부를 나타내는 값 GC.Spread.Sheets.Events.ViewZoomed handler 함수에서 사용 가능한 인수 sheet: 이벤트를 트리거한 시트 sheetName: 시트의 이름 newZoomFactor: 새로운 확대/축소 배율, 사용자는 실제 확대/축소 액션을 간섭하기 위해 약간의 변경을 할 수 있습니다. oldZoomFactor: 이전 확대축소 배율
import * as React from 'react'; import * as ReactDOM from 'react-dom'; import './styles.css'; import { AppFunc } from './app-func'; import { App } from './app-class'; // 1. Functional Component sample ReactDOM.render(<AppFunc />, document.getElementById('app')); // 2. Class Component sample // ReactDOM.render(<App />, document.getElementById('app'));
import * as React from 'react'; import { SpreadSheets, Worksheet } from '@mescius/spread-sheets-react'; import GC from '@mescius/spread-sheets'; import '@mescius/spread-sheets-resources-ko'; GC.Spread.Common.CultureManager.culture("ko-kr"); import './styles.css'; const useState = React.useState; export function AppFunc() { const [spread, setSpread] = useState(null); const [state, setState] = useState({ useLimit: false, maxZoom: 4, minZoom: 0.25, zoomFactor: 1 }); const initSpread = (spread) => { setSpread(spread); initStatusBar(spread); initEvents(spread); } const setZoomFactor = (value) => { var sheet = spread.getActiveSheet(); if (sheet) { var zoomFactor = parseFloat(value); var maxZoom = parseFloat(state.maxZoom), minZoom = parseFloat(state.minZoom); if (state.useLimit) { if (zoomFactor >= maxZoom) { zoomFactor = maxZoom; } if (zoomFactor <= minZoom) { zoomFactor = minZoom; } } sheet.zoom(zoomFactor); //setState(state=>({...state,...{ zoomFactor: zoomFactor }})); setZoomFactorState(zoomFactor); } } const setZoomFactorState = (zoomFactor) => { setState(state => ({ ...state, ...{ zoomFactor: zoomFactor } })); } const setUseLimit = (value) => { setState(state => ({ ...state, ...{ useLimit: value } })); } const setMaxZoom = (value) => { setState(state => ({ ...state, ...{ maxZoom: value } })); } const setMinZoom = (value) => { setState(state => ({ ...state, ...{ minZoom: value } })); } const initStatusBar = (spread) => { const statusBarDOM = document.getElementById('statusBar'); const statusBar = new GC.Spread.Sheets.StatusBar.StatusBar(statusBarDOM); statusBar.bind(spread); } const initEvents = (spread) => { spread.bind(GC.Spread.Sheets.Events.ViewZooming, (e, args) => { var maxZoom = parseFloat(state.maxZoom), minZoom = parseFloat(state.minZoom); if (state.useLimit) { if (args.newZoomFactor >= maxZoom) { args.newZoomFactor = maxZoom; } if (args.newZoomFactor <= minZoom) { args.newZoomFactor = minZoom; } } //setState({ zoomFactor: args.newZoomFactor }); setZoomFactorState(args.newZoomFactor); }); } return ( <div class="sample-tutorial"> <div class="spread-container"> <div class="sample-spreadsheets"> <SpreadSheets workbookInitialized={spread => initSpread(spread)}> <Worksheet></Worksheet> </SpreadSheets> </div> <div id="statusBar"></div> </div> <PanelFunc setting={state} setZoomFactor={(value) => setZoomFactor(value)} setUseLimit={(value) => setUseLimit(value)} setMaxZoom={(value) => setMaxZoom(value)} setMinZoom={(value) => setMinZoom(value)} ></PanelFunc> </div> ); } function PanelFunc(props) { return ( <div className="options-container"> <div className="options-row"> <label>Slide to zoom active sheet:</label> <div class="input"> <label class="inline-label">0.25</label> <input id="zoomFactor" type="range" name="points" min="0.25" max="4" step="0.01" value={props.setting.zoomFactor} onInput={(e) => { props.setZoomFactor(parseFloat(e.target.value)) }} /> <label class="inline-label">4</label> </div> </div> <div class="option-row"> <input id="useLimit" type="checkbox" checked={props.setting.useLimit} onChange={(e) => { props.setUseLimit(e.target.checked); }} /> <label for="useLimit" class="inline-label">Limit the zoom factor</label> </div> <div class="option-row" style={{ display: props.setting.useLimit ? 'block' : 'none' }}> <label for="maxZoom">The max zoom factor:</label> <input id="maxZoom" type="number" min="0.25" max="4" step="0.1" value={props.setting.maxZoom} onChange={(e) => props.setMaxZoom(parseFloat(e.target.value))} /> </div> <div class="option-row" style={{ display: props.setting.useLimit ? 'block' : 'none' }}> <label for="minZoom">The min zoom factor:</label> <input id="minZoom" type="number" min="0.25" max="4" step="0.1" value={props.setting.minZoom} onChange={(e) => props.setMinZoom(parseFloat(e.target.value))} /> </div> </div> ); }
import * as React from 'react'; import { SpreadSheets, Worksheet } from '@mescius/spread-sheets-react'; import GC from '@mescius/spread-sheets'; import '@mescius/spread-sheets-resources-ko'; GC.Spread.Common.CultureManager.culture("ko-kr"); import './styles.css'; const Component = React.Component, useState = React.useState; export class App extends Component { constructor(props) { super(props); this.spread = null; this.dataSource = dataSource; this.autoGenerateColumns = false; this.state = { useLimit: false, maxZoom: 4, minZoom: 0.25, zoomFactor: 1 }; } render() { return ( <div class="sample-tutorial"> <div class="spread-container"> <div class="sample-spreadsheets"> <SpreadSheets workbookInitialized={spread => this.initSpread(spread)}> <Worksheet></Worksheet> </SpreadSheets> </div> <div id="statusBar"></div> </div> <Panel setting={this.state} setZoomFactor={(value) => this.setZoomFactor(value)} setUseLimit={(value) => this.setUseLimit(value)} setMaxZoom={(value) => this.setMaxZoom(value)} setMinZoom={(value) => this.setMinZoom(value)} ></Panel> </div> ); } initSpread(spread) { this.spread = spread; this.initStatusBar(); this.initEvents(); } setZoomFactor(value) { let spread = this.spread; var sheet = spread.getActiveSheet(); if (sheet) { var zoomFactor = parseFloat(value); var maxZoom = parseFloat(this.state.maxZoom), minZoom = parseFloat(this.state.minZoom); if (this.state.useLimit) { if (zoomFactor >= maxZoom) { zoomFactor = maxZoom; } if (zoomFactor <= minZoom) { zoomFactor = minZoom; } } sheet.zoom(zoomFactor); this.setState({ zoomFactor: zoomFactor }); } } setUseLimit(value) { this.setState({ useLimit: value }); } setMaxZoom(value) { this.setState({ maxZoom: value }); } setMinZoom(value) { this.setState({ minZoom: value }); } initStatusBar() { var statusBarDOM = document.getElementById('statusBar'); var statusBar = new GC.Spread.Sheets.StatusBar.StatusBar(statusBarDOM); statusBar.bind(this.spread); } initEvents() { this.spread.bind(GC.Spread.Sheets.Events.ViewZooming, (e, args) => { var maxZoom = parseFloat(this.state.maxZoom), minZoom = parseFloat(this.state.minZoom); if (this.state.useLimit) { if (args.newZoomFactor >= maxZoom) { args.newZoomFactor = maxZoom; } if (args.newZoomFactor <= minZoom) { args.newZoomFactor = minZoom; } } this.setState({ zoomFactor: args.newZoomFactor }); }); } } class Panel extends Component { constructor(props) { super(props); } render() { return ( <div className="options-container"> <div className="options-row"> <label>Slide to zoom active sheet:</label> <div class="input"> <label class="inline-label">0.25</label> <input id="zoomFactor" type="range" name="points" min="0.25" max="4" step="0.01" value={this.props.setting.zoomFactor} onInput={(e) => { this.props.setZoomFactor(parseFloat(e.target.value)) }} /> <label class="inline-label">4</label> </div> </div> <div class="option-row"> <input id="useLimit" type="checkbox" checked={this.props.setting.useLimit} onChange={(e) => { this.props.setUseLimit(e.target.checked); }} /> <label for="useLimit" class="inline-label">Limit the zoom factor</label> </div> <div class="option-row" style={{ display: this.props.setting.useLimit ? 'block' : 'none' }}> <label for="maxZoom">The max zoom factor:</label> <input id="maxZoom" type="number" min="0.25" max="4" step="0.1" value={this.props.setting.maxZoom} onChange={(e) => { this.props.setMaxZoom(parseFloat(e.target.value)); }} /> </div> <div class="option-row" style={{ display: this.props.setting.useLimit ? 'block' : 'none' }}> <label for="minZoom">The min zoom factor:</label> <input id="minZoom" type="number" min="0.25" max="4" step="0.1" value={this.props.setting.minZoom} onChange={(e) => { this.props.setMinZoom(parseFloat(e.target.value)); }} /> </div> </div> ); } }
<!doctype html> <html style="height:100%;font-size:14px;"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <link rel="stylesheet" type="text/css" href="$DEMOROOT$/ko/react/node_modules/@mescius/spread-sheets/styles/gc.spread.sheets.excel2013white.css"> <script src="$DEMOROOT$/spread/source/data/data.js" type="text/javascript"></script> <!-- SystemJS --> <script src="$DEMOROOT$/ko/react/node_modules/systemjs/dist/system.src.js"></script> <script src="systemjs.config.js"></script> <script> System.import('$DEMOROOT$/ko/lib/react/license.js').then(function () { System.import('./src/app'); }); </script> </head> <body> <div id="app"></div> </body> </html>
.sample-tutorial { position: relative; height: 100%; overflow: hidden; } .spread-container { width: calc(100% - 280px); height: 100%; overflow: hidden; float: left; } .sample-spreadsheets { width: 100%; height: calc(100% - 30px); } #statusBar { width: 100%; height: 30px; } .inline-label { display: inline-block; } .options-container { float: right; width: 280px; padding: 12px; height: 100%; box-sizing: border-box; background: #fbfbfb; overflow: auto; } .option-row { font-size: 14px; padding: 5px; margin-top: 10px; } label { display: block; margin-bottom: 6px; } input[type=button] { margin-top: 6px; display: block; padding: 4px 6px; } body { position: absolute; top: 0; bottom: 0; left: 0; right: 0; } .hide { display: none !important; } .inputbox input { display: inline-block; } #app { height: 100%; }
(function (global) { System.config({ transpiler: 'plugin-babel', babelOptions: { es2015: true, react: true }, meta: { '*.css': { loader: 'css' } }, paths: { // paths serve as alias 'npm:': 'node_modules/' }, // map tells the System loader where to look for things map: { '@mescius/spread-sheets': 'npm:@mescius/spread-sheets/index.js', '@mescius/spread-sheets-resources-ko': 'npm:@mescius/spread-sheets-resources-ko/index.js', '@mescius/spread-sheets-react': 'npm:@mescius/spread-sheets-react/index.js', '@grapecity/jsob-test-dependency-package/react-components': 'npm:@grapecity/jsob-test-dependency-package/react-components/index.js', 'react': 'npm:react/umd/react.production.min.js', 'react-dom': 'npm:react-dom/umd/react-dom.production.min.js', 'css': 'npm:systemjs-plugin-css/css.js', 'plugin-babel': 'npm:systemjs-plugin-babel/plugin-babel.js', 'systemjs-babel-build':'npm:systemjs-plugin-babel/systemjs-babel-browser.js' }, // packages tells the System loader how to load when no filename and/or no extension packages: { src: { defaultExtension: 'jsx' }, "node_modules": { defaultExtension: 'js' }, } }); })(this);