Merge branch 'main' into dev

Author: liihuu

.gitignore

@@ -7,3 +7,5 @@
 /docs/node_modules
 
 .npmrc
+
+.DS_Store

docs/.vitepress/config/share.js

@@ -67,6 +67,8 @@ export function getInstanceApiMenus (lang = '') {
     { text: 'removeOverlay', link: `${prefix}/removeOverlay` },
     { text: 'setPaneOptions', link: `${prefix}/setPaneOptions` },
     { text: 'getPaneOptions', link: `${prefix}/getPaneOptions` },
+    { text: 'setZoomAnchor', link: `${prefix}/setZoomAnchor` },
+    { text: 'getZoomAnchor', link: `${prefix}/getZoomAnchor` },
     { text: 'setZoomEnabled', link: `${prefix}/setZoomEnabled` },
     { text: 'isZoomEnabled', link: `${prefix}/isZoomEnabled` },
     { text: 'setScrollEnabled', link: `${prefix}/setScrollEnabled` },

docs/@views/api/references/chart/init.md

@@ -61,6 +61,7 @@
       threshold?: number
       format?: (value: number | string) => string
     }
+    zoomAnchor?: 'cursor' | 'last_bar' | { main?: 'cursor' | 'last_bar', xAxis?: 'cursor' | 'last_bar' }
   }
 ) => Chart
 ```

docs/@views/api/samples/getZoomAnchor/index.data.js

@@ -0,0 +1,20 @@
+import fs from 'fs'
+
+export default {
+  watch: ['./index.js'],
+  load (watchedFiles) {
+    return watchedFiles.reduce((data, file) => {
+      const result = fs.readFileSync(file, 'utf-8')
+      let key
+      if (file.match('index.js')) {
+        key = 'js'
+      } else if (file.match('index.css')) {
+        key = 'css'
+      } else {
+        key = 'html'
+      }
+      data[key] = result
+      return data
+    }, {})
+  }
+}

docs/@views/api/samples/getZoomAnchor/index.js

@@ -0,0 +1,20 @@
+import { init } from 'klinecharts'
+
+const chart = init('getZoomAnchor-chart')
+
+chart.setSymbol({ ticker: 'TestSymbol' })
+chart.setPeriod({ span: 1, type: 'day' })
+chart.setDataLoader({
+  getBars: ({
+    callback
+  }) => {
+    fetch('https://klinecharts.com/datas/kline.json')
+      .then(res => res.json())
+      .then(dataList => {
+        callback(dataList)
+      })
+  }
+})
+
+const anchor = chart.getZoomAnchor()
+console.log(anchor)

docs/@views/api/samples/getZoomAnchor/index.vue

@@ -0,0 +1,11 @@
+<script setup>
+import ChartPreview from '../../../../@components/ChartPreview.vue';
+import { data } from './index.data'
+</script>
+
+<template>
+  <ChartPreview
+    title="getZoomAnchor"
+    chartId="getZoomAnchor-chart"
+    :code="data.js"/>
+</template>

docs/@views/api/samples/init-zoomAnchor/index.data.js

@@ -0,0 +1,20 @@
+import fs from 'fs'
+
+export default {
+  watch: ['./index.js'],
+  load (watchedFiles) {
+    return watchedFiles.reduce((data, file) => {
+      const result = fs.readFileSync(file, 'utf-8')
+      let key
+      if (file.match('index.js')) {
+        key = 'js'
+      } else if (file.match('index.css')) {
+        key = 'css'
+      } else {
+        key = 'html'
+      }
+      data[key] = result
+      return data
+    }, {})
+  }
+}

docs/@views/api/samples/init-zoomAnchor/index.js

@@ -0,0 +1,20 @@
+import { init } from 'klinecharts'
+
+const chart = init(
+  'init-zoomAnchor-chart',
+  { zoomAnchor: { main: 'last_bar', xAxis: 'last_bar' } }
+)
+
+chart.setSymbol({ ticker: 'TestSymbol' })
+chart.setPeriod({ span: 1, type: 'day' })
+chart.setDataLoader({
+  getBars: ({
+    callback
+  }) => {
+    fetch('https://klinecharts.com/datas/kline.json')
+      .then(res => res.json())
+      .then(dataList => {
+        callback(dataList)
+      })
+  }
+})

docs/@views/api/samples/init-zoomAnchor/index.vue

@@ -0,0 +1,11 @@
+<script setup>
+import ChartPreview from '../../../../@components/ChartPreview.vue';
+import { data } from './index.data'
+</script>
+
+<template>
+  <ChartPreview
+    title="init-zoomAnchor"
+    chartId="init-zoomAnchor-chart"
+    :code="data.js"/>
+</template>

docs/@views/api/samples/setZoomAnchor/index.data.js

@@ -0,0 +1,20 @@
+import fs from 'fs'
+
+export default {
+  watch: ['./index.js'],
+  load (watchedFiles) {
+    return watchedFiles.reduce((data, file) => {
+      const result = fs.readFileSync(file, 'utf-8')
+      let key
+      if (file.match('index.js')) {
+        key = 'js'
+      } else if (file.match('index.css')) {
+        key = 'css'
+      } else {
+        key = 'html'
+      }
+      data[key] = result
+      return data
+    }, {})
+  }
+}