2014-08-26 12:08:26 +08:00
|
|
|
/****************************************************************************
|
2015-03-24 14:12:58 +08:00
|
|
|
Copyright (c) 2014-2015 Chukong Technologies Inc.
|
2014-08-26 12:08:26 +08:00
|
|
|
|
|
|
|
http://www.cocos2d-x.org
|
|
|
|
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
|
|
in the Software without restriction, including without limitation the rights
|
|
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
|
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
|
|
all copies or substantial portions of the Software.
|
|
|
|
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
|
|
THE SOFTWARE.
|
|
|
|
****************************************************************************/
|
2014-08-25 13:44:38 +08:00
|
|
|
|
2014-09-15 16:56:51 +08:00
|
|
|
#ifndef __COCOS2D_UI_WEBVIEW_H
|
|
|
|
#define __COCOS2D_UI_WEBVIEW_H
|
2014-08-25 13:44:38 +08:00
|
|
|
|
2014-09-17 22:30:15 +08:00
|
|
|
#include "platform/CCPlatformConfig.h"
|
|
|
|
|
|
|
|
#if (CC_TARGET_PLATFORM == CC_PLATFORM_ANDROID || CC_TARGET_PLATFORM == CC_PLATFORM_IOS || CC_TARGET_PLATFORM == CC_PLATFORM_WIN32)
|
2014-08-26 11:39:56 +08:00
|
|
|
|
|
|
|
|
2014-08-25 13:44:38 +08:00
|
|
|
#include "ui/UIWidget.h"
|
2014-09-18 16:33:46 +08:00
|
|
|
#include "ui/GUIExport.h"
|
2014-08-25 13:44:38 +08:00
|
|
|
#include "base/CCData.h"
|
|
|
|
|
2015-03-24 14:12:58 +08:00
|
|
|
/**
|
|
|
|
* @addtogroup ui
|
|
|
|
* @{
|
|
|
|
*/
|
|
|
|
|
2014-08-26 11:39:56 +08:00
|
|
|
NS_CC_BEGIN
|
|
|
|
namespace experimental{
|
|
|
|
namespace ui{
|
|
|
|
|
2014-08-25 13:44:38 +08:00
|
|
|
class WebViewImpl;
|
|
|
|
|
2015-03-19 10:38:12 +08:00
|
|
|
/**
|
|
|
|
* @brief A View that displays web pages.
|
|
|
|
*
|
|
|
|
* @note WebView displays web pages base on system widget.
|
|
|
|
* It's mean WebView displays web pages above all graphical elements of cocos2d-x.
|
|
|
|
*/
|
2014-09-18 16:33:46 +08:00
|
|
|
class CC_GUI_DLL WebView : public cocos2d::ui::Widget {
|
2014-08-25 13:44:38 +08:00
|
|
|
public:
|
|
|
|
/**
|
2015-03-19 10:38:12 +08:00
|
|
|
* Allocates and initializes a WebView.
|
|
|
|
*/
|
2014-08-25 13:44:38 +08:00
|
|
|
static WebView *create();
|
|
|
|
|
|
|
|
/**
|
2015-03-19 10:38:12 +08:00
|
|
|
* Set javascript interface scheme.
|
|
|
|
*
|
2015-03-27 17:09:54 +08:00
|
|
|
* @see WebView::setOnJSCallback()
|
2015-03-19 10:38:12 +08:00
|
|
|
*/
|
2014-08-25 13:44:38 +08:00
|
|
|
void setJavascriptInterfaceScheme(const std::string &scheme);
|
|
|
|
|
|
|
|
/**
|
2015-03-19 10:38:12 +08:00
|
|
|
* Sets the main page contents, MIME type, content encoding, and base URL.
|
|
|
|
*
|
|
|
|
* @param data The content for the main page.
|
|
|
|
* @param MIMEType The MIME type of the data.
|
|
|
|
* @param encoding The encoding of the data.
|
|
|
|
* @param baseURL The base URL for the content.
|
|
|
|
*/
|
2014-08-26 12:08:26 +08:00
|
|
|
void loadData(const cocos2d::Data &data,
|
|
|
|
const std::string &MIMEType,
|
|
|
|
const std::string &encoding,
|
|
|
|
const std::string &baseURL);
|
|
|
|
|
2014-08-25 13:44:38 +08:00
|
|
|
/**
|
2015-03-19 10:38:12 +08:00
|
|
|
* Sets the main page content and base URL.
|
|
|
|
*
|
|
|
|
* @param string The content for the main page.
|
|
|
|
* @param baseURL The base URL for the content.
|
|
|
|
*/
|
2015-01-23 18:30:12 +08:00
|
|
|
void loadHTMLString(const std::string &string, const std::string &baseURL = "");
|
2014-08-25 13:44:38 +08:00
|
|
|
|
|
|
|
/**
|
2015-03-19 10:38:12 +08:00
|
|
|
* Loads the given URL.
|
|
|
|
*
|
|
|
|
* @param url Content URL.
|
|
|
|
*/
|
2014-09-15 18:02:11 +08:00
|
|
|
void loadURL(const std::string &url);
|
2014-08-25 13:44:38 +08:00
|
|
|
|
|
|
|
/**
|
2015-03-19 10:38:12 +08:00
|
|
|
* Loads the given fileName.
|
|
|
|
*
|
|
|
|
* @param fileName Content fileName.
|
|
|
|
*/
|
2014-08-25 13:44:38 +08:00
|
|
|
void loadFile(const std::string &fileName);
|
|
|
|
|
|
|
|
/**
|
2015-03-19 10:38:12 +08:00
|
|
|
* Stops the current load.
|
|
|
|
*/
|
2014-08-25 13:44:38 +08:00
|
|
|
void stopLoading();
|
|
|
|
|
|
|
|
/**
|
2015-03-19 10:38:12 +08:00
|
|
|
* Reloads the current URL.
|
|
|
|
*/
|
2014-08-25 13:44:38 +08:00
|
|
|
void reload();
|
|
|
|
|
|
|
|
/**
|
2015-03-19 10:38:12 +08:00
|
|
|
* Gets whether this WebView has a back history item.
|
|
|
|
*
|
|
|
|
* @return WebView has a back history item.
|
|
|
|
*/
|
2014-08-25 13:44:38 +08:00
|
|
|
bool canGoBack();
|
|
|
|
|
|
|
|
/**
|
2015-03-19 10:38:12 +08:00
|
|
|
* Gets whether this WebView has a forward history item.
|
|
|
|
*
|
|
|
|
* @return WebView has a forward history item.
|
|
|
|
*/
|
2014-08-25 13:44:38 +08:00
|
|
|
bool canGoForward();
|
|
|
|
|
|
|
|
/**
|
2015-03-19 10:38:12 +08:00
|
|
|
* Goes back in the history.
|
|
|
|
*/
|
2014-08-25 13:44:38 +08:00
|
|
|
void goBack();
|
|
|
|
|
|
|
|
/**
|
2015-03-19 10:38:12 +08:00
|
|
|
* Goes forward in the history.
|
|
|
|
*/
|
2014-08-25 13:44:38 +08:00
|
|
|
void goForward();
|
|
|
|
|
|
|
|
/**
|
2015-03-19 10:38:12 +08:00
|
|
|
* Evaluates JavaScript in the context of the currently displayed page.
|
|
|
|
*/
|
2014-08-25 13:44:38 +08:00
|
|
|
void evaluateJS(const std::string &js);
|
|
|
|
|
|
|
|
/**
|
2015-03-19 10:38:12 +08:00
|
|
|
* Set WebView should support zooming. The default value is false.
|
|
|
|
*/
|
2014-08-25 13:44:38 +08:00
|
|
|
void setScalesPageToFit(const bool scalesPageToFit);
|
2014-09-15 18:02:11 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Call before a web view begins loading.
|
2015-03-19 10:38:12 +08:00
|
|
|
*
|
2015-03-27 17:09:54 +08:00
|
|
|
* @param callback The web view that is about to load new content.
|
2014-09-15 18:02:11 +08:00
|
|
|
* @return YES if the web view should begin loading content; otherwise, NO .
|
|
|
|
*/
|
2014-09-17 22:30:15 +08:00
|
|
|
void setOnShouldStartLoading(const std::function<bool(WebView *sender, const std::string &url)>& callback);
|
2014-09-15 18:02:11 +08:00
|
|
|
|
2015-03-19 10:38:12 +08:00
|
|
|
typedef std::function<void(WebView *sender, const std::string &url)> ccWebViewCallback;
|
|
|
|
|
2014-09-15 18:02:11 +08:00
|
|
|
/**
|
|
|
|
* Call after a web view finishes loading.
|
2015-03-19 10:38:12 +08:00
|
|
|
*
|
2015-03-27 17:09:54 +08:00
|
|
|
* @param callback The web view that has finished loading.
|
2014-09-15 18:02:11 +08:00
|
|
|
*/
|
2014-09-18 11:52:23 +08:00
|
|
|
void setOnDidFinishLoading(const ccWebViewCallback& callback);
|
2014-09-15 18:02:11 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Call if a web view failed to load content.
|
2015-03-19 10:38:12 +08:00
|
|
|
*
|
2015-03-27 17:09:54 +08:00
|
|
|
* @param callback The web view that has failed loading.
|
2014-09-15 18:02:11 +08:00
|
|
|
*/
|
2014-09-18 11:52:23 +08:00
|
|
|
void setOnDidFailLoading(const ccWebViewCallback& callback);
|
2014-09-15 18:02:11 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* This callback called when load URL that start with javascript interface scheme.
|
|
|
|
*/
|
2014-09-18 11:52:23 +08:00
|
|
|
void setOnJSCallback(const ccWebViewCallback& callback);
|
2014-09-15 18:02:11 +08:00
|
|
|
|
2014-09-17 22:30:15 +08:00
|
|
|
std::function<bool(WebView *sender, const std::string &url)> getOnShouldStartLoading()const;
|
2014-09-18 11:52:23 +08:00
|
|
|
ccWebViewCallback getOnDidFinishLoading()const;
|
|
|
|
ccWebViewCallback getOnDidFailLoading()const;
|
|
|
|
ccWebViewCallback getOnJSCallback()const;
|
2015-03-19 10:38:12 +08:00
|
|
|
|
|
|
|
virtual void draw(cocos2d::Renderer *renderer, cocos2d::Mat4 const &transform, uint32_t flags) override;
|
|
|
|
|
|
|
|
virtual void setVisible(bool visible) override;
|
2014-09-15 18:02:11 +08:00
|
|
|
|
|
|
|
protected:
|
|
|
|
virtual cocos2d::ui::Widget* createCloneInstance() override;
|
|
|
|
virtual void copySpecialProperties(Widget* model) override;
|
|
|
|
|
2014-09-17 22:30:15 +08:00
|
|
|
std::function<bool(WebView *sender, const std::string &url)> _onShouldStartLoading;
|
2014-09-15 18:02:11 +08:00
|
|
|
|
2014-09-18 11:52:23 +08:00
|
|
|
ccWebViewCallback _onDidFinishLoading;
|
2014-09-15 18:02:11 +08:00
|
|
|
|
2014-09-18 11:52:23 +08:00
|
|
|
ccWebViewCallback _onDidFailLoading;
|
2014-09-15 18:02:11 +08:00
|
|
|
|
2014-09-18 11:52:23 +08:00
|
|
|
ccWebViewCallback _onJSCallback;
|
2014-09-15 18:02:11 +08:00
|
|
|
|
|
|
|
/**
|
2015-03-19 10:38:12 +08:00
|
|
|
* Default constructor.
|
2014-09-15 18:02:11 +08:00
|
|
|
*/
|
|
|
|
WebView();
|
|
|
|
|
|
|
|
/**
|
2015-03-19 10:38:12 +08:00
|
|
|
* Default destructor.
|
2014-09-15 18:02:11 +08:00
|
|
|
*/
|
|
|
|
virtual ~WebView();
|
2014-08-25 13:44:38 +08:00
|
|
|
|
|
|
|
private:
|
2014-08-26 11:39:56 +08:00
|
|
|
WebViewImpl *_impl;
|
2014-09-15 18:02:11 +08:00
|
|
|
friend class WebViewImpl;
|
2014-08-25 13:44:38 +08:00
|
|
|
};
|
2014-08-26 11:39:56 +08:00
|
|
|
|
2014-08-26 22:03:55 +08:00
|
|
|
} // namespace ui
|
2014-08-26 12:08:26 +08:00
|
|
|
} // namespace experimental
|
2014-08-26 22:03:55 +08:00
|
|
|
}//namespace cocos2d
|
2014-08-26 11:39:56 +08:00
|
|
|
|
|
|
|
#endif
|
2015-03-24 14:12:58 +08:00
|
|
|
// end group
|
|
|
|
/// @}
|
2014-09-15 16:56:51 +08:00
|
|
|
#endif //__COCOS2D_UI_WEBVIEW_H
|