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)

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

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,294评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,493评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,790评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,595评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,718评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,906评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,053评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,797评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,250评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,570评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,711评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,388评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,018评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,796评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,023评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,461评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,595评论 2 350