uni-shared.d.ts 15.2 KB
Newer Older
fxy060608's avatar
fxy060608 已提交
1 2
import { FontFaceDescriptors } from 'css-font-loading-module';

fxy060608's avatar
fxy060608 已提交
3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30
export declare const ACTION_TYPE_ADD_EVENT = 8;

export declare const ACTION_TYPE_CREATE = 3;

export declare const ACTION_TYPE_EVENT = 20;

export declare const ACTION_TYPE_INSERT = 4;

export declare const ACTION_TYPE_PAGE_CREATE = 1;

export declare const ACTION_TYPE_PAGE_CREATED = 2;

export declare const ACTION_TYPE_REMOVE = 5;

export declare const ACTION_TYPE_REMOVE_ATTRIBUTE = 7;

export declare const ACTION_TYPE_REMOVE_EVENT = 9;

export declare const ACTION_TYPE_SET_ATTRIBUTE = 6;

export declare const ACTION_TYPE_SET_TEXT = 10;

/**
 * nodeId
 * event
 * flag
 */
export declare type AddEventAction = [
Q
qiang 已提交
31 32 33 34
    typeof ACTION_TYPE_ADD_EVENT,
    number,
    string | number,
    number
fxy060608's avatar
fxy060608 已提交
35 36
];

fxy060608's avatar
fxy060608 已提交
37
export declare function addFont(family: string, source: string, desc?: FontFaceDescriptors): Promise<void>;
fxy060608's avatar
fxy060608 已提交
38

fxy060608's avatar
fxy060608 已提交
39 40 41 42
export declare const ATTR_CLASS = "class";

export declare const ATTR_STYLE = "style";

fxy060608's avatar
fxy060608 已提交
43 44
export declare const BACKGROUND_COLOR = "#f7f7f7";

fxy060608's avatar
fxy060608 已提交
45 46
export declare const BUILT_IN_TAGS: string[];

fxy060608's avatar
fxy060608 已提交
47 48 49
export declare function cache<T>(fn: (str: string) => T): (str: string) => T;

export declare function cacheStringFunction(fn: (string: string) => string): (str: string) => string;
fxy060608's avatar
fxy060608 已提交
50

Q
qiang 已提交
51 52 53 54 55 56 57
export declare function callOptions(options: Options, errMsg: string): void;

export declare function callOptions(options: Options, data: {
    [key: string]: any;
    errMsg: string;
}): void;

fxy060608's avatar
fxy060608 已提交
58 59
export declare const COMPONENT_NAME_PREFIX = "VUni";

fxy060608's avatar
fxy060608 已提交
60 61 62
export declare const COMPONENT_PREFIX: string;

export declare const COMPONENT_SELECTOR_PREFIX = "uni-";
fxy060608's avatar
fxy060608 已提交
63

fxy060608's avatar
fxy060608 已提交
64 65 66 67 68 69 70
/**
 * nodeId
 * tag
 * parentNodeId
 * nodeJson
 */
export declare type CreateAction = [
Q
qiang 已提交
71 72 73 74 75
    typeof ACTION_TYPE_CREATE,
    number,
    string | number,
    number,
    Partial<UniNodeJSON | UniNodeJSONMinify>?
fxy060608's avatar
fxy060608 已提交
76 77
];

fxy060608's avatar
fxy060608 已提交
78 79
export declare function createRpx2Unit(unit: string, unitRatio: number, unitPrecision: number): (val: string) => string;

fxy060608's avatar
fxy060608 已提交
80 81
export declare const DATA_RE: RegExp;

fxy060608's avatar
fxy060608 已提交
82 83 84 85 86
export declare function debounce(fn: Function, delay: number): {
    (this: any): void;
    cancel(): void;
};

fxy060608's avatar
fxy060608 已提交
87 88 89 90 91 92 93 94 95 96 97
/**
 * Decode text using `decodeURIComponent`. Returns the original text if it
 * fails.
 *
 * @param text - string to decode
 * @returns decoded string
 */
export declare function decode(text: string | number): string;

export declare function decodedQuery(query?: Record<string, any>): Record<string, string>;

