Hi,
I can't help but think that I may be asking questions with obvious answers because I don't find the information in the Getting Started Guide, The Sigma Visual Manual, or in this forum. I do need to learn more CSS and overall linb workings, the latter being more difficult and hopefully you can help with that. I find the linb library and the GUI Builder very good. The documentation is fairly good, although for me the following would help:
1. A lot more tutorials and examples.
2. The DOM is well-documented. A complete description of how to do in linb each thing that can be done in the DOM would be helpful. And/or how to access each underlying DOM element and attribute. For example, when to use "KEY" versus "INPUT" (versus other)? to set a background color.
3. Update API method descriptions with tutorial-type information: why one would want to use the method, and how, in an example.
4. The comments for many of the methods say that maybe the code explains the method. This could be replaced with real explanations.
5. Add an overview of UI Profiles. What are UI Profiles?
6. Between the GUI Builder output and posts on this forum, I've seen three (maybe 4) different ways to create an app (below). What is each method best suited for? / When to use one method instead of another?
7.1. Gui Builder output, then linb.Com.load()
7.2. Gui Builder output, then:
function My_App()
{
app = new App;
app.iniComponents();
linb('gui').append( app.getUIComponents() ); // "gui" is a div id
}
linb.main( My_App );
7.3. It appears that one can make a bunch of linb.create() calls.
7.4. In section 5.1 of the Cookbook - Getting Started Guide:
Namespace("App");
linb.include("App.MyName",
linb.getPath("mypath"),
function() {
var x = new App.MyName();
x.show();
} ...
The example is for a dialog, but an entire app could be run this way, correct? Is this show() doing the iniComponents() from 7.2 above? How does that all work?
7.5. Other ways?
8. Examples of using (in the GUI Builder) Custom Style, Custom Class, Custom Behaviors, and Custom Functions. What is the syntax that should be used for each?
Other questions:
1. I'm trying to get the app to center horizontally, and move when the browser window is re-sized. What is the best way to do this? I've tried
<div style="width:100%; text-align:center;">
<div id="gui" style="margin:0 auto; width: 1024px; margin-left: auto; margin-right: auto;"></div> <!-- Location for the GUI to reside in. -->
</div>
but the linb lib appears to be overriding this and the app is placed on the left. Even after commenting-out the .setLeft() code etc that the Builder generated. I'm using .setDock("top"), by the way.
2. I've placed the generated app on a pane below a div, both on a main pane. Is this good or bad? What would you do in regards to panes on panes etc?
3. What is the best way to apply an external CSS to the generated app? linb.CSS.addStyleSheet("/static/css/mainstyles.css");? Or
<head>
<link href="
http://127.0.0.1:8000/has/static/css/mainstyles.css" rel="stylesheet" type="text/css" />
</head>?
Other?
4. Linb appears to be overriding the background color of panes on the tabbed window. How can the background color of these be set?
5. How can a border be given to the TreeGrid? I've tried .setProperties( {border:"solid 1px"} ), which has no effect.
6. Is this valid: .setProperties("overflow", "auto")? Or should it be .setProperties ( { overflow: "auto"} )?
Sorry for the long post, but thank you very much for your help,
Bruce
