ICode9

精准搜索请尝试: 精确搜索
首页 > 其他分享> 文章详细

Cesium 做汉化的另一种思路

2022-05-09 09:32:36  阅读:222  来源: 互联网

标签:lang viewer navigationHelp vm 汉化 cesium let Cesium 思路


目前好几个月没有做Cesium 相关的开发了。
汉化肯定是最基础又必须做的一个功能,要不界面上按钮toolTip都是英文,都不知道怎么和客户交代。
因为Cesium 里面的一些按钮的toolTip提示都是硬编码在里面的。
所以好多小伙伴们做汉化通常是直接修改源码然后编译使用。
如果仅仅是为了汉化去编译源代码,我觉得有些不那么合适,你想想每次你升级Cesium版本的时候,这些重复劳动是不是很烦。
首先这个也不是我原创,是在看一个库里发现的这种方法。在用的过程中扩展了一些。
新建 cesium.local.js 内容如下

import Cesium from "cesium/Cesium"
/**
 * @time: 2018/11/139:47 AM
 * @author:QingMings(1821063757@qq.com)
 * @desc: CesiumLocal 本地化Cesium
 *
 */
export default class CesiumLocal {
  /**
   * @time: 2018/11/139:48 AM
   * @author:QingMings(1821063757@qq.com)
   * @desc: CesiumLocal 本地化Cesium
   * @param viewer {Cesium.Viewer}
   */
  constructor(viewer) {
    this._viewer = viewer;
    this._lang = {
      "Imagery": "影像",
      "Terrain": "地形",
      "GeocodersPlaceholder": "请输入地名或坐标",
      "HomeButtonToolTip": "回到全球",
      "SceneModePickerToolTip2D": "二维",
      "SceneModePickerToolTip3D": "三维",
      "SceneModePickerToolTipView": "哥伦布视图",
      "NavigationHelpButtonToolTip": "操作指南",
      "navigationHelp_Touch": ">手势",
      "navigationHelp_Mouse": ">鼠标",
      "navigationHelp_Mouse_Pan": "平移",
      "navigationHelp_Mouse_Pan_details": "按下左键+ 拖动",
      "navigationHelp_Mouse_Zoom": "缩放",
      "navigationHelp_Mouse_Zoom_details0": "按下右键+ 拖动,或者",
      "navigationHelp_Mouse_Zoom_details1": "滚动鼠标滚轮",
      "navigationHelp_Mouse_Rotate": "旋转",
      "navigationHelp_Mouse_Rotate_details0": "按下中键+ 拖动,或者",
      "navigationHelp_Mouse_Rotate_details1": "按下CTRL + 左键/右键 +拖动",

      "navigationHelp_Touch_Pan": "平移",
      "navigationHelp_Touch_Pan_details": "单指拖动",
      "navigationHelp_Touch_Zoom": "缩放",
      "navigationHelp_Touch_Zoom_details": "双指捏合",
      "navigationHelp_Touch_Rotate": "旋转",
      "navigationHelp_Touch_Rotate_details": "双指反向拖动",
      "navigationHelp_Touch_Tilt": "俯仰",
      "navigationHelp_Touch_Tilt_details": "双指同向拖动",

      "enterFullScreen": "全屏",
      "exitFullScreen": "退出全屏"
    };
    this.init();
  }

  /**
   * @time: 2018/11/139:59 AM
   * @author:QingMings(1821063757@qq.com)
   * @desc:
   * @type Viewer
   */
  get viewer() {
    return this._viewer;
  }

  /**
   * @time: 2018/11/1310:04 AM
   * @author:QingMings(1821063757@qq.com)
   * @desc:
   * @type Object
   */
  get lang() {
    return this._lang;
  }

  init() {
    let _vm = this;
    _vm._baseLayerPickerSectionTitleLang();
    _vm._homeButtonLang();
    _vm._geocoderLang();
    _vm._sceneModePickerButtonLang();
    _vm._navigationHelpButtonLang();
    _vm._fullScreenButtonLang();
  }

  /**
   * @time: 2018/11/139:55 AM
   * @author:QingMings(1821063757@qq.com)
   * @desc: 本地化 Cesium.BaseLayerPicker
   *
   */
  _baseLayerPickerSectionTitleLang() {
    let _vm = this;
    let titles = _vm.viewer.container.getElementsByClassName('cesium-baseLayerPicker-sectionTitle');
    for (let i = 0; i < titles.length; i++) {
      titles[i].innerHTML = titles[i].innerHTML.replace("Imagery", _vm.lang.Imagery).replace("Terrain", _vm.lang.Terrain)
    }
  }