fxy060608's avatar
fxy060608 已提交
98 99 100 101 102 103
export declare const defaultRpx2Unit: {
    unit: string;
    unitRatio: number;
    unitPrecision: number;
};

fxy060608's avatar
fxy060608 已提交
104
declare type DictArray = [number, number][];
fxy060608's avatar
fxy060608 已提交
105

fxy060608's avatar
fxy060608 已提交
106 107 108 109 110 111
export declare const EventModifierFlags: {
    stop: number;
    prevent: number;
    self: number;
};

D
DCloud_LXH 已提交
112 113 114 115 116
export declare function formatDateTime({ date, mode }: {
    date?: Date | undefined;
    mode?: string | undefined;
}): string;

fxy060608's avatar
fxy060608 已提交
117 118
export declare function formatLog(module: string, ...args: any[]): string;

Q
qiang 已提交
119
export declare function getCustomDataset(el: HTMLElement | HTMLElementWithDataset): DOMStringMap & Record<string, any>;
Q
qiang 已提交
120

fxy060608's avatar
fxy060608 已提交
121 122
export declare function getEnvLocale(): string;

fxy060608's avatar
fxy060608 已提交
123 124
export declare function getLen(str?: string): number;

Q
qiang 已提交
125 126 127 128
declare interface HTMLElementWithDataset extends HTMLElement {
    __uniDataset?: Record<string, any>;
}

Q
qiang 已提交
129
export declare function initCustomDataset(): void;
Q
qiang 已提交
130

fxy060608's avatar
fxy060608 已提交
131 132 133 134 135 136 137
/**
 * nodeId
 * parentNodeId
 * refNodeId
 */
export declare type InsertAction = [typeof ACTION_TYPE_INSERT, number, number, number];

fxy060608's avatar
fxy060608 已提交
138 139
export declare const invokeArrayFns: (fns: Function[], arg?: any) => any;

fxy060608's avatar
fxy060608 已提交
140 141 142 143 144 145
export declare function isBuiltInComponent(tag: string): boolean;

export declare function isCustomElement(tag: string): boolean;

export declare function isNativeTag(tag: string): boolean;

fxy060608's avatar
fxy060608 已提交
146 147 148 149
export declare function isServiceCustomElement(_tag: string): boolean;

export declare function isServiceNativeTag(tag: string): boolean;

fxy060608's avatar
fxy060608 已提交
150 151
export declare interface IUniPageNode {
    pageId: number;
fxy060608's avatar
fxy060608 已提交
152
    pageNode: IUniPageNode | null;
fxy060608's avatar
fxy060608 已提交
153
    isUnmounted: boolean;
fxy060608's avatar
fxy060608 已提交
154 155
    genId: () => number;
    push: (...args: any[]) => void;
fxy060608's avatar
fxy060608 已提交
156
    onCreate: (thisNode: UniNode, nodeName: string | number) => UniNode;
fxy060608's avatar
fxy060608 已提交
157 158
    onInsertBefore: (thisNode: UniNode, newChild: UniNode, refChild: UniNode | null) => UniNode;
    onRemoveChild: (oldChild: UniNode) => UniNode;
fxy060608's avatar
fxy060608 已提交
159 160
    onAddEvent: (thisNode: UniNode, name: string, flag: number) => void;
    onRemoveEvent: (thisNode: UniNode, name: string) => void;
fxy060608's avatar
fxy060608 已提交
161 162 163 164
    onSetAttribute: (thisNode: UniNode, qualifiedName: string, value: unknown) => void;
    onRemoveAttribute: (thisNode: UniNode, qualifiedName: string) => void;
    onTextContent: (thisNode: UniNode, text: string) => void;
    onNodeValue: (thisNode: UniNode, val: string | null) => void;
fxy060608's avatar
fxy060608 已提交
165 166
}

fxy060608's avatar
fxy060608 已提交
167 168
export declare const NAVBAR_HEIGHT = 44;

fxy060608's avatar
fxy060608 已提交
169 170 171 172 173 174 175 176
export declare const NODE_TYPE_COMMENT = 8;

export declare const NODE_TYPE_ELEMENT = 1;

