Skip to main content

Serving HTML content in an iOS app that works in iOS 7 and later (using Swift)

As I have mentioned in an earlier post, I really enjoying coding in Swift. Now what am I doing with it? Well I am trying to build an HTML5 app that must work on devices with iOS 7. So in iOS8 apple has introduced a whole bunch of features that facilitate easy communication between web content and lets just call it back-end Swift code, but those features are not in iOS 7. So why do I want to build something that would work in an older OS? well I do not expect existing iOS users to upgrade to iOS 8 straight away and i also know a couple of people who would be very reluctant to upgrade their iPhones to iOS 8.

Now in case you do not, you can have a read of the "Working with WebViews" section of this post, to know how to serve HTML content with WebViews. So when I started building my app, I wanted to know:

How do I invoke some Swift code from my HTML content?

Well the solution to this may feel a little bit "hacky" but it is a solution to achieve this.  The following are the steps to achieve it:
  • Add a UIWebViewDelegate to your class definition: The UIWebViewDelegate is a protocol in Swift. You can think of a protocol like a Java interface, which means the method that implements or conforms to the protocol must implement the methods defined by that protocol.
  • Implement the UIWebVIewDelegate protocol's methods: which in this case would be as follows 
optional func webView(webView: UIWebView, shouldStartLoadWithRequest request:   NSURLRequest, navigationType: UIWebViewNavigationType) -> Bool
optional func webViewDidStartLoad(webView: UIWebView)
optional func webViewDidFinishLoad(webView: UIWebView)
optional func webView(webView: UIWebView, didFailLoadWithError error: NSError)
  • The method of interest here is the one with the shouldStartLoadWithRequest parameter: So every time we send a request to load a url from a webpage in a webView, this method is invoked.
  • As you can see the method has a boolean return type: So if this method returns true, it means we load the url and if false, means we do not load the url. 
  • Great, so what do we do with all this info? To tie this all up, one way to trigger execution of Swift code from some HTML content in a webview is 
    • Have a javascript function in your html page, which on being called modifies window.location
    • This will invoke the webView method with the shouldStartLoadWithRequest parameter. At this point we can execute any Swift code that we would like to in our Swift class which in this case I suppose would be a ViewController.
    • Now use the shouldStartLoadWithRequest.path property to determine the request for the path to be loaded. 
    • So if it is just a request to trigger some Swift code then we just return false from that method.
So now we know how to trigger some Swift code from HTML code, so what about 

Getting some data in our Swift code from the HTML?

One way to accomplish this  is using the UIWebView method stringByEvaluatingJavaScriptFromString that fetches us an optional String. So say we have a DOM element in our HTML file called "test", we can store some data in it and get it in our Swift code. Something like this,

var fromHtml:String? = view?.stringByEvaluatingJavaScriptFromString("document.getElementById('test').value")

To know more about an Optional value in Swift, I would recommend having a read of this article.

I will soon post a link to a Github or Bitbucket repository that hosts an XCode project that shows a working example of the concepts discussed here.




Comments

Popular posts from this blog

Upload to AWS S3 from Java API

In this post, you will see code samples for how to upload a file to AWS S3 bucket from a Java Spring Boot app. The code you will see here is from one of my open-source repositories on Github, called document-sharing. Problem Let’s say you are building a document sharing app where you allow your users to upload the file to a public cloud solution. Now, let’s say you are building the API for your app with Spring Boot and you are using AWS S3 as your public cloud solution. How would you do that? This blog post contains the code that can help you achieve that. Read more below,  Upload to AWS S3 bucket from Java Spring Boot app - My Day To-Do (mydaytodo.com)

Build a Full-Stack Image Upload App with Node.js, Express, React, and Vite (Beginner Tutorial)

 If you’re new to full-stack web development and want a hands-on project to practice React frontend integration with a Node.js + Express backend , this tutorial is for you. In this guide, we’ll walk through a simple but powerful app that lets users upload images, store them on the server, and display them back in the browser. This project is based on my GitHub repo: node-express-react-simple-fileupload . It’s designed to be beginner-friendly, SEO-optimized, and a great starting point for anyone learning JavaScript full-stack development . 🛠️ Technologies Used Here’s the tech stack powering this project: Node.js – JavaScript runtime for the backend. Express.js – Lightweight web framework for building REST APIs. Multer – Middleware for handling file uploads. CORS – Enables cross-origin requests between frontend and backend. React.js – Frontend library for building user interfaces. Vite – Fast development server and build tool for React. Fetch API – For making HTTP requests ...

Html5 based widget for an iOS app: Today extension powered by the Ionic framework

At some point the thought of adding a Widget to my iOS app came to mind which was followed by starting work on adding a widget for my app, My Day Todos . Obviously the first step was to learn how to add a Widget to an iOS app and in that learning process I discovered many things about widgets in iOS first of which was a widget in iOS is a an app extension i.e a  Today Extension . While I am still haven't finished working on the widget for my iOS app, I thought I would take some time out and share what I have learned. In this post, I will share a few important tips and provide an example of how to add a Widget to an iOS app and have the widget UI powered by Html5 via  Ionic framework . I added some code to my Github repo, Html5StarterAppWithSwift in order to show how this can be achieved. There are already too many tutorials out on the Web on how to add a Today extension to an iOS app so I won't be including that here. Instead I will focus on sharing some of the useful tip...