本文将深入探讨在 Laravel 多语言应用中，如何有效处理用户输入数据的翻译问题。虽然 Laravel 提供了强大的本地化机制来翻译静态文本，但对于存储在数据库中的用户动态内容，需要借助 Google 翻译工具的客户端能力，通过巧妙结合 `translate` 和 `notranslate` CSS 类，实现按需翻译，并可与 Laravel 的语言切换机制协同工作。

引言：Laravel 本地化与动态内容翻译的挑战

Laravel 框架通过其内置的本地化功能，为构建多语言网站提供了便捷的解决方案。开发者可以通过在 resources/lang 目录下创建不同语言的翻译文件，并使用 __('key') 助手函数轻松地在视图中渲染多语言的静态文本。然而，这种机制主要针对预定义的、静态的文本内容。

当涉及到用户通过表单提交并存储到数据库中的动态数据时，Laravel 的本地化机制就无法直接应用了。例如，用户以英文提交了一篇文章标题和内容，如果网站当前语言环境切换到法语，这些动态内容并不会自动翻译。这就对多语言应用提出了新的挑战：如何在不修改数据库结构（例如为每个字段存储多个语言版本）的前提下，实现用户输入内容的实时翻译？

本文将介绍一种利用客户端 Google 翻译工具解决这一问题的策略，实现对特定动态内容的按需翻译。

集成 Google 翻译工具实现页面内容翻译

要实现用户输入数据的动态翻译，我们可以借助 Google 翻译提供的客户端小部件。

1. 基本集成

首先，在您的 Laravel 视图文件中（例如 resources/views/layouts/app.blade.php 或包含动态内容的特定视图），添加以下 HTML 元素和 JavaScript 代码来初始化 Google 翻译小部件：

代码说明：

  • #google_translate_element：这是一个占位符 div，Google 翻译小部件会在此处渲染。我们将其设置为 display:none; 以隐藏默认的下拉菜单，因为我们将通过 JavaScript 进行控制。
  • pageLanguage: 'en'：这告诉 Google 翻译，页面上大部分内容的原始语言是英文。如果您的用户输入数据主要以其他语言存储，请相应调整。
  • includedLanguages: 'en,fr,es,ar'：定义了用户可以选择翻译到的目标语言。
  • autoDisplay: false：禁用 Google 翻译默认的浮动下拉菜单。

2. 初步问题：全页面翻译

默认情况下，当 Google 翻译小部件被激活时，它会尝试翻译整个页面的所有可见文本内容。这通常不是我们期望的行为，因为我们希望 Laravel 的本地化机制处理静态文本，而 Google 翻译只处理动态的用户输入数据。为了解决这个问题，我们需要更精细地控制翻译范围。

精细控制翻译范围：translate 和 notranslate 类

Google 翻译小部件提供了一对非常有用的 CSS 类，允许开发者精确控制哪些内容需要翻译，哪些内容应保持不变。

1. 核心机制

  • notranslate 类： 任何带有 notranslate 类的 HTML 元素及其所有子元素都将被 Google 翻译工具忽略，不会被翻译。
  • translate 类： 当一个元素的父级或整个页面被标记为 notranslate 时，如果某个子元素带有 translate 类，那么该子元素将会被翻译。

2. 应用策略

为了实现对用户输入数据的选择性翻译，推荐以下策略：

  1. 将大部分页面内容标记为 notranslate： 通常，您可以将

    标签或包含大部分静态内容的顶级 div 元素添加 notranslate 类。这样可以确保由 Laravel 本地化处理的静态文本不会被 Google 翻译干扰。
    
    
    
    {{ __('message.page_title') }}
    
    
    {{ __('message.welcome_message') }}

  2. 仅对包含动态用户数据的元素添加 translate 类： 对于那些从数据库中获取并展示的用户输入数据（例如文章标题、评论内容、产品描述等），将其所在的 HTML 元素（如

    ,

    , 等）添加 translate 类。

    
    

    
        
    用户文章标题: {{ $article->title }}
    
        
    {{ $article->content }}
    

        
    用户评论:
    
        @foreach($comments as $comment)
            
    {{ $comment->text }} - {{ $comment->author }}
    
        @endforeach

    通过这种方式，Google 翻译只会处理带有 translate 类的动态内容，而不会触及其他静态或不需要翻译的部分，从而实现精确控制。

    与 Laravel 语言切换机制协同

    为了让 Google 翻译工具与 Laravel 应用的语言切换机制无缝协作，我们需要在用户切换语言时，动态地通知 Google 翻译目标语言。这可以通过设置 googtrans cookie 来实现。

    1. googtrans Cookie 原理

    Google 翻译小部件会读取一个名为 googtrans 的 cookie 来决定翻译的源语言和目标语言。该 cookie 的格式为 /源语言代码/目标语言代码。例如，/en/fr 表示将内容从英文翻译成法文。

    2. 实现步骤

    假设您的用户输入数据始终以一种原始语言（例如英文 en）存储。当用户在 Laravel 应用中通过下拉菜单选择不同的语言时，您需要：

    1. 获取当前 Laravel 应用的语言环境（即用户希望看到的语言）。
    2. 设置 googtrans cookie，指示 Google 翻译将内容从原始语言翻译到当前应用语言。
    3. 如果当前应用语言与原始语言相同，可以清除翻译 cookie 或设置为 /en/en，以避免不必要的翻译。

    以下是一个修改后的 JavaScript 示例，用于在 Laravel 语言切换时更新 Google 翻译：

    





 雄杰鑫电商资讯网 版权所有  鄂ICP备2024084503号