export declare const NODE_TYPE_PAGE = 0;

export declare const NODE_TYPE_TEXT = 3;

fxy060608's avatar
fxy060608 已提交
177 178
export declare function normalizeDataset(el: Element): any;

fxy060608's avatar
fxy060608 已提交
179 180
export declare function normalizeEventType(type: string, options?: AddEventListenerOptions): string;

fxy060608's avatar
fxy060608 已提交
181 182
export declare function normalizeTarget(el: HTMLElement): {
    id: string;
Q
qiang 已提交
183
    dataset: DOMStringMap & Record<string, any>;
fxy060608's avatar
fxy060608 已提交
184 185 186 187
    offsetTop: number;
    offsetLeft: number;
};

fxy060608's avatar
fxy060608 已提交
188 189 190 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
export declare const ON_ADD_TO_FAVORITES = "onAddToFavorites";

export declare const ON_APP_ENTER_BACKGROUND = "onAppEnterBackground";

export declare const ON_APP_ENTER_FOREGROUND = "onAppEnterForeground";

export declare const ON_BACK_PRESS = "onBackPress";

export declare const ON_ERROR = "onError";

export declare const ON_HIDE = "onHide";

export declare const ON_LAUNCH = "onLaunch";

export declare const ON_LOAD = "onLoad";

export declare const ON_NAVIGATION_BAR_BUTTON_TAP = "onNavigationBarButtonTap";

export declare const ON_NAVIGATION_BAR_SEARCH_INPUT_CHANGED = "onNavigationBarSearchInputChanged";

export declare const ON_NAVIGATION_BAR_SEARCH_INPUT_CLICKED = "onNavigationBarSearchInputClicked";

export declare const ON_NAVIGATION_BAR_SEARCH_INPUT_CONFIRMED = "onNavigationBarSearchInputConfirmed";

export declare const ON_NAVIGATION_BAR_SEARCH_INPUT_FOCUS_CHANGED = "onNavigationBarSearchInputFocusChanged";

export declare const ON_PAGE_NOT_FOUND = "onPageNotFound";

export declare const ON_PAGE_SCROLL = "onPageScroll";

export declare const ON_PULL_DOWN_REFRESH = "onPullDownRefresh";

export declare const ON_REACH_BOTTOM = "onReachBottom";

fxy060608's avatar
fxy060608 已提交
222 223
export declare const ON_REACH_BOTTOM_DISTANCE = 50;

fxy060608's avatar
fxy060608 已提交
224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243
export declare const ON_READY = "onReady";

export declare const ON_RESIZE = "onResize";

export declare const ON_SHARE_APP_MESSAGE = "onShareAppMessage";

export declare const ON_SHARE_TIMELINE = "onShareTimeline";

export declare const ON_SHOW = "onShow";

export declare const ON_TAB_ITEM_TAP = "onTabItemTap";

export declare const ON_THEME_CHANGE = "onThemeChange";

export declare const ON_UNHANDLE_REJECTION = "onUnhandledRejection";

export declare const ON_UNLOAD = "onUnload";

export declare const ON_WEB_INVOKE_APP_SERVICE = "onWebInvokeAppService";

fxy060608's avatar
fxy060608 已提交
244
export declare function once<T extends (...args: any[]) => any>(fn: T, ctx?: unknown): T;
fxy060608's avatar
fxy060608 已提交
245

Q
qiang 已提交
246 247 248 249 250 251
declare interface Options {
    success?: (res: any) => void;
    fail?: (res: any) => void;
    complete?: (res: any) => void;
}

fxy060608's avatar
fxy060608 已提交
252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279
export declare type PageAction = PageCreateAction | PageCreatedAction | PageUpdateAction;

export declare type PageCreateAction = [typeof ACTION_TYPE_PAGE_CREATE, PageCreateData];

export declare type PageCreatedAction = [typeof ACTION_TYPE_PAGE_CREATED];

export declare interface PageCreateData extends PageNodeOptions {
}

