跳到主要內容

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.dev.org.tw/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 於 2025/1/22
eddbf - feat: 更多被動事件處理程序 (#4484)
v12.0.0-beta.1 於 2024/11/21
0a9ed - feat!: 移除 Vue 2 支援、優化捆綁包並清理 (#4349)
v10.0.0-beta.0 於 2023/3/14
a860c - feat: 雙向綁定 (#2168)

根據 MIT 許可證發布。