VueUse中文文档useShare
响应式 Web Share API。浏览器提供可以共享文本或文件内容的功能。
Reactive Web Share API. The Browser provides features that can share content in text or file.
share方法必须在用户动作如单击按钮后调用。例如，它不能简单地在页面加载时调用。这有助于防止滥用。
The
sharemethod has to be called following a user gesture like a button click. It can’t simply be called on page load for example. That’s in place to help prevent abuse.
Demo
Usage
js
import { useShare } from '@vueuse/core'
const { share, isSupported } = useShare()
function startShare() {
share({
title: 'Hello',
text: 'Hello my friend!',
url: location.href,
})
}
import { useShare } from '@vueuse/core'
const { share, isSupported } = useShare()
function startShare() {
share({
title: 'Hello',
text: 'Hello my friend!',
url: location.href,
})
}
Passing a source ref
您可以给它传个 ref ，源引用的更改将作用到到您的共享选项上。
You can pass a ref to it, changes from the source ref will be reflected to your sharing options.
js
import { ref } from 'vue'
const shareOptions = ref < ShareOptions > ({ text: 'foo' })
const { share, isSupported } = useShare(shareOptions)
shareOptions.value.text = 'bar'
share()
import { ref } from 'vue'
const shareOptions = ref < ShareOptions > ({ text: 'foo' })
const { share, isSupported } = useShare(shareOptions)
shareOptions.value.text = 'bar'
share()
Type Declarations
typescript
export interface UseShareOptions {
title?: string
files?: File[]
text?: string
url?: string
}
/**
* Reactive Web Share API.
*
* @see https://vueuse.org/useShare
* @param shareOptions
* @param options
*/
export declare function useShare(
shareOptions?: MaybeComputedRef<UseShareOptions>,
options?: ConfigurableNavigator
): {
isSupported: Ref<boolean>
share: (overrideOptions?: MaybeComputedRef<UseShareOptions>) => Promise<void>
}
export type UseShareReturn = ReturnType<typeof useShare>
export interface UseShareOptions {
title?: string
files?: File[]
text?: string
url?: string
}
/**
* Reactive Web Share API.
*
* @see https://vueuse.org/useShare
* @param shareOptions
* @param options
*/
export declare function useShare(
shareOptions?: MaybeComputedRef<UseShareOptions>,
options?: ConfigurableNavigator
): {
isSupported: Ref<boolean>
share: (overrideOptions?: MaybeComputedRef<UseShareOptions>) => Promise<void>
}
export type UseShareReturn = ReturnType<typeof useShare>