export declare interface PageNodeOptions {
    css: boolean;
    route: string;
    version: number;
    locale: string;
    platform: string;
    pixelRatio: number;
    windowWidth: number;
    disableScroll: boolean;
    onPageScroll: boolean;
    onPageReachBottom: boolean;
    onReachBottomDistance: number;
    statusbarHeight: number;
    windowTop: number;
    windowBottom: number;
}

export declare type PageUpdateAction = CreateAction | InsertAction | RemoveAction | AddEventAction | RemoveEventAction | SetAttributeAction | RemoveAttributeAction | SetTextAction;

fxy060608's avatar
fxy060608 已提交
280 281
export declare function parseEventName(name: string): [string, EventListenerOptions | undefined];

fxy060608's avatar
fxy060608 已提交
282 283 284 285 286 287 288 289 290
/**
 * https://github.com/vuejs/vue-router-next/blob/master/src/query.ts
 * @internal
 *
 * @param search - search string to parse
 * @returns a query object
 */
export declare function parseQuery(search: string): Record<string, any>;

fxy060608's avatar
fxy060608 已提交
291 292 293 294 295
export declare function parseUrl(url: string): {
    path: string;
    query: Record<string, any>;
};

fxy060608's avatar
fxy060608 已提交
296 297 298 299
export declare function passive(passive: boolean): {
    passive: boolean;
};

fxy060608's avatar
fxy060608 已提交
300 301
export declare const PLUS_RE: RegExp;

fxy060608's avatar
fxy060608 已提交
302 303
export declare function plusReady(callback: () => void): void;

fxy060608's avatar
fxy060608 已提交
304 305
export declare const PRIMARY_COLOR = "#007aff";

fxy060608's avatar
fxy060608 已提交
306 307 308 309 310 311 312 313 314 315
/**
 * nodeId
 */
export declare type RemoveAction = [typeof ACTION_TYPE_REMOVE, number];

/**
 * nodeId
 * name
 */
export declare type RemoveAttributeAction = [
Q
qiang 已提交
316 317 318
    typeof ACTION_TYPE_REMOVE_ATTRIBUTE,
    number,
    string | number
fxy060608's avatar
fxy060608 已提交
319 320 321 322 323 324 325
];

/**
 * nodeId
 * event
 */
export declare type RemoveEventAction = [
Q
qiang 已提交
326 327 328
    typeof ACTION_TYPE_REMOVE_EVENT,
    number,
    string | number
fxy060608's avatar
fxy060608 已提交
329 330
];

fxy060608's avatar
fxy060608 已提交
331 332
export declare function removeLeadingSlash(str: string): string;

fxy060608's avatar
fxy060608 已提交
333 334
export declare const RESPONSIVE_MIN_WIDTH = 768;

fxy060608's avatar
fxy060608 已提交
335 336
export declare type Rpx2UnitOptions = typeof defaultRpx2Unit;

fxy060608's avatar
fxy060608 已提交
337 338
export declare const sanitise: (val: unknown) => any;

fxy060608's avatar
fxy060608 已提交
339 340
export declare const SCHEME_RE: RegExp;

fxy060608's avatar
fxy060608 已提交
341 342 343
declare function scrollTo_2(scrollTop: number | string, duration: number): void;
export { scrollTo_2 as scrollTo }

fxy060608's avatar
fxy060608 已提交
344 345
export declare const SELECTED_COLOR = "#0062cc";

fxy060608's avatar
fxy060608 已提交
346 347 348 349 350 351
/**
 * nodeId
 * name
 * value
 */
export declare type SetAttributeAction = [
Q
qiang 已提交
352 353 354 355
    typeof ACTION_TYPE_SET_ATTRIBUTE,
    number,
    string | number,
    unknown | number
fxy060608's avatar
fxy060608 已提交
356 357 358 359 360 361
];

/**
 * nodeId
 * text
 */
fxy060608's avatar
fxy060608 已提交
362
export declare type SetTextAction = [
Q
qiang 已提交
363 364 365
    typeof ACTION_TYPE_SET_TEXT,
    number,
    string | number
fxy060608's avatar
fxy060608 已提交
366
];
fxy060608's avatar
fxy060608 已提交
367

