UNPKG

@googleworkspace/drive-picker-element

Version:
650 lines (649 loc) 19.5 kB
{ "schemaVersion": "1.0.0", "readme": "", "modules": [ { "kind": "javascript-module", "path": "src/index.ts", "declarations": [], "exports": [ { "kind": "custom-element-definition", "name": "drive-picker", "declaration": { "name": "DrivePickerElement", "module": "/src/drive-picker" } }, { "kind": "custom-element-definition", "name": "drive-picker-docs-view", "declaration": { "name": "DrivePickerDocsViewElement", "module": "/src/drive-picker" } }, { "kind": "js", "name": "DrivePickerElement", "declaration": { "name": "DrivePickerElement", "module": "src/index.ts" } }, { "kind": "js", "name": "DrivePickerDocsViewElement", "declaration": { "name": "DrivePickerDocsViewElement", "module": "src/index.ts" } }, { "kind": "js", "name": "DrivePickerElementProps", "declaration": { "name": "DrivePickerElementProps", "module": "src/index.ts" } }, { "kind": "js", "name": "DrivePickerDocsViewElementProps", "declaration": { "name": "DrivePickerDocsViewElementProps", "module": "src/index.ts" } }, { "kind": "js", "name": "OAuthErrorEvent", "declaration": { "name": "OAuthErrorEvent", "module": "src/index.ts" } }, { "kind": "js", "name": "OAuthResponseEvent", "declaration": { "name": "OAuthResponseEvent", "module": "src/index.ts" } }, { "kind": "js", "name": "PickerCanceledEvent", "declaration": { "name": "PickerCanceledEvent", "module": "src/index.ts" } }, { "kind": "js", "name": "PickerErrorEvent", "declaration": { "name": "PickerErrorEvent", "module": "src/index.ts" } }, { "kind": "js", "name": "PickerPickedEvent", "declaration": { "name": "PickerPickedEvent", "module": "src/index.ts" } } ] }, { "kind": "javascript-module", "path": "src/drive-picker/drive-picker-docs-view-element.ts", "declarations": [ { "kind": "class", "description": "The `drive-picker-docs-view` element is used to define a [`google.picker.DocsView`](https://developers.google.com/drive/picker/reference/picker.docsview).", "name": "DrivePickerDocsViewElement", "members": [ { "kind": "field", "name": "view", "type": { "text": "google.picker.DocsView" }, "privacy": "public", "description": "Gets the Google Drive Picker view based on the current attribute values.", "return": { "type": { "text": "google.picker.DocsView" } }, "readonly": true }, { "kind": "field", "name": "viewId", "type": { "text": "google.picker.ViewId | undefined" }, "privacy": "private", "readonly": true } ], "attributes": [ { "name": "enable-drives", "type": { "text": "\"default\"|\"true\"|\"false\"" }, "description": "Whether to allow the user to select files from shared drives. See [`DocsView.enableDrives`](https://developers.google.com/drive/picker/reference/picker.docsview.setenabledrives)." }, { "name": "file-ids", "type": { "text": "string" }, "description": "A comma-separated list of file IDs to filter the view. See [`View.setFileIds`](https://developers.google.com/workspace/drive/picker/reference/picker.docsview.setfileids)." }, { "name": "include-folders", "type": { "text": "\"default\"|\"true\"|\"false\"" }, "description": "Whether to include folders in the view. See [`DocsView.includeFolders`](https://developers.google.com/drive/picker/reference/picker.docsview.setincludefolders)." }, { "name": "mime-types", "type": { "text": "string" }, "description": "A comma-separated list of MIME types to filter the view. See [`View.setMimeTypes`](https://developers.google.com/drive/picker/reference/picker.view.setmimetypes)." }, { "name": "mode", "type": { "text": "string" }, "description": "The mode of the view. See [`DocsViewMode`](https://developers.google.com/drive/picker/reference/picker.docsviewmode)." }, { "name": "owned-by-me", "type": { "text": "\"default\"|\"true\"|\"false\"" }, "description": "Whether to show files owned by the user. See [`DocsView.ownedByMe`](https://developers.google.com/drive/picker/reference/picker.docsview.setownedbyme)." }, { "name": "parent", "type": { "text": "string" }, "description": "The ID of the folder to view. See [`DocsView.setParent`](https://developers.google.com/drive/picker/reference/picker.docsview.setparent)." }, { "name": "query", "type": { "text": "string" }, "description": "The query string to filter the view. See [`View.setQuery`](https://developers.google.com/drive/picker/reference/picker.view.setquery)." }, { "name": "select-folder-enabled", "type": { "text": "\"default\"|\"true\"|\"false\"" }, "description": "Whether to allow the user to select folders. See [`DocsView.selectFolderEnabled`](https://developers.google.com/drive/picker/reference/picker.docsview.setselectfolderenabled)." }, { "name": "starred", "type": { "text": "\"default\"|\"true\"|\"false\"" }, "description": "Whether to show starred files. See [`DocsView.starred`](https://developers.google.com/drive/picker/reference/picker.docsview.setstarred)." }, { "name": "view-id", "type": { "text": "string" }, "description": "The `keyof typeof google.picker.ViewId`. For example, `\"DOCS\"`, which is equivalent to `google.picker.ViewId.DOCS`. See [`ViewId`](https://developers.google.com/drive/picker/reference/picker.viewid)." } ], "superclass": { "name": "HTMLElement" }, "tagName": "drive-picker-docs-view", "customElement": true } ], "exports": [ { "kind": "js", "name": "DrivePickerDocsViewElement", "declaration": { "name": "DrivePickerDocsViewElement", "module": "src/drive-picker/drive-picker-docs-view-element.ts" } } ] }, { "kind": "javascript-module", "path": "src/drive-picker/drive-picker-element.ts", "declarations": [ { "kind": "class", "description": "The `drive-picker` web component provides a convenient way to declaratively\nbuild\n[`google.picker.Picker`](https://developers.google.com/drive/picker/reference/picker)\nby using the component attributes mapped to the corresponding methods of\n[`google.picker.PickerBuilder`](https://developers.google.com/drive/picker/reference/picker.pickerbuilder).", "name": "DrivePickerElement", "slots": [ { "description": "The default slot contains View elements to display in the picker. Each View element should implement a property `view` of type `google.picker.View`.", "name": "" } ], "members": [ { "kind": "field", "name": "picker", "type": { "text": "google.picker.Picker | undefined" }, "privacy": "private" }, { "kind": "field", "name": "observer", "type": { "text": "MutationObserver | undefined" }, "privacy": "private" }, { "kind": "field", "name": "google", "type": { "text": "typeof google | undefined" }, "privacy": "private" }, { "kind": "field", "name": "loading", "type": { "text": "Promise<void> | undefined" }, "privacy": "private" }, { "kind": "field", "name": "debounceTimer", "type": { "text": "number | undefined" }, "privacy": "private" }, { "kind": "field", "name": "visible", "type": { "text": "boolean" }, "privacy": "public", "description": "Controls the visibility of the picker after the picker dialog has been\nclosed. If any of the attributes change, the picker will be rebuilt and\nthe visibility will be reset." }, { "kind": "field", "name": "tokenClientConfig", "type": { "text": "Omit<\n\t\tgoogle.accounts.oauth2.TokenClientConfig,\n\t\t\"callback\" | \"error_callback\"\n\t>" }, "privacy": "public", "readonly": true }, { "kind": "method", "name": "scheduleBuild", "privacy": "private" }, { "kind": "method", "name": "build", "privacy": "private" }, { "kind": "field", "name": "views", "type": { "text": "(View | google.picker.ViewId)[]" }, "privacy": "private", "description": "The `google.Picker.View` objects to display in the picker as defined by the slot elements.", "readonly": true }, { "kind": "method", "name": "callbackToDispatchEvent", "privacy": "private", "parameters": [ { "name": "detail", "type": { "text": "google.picker.ResponseObject" } } ] }, { "kind": "method", "name": "requestAccessToken", "privacy": "private", "return": { "type": { "text": "Promise<string | undefined>" } } } ], "events": [ { "name": "eventType", "type": { "text": "CustomEvent" } }, { "name": "picker:oauth:error", "type": { "text": "CustomEvent" } }, { "name": "picker-oauth-error", "type": { "text": "OAuthErrorEvent" }, "description": "Triggered when an error occurs in the OAuth flow. See the [error guide](https://developers.google.com/identity/oauth2/web/guides/error). Note that the `TokenResponse` object can have error fields." }, { "name": "picker:authenticated", "type": { "text": "CustomEvent" } }, { "name": "picker-oauth-response", "type": { "text": "OAuthResponseEvent" }, "description": "Triggered when an OAuth flow completes. See the [token model guide](https://developers.google.com/identity/oauth2/web/guides/use-token-model)." }, { "name": "picker:oauth:response", "type": { "text": "CustomEvent" } }, { "type": { "text": "PickerCanceledEvent" }, "description": "Triggered when the user cancels the picker dialog. See [`ResponseObject`](https://developers.google.com/drive/picker/reference/picker.responseobject).", "name": "picker-canceled" }, { "type": { "text": "PickerPickedEvent" }, "description": "Triggered when the user picks one or more items. See [`ResponseObject`](https://developers.google.com/drive/picker/reference/picker.responseobject).", "name": "picker-picked" }, { "type": { "text": "PickerErrorEvent" }, "description": "Triggered when an error occurs. See [`ResponseObject`](https://developers.google.com/drive/picker/reference/picker.responseobject).", "name": "picker-error" } ], "attributes": [ { "name": "app-id", "type": { "text": "string" }, "description": "The Google Drive app ID. See [`PickerBuilder.setAppId`](https://developers.google.com/drive/picker/reference/picker.pickerbuilder.setappid)." }, { "name": "client-id", "type": { "text": "string" }, "description": "The OAuth 2.0 client ID. See [Using OAuth 2.0 to Access Google APIs](https://developers.google.com/identity/protocols/oauth2)." }, { "name": "debounce-delay", "type": { "text": "number" }, "description": "The debounce delay in milliseconds before building the picker after an attribute change.", "default": "0" }, { "name": "developer-key", "type": { "text": "string" }, "description": "The API key for accessing Google Picker API. See [`PickerBuilder.setDeveloperKey`](https://developers.google.com/drive/picker/reference/picker.pickerbuilder.setdeveloperkey)." }, { "name": "hide-title-bar", "type": { "text": "\"default\"|\"true\"|\"false\"" }, "description": "Hides the title bar of the picker if set to true. See [`PickerBuilder.hideTitleBar`](https://developers.google.com/drive/picker/reference/picker.pickerbuilder.hidetitlebar)." }, { "name": "locale", "type": { "text": "string" }, "description": "The locale to use for the picker. See [`PickerBuilder.setLocale`](https://developers.google.com/drive/picker/reference/picker.pickerbuilder.setlocale)." }, { "name": "max-items", "type": { "text": "number" }, "description": "The maximum number of items that can be selected. See [`PickerBuilder.setMaxItems`](https://developers.google.com/drive/picker/reference/picker.pickerbuilder.setmaxitems)." }, { "name": "mine-only", "type": { "text": "boolean" }, "description": "If set to true, only shows files owned by the user. See [`PickerBuilder.enableFeature`](https://developers.google.com/drive/picker/reference/picker.pickerbuilder.enablefeature)." }, { "name": "multiselect", "type": { "text": "boolean" }, "description": "Enables multiple file selection if set to true. See [`PickerBuilder.enableFeature`](https://developers.google.com/drive/picker/reference/picker.pickerbuilder.enablefeature)." }, { "name": "nav-hidden", "type": { "text": "boolean" }, "description": "Hides the navigation pane if set to true. See [`PickerBuilder.enableFeature`](https://developers.google.com/drive/picker/reference/picker.pickerbuilder.enablefeature)." }, { "name": "oauth-token", "type": { "text": "string" }, "description": "The OAuth 2.0 token for authentication. See [`PickerBuilder.setOAuthToken`](https://developers.google.com/drive/picker/reference/picker.pickerbuilder.setoauthtoken)." }, { "name": "origin", "type": { "text": "string" }, "description": "The origin parameter for the picker. See [`PickerBuilder.setOrigin`](https://developers.google.com/drive/picker/reference/picker.pickerbuilder.setorigin)." }, { "name": "relay-url", "type": { "text": "string" }, "description": "The relay URL for the picker. See [`PickerBuilder.setRelayUrl`](https://developers.google.com/drive/picker/reference/picker.pickerbuilder.setrelayurl)." }, { "name": "scope", "type": { "text": "string" }, "description": "The OAuth 2.0 scope for the picker. The default is `https://www.googleapis.com/auth/drive.file`. See [Drive API scopes](https://developers.google.com/drive/api/guides/api-specific-auth#drive-scopes)." }, { "name": "title", "type": { "text": "string" }, "description": "The title of the picker. See [`PickerBuilder.setTitle`](https://developers.google.com/drive/picker/reference/picker.pickerbuilder.settitle)." }, { "type": { "text": "string" }, "description": "The hosted domain to restrict sign-in to. (Optional) See the `hd` field in the OpenID Connect docs.", "name": "hd" }, { "type": { "text": "boolean" }, "description": "Enables applications to use incremental authorization. See [`TokenClientConfig.include_granted_scopes`](https://developers.google.com/identity/oauth2/web/reference/js-reference#TokenClientConfig).", "name": "include-granted-scopes" }, { "type": { "text": "string" }, "description": "An email address or an ID token 'sub' value. Google will use the value as a hint of which user to sign in. See the `login_hint` field in the OpenID Connect docs.", "name": "login-hint" }, { "type": { "text": "\"\"|\"none\"|\"consent\"|\"select_account\"" }, "description": "A space-delimited, case-sensitive list of prompts to present the user. See [`TokenClientConfig.prompt`](https://developers.google.com/identity/oauth2/web/reference/js-reference#TokenClientConfig)", "name": "prompt" } ], "superclass": { "name": "HTMLElement" }, "tagName": "drive-picker", "customElement": true } ], "exports": [ { "kind": "js", "name": "DrivePickerElement", "declaration": { "name": "DrivePickerElement", "module": "src/drive-picker/drive-picker-element.ts" } } ] }, { "kind": "javascript-module", "path": "src/drive-picker/index.ts", "declarations": [], "exports": [ { "kind": "js", "name": "DrivePickerElement", "declaration": { "name": "DrivePickerElement", "module": "\"./drive-picker-element\"" } }, { "kind": "js", "name": "OAuthErrorEvent", "declaration": { "name": "OAuthErrorEvent", "module": "\"./drive-picker-element\"" } }, { "kind": "js", "name": "OAuthResponseEvent", "declaration": { "name": "OAuthResponseEvent", "module": "\"./drive-picker-element\"" } }, { "kind": "js", "name": "PickerCanceledEvent", "declaration": { "name": "PickerCanceledEvent", "module": "\"./drive-picker-element\"" } }, { "kind": "js", "name": "PickerErrorEvent", "declaration": { "name": "PickerErrorEvent", "module": "\"./drive-picker-element\"" } }, { "kind": "js", "name": "PickerPickedEvent", "declaration": { "name": "PickerPickedEvent", "module": "\"./drive-picker-element\"" } }, { "kind": "js", "name": "DrivePickerDocsViewElement", "declaration": { "name": "DrivePickerDocsViewElement", "module": "\"./drive-picker-docs-view-element\"" } }, { "kind": "js", "name": "DrivePickerDocsViewElementProps", "declaration": { "name": "DrivePickerDocsViewElementProps", "module": "\"./props\"" } }, { "kind": "js", "name": "DrivePickerElementProps", "declaration": { "name": "DrivePickerElementProps", "module": "\"./props\"" } } ] }, { "kind": "javascript-module", "path": "src/drive-picker/props.ts", "declarations": [], "exports": [] } ] }