feat: add scroll to view

src/index.ts

@@ -1 +1,2 @@
-export { default as numberParse } from './numberParse'
+export { numberParse, numberMatch } from './numberParse'
+export { default as scrollToView } from './scrollToView'

src/numberParse/index.ts

@@ -24,6 +24,7 @@ const FLOAT_REGEXP = /-?\d+(\.\d+)?/g
 
 type ParserResult<T> = T extends ('NUMBER_FLOAT' | 'NUMBER_INT') ? number : string
 
+/** 解析字符串中的数字 */
 export const numberParse = <T = 'STRING_FLOAT'>(str: string, options?: Options<T>): ParserResult<T> | undefined => {
   const { digits, format = 'STRING_FLOAT', customRegexp } = options ?? {}
   const isFloat = format === 'NUMBER_FLOAT' || format === 'STRING_FLOAT'
@@ -51,6 +52,7 @@ export const numberParse = <T = 'STRING_FLOAT'>(str: string, options?: Options<T
   }
 }
 
+/** 匹配字符串中的数字 */
 export const numberMatch = <T = 'STRING_FLOAT'>(str: string, options?: Options<T>): ParserResult<T>[] => {
   const { digits, format = 'STRING_FLOAT', customRegexp } = options ?? {}
   const isFloat = format === 'NUMBER_FLOAT' || format === 'STRING_FLOAT'

src/scrollToView/index.ts

@@ -0,0 +1,36 @@
+
+export type Options = ScrollToOptions & {
+  /** 横向滚动位置偏移量，正数偏右，负数偏左 */
+  offsetX?: number
+  /** 纵向滚动位置偏移量，正数偏上，负数偏下 */
+  offsetY?: number
+  /** css选择器，用于指定滚动的dom */
+  selector?: string
+}
+
+/** 滚动至可视区域 */
+const scrollToView = (options: Options) => {
+  const { top, left, offsetY = 0, offsetX = 0, selector, behavior } = options ?? {}
+  let elmSelector = selector
+  if (!elmSelector) {
+    // 如果未指定选择器，就从路由里面读取锚点
+    const matchs = window.location.hash.match(/(#\w+)/g)
+    if (matchs) {
+      elmSelector = matchs[matchs.length - 1]
+    }
+  }
+  if (elmSelector) {
+    const dom = document.querySelector(elmSelector)
+    if (dom) {
+      window.scrollTo({
+        behavior,
+        top: top ?? dom.getBoundingClientRect().top + offsetY,
+        left: left ?? dom.getBoundingClientRect().left + offsetX,
+      })
+    }
+  } else {
+    throw new Error('Did you forget params selector?')
+  }
+}
+
+export default scrollToView