fxy060608's avatar
fxy060608 已提交
368 369 370 371 372 373
export declare function stringifyQuery(obj?: Record<string, any>, encodeStr?: typeof encodeURIComponent): string;

export declare const TABBAR_HEIGHT = 50;

export declare const TAGS: string[];

fxy060608's avatar
fxy060608 已提交
374 375 376 377 378 379
export declare const UNI_SSR = "__uniSSR";

export declare const UNI_SSR_DATA = "data";

export declare const UNI_SSR_GLOBAL_DATA = "globalData";

fxy060608's avatar
fxy060608 已提交
380 381
export declare const UNI_SSR_STORE = "store";

fxy060608's avatar
fxy060608 已提交
382 383
export declare const UNI_SSR_TITLE = "title";

fxy060608's avatar
fxy060608 已提交
384 385
export declare class UniBaseNode extends UniNode {
    attributes: Record<string, unknown>;
fxy060608's avatar
fxy060608 已提交
386
    style: null | string | Record<string, string | string[]>;
fxy060608's avatar
fxy060608 已提交
387
    protected _html: string | null;
fxy060608's avatar
fxy060608 已提交
388
    constructor(nodeType: UniNodeType, nodeName: string, container: UniElement | IUniPageNode);
fxy060608's avatar
fxy060608 已提交
389 390 391 392 393 394 395 396 397
    get className(): string;
    set className(val: string);
    get innerHTML(): string;
    set innerHTML(html: string);
    addEventListener(type: string, listener: UniEventListener, options?: AddEventListenerOptions): void;
    removeEventListener(type: string, callback: UniEventListener, options?: EventListenerOptions): void;
    getAttribute(qualifiedName: string): unknown;
    removeAttribute(qualifiedName: string): void;
    setAttribute(qualifiedName: string, value: unknown): void;
fxy060608's avatar
fxy060608 已提交
398
    toJSON({ attr, normalize, }?: {
fxy060608's avatar
fxy060608 已提交
399 400
        attr?: boolean;
        children?: boolean;
fxy060608's avatar
fxy060608 已提交
401
        normalize?: (val: any, includeValue?: boolean) => any | number;
fxy060608's avatar
fxy060608 已提交
402
    }): Partial<UniNodeJSON>;
fxy060608's avatar
fxy060608 已提交
403 404 405
}

export declare class UniCommentNode extends UniNode {
fxy060608's avatar
fxy060608 已提交
406 407 408 409 410 411 412 413
    constructor(text: string, container: UniElement | IUniPageNode);
    toJSON(opts?: {
        attr?: boolean;
    }): {
        i?: undefined;
    } | {
        i: number;
    };
fxy060608's avatar
fxy060608 已提交
414 415 416 417 418 419
}

declare type UniCSSStyleDeclarationJSON = string | null | Record<string, string | string[]> | [string, Record<string, string | string[]>];

export declare class UniElement extends UniBaseNode {
    tagName: string;
fxy060608's avatar
fxy060608 已提交
420
    constructor(nodeName: string, container: UniElement | IUniPageNode);
fxy060608's avatar
fxy060608 已提交
421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438
}

export declare class UniEvent {
    type: string;
    bubbles: boolean;
    cancelable: boolean;
    defaultPrevented: boolean;
    timeStamp: number;
    _stop: boolean;
    _end: boolean;
    constructor(type: string, opts: UniEventOptions);
    preventDefault(): void;
    stopImmediatePropagation(): void;
    stopPropagation(): void;
}

export declare interface UniEventListener {
    (evt: UniEvent): void;
fxy060608's avatar
fxy060608 已提交
439
    modifiers?: string[];
fxy060608's avatar
fxy060608 已提交
440 441 442 443 444 445 446 447
}

declare interface UniEventOptions {
    bubbles: boolean;
    cancelable: boolean;
}

declare class UniEventTarget {
fxy060608's avatar
fxy060608 已提交
448
    listeners: Record<string, UniEventListener[]>;
fxy060608's avatar
fxy060608 已提交
449 450
    dispatchEvent(evt: UniEvent): boolean;
    addEventListener(type: string, listener: UniEventListener, options?: AddEventListenerOptions): void;
fxy060608's avatar
fxy060608 已提交
451
    removeEventListener(type: string, callback: UniEventListener, options?: AddEventListenerOptions): void;
fxy060608's avatar
fxy060608 已提交
452 453 454 455 456 457 458 459 460 461 462 463 464 465 466
}

