shims-uni-app.d.ts 10.0 KB
Newer Older
fxy060608's avatar
fxy060608 已提交
1 2 3 4 5 6 7 8 9 10 11 12
declare namespace Page {
  interface PageInstance {
    $page: {
      id: number
      path: string
      route: string
      fullPath: string
      options: Record<string, any>
      meta: UniApp.PageRouteMeta
    }
  }
}
fxy060608's avatar
fxy060608 已提交
13
declare namespace UniApp {
fxy060608's avatar
fxy060608 已提交
14 15
  type ClassObj = Record<string, boolean>
  type StyleObj = Record<string, any>
fxy060608's avatar
fxy060608 已提交
16
  type PLATFORM = keyof PagesJsonPagePlatformStyle
fxy060608's avatar
fxy060608 已提交
17 18 19 20 21
  interface LayoutWindowOptions {
    matchMedia?: {
      minWidth?: number
    }
    style?: Record<string, any>
22
    component: any
fxy060608's avatar
fxy060608 已提交
23 24 25
  }

  interface UniConfig {
fxy060608's avatar
fxy060608 已提交
26
    ready?: boolean
fxy060608's avatar
fxy060608 已提交
27 28
    router: {
      strict: boolean
fxy060608's avatar
fxy060608 已提交
29
      base: string
fxy060608's avatar
fxy060608 已提交
30
    }
fxy060608's avatar
fxy060608 已提交
31 32 33
    nvue: {
      'flex-direction': 'column' | 'row'
    }
fxy060608's avatar
fxy060608 已提交
34 35 36
    globalStyle: {
      navigationBar: PageNavigationBar
      refreshOptions?: PageRefreshOptions
Q
qiang 已提交
37 38 39 40
      maxWidth?: number
      rpxCalcMaxDeviceWidth?: number
      rpxCalcBaseDeviceWidth?: number
      // rpxCalcIncludeWidth?: number
fxy060608's avatar
fxy060608 已提交
41
    }
fxy060608's avatar
fxy060608 已提交
42 43 44
    topWindow?: LayoutWindowOptions
    leftWindow?: LayoutWindowOptions
    rightWindow?: LayoutWindowOptions
fxy060608's avatar
fxy060608 已提交
45 46 47 48 49 50
    networkTimeout: {
      connectSocket: number
      downloadFile: number
      request: number
      uploadFile: number
    }
fxy060608's avatar
fxy060608 已提交
51
    tabBar?: TabBarOptions
fxy060608's avatar
fxy060608 已提交
52
    subPackages?: { root: string }[]
Q
qiang 已提交
53
    qqMapKey?: string
fxy060608's avatar
fxy060608 已提交
54
  }
fxy060608's avatar
fxy060608 已提交
55

fxy060608's avatar
fxy060608 已提交
56 57
  interface UniRoute {
    path: string
fxy060608's avatar
fxy060608 已提交
58
    alias?: string
fxy060608's avatar
fxy060608 已提交
59 60
    meta: PageRouteMeta
    component?: any
D
DCloud_LXH 已提交
61
    loader: () => Promise<any>
fxy060608's avatar
fxy060608 已提交
62 63 64 65
  }

  type UniRoutes = UniRoute[]

fxy060608's avatar
fxy060608 已提交
66
  interface PageNavigationBarButton {
fxy060608's avatar
fxy060608 已提交
67
    type:
fxy060608's avatar
fxy060608 已提交
68 69 70 71 72 73 74 75
      | 'none'
      | 'forward'
      | 'back'
      | 'share'
      | 'favorite'
      | 'home'
      | 'menu'
      | 'close'
fxy060608's avatar
fxy060608 已提交
76
    color: string
fxy060608's avatar
fxy060608 已提交
77
    background?: string
fxy060608's avatar
fxy060608 已提交
78
    badgeText?: string
fxy060608's avatar
fxy060608 已提交
79 80
    colorPressed?: string
    float?: 'right' | 'left'
fxy060608's avatar
fxy060608 已提交
81 82
    fontWeight?: any
    fontSize: string
fxy060608's avatar
fxy060608 已提交
83
    fontSrc?: string
fxy060608's avatar
fxy060608 已提交
84
    fontFamily?: string
fxy060608's avatar
fxy060608 已提交
85
    select?: boolean
fxy060608's avatar
fxy060608 已提交
86
    text: string
fxy060608's avatar
fxy060608 已提交
87
    width?: string
fxy060608's avatar
fxy060608 已提交
88
    redDot?: boolean
fxy060608's avatar
fxy060608 已提交
89
  }
fxy060608's avatar
fxy060608 已提交
90 91

