I gave a talk at ElixirConf 2015 on combining the Phoenix web framework with the Elm programming language. This is the tutorial that was referred to in that talk.
The tutorial walks through the creation of a very basic seat saving application, like one you'd use when booking a flight for example. The application will do just enough to demonstrate the mechanisms for getting the two technologies talking to each other.
There is an accompanying repo for this tutorial. Each of the numbered steps has an associated commit so that you can just look at the diffs if you'd rather not read through the whole thing.
Adding a simple View
OK so now we have a basic Phoenix application into which we've embedded a simple Elm application. Let's start to flesh out our Elm application a little. Elm has a Model - Update - View architecture. Let's take a look at what that means:
- Model Elm keeps its state in one single place, the Model. The Model is immutable.
- Update Elm has an update function that steps the model from one state to the next. It receives a Message (detailing a task to be performed) and the current model, and then swaps out the current model for a new one.
- View A representation of the current model that can be displayed to the user, be that HTML, SVG or some other visual representation.
We'll start with the View. We want to create a simple representation of an airplane with seats that we can book. Something like this.
It's not the most accurate rendition, but it's just enough for us to demonstrate everything we need to.
- Open web/elm/SeatSaver.elm.
Now we can create a View function. A View function is just an ordinary function that returns HTML. That is to say that its return value must be of the type
Html
. Elm is a statically typed language, so every value has a type. Luckily for us Elm also uses type inference so that we don't typically have to declare what type a value has. We'll explain more about types as we go through the tutorial, covering what we need to know when we need to know it. For now, change themain
function as follows:main = view -- VIEW view = Html.text "Woo hoo, I'm in a View"
A few other things to note here are that
--VIEW
is just a standard Elm comment and has no special value. We're going to put all of our Elm code in one file in this tutorial to keep it easier to see what's going on. These comments will help us to find things as we add more code.Also, in Elm, we idiomatically place two new lines between function definitions.
If you check your browser now (start the server with
iex -S mix phoenix.server
if it's not already running) you should see something like this.
What we actually want to display here is a bunch of seats, but in order to do that we need to know what seat data is going to look like. For that we need to introduce the Model. Let's do that next.
Summary
We now have a simple view for our Elm application. In Part 4 we'll introduce a Model and expand our View.