  /**
   * @time: 2018/11/1310:17 AM
   * @author:QingMings(1821063757@qq.com)
   * @desc: 本地化 HomeButton
   *
   */
  _homeButtonLang() {
    let _vm = this;
    if (!defined(_vm.viewer.homeButton)) {
      return;
    }
    _vm.viewer.homeButton.viewModel.tooltip = _vm.lang.HomeButtonToolTip
  }

  /**
   * @time: 2018/11/1310:20 AM
   * @author:QingMings(1821063757@qq.com)
   * @desc: 本地化 geocoder
   *
   */
  _geocoderLang() {
    let _vm = this;
    let geocoders = this.viewer.container.getElementsByClassName("cesium-geocoder-input");
    for (let i = 0; i < geocoders.length; i++) {
      geocoders[i].setAttribute("placeholder", _vm.lang.GeocodersPlaceholder);
    }
  }

  /**
   * @time: 2018/11/1311:22 AM
   * @author:QingMings(1821063757@qq.com)
   * @desc: 本地化 sceneModePicker
   *
   */
  _sceneModePickerButtonLang() {
    let _vm = this;
    if (!defined(_vm.viewer.sceneModePicker)) {
      return;
    }
    _vm.viewer.sceneModePicker.viewModel.tooltip2D = _vm.lang.SceneModePickerToolTip2D;
    _vm.viewer.sceneModePicker.viewModel.tooltip3D = _vm.lang.SceneModePickerToolTip3D;
    _vm.viewer.sceneModePicker.viewModel.tooltipColumbusView = _vm.lang.SceneModePickerToolTipView;
  }

  /**
   * @time: 2018/11/1311:23 AM
   * @author:QingMings(1821063757@qq.com)
   * @desc: 本地化操作指南
   *
   */
  _navigationHelpButtonLang() {
    let _vm = this;
    if (!defined(_vm.viewer.navigationHelpButton)) {
      return;
    }
    _vm.viewer.navigationHelpButton.viewModel.tooltip = _vm.lang.NavigationHelpButtonToolTip;
    let clickHelpElement = _vm.viewer.navigationHelpButton.container.getElementsByClassName("cesium-click-navigation-help")[0];
    let touchHelpElement = _vm.viewer.navigationHelpButton.container.getElementsByClassName("cesium-touch-navigation-help")[0];

    let tabButtonElement = _vm.viewer.navigationHelpButton.container.getElementsByClassName("cesium-navigation-button-right")[0];
    tabButtonElement.innerHTML = tabButtonElement.innerHTML.replace(">Touch", _vm.lang.navigationHelp_Touch);
    tabButtonElement = _vm.viewer.navigationHelpButton.container.getElementsByClassName("cesium-navigation-button-left")[0];
    tabButtonElement.innerHTML = tabButtonElement.innerHTML.replace(">Mouse", _vm.lang.navigationHelp_Mouse);
    // 平移
    let clickHelpPanElement = clickHelpElement.getElementsByClassName("cesium-navigation-help-pan")[0];
    clickHelpPanElement.innerHTML = _vm.lang.navigationHelp_Mouse_Pan;
    let clickHelpPanDetailsElement = clickHelpPanElement.parentNode.getElementsByClassName("cesium-navigation-help-details")[0];
    clickHelpPanDetailsElement.innerHTML = _vm.lang.navigationHelp_Mouse_Pan_details;
    // 缩放
    let clickHelpZoomElement = clickHelpElement.getElementsByClassName("cesium-navigation-help-zoom")[0];
    clickHelpZoomElement.innerHTML = _vm.lang.navigationHelp_Mouse_Zoom;
    let clickHelpZoomDetailsElement0 = clickHelpZoomElement.parentNode.getElementsByClassName("cesium-navigation-help-details")[0];
    clickHelpZoomDetailsElement0.innerHTML = _vm.lang.navigationHelp_Mouse_Zoom_details0;
    let clickHelpZoomDetailsElement1 = clickHelpZoomElement.parentNode.getElementsByClassName("cesium-navigation-help-details")[1];
    clickHelpZoomDetailsElement1.innerHTML = _vm.lang.navigationHelp_Mouse_Zoom_details1;
    // 旋转
    let clickHelpRotateElement = clickHelpElement.getElementsByClassName("cesium-navigation-help-rotate")[0];
    clickHelpRotateElement.innerHTML = _vm.lang.navigationHelp_Mouse_Rotate;
    let clickHelpRotateDetailsElement0 = clickHelpRotateElement.parentNode.getElementsByClassName("cesium-navigation-help-details")[0];
    clickHelpRotateDetailsElement0.innerHTML = _vm.lang.navigationHelp_Mouse_Rotate_details0;
    let clickHelpRotateDetailsElement1 = clickHelpRotateElement.parentNode.getElementsByClassName("cesium-navigation-help-details")[1];
    clickHelpRotateDetailsElement1.innerHTML = _vm.lang.navigationHelp_Mouse_Rotate_details1;

    let touchHelpPanElement = touchHelpElement.getElementsByClassName("cesium-navigation-help-pan")[0];
    touchHelpPanElement.innerHTML = _vm.lang.navigationHelp_Touch_Pan;
    let touchHelpPanDetailsElement = touchHelpPanElement.parentNode.getElementsByClassName("cesium-navigation-help-details")[0];
    touchHelpPanDetailsElement.innerHTML = _vm.lang.navigationHelp_Touch_Pan_details;

    let touchHelpZoomElement = touchHelpElement.getElementsByClassName("cesium-navigation-help-zoom")[0];
    touchHelpZoomElement.innerHTML = _vm.lang.navigationHelp_Touch_Zoom;
    let touchHelpZoomDetailsElement = touchHelpZoomElement.parentNode.getElementsByClassName("cesium-navigation-help-details")[0];
    touchHelpZoomDetailsElement.innerHTML = _vm.lang.navigationHelp_Touch_Zoom_details;

    let touchHelpTiltElement = touchHelpElement.getElementsByClassName("cesium-navigation-help-rotate")[0];
    touchHelpTiltElement.innerHTML = _vm.lang.navigationHelp_Touch_Tilt;
    let touchHelpTiltDetailsElement = touchHelpTiltElement.parentNode.getElementsByClassName("cesium-navigation-help-details")[0];
    touchHelpTiltDetailsElement.innerHTML = _vm.lang.navigationHelp_Touch_Tilt_details;

    let touchHelpRotateElement = touchHelpElement.getElementsByClassName("cesium-navigation-help-tilt")[0];
    touchHelpRotateElement.innerHTML = _vm.lang.navigationHelp_Touch_Rotate;
    let touchHelpRotateDetailsElement = touchHelpRotateElement.parentNode.getElementsByClassName("cesium-navigation-help-details")[0];
    touchHelpRotateDetailsElement.innerHTML = _vm.lang.navigationHelp_Touch_Rotate_details;
  }

