在越來越多的 App 中,原生介面與網頁內容並存已經是常見架構。特別是電商、旅遊、內容平台等應用,HTML 頁面往往不只是展示資訊,還需要與原生程式互相傳遞資料。本文整理三種常用且實用的 iOS 與 JS 互動方式。
JavaScriptCore.framework 可以直接在 Objective-C 中取得網頁的 JavaScript 執行環境,並註冊方法供 JS 呼叫。
JSContext *context = [webView valueForKeyPath:@"documentView.webView.mainFrame.javaScriptContext"];
context[@"passValue"] = ^{
NSArray *arguments = [JSContext currentArguments];
for (id value in arguments) {
NSLog(@"%@", value);
}
};
其中 passValue 是開放給 JS 呼叫的方法名稱,arguments 陣列中就是 JS 傳過來的參數。
function testClick() {
var str1 = document.getElementById("text1").value;
var str2 = document.getElementById("text2").value;
passValue(str1, str2);
}
當網頁中的按鈕或事件觸發時,只要呼叫 passValue,OC 端就能收到資料。
這種方式利用網頁跳轉時觸發的 shouldStartLoadWithRequest 代理方法,攔截自定義協議並解析參數。
function testClick() {
var str1 = document.getElementById("text1").value;
var str2 = document.getElementById("text2").value;
window.location.href = "objc://:/" + str1 + ":/" + str2;
}
- (BOOL)webView:(UIWebView *)webView
shouldStartLoadWithRequest:(NSURLRequest *)request
navigationType:(UIWebViewNavigationType)navigationType {
NSString *urlString = [[request URL] absoluteString];
if ([urlString hasPrefix:@"objc://"]) {
NSArray *parts = [urlString componentsSeparatedByString:@":/"];
if (parts.count >= 3) {
[self doSomethingWithParamA:parts[1] andParamB:parts[2]];
}
return NO;
}
return YES;
}
這種做法不需要額外套件,但要注意 URL 編碼、參數分隔符以及特殊字元處理。
若需要雙向溝通、回呼機制與較完整的橋接設計,可以考慮第三方庫 WebViewJavascriptBridge。
function setupWebViewJavascriptBridge(callback) {
if (window.WebViewJavascriptBridge) {
return callback(WebViewJavascriptBridge);
}
if (window.WVJBCallbacks) {
return window.WVJBCallbacks.push(callback);
}
window.WVJBCallbacks = [callback];
var iframe = document.createElement('iframe');
iframe.style.display = 'none';
iframe.src = 'wvjbscheme://__BRIDGE_LOADED__';
document.documentElement.appendChild(iframe);
setTimeout(function() {
document.documentElement.removeChild(iframe);
}, 0);
}
setupWebViewJavascriptBridge(function(bridge) {
bridge.registerHandler('testJavascriptHandler', function(data, responseCallback) {
var responseData = {
'Javascript Says': 'Right back atcha!'
};
responseCallback(responseData);
});
});
[WebViewJavascriptBridge enableLogging];
_bridge = [WebViewJavascriptBridge bridgeForWebView:web];
[_bridge setWebViewDelegate:self];
[_bridge callHandler:@"testJavascriptHandler"
data:@{@"年齡": @"20"}];
[_bridge registerHandler:@"passValue"
handler:^(id data, WVJBResponseCallback responseCallback) {
NSLog(@"%@", data);
responseCallback(@"收到了");
}];
不論使用哪一種方式,傳值方法名稱與接收方法名稱都必須保持一致。若牽涉到使用者個資、登入狀態或敏感資料,也應在原生端做好驗證與加密處理。