  interface PageNavigationBarSearchInput {
fxy060608's avatar
fxy060608 已提交
92
    color?: string
fxy060608's avatar
fxy060608 已提交
93 94 95 96 97 98 99 100 101
    autoFocus?: boolean
    align?: 'center' | 'left' | 'right'
    backgroundColor?: string
    borderRadius?: string
    placeholder?: string
    placeholderColor?: string
    disabled?: boolean
  }

fxy060608's avatar
fxy060608 已提交
102
  interface PageNavigationBar {
fxy060608's avatar
fxy060608 已提交
103
    type?: 'default' | 'transparent' | 'float' | 'none'
fxy060608's avatar
fxy060608 已提交
104
    titleSize?: string
fxy060608's avatar
fxy060608 已提交
105
    titleText?: string
fxy060608's avatar
fxy060608 已提交
106 107
    titleImage?: string
    titleColor?: '#000' | '#fff'
fxy060608's avatar
fxy060608 已提交
108 109 110 111 112 113 114
    timingFunc?: string
    duration?: string
    backgroundColor?: string
    titlePenetrate?: 'YES' | 'NO'
    shadowColorType?: 'grey' | 'blue' | 'green' | 'orange' | 'red' | 'yellow'
    backButton?: boolean
    buttons?: PageNavigationBarButton[]
fxy060608's avatar
fxy060608 已提交
115 116
    searchInput?: PageNavigationBarSearchInput
    style?: 'default' | 'custom'
fxy060608's avatar
fxy060608 已提交
117 118
    loading?: boolean
    coverage?: string
fxy060608's avatar
fxy060608 已提交
119 120 121 122 123 124 125 126 127
  }
  interface PageRefreshOptions {
    support: boolean
    color: string
    style: 'circle' | string
    height: number
    range: number
    offset: number
  }
fxy060608's avatar
fxy060608 已提交
128 129 130

  interface PagesJsonPagePlatformStyle {
    h5?: PagesJsonPageStyle
fxy060608's avatar
fxy060608 已提交
131
    app?: PagesJsonPageStyle
Q
qiang 已提交
132
    'app-plus'?: PagesJsonPageStyle
fxy060608's avatar
fxy060608 已提交
133 134 135 136 137 138 139 140 141
    'mp-alipay'?: PagesJsonPageStyle
    'mp-baidu'?: PagesJsonPageStyle
    'mp-qq'?: PagesJsonPageStyle
    'mp-toutiao'?: PagesJsonPageStyle
    'mp-weixin'?: PagesJsonPageStyle
    'quickapp-webview'?: PagesJsonPageStyle
  }

