1 Topic by MarcusT (edited by MarcusT 2010-03-22 10:49:54)

  • Registered: 2010-03-22
  • Posts: 9

Topic: Runtime feature support matrix/table

Given that each runtime has its own nuances and cannot be used 100% interchangeably (e.g. judging from the example page, the HTML4 and HTML5* runtimes don't seem to support adding multiple files to the queue), I think it's crucial that the API documentation features a feature comparison table.

Moreover, the JS API should expose a number of properties reflecting the same information (i.e. which features are available for the initiated control), so that the UI can dynamically reflect the capabilities (e.g. displaying different user instructions depending on whether single or multiple file selection is available, etc).


* CORRECTION: HTML5 does support multiple files but the dialog suggests singular - "File upload", whereas HTML4 displays the same dialog title but doesn't support multiple file selection. Can the HTML5 dialog title be altered (e.g. to "Select file(s) to upload") to make this clearer?

2 Reply by MarcusT (edited by MarcusT 2010-03-22 10:42:10)

  • Registered: 2010-03-22
  • Posts: 9

Re: Runtime feature support matrix/table

Information such as max filesize supported should also be included, using info from http://www.plupload.com/punbb/viewtopic.php?id=16 (and perhaps further investigation)

And of course the documentation already shows info such as "This runtime supports these features: dragdrop, jpgresize, pngresize, chunks" which can be used as the starting point for the feature support matrix/table that I am suggesting/requesting.

  • Spocke
  • Administrator
  • Offline
  • Registered: 2010-03-09
  • Posts: 353

Re: Runtime feature support matrix/table

I have now updated the matrix. Will soon add a required features property that will check so that all those features exists for the specific runtimes.

  • Registered: 2010-03-22
  • Posts: 9

Re: Runtime feature support matrix/table

Spocke wrote:

I have now updated the matrix.

Great, I didn't know you had one at all (hence my suggestion) - where is it?

Spocke wrote:

Will soon add a required features property that will check so that all those features exists for the specific runtimes.

Not quite sure what you mean here, please explain in greater detail?

  • Spocke
  • Administrator
  • Offline
  • Registered: 2010-03-09
  • Posts: 353

Re: Runtime feature support matrix/table

1) It's on the first page of the site:
http://www.plupload.com/

2) For example if you must have drag/drop + chunking. Then you will be able to define that in the init call using something like.

required_features : 'dragdrop,chunking'

Then all runtimes will be ignored that doesn't support those specific features. Why we need a specific config for this is things like HTML5 might support chunking in one browser but not the other.

  • Registered: 2010-03-22
  • Posts: 9

Re: Runtime feature support matrix/table

Ah! I only went to the home page when I first found Plupload, I was looking through the other pages (particularly the documentation) after that... could you duplicate the table in the documentation please?

And now that I understand it, I like your suggestion of specifying the required features and letting the init decide which available library fits best.

However, it will surely be necessary to handle a situation in which no library meets the requirements, in which case it would surely be better to initiate the best fit library, allow the (missing) features to be checked via JavaScript, and handle this accordingly, than to display no upload control at all? Hence I think being able to query the features as I suggested needs to complement your required_features parameter.