目前好几个月没有做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)
本次分享的就是这些了,希望可以帮到大家。