  interface PagesJsonPageStyle extends PagesJsonPagePlatformStyle {
fxy060608's avatar
fxy060608 已提交
142
    disableScroll?: boolean
fxy060608's avatar
fxy060608 已提交
143 144 145
    enablePullDownRefresh?: boolean
    navigationBar: PageNavigationBar
    refreshOptions?: PageRefreshOptions
fxy060608's avatar
fxy060608 已提交
146
    onReachBottomDistance?: number
fxy060608's avatar
fxy060608 已提交
147 148
  }
  interface PageRouteMeta extends PagesJsonPageStyle {
fxy060608's avatar
fxy060608 已提交
149
    id: number
fxy060608's avatar
fxy060608 已提交
150
    route: string
fxy060608's avatar
fxy060608 已提交
151
    isNVue?: boolean
fxy060608's avatar
fxy060608 已提交
152 153 154 155 156 157 158 159
    isQuit?: boolean
    isEntry?: boolean
    isTabBar?: boolean
    tabBarIndex?: number
    windowTop?: number
    topWindow?: boolean
    leftWindow?: boolean
    rightWindow?: boolean
fxy060608's avatar
fxy060608 已提交
160
    maxWidth?: string | number
fxy060608's avatar
fxy060608 已提交
161 162
  }

fxy060608's avatar
fxy060608 已提交
163 164
  interface PagesJsonPageOptions {
    path: string
fxy060608's avatar
fxy060608 已提交
165
    style: PagesJsonPageStyle
fxy060608's avatar
fxy060608 已提交
166 167 168 169 170 171
  }
  interface PagesJsonSubpackagesOptions {
    root: string
    pages: PagesJsonPageOptions[]
  }

fxy060608's avatar
fxy060608 已提交
172 173 174 175 176 177
  interface PagesJsonWindowOptions extends PagesJsonPageOptions {
    matchMedia: {
      minWidth: number
    }
  }

fxy060608's avatar
fxy060608 已提交
178 179 180 181
  interface PagesJson {
    pages: PagesJsonPageOptions[]
    subpackages?: PagesJsonSubpackagesOptions[]
    subPackages?: PagesJsonSubpackagesOptions[]
fxy060608's avatar
fxy060608 已提交
182
    globalStyle: PagesJsonPageStyle
fxy060608's avatar
fxy060608 已提交
183
    tabBar?: TabBarOptions
fxy060608's avatar
fxy060608 已提交
184 185 186
    topWindow?: PagesJsonWindowOptions
    leftWindow?: PagesJsonWindowOptions
    rightWindow?: PagesJsonWindowOptions
fxy060608's avatar
fxy060608 已提交
187 188 189 190 191 192
    easycom?: {
      autoscan?: boolean
      custom?: {
        [name: string]: string
      }
    }
fxy060608's avatar
fxy060608 已提交
193
  }
fxy060608's avatar
fxy060608 已提交
194

fxy060608's avatar
fxy060608 已提交
195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233
  interface TabBarItemBaseOptions {
    pagePath: string
    text: string
    iconPath?: string
    selectedIconPath?: string
    redDot?: boolean
    badge?: string
  }

  interface TabBarNormalItemOptions extends TabBarItemBaseOptions {
    type: 'normal'
  }
  interface TabBarMidButtonOptions extends TabBarItemBaseOptions {
    type: 'midButton'
    width?: string
    height?: string
    iconWidth?: string
    backgroundImage?: string
  }

  type TabBarItemOptions = TabBarNormalItemOptions | TabBarMidButtonOptions

