跳到内容

useBrowserLocation

类别
导出大小
820 B
最后更改
3 周前

响应式浏览器位置

注意:如果您正在使用 Vue Router,请改用 Vue Router 提供的 useRoute

示例

输入和哈希值将被更改
trigger: 'load'

用法

js
import { useBrowserLocation } from '@vueuse/core'

const location = useBrowserLocation()

组件用法

此函数还通过 @vueuse/components 包提供了无渲染组件版本。 了解更多用法

vue
<UseBrowserLocation v-slot="{ location }">
  Browser Location: {{ location }}
</UseBrowserLocation>

类型声明

显示类型声明
typescript
export interface BrowserLocationState {
  readonly trigger: string
  readonly state?: any
  readonly length?: number
  readonly origin?: string
  hash?: string
  host?: string
  hostname?: string
  href?: string
  pathname?: string
  port?: string
  protocol?: string
  search?: string
}
/**
 * Reactive browser location.
 *
 * @see https://vueuse.org.cn/useBrowserLocation
 */
export declare function useBrowserLocation(options?: ConfigurableWindow): Ref<
  {
    readonly trigger: string
    readonly state?: any
    readonly length?: number | undefined
    readonly origin?: string | undefined
    hash?: string | undefined
    host?: string | undefined
    hostname?: string | undefined
    href?: string | undefined
    pathname?: string | undefined
    port?: string | undefined
    protocol?: string | undefined
    search?: string | undefined
  },
  | BrowserLocationState
  | {
      readonly trigger: string
      readonly state?: any
      readonly length?: number | undefined
      readonly origin?: string | undefined
      hash?: string | undefined
      host?: string | undefined
      hostname?: string | undefined
      href?: string | undefined
      pathname?: string | undefined
      port?: string | undefined
      protocol?: string | undefined
      search?: string | undefined
    }
>
export type UseBrowserLocationReturn = ReturnType<typeof useBrowserLocation>

源码

源码示例文档

贡献者

Anthony Fu
Fernando Fernández
Anthony Fu
三咲智子 Kevin Deng
vaakian X
Mike
Eureka
Shinigami
wheat
Alex Kozack
Antério Vieira

更新日志

v12.5.0 于 1/22/2025
eddbf - feat: more passive event handlers (#4484)
v12.0.0-beta.1 于 11/21/2024
0a9ed - feat!: drop Vue 2 support, optimize bundles and clean up (#4349)
v10.0.0-beta.0 于 3/14/2023
a860c - feat: two-way binding (#2168)

根据 MIT 许可证发布。