上次談的是 OC 呼叫 JS——透過原生程式操作網頁的 JS,進行增刪改查與方法呼叫。這次換個方向,來看JS 怎麼呼叫 OC。
在 iOS 開發中,JS 呼叫 OC 主要就靠這個方法:
#pragma mark - <UIWebViewDelegate>
/** 透過這個方法完成 JS 呼叫 OC */
- (BOOL)webView:(UIWebView *)webView
shouldStartLoadWithRequest:(NSURLRequest *)request
navigationType:(UIWebViewNavigationType)navigationType {
// 取得請求的 URL 資料
NSString *str = request.URL.absoluteString;
NSLog(@"URL-String = %@", str);
return YES;
}
原理很單純:每當 webView 要發起請求時就會呼叫此方法,並把請求參數交給我們。透過 request.URL.absoluteString 就能看到請求的 URL(JS 內部可以自訂這個 URL 路徑)。於是只要攔下請求、篩選特定格式、解析內容,就能觸發對應的 OC 方法。
當我們操作網頁內容時,這些請求路徑就會被印出來:

下面用 HTML 排了一個簡易的登入介面(CSS 只負責排版,這裡省略)。頁面裡刻意放了一個「百度一下」的連結,目的有兩個:一是用來測試 OC 端能否抓到請求 URL,二是順便證明這是網頁而不是原生介面。
<body> <div id="name" align="center"> <input id="userName" placeholder="請輸入用戶名"/> </div> <div id="pwd" align="center"> <input id="password" placeholder="請輸入密碼" type="password"/> </div> <div id="login" align="center"> <button class="button">登錄</button> </div> <br /><br /><br /> <div align="center"> <a href="https://www.baidu.com">百度一下</a> </div> </body>

接著用 JS 抓取輸入框與按鈕,監聽點擊事件,並在點擊時把使用者輸入的值拼到一個自訂協定的 URL 後面。
<body>
<!-- 呼叫 javascript -->
<script type="text/javascript">
<!-- 透過 id 取得輸入框 -->
var userName = document.getElementById('userName');
var password = document.getElementById('password');
<!-- 透過 id 取得按鈕 -->
var button = document.getElementById('login');
<!-- 為按鈕加上點擊方法 -->
button.onclick = function(){
var name = userName.value;
var pwd = password.value;
if (!name || !pwd) {
alert('用戶名或密碼為空!');
return;
}
// href 是 Hypertext Reference 的縮寫,值可以是相對或絕對 URL,
// 包含片段標識符與 JavaScript 碼段
window.location.href = 'text://loginAction:pwd:' + '?' + name + '?' + pwd;
}
</script>
</body>
重點在最後那行:按鈕被點擊時,瀏覽器會發起一個 text:// 開頭的請求,並把帳號與密碼用 ? 串接起來。這個請求會被 OC 的代理方法攔下,於是資料就從網頁流到了原生。
這裡示範一個假的登入流程:帳號與密碼相同(且都不能為空)才算登入成功。
#pragma mark - <UIWebViewDelegate>
/** 透過這個方法完成 JS 呼叫 OC
* JS 與 OC 互動的第三方框架:WebViewJavaScriptBridge
*/
- (BOOL)webView:(UIWebView *)webView
shouldStartLoadWithRequest:(NSURLRequest *)request
navigationType:(UIWebViewNavigationType)navigationType {
NSString *str = request.URL.absoluteString;
NSLog(@"requestURL-String = %@", str);
// 找出自訂標記符 text:// 的位置
NSRange range = [str rangeOfString:@"text://"];
if (range.location != NSNotFound) {
// 取出標記符之後的字串(方法名?帳號?密碼?)
NSString *params = [str substringFromIndex:range.location + range.length];
// 用 ? 切開參數
NSArray *subStrings = [params componentsSeparatedByString:@"?"];
NSString *methodStr = subStrings.firstObject; // 方法名
NSString *userName = subStrings[1]; // 帳號
NSString *password = subStrings.lastObject; // 密碼
// 動態執行方法並傳入兩個參數
[self performSelector:NSSelectorFromString(methodStr)
withObject:userName
withObject:password];
}
return YES;
}
/**
* 登入方法
* @param name 用戶名
* @param pwd 密碼
*/
- (void)loginAction:(NSString *)name pwd:(NSString *)pwd {
// 模擬登入:帳號 != 密碼 即失敗
if (![name isEqualToString:pwd]) {
UIAlertController *alertVC =
[UIAlertController alertControllerWithTitle:@"溫馨提示"
message:@"用戶名或密碼錯誤,請重新輸入"
preferredStyle:UIAlertControllerStyleAlert];
UIAlertAction *cancel =
[UIAlertAction actionWithTitle:@"確定"
style:UIAlertActionStyleCancel
handler:nil];
[alertVC addAction:cancel];
[self presentViewController:alertVC animated:YES completion:nil];
return;
}
// 登入成功,進入下一頁
SuccessViewController *svc = [[SuccessViewController alloc] init];
svc.userName = name;
svc.password = pwd;
[self presentViewController:svc animated:YES completion:nil];
}
解析邏輯拆解如下:先用 rangeOfString: 找到 text:// 這個標記符,若存在就取出後面的字串,再以 ? 切成分段。第一段是方法名,後面兩段是帳號與密碼。最後透過 performSelector:withObject:withObject: 把方法名動態轉成 selector 執行。
這裡有個關鍵要注意:JS 端傳出的方法名,必須與 OC 端實際要呼叫的方法名完全一致,否則會拋出找不到方法的例外。
執行結果依序如下。首先是 JS 端的提示框:

帳號密碼不一致時,由 OC 攔下並提示錯誤:

帳號密碼相同時,跳轉到下一頁:

整套機制其實就兩個環節:第一,JS 在按鈕的點擊方法中設定一個自訂協定的 URL,把資料拼在後面;第二,OC 在 WebView 的代理方法裡攔截這個請求,解析結構後呼叫自己的方法。原理簡單,但這正是 Hybrid 應用的地基。實務專案裡若要更完整的方案,可以考慮 WebViewJavaScriptBridge 這類成熟框架。