  interface TabBarOptions {
    position?: 'bottom' | 'top'
    color: string
    selectedColor: string
    backgroundColor: string
    borderStyle?: 'black' | 'white'
    list: TabBarItemOptions[]
    blurEffect?: 'none' | 'dark' | 'extralight' | 'light'
    fontSize?: string
    iconWidth?: string
    spacing?: string
    height?: string
    midButton?: TabBarMidButtonOptions
    selectedIndex?: number
    shown: boolean
  }

fxy060608's avatar
fxy060608 已提交
234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269
  type OnApiLike = (callback: (result: unknown) => void) => void
  interface UniServiceJSBridge {
    /**
     * 监听 service 层的自定义事件。事件由 emit 触发,回调函数会接收所有传入事件触发函数的额外参数。
     * @param event
     * @param callback
     */
    on(event: string | string[], callback: Function): void
    /**
     * 监听 service 层的自定义事件。仅触发一次,在第一次触发之后移除监听器。
     * @param event
     * @param callback
     */
    once(event: string, callback: Function): void
    /**
     * 移除 service 层的自定义事件监听器。
     * 如果没有提供参数,则移除所有的事件监听器;
     * 如果只提供了事件,则移除该事件所有的监听器;
     * 如果同时提供了事件与回调,则只移除这个回调的监听器。
     * @param event
     * @param callback
     */
    off(event?: string | string[], callback?: Function): void
    /**
     * 触发 Service 层的事件。附加参数都会传给监听器回调。
     * @param event
     * @param args
     */
    emit(event: string, ...args: any[]): void
    /**
     * 触发 Service 层事件类型API(on开头)回调。
     * @param name
     * @param res
     */
    invokeOnCallback<T extends OnApiLike>(
      name: string,
fxy060608's avatar
fxy060608 已提交
270
      res?: Parameters<Parameters<T>[0]>[0]
fxy060608's avatar
fxy060608 已提交
271
    ): void
fxy060608's avatar
fxy060608 已提交
272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298
    /**
     * 订阅 View 的自定义事件,回调函数会接收所有传入事件触发函数的额外参数。
     * @param event
     * @param callback
     */
    subscribe(event: string, callback: Function): void
    /**
     * 取消订阅 View 的自定义事件
     * 如果没有提供参数,则移除所有的事件监听器;
     * 如果只提供了事件,则移除该事件所有的监听器;
     * 如果同时提供了事件与回调,则只移除这个回调的监听器。
     * @param event
     * @param callback
     */
    unsubscribe(event: string, callback?: Function): void
    /**
     * 执行  Service 层 API 回调
     * @param callbackId
     * @param args
     */
    invokeCallbackHandler(callbackId: number, args: unknown): void
    /**
     * 向 View 层发送事件
     * @param event
     * @param args
     * @param pageId
     */
fxy060608's avatar
fxy060608 已提交
299
    publishHandler(event: string, args: unknown, pageId: number): void
fxy060608's avatar
fxy060608 已提交
300 301 302 303 304 305 306
    /**
     * 接收 View 层事件(通常由 View 层调用,并暴露至全局 UniServiceJSBridge 对象中)
     * @param event
     * @param args
     * @param pageId
     */
    subscribeHandler(event: string, args: unknown, pageId: number): void
fxy060608's avatar
fxy060608 已提交
307
  }
fxy060608's avatar
fxy060608 已提交
308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365
  interface UniViewJSBridge {
    /**
     * 监听 View 的自定义事件。事件由 emit 触发,回调函数会接收所有传入事件触发函数的额外参数。
     * @param event
     * @param callback
     */
    on(event: string | string[], callback: Function): void
    /**
     * 监听 View 的自定义事件。仅触发一次,在第一次触发之后移除监听器。
     * @param event
     * @param callback
     */
    once(event: string, callback: Function): void
    /**
     * 移除 View 的自定义事件监听器。
     * 如果没有提供参数,则移除所有的事件监听器;
     * 如果只提供了事件,则移除该事件所有的监听器;
     * 如果同时提供了事件与回调,则只移除这个回调的监听器。
     * @param event
     * @param callback
     */
    off(event?: string | string[], callback?: Function): void
    /**
     * 触发 View 的事件。附加参数都会传给监听器回调。
     * @param event
     * @param args
     */
    emit(event: string, ...args: any[]): void
    /**
     * 订阅 Service 的自定义事件,回调函数会接收所有传入事件触发函数的额外参数。
     * @param event
     * @param callback
     */
    subscribe(event: string, callback: Function): void
    /**
     * 取消订阅 Service 的自定义事件
     * 如果没有提供参数,则移除所有的事件监听器;
     * 如果只提供了事件,则移除该事件所有的监听器;
     * 如果同时提供了事件与回调,则只移除这个回调的监听器。
     * @param event
     * @param callback
     */
    unsubscribe(event: string, callback?: Function): void
    /**
     * 接收 Service 层事件(通常由 Service 层调用,并暴露至全局 UniViewJSBridge 对象中)
     * @param event
     * @param args
     * @param pageId
     */
    subscribeHandler(event: string, args: unknown, pageId: number): void
    /**
     * 向 Service 层发送事件
     * @param event
     * @param args
     * @param pageId
     */
    publishHandler(event: string, args: unknown, pageId?: number): void
  }
fxy060608's avatar
fxy060608 已提交
366
}