  /**
   * @time: 2018/11/133:31 PM
   * @author:QingMings(1821063757@qq.com)
   * @desc: 本地化全屏按钮
   *
   */
  _fullScreenButtonLang() {
    let _vm = this;
    if (!defined(_vm.viewer.fullscreenButton)) {
      return;
    }
    let tmpIsFullscreen= Cesium.knockout.getObservable(_vm.viewer.fullscreenButton.viewModel,"isFullscreen");
    delete _vm.viewer.fullscreenButton.viewModel.tooltip;
    Cesium.knockout.defineProperty(_vm.viewer.fullscreenButton.viewModel,"tooltip",function () {
      if (!_vm.viewer.fullscreenButton.viewModel.isFullscreenEnabled){
        return 'Full screen unavailable';
      }
      return tmpIsFullscreen() ? _vm.lang.exitFullScreen : _vm.lang.enterFullScreen;
    });
    // 重新绑定全屏按钮
    let fullScreenButtonElement = _vm.viewer.fullscreenButton.container.getElementsByClassName("cesium-fullscreenButton")[0];
    Cesium.knockout.cleanNode(fullScreenButtonElement);
    Cesium.knockout.applyBindings(_vm.viewer.fullscreenButton.viewModel,fullScreenButtonElement);
  }
}


如何使用呢
上面是一个ES 6 的类,构造函数需要传入Cesium.Viewer 对象。
也就是说,在Cesium.Viewer对象初始化之后就可以使用了。

 //   ... 省略非必要代码
//  创建 Cesium.Viewer
this.viewer = new Cesium.Viewer(options.container, options.viewerOptions);
// 创建对象,传入Cesium.Viewer对象。
this._local = new CesiumLocal(this.viewer)

本次分享的就是这些了,希望可以帮到大家。

本文转自 https://www.jianshu.com/p/9e28ecf7724f,如有侵权,请联系删除。

标签:lang,viewer,navigationHelp,vm,汉化,cesium,let,Cesium,思路
来源: https://www.cnblogs.com/hustshu/p/16247969.html

本站声明: 1. iCode9 技术分享网(下文简称本站)提供的所有内容,仅供技术学习、探讨和分享;
2. 关于本站的所有留言、评论、转载及引用,纯属内容发起人的个人观点,与本站观点和立场无关;
3. 关于本站的所有言论和文字,纯属内容发起人的个人观点,与本站观点和立场无关;
4. 本站文章均是网友提供,不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属;如您发现该文章侵犯了您的权益,可联系我们第一时间进行删除;
5. 本站为非盈利性的个人网站,所有内容不会用来进行牟利,也不会利用任何形式的广告来间接获益,纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

专注分享技术,共同学习,共同进步。侵权联系[81616952@qq.com]

Copyright (C)ICode9.com, All Rights Reserved.

ICode9版权所有