wTk Documentation

Overview

This project is for an open source toolkit that is intended to be compatible at the Tcl layer with Tk but implement its widgets via JavaScript in a web browser using HTML5/CSS3 and a connection pair, such as AJAX, WebSockets, socket.io, etc..

License

Open Source -- BSD
Click here to display the license.

Widgets

Clasic Widgets

Implemented

combobox	NEW Text field with popdown selection list.
frame	Create and manipulate frame widgets
label	Create and manipulate label widgets
textarea	NEW Create and manipulate multi-line text.

Partially Implemented

button	Create and manipulate button widgets
canvas	Create and manipulate canvas widgets
checkbutton	Create and manipulate checkbutton widgets
entry	Create and manipulate entry widgets

To Be Implemented

labelframe	Create and manipulate labelframe widgets
listbox	Create and manipulate listbox widgets
menu	Create and manipulate menu widgets
menubutton	Create and manipulate menubutton widgets
message	Create and manipulate message widgets
tk_optionMenu	Create an option menubutton and its menu
panedwindow	Create and manipulate panedwindow widgets
radiobutton	Create and manipulate radiobutton widgets
scale	Create and manipulate scale widgets
scrollbar	Create and manipulate scrollbar widgets
spinbox	Create and manipulate spinbox widgets
text	Create and manipulate text widgets

Themed Widgets

To Be Implemented

ttk_button	Widget that issues a command when pressed.
ttk_checkbutton	On/off widget.
ttk_combobox	text field with popdown selection list.
ttk_entry	Editable text field widget.
ttk_frame	Simple container widget.
ttk_image	Define an element based on an image.
ttk_intro	Introduction to the Tk theme engine.
ttk_label	Display a text string and/or image.
ttk_labelframe	Container widget with optional label.
ttk_menubutton	Widget that pops down a menu when pressed.
ttk_notebook	Multi-paned container widget.
ttk_panedwindow	Multi-pane container window.
ttk_progressbar	Provide progress feedback.
ttk_radiobutton	Mutually exclusive option widget.
ttk_scrollbar	Control the viewport of a scrollable widget.
ttk_separator	Separator bar.
ttk_sizegrip	Bottom-right corner resize widget.
ttk_style	Control overall look and feel of widgets.
ttk_treeview	hierarchical multicolumn data display widget.
ttk_widget	Standard options and commands supported by Tk themed widgets.

Geometry Management

Implemented

grid	Geometry manager that arranges widgets in a grid.

May Be Implemented

place	Geometry manager for fixed or rubber-sheet placement.
lower	Change a window's position in the stacking order.
raise	Change a window's position in the stacking order.

Not To Be Implemented

pack	Geometry manager that packs around edges of cavity.

Code Overview

index.html	Index page for the mini webserver.
server.tcl	Main demo application; it manages the webserver communication and creates wtk interpreters which actually run demos for a client.
httpd.tcl	Generic minihttpd.tcl-based webserver (nothing wtk specific).
demo1.html	Web page for an application, which initializes the Javascript side of wtk and connects to the wtk interpreter for this client on the server and waits for further instructions.
wtk.js	Javascript library for the client side of wtk.
demo1.tcl	wtk code for the specific demo application, run in a separate interpreter on the server for each client.
demo2.tcl	feet to meters calculator from tkdocs site
sketch.tcl	freehand sketch on canvas
wtk.tcl	Application (server) side of wtk, which implements the Tk-like API, sending to and receiving messages from the Javascript code on the web side (just loads each of the wtk-*.tcl files).
lib/wtk-base.tcl	Generic datatypes, global commands, etc.
widgets/wtk-widgets.tcl	Main widget file, causes all widget files in the widgets directory to load.
geomanager/wtk-grid.tcl	Grid geometry management.
tests/wtk.test	Test suite, mostly works by analyzing protocol.