Skip to content

useNavigatorLanguage

类别
导出体积
681 B
上次更改
3 days ago

响应式地获取 navigator.language

示例

Supported: false

Navigator Language:
你的浏览器不支持 Navigator.language API。

使用方法

ts
import { useNavigatorLanguage } from '@vueuse/core'
import { defineComponent, ref } from 'vue'

export default defineComponent({
  setup() {
    const { language } = useNavigatorLanguage()

    watch(language, () => {
      // 监听值的变化
    })

    return {
      language,
    }
  },
})
js
import { useNavigatorLanguage } from '@vueuse/core'
import { defineComponent } from 'vue'
export default defineComponent({
  setup() {
    const { language } = useNavigatorLanguage()
    watch(language, () => {
      // 监听值的变化
    })
    return {
      language,
    }
  },
})

类型声明

typescript
export interface NavigatorLanguageState {
  isSupported: ComputedRef<boolean>
  /**
   * ISO 639-1 标准语言代码
   *
   * @info 检测到的用户代理语言偏好作为语言标签
   * (有时称为“区域设置标识符”)。
   * 这由一个表示语言的2-3个字母的基本语言标签组成,
   * 可选地后跟由“-”分隔的其他子标签。
   * 最常见的额外信息是国家或地区变体(如 'en-US' 或 'fr-CA')。
   *
   * @see https://www.iso.org/iso-639-language-codes.html
   * @see https://www.loc.gov/standards/iso639-2/php/code_list.php
   *
   */
  language: Ref<string | undefined>
}
/**
 *
 * Reactive useNavigatorLanguage
 *
 * Detects the currently selected user language and returns a reactive language
 * @see https://vueuse.org/useNavigatorLanguage
 *
 */
export declare function useNavigatorLanguage(
  options?: ConfigurableWindow,
): Readonly<NavigatorLanguageState>
export type UseNavigatorLanguageReturn = ReturnType<typeof useNavigatorLanguage>

源码

源码演示文档

贡献者

Anthony Fu
一纸忘忧
Fernando Fernández
Alex Liu
Anthony Fu
vaakian X
Jelf
WuLianN
Michael J. Roberts

更新日志

v12.4.0 on 1/10/2025
dd316 - feat: use passive event handlers everywhere is possible (#4477)
v12.0.0-beta.1 on 11/21/2024
0a9ed - feat!: drop Vue 2 support, optimize bundles and clean up (#4349)