export declare class UniInputElement extends UniElement {
    get value(): string | number;
    set value(val: string | number);
}

export declare class UniNode extends UniEventTarget {
    nodeId?: number;
    nodeType: UniNodeType;
    nodeName: string;
    childNodes: UniNode[];
    pageNode: IUniPageNode | null;
    parentNode: UniNode | null;
    protected _text: string | null;
fxy060608's avatar
fxy060608 已提交
467
    constructor(nodeType: UniNodeType, nodeName: string, container: UniElement | IUniPageNode);
fxy060608's avatar
fxy060608 已提交
468 469 470
    get firstChild(): UniNode | null;
    get lastChild(): UniNode | null;
    get nextSibling(): UniNode | null;
fxy060608's avatar
fxy060608 已提交
471 472
    get nodeValue(): string | null;
    set nodeValue(_val: string | null);
fxy060608's avatar
fxy060608 已提交
473 474 475 476
    get textContent(): string;
    set textContent(text: string);
    get parentElement(): UniElement | null;
    get previousSibling(): UniNode | null;
fxy060608's avatar
fxy060608 已提交
477
    appendChild(newChild: UniNode): UniNode;
fxy060608's avatar
fxy060608 已提交
478
    cloneNode(deep?: boolean): UniNode;
fxy060608's avatar
fxy060608 已提交
479 480
    insertBefore(newChild: UniNode, refChild: UniNode | null): UniNode;
    removeChild(oldChild: UniNode): UniNode;
fxy060608's avatar
fxy060608 已提交
481 482 483 484 485 486 487 488 489 490
}

export declare interface UniNodeJSON {
    /**
     * nodeId
     */
    i: number;
    /**
     * nodeName
     */
fxy060608's avatar
fxy060608 已提交
491
    n: string | number;
fxy060608's avatar
fxy060608 已提交
492 493 494 495
    /**
     * attributes
     */
    a: Record<string, unknown>;
fxy060608's avatar
fxy060608 已提交
496 497 498 499
    /**
     * listeners
     */
    e: Record<string, number>;
fxy060608's avatar
fxy060608 已提交
500 501 502
    /**
     * style
     */
fxy060608's avatar
fxy060608 已提交
503
    s?: UniCSSStyleDeclarationJSON;
fxy060608's avatar
fxy060608 已提交
504 505 506 507 508 509
    /**
     * text
     */
    t?: string;
}

fxy060608's avatar
fxy060608 已提交
510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536
declare interface UniNodeJSONMinify {
    /**
     * nodeId
     */
    i: number;
    /**
     * nodeName
     */
    n: string | number;
    /**
     * attributes
     */
    a: DictArray;
    /**
     * listeners
     */
    e: DictArray;
    /**
     * style
     */
    s?: DictArray;
    /**
     * text
     */
    t?: number;
}

fxy060608's avatar
fxy060608 已提交
537 538 539 540 541 542
declare type UniNodeType = typeof NODE_TYPE_PAGE | typeof NODE_TYPE_ELEMENT | typeof NODE_TYPE_TEXT | typeof NODE_TYPE_COMMENT;

export declare class UniTextAreaElement extends UniInputElement {
}

export declare class UniTextNode extends UniBaseNode {
fxy060608's avatar
fxy060608 已提交
543
    constructor(text: string, container: UniElement | IUniPageNode);
fxy060608's avatar
fxy060608 已提交
544 545 546 547
    get nodeValue(): string;
    set nodeValue(text: string);
}

fxy060608's avatar
fxy060608 已提交
548 549
export declare function updateElementStyle(element: HTMLElement, styles: Partial<CSSStyleDeclaration>): void;

fxy060608's avatar
fxy060608 已提交
550 551
export declare const WEB_INVOKE_APPSERVICE = "WEB_INVOKE_APPSERVICE";

fxy060608's avatar
fxy060608 已提交
552
export { }