Go to file
Frank A. Krueger 29881a4e51
Merge pull request #64 from Lostsoul0589/master
Updated getting started steps to use msbuild while dot net cli has issues with Xamarin Forms
2018-01-09 16:19:34 -08:00
.vscode Don't show test build status 2017-06-19 00:15:48 -07:00
Documentation Add page used to measure text 2017-12-09 14:46:14 -08:00
Ooui Add Anchor, Forms.LinkLabel and LinkView 2017-12-28 14:01:00 -06:00
Ooui.AspNetCore Implement ImageRenderer (fixes #44) 2017-12-10 17:51:05 -08:00
Ooui.Forms Added SliderRenderer to Exports 2017-12-29 13:26:02 +01:00
PlatformSamples/AspNetCoreMvc Added Xuzzle sample 2017-12-12 21:22:13 +01:00
PlatformTests Add Android presentation to a web view 2017-07-07 18:04:09 -07:00
Samples Merge with latests changes 2017-12-29 13:25:54 +01:00
Tests Rename events to be DOM names (fix #41) 2017-12-10 15:07:33 -08:00
.editorconfig Update styling 2017-11-09 12:34:08 -08:00
.gitignore Cleanup xaml page and added design time xaml 2017-11-16 11:06:27 -08:00
LICENSE Add MIT license 2017-06-13 18:12:27 -07:00
Ooui.sln Added Xuzzle sample 2017-12-12 21:22:13 +01:00
README.md Updated build steps to use msbuild 2018-01-09 08:37:04 +00:00
ooui.service Update the service to always restart 2017-12-09 15:50:59 -08:00

README.md

Ooui Web Framework Build Status

Version Package Description
NuGet Package Ooui Core library with HTML elements and a server.
NuGet Package Ooui.Forms Xamarin.Forms backend using Ooui
NuGet Package Ooui.AspNetCore Integration with ASP.NET Core MVC

Ooui (pronounced weeee!) is a small cross-platform UI library for .NET that uses web technologies.

It presents a classic object-oriented UI API that controls a dumb browser. With Ooui, you get the full power of your favorite .NET programming language plus the ability to interact with your app using any device.

Try it Online

Head on over to http://ooui.mecha.parts to tryout the samples.

Try the Samples Locally

git clone git@github.com:praeclarum/Ooui.git
cd Ooui

dotnet restore
msbuild
dotnet run --project Samples/Samples.csproj --no-build

There is currently an issue with Xamarin.Forms and building from the dotnet cli, so for now we use the msbuild command and then set the --no-build flag on dotnet run but this will eventually change when the issue is resolved.

This will open the default starting page for the Samples. Now point your browser at http://localhost:8080/shared-button

You should see a button that tracks the number of times it was clicked. The source code for that button is shown in the example below.

Example Use

Here is the complete source code to a fully collaborative button clicking app.

using System;
using Ooui;

class Program
{
    static void Main(string[] args)
    {
        // Create the UI
        var button = new Button("Click me!");

        // Add some logic to it
        var count = 0;
        button.Click += (s, e) => {
            count++;
            button.Text = $"Clicked {count} times";
        };

        // Publishing makes an object available at a given URL
        // The user should be directed to http://localhost:8080/button
        UI.Publish ("/shared-button", button);

        // Don't exit the app until someone hits return
        Console.ReadLine ();
    }
}

Make sure to add a reference to Ooui before you try running!

dotnet add package Ooui

With just that code, the user will be presented with a silly counting button.

In fact, any number of users can hit that URL and start interacting with the same button. That's right, automatic collaboration!

If you want each user to get their own button, then you will instead Publish a function to create it:

Button MakeButton()
{
    var button = new Button("Click me!");
    var count = 0;
    button.Click += (s, e) => {
        count++;
        button.Text = $"Clicked {count} times";
    };
    return button;
}

UI.Publish("/button", MakeButton);

Now every user (well, every load of the page) will get their own button.

How it works

When the user requests a page, Ooui will connect to the client using a Web Socket. This socket is used to keep an in-memory model of the UI (the one you work with as a programmer) in sync with the actual UI shown to the user in their browser. This is done using a simple messaging protocol with JSON packets.

When the user clicks or otherwise interacts with the UI, those events are sent back over the web socket so that your code can deal with them.

Comparison

UI LibraryOouiXamarin.FormsASP.NET MVC
How big is it? 50 KB 650 KB 1,300 KB
Where does it run? Everywhere iOS, Android, Mac, Windows Everywhere
How do I make a button?
new Button()
new Button()
<button />
Does it use native controls? No, HTML5 controls Yes! HTML5 controls
What controls are available? All of those in HTML5 Xamarin.Forms controls All of those in HTML5
Which architecture will you force me to use? None, you're free MVVM MVC/MVVM
What's the templating language? C# XAML Razor
How do I style things? CSS baby! (soon) XAML resources CSS
Is there databinding? No :-( Yes! Debatable
Do I need to run a server? Nope Heck no Yes
Is it web scale? Yes? What's the web? Yes!