shims-uni-app.d.ts 9.9 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 37
    globalStyle: {
      navigationBar: PageNavigationBar
      refreshOptions?: PageRefreshOptions
    }
fxy060608's avatar
fxy060608 已提交
38 39 40
    topWindow?: LayoutWindowOptions
    leftWindow?: LayoutWindowOptions
    rightWindow?: LayoutWindowOptions
fxy060608's avatar
fxy060608 已提交
41 42 43 44 45 46
    networkTimeout: {
      connectSocket: number
      downloadFile: number
      request: number
      uploadFile: number
    }
fxy060608's avatar
fxy060608 已提交
47
    tabBar?: TabBarOptions
fxy060608's avatar
fxy060608 已提交
48
    subPackages?: { root: string }[]
Q
qiang 已提交
49
    qqMapKey?: string
fxy060608's avatar
fxy060608 已提交
50
  }
fxy060608's avatar
fxy060608 已提交
51

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

  type UniRoutes = UniRoute[]

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

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

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

  interface PagesJsonPagePlatformStyle {
    h5?: PagesJsonPageStyle
fxy060608's avatar
fxy060608 已提交
127
    app?: PagesJsonPageStyle
Q
qiang 已提交
128
    'app-plus'?: PagesJsonPageStyle
fxy060608's avatar
fxy060608 已提交
129 130 131 132 133 134 135 136 137
    '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 已提交
138
    disableScroll?: boolean
fxy060608's avatar
fxy060608 已提交
139 140 141
    enablePullDownRefresh?: boolean
    navigationBar: PageNavigationBar
    refreshOptions?: PageRefreshOptions
fxy060608's avatar
fxy060608 已提交
142
    onReachBottomDistance?: number
fxy060608's avatar
fxy060608 已提交
143 144
  }
  interface PageRouteMeta extends PagesJsonPageStyle {
fxy060608's avatar
fxy060608 已提交
145
    id: number
fxy060608's avatar
fxy060608 已提交
146
    route: string
fxy060608's avatar
fxy060608 已提交
147
    isNVue?: boolean
fxy060608's avatar
fxy060608 已提交
148 149 150 151 152 153 154 155
    isQuit?: boolean
    isEntry?: boolean
    isTabBar?: boolean
    tabBarIndex?: number
    windowTop?: number
    topWindow?: boolean
    leftWindow?: boolean
    rightWindow?: boolean
fxy060608's avatar
fxy060608 已提交
156
    maxWidth?: string | number
fxy060608's avatar
fxy060608 已提交
157 158
  }

fxy060608's avatar
fxy060608 已提交
159 160
  interface PagesJsonPageOptions {
    path: string
fxy060608's avatar
fxy060608 已提交
161
    style: PagesJsonPageStyle
fxy060608's avatar
fxy060608 已提交
162 163 164 165 166 167
  }
  interface PagesJsonSubpackagesOptions {
    root: string
    pages: PagesJsonPageOptions[]
  }

fxy060608's avatar
fxy060608 已提交
168 169 170 171 172 173
  interface PagesJsonWindowOptions extends PagesJsonPageOptions {
    matchMedia: {
      minWidth: number
    }
  }

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

fxy060608's avatar
fxy060608 已提交
191 192 193 194 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
  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 已提交
230 231 232 233 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
  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 已提交
266
      res?: Parameters<Parameters<T>[0]>[0]
fxy060608's avatar
fxy060608 已提交
267
    ): void
fxy060608's avatar
fxy060608 已提交
268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294
    /**
     * 订阅 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 已提交
295
    publishHandler(event: string, args: unknown, pageId: number): void
fxy060608's avatar
fxy060608 已提交
296 297 298 299 300 301 302
    /**
     * 接收 View 层事件(通常由 View 层调用,并暴露至全局 UniServiceJSBridge 对象中)
     * @param event
     * @param args
     * @param pageId
     */
    subscribeHandler(event: string, args: unknown, pageId: number): void
fxy060608's avatar
fxy060608 已提交
303
  }
fxy060608's avatar
fxy060608 已提交
304 305 306 307 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
  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 已提交
362
}