openpencil/packages/docs/it/programmable/sdk/api/composables/use-i18n.md
Danila Poyarkov 14325280d9 docs(i18n): translate all missing pages to 6 languages
- 78 SDK pages per language (components, composables, advanced API,
  guides, architecture, getting-started)
- vector-edit.md user guide page (5 languages)
- Update stale ru/programmable/cli/inspecting.md
- Fix YAML frontmatter quoting for colons in descriptions

474 files, 0 missing pages across de/es/fr/it/pl/ru.
VitePress build verified — all 546 SDK pages render.
2026-04-22 18:35:22 +03:00

1.5 KiB

title description
useI18n Leggi i messaggi UI OpenPencil localizzati e cambia la lingua attiva dell'SDK.

useI18n

useI18n() restituisce gruppi di traduzione reattivi e controlli della lingua per le shell editor basate su OpenPencil.

Usalo quando vuoi etichette supportate dall'SDK per menu, comandi, pannelli, pagine e dialoghi, o quando vuoi consentire agli utenti di cambiare la lingua.

Utilizzo

import { useI18n } from '@open-pencil/vue'

const { menu, commands, panels, locale, availableLocales, localeLabels, setLocale } = useI18n()

Restituisce

  • menu
  • commands
  • tools
  • panels
  • pages
  • dialogs
  • locale
  • availableLocales
  • localeLabels
  • setLocale

Esempio base

<script setup lang="ts">
import { useI18n } from '@open-pencil/vue'

const { menu, locale, availableLocales, localeLabels, setLocale } = useI18n()
</script>

<template>
  <label class="flex items-center gap-2">
    <span>{{ menu.view }}</span>
    <select :value="locale" @change="setLocale(($event.target as HTMLSelectElement).value as typeof locale)">
      <option v-for="code in availableLocales" :key="code" :value="code">
        {{ localeLabels[code] }}
      </option>
    </select>
  </label>
</template>

Note

  • i cambiamenti di lingua sono reattivi in tutti i gruppi di messaggi dell'SDK
  • l'SDK esporta anche primitive di locale di livello inferiore quando hai bisogno di accesso diretto allo store

API correlate