atk4 / ui Goto Github PK

should be new \atk4\ui\Exception()

Tree documentation and src file is there but is not working.

created, see demos/buttons.php

App->url() have hardcoded .php extension for pages. Sometimes we want to use different extension, .html for example.

Implement Lister and integration with Model

Our templates are similar to Moustache, but we use single bracket format {foo}. At this point we can refactor to use {{foo}}, but only for the tags.

Need a bit of a refactor for form saving especially into the SQL table. I'll open a PR momentarily.

App->url() can't reference current URL.

What if I want to just refer current URL and add some additional GET arguments.
For example, this won't work to get current page

$url = $app->url([null, ['new_id' => 123]]);

Arguments 👍

• more people will try Agile Data
• can shift some code out (e.g. Form field population)
• no need for MVC Controller
• better conception (all data must live somewhere!)

Arguments 👎

• unnecessary dependency, UI can work without Data.
• can be more appealing for users, bigger exposure
• better backwards compatibility

e.g. http://ui.agiletoolkit.org/demos/table.php

Doesn't tell where I am and what this page is about or what is header for this page

Implement a bunch of basic views form Semantic UI (non interactive)

Create demo pages

We require ability to create JS action from inside PHP that will re-load a component.

Grid relies on Column_Checkbox, but there is no such column class in UI.
https://github.com/atk4/ui/blob/develop/src/Grid.php#L148

It's possible for ATK loaders to load any dynamic content without anticipating what's inside. Loaded component may rely on 3rd party JavaScript code.

There should be a mechanism for 3rd party component to dynamically load JavaScript library and make sure it's fully loaded before initializing <script> code.

Scenario:

1. UI contains a button that pops-up a new dialog
2. Content contains a component that relies on on external JS code, e.g. Zoomcharts.com
3. Zoomchart library is loaded dynamically (unless it was loaded previously)
4. Zoomchart initialization code is executed.

WARNING: I have had problem with dynamic loading in the past in some situations for example WYSIWYG editors. Most jQuery based add-ons worked fine.

need to review and correct.

during form submission complains about https://github.com/macek/jquery-serialize-object not being available in the console log.

This works:

$view->on('click')->hide();

but this does not

$view->js('click')->hide();

I suspect that maybe init() is called more than once.

A button that executes call-back to update value is broken.

We need to find a good JavaScript libraries to:

• reloading parts of page through AJAX. jQuery.load() is a start, but we need loading progress, time-out handling and working with duplicate DIVs (replacing element itself not just it's content)
• manipulating URL, so when AJAX load completes, we can update the URL as well as handle "back" button properly.
• request authentication errors. Intercept jQuery requests and if they contain "non-authorized", then display message 'you have been logged off'

otherwise its' very confusing when jsCallback encounters error or some var-dump results are there.

currently in 'require'

Some things that need to be improved:

• jsReloader should not delete current content until new content is loaded. Otherwise content collapses causing screen to scroll up.
• jsReloader should accept additional parameters new jsReloader($view, ['foo'=>$bar])
• $bar above should allow jsExpression
• loader should show up only if loading takes longer than 1 second (over current content).

done in #18

• Can't find in code where we actually use jQuery->_include and load jquery.min.js. In demos we have hard-coded <script src="https://code.jquery.com/jquery-3.1.1.js"></script>
• Same story with jUniv - that's why $view->js()->univ()->reaload() doesn't work

When data is presented to the user, it needs to be formatted. Agile Data contains information about the type, and some meta information about the UI, but it does not contain logic for presenting data. That is a job of a User Interface.

For example, you may have a form field -> input, which will contain money, numeric, float etc. The field is theoretically the same, but the formatting logic is different.

👎 Traditionally we would use Field_Money, which knew how to display money and how to store it in the database.

• backward compatible
• great control over presentation of money field
• grid / lister can implement their own formatters on their own
• we can support custom formatters for custom types

👍 Alternatively we may introduce a new component just for formatting data. It can be used on Field_Line to display all sorts of things. It can also be used on Grid and Lister.

• use same formatter everywhere
• model can define formatters
• multiple formatters can be combined like in grid, but anywhere
• can invoke formatters in templates {name|uppercase}

Need to do research.

Need documentation!!

should also give a simple example.

Some components may require additional CSS / JS includes to function. The "Application" class needs to some methods for this.

Example:

$this->app->includeJS('https://code.jquery.com/jquery-3.1.1.js');

Additional note here - ability to install and use bundled resources.

Implement lister

Currently when you add column to grid, you can use:

$table->addColumn('name', new \atk4\ui\TableColumn\Link(['details.php?id={$id}']));

Columns contribute to formatting of the CELL but NOT DATA, so your "money" type will be formatted in 123,345.10 regardless. With existence of a Template (http://agile-ui.readthedocs.io/en/latest/grid.html#template) you already have a great deal of control over cell formatting. Finally you can extend TableColumn class and do more formatting yourself.

There may be cases, however, when multiple CELL formatters are necessary. For instance if you want to present "status" but also put a link over it. From the Agile UI perspective it complicates things, but if there are extensive use cases, then something like this could be implemented:

$grid->addColumn('rating', [
   new \atk4\ui\TableColumn\Template('{$rating} out of 10'),
   new \atk4\ui\TableColumn\Link('rate.php?id={$id}')
]);

I think this change can be done along with addition of un-named columns (e.g. radio boxes, actions, expanders etc).

Please provide your vote and comment below on a possible use-case I might have not considered

See code: