@@ -173,47 +173,14 @@ The `options` are passed (almost) verbatim to the DataTables clientside construc
173173options. Only options which are meaningful to be defined serverside can be set at this level, so
174174setting callbacks and events is not possible. These are however easily set on the Javascript end.
175175
176- # Core concepts
177-
178- This chapter details various base building blocks used in the bundle.
179-
180- # # Adapters
176+ # Adapters
181177
182178Adapters are the core elements bridging DataTables functionality to their underlying data source.
183179Popular implementations for common data sources are provided, and more are welcomed.
184180
185181An adapter is called by the bundle when a request for data has been formulated, including search
186182and sorting criteria, and returns a result set with metadata on record counts.
187183
188- # # Columns
189-
190- Column classes derive from `AbstractColumn`, and implement the transformations required to convert
191- raw data into output ready for rendering in a DataTable.
192-
193- # # DataTable types
194-
195- ` ` ` php?start_inline=1
196- $table = $this->createDataTableFromType(PresidentsTableType::class)
197- ->handleRequest($request);
198- ` ` `
199-
200- Having the table configuration in your controller is convenient, but not practical for reusable or
201- extensible tables, or highly customized tables. In the example above we could also create a class
202- ` DataTable\T ype\P residentsTableType` in our app bundle, and make it implement
203- ` Omines\D ataTablesBundle\D ataTableTypeInterface` . We can then use the code illustrated here to
204- instantiate the reusable class in the controller.
205-
206- This ensures your controllers stay lean and short, and only delegate tasks. The first parameter
207- takes either a Fully Qualified Class Name (FQCN) to instantiate the class dynamically, or a
208- registered service with a `datatables.type` tag. Use a service if you need to inject dependencies
209- dynamically. When using Symfony's autoconfiguration the tag will be applied automatically.
210-
211- Of course you can modify the base type to fit the controller's specific needs before calling
212- ` handleRequest` . Secondly, the `createDataTableFromType` function accepts an array as a second
213- argument which is passed to the type class for parametrized instantiation.
214-
215- # Adapters
216-
217184Ready-made adapters are supplied for easy integration with various data sources.
218185
219186# # Doctrine ORM
@@ -246,4 +213,43 @@ tables in your site.
246213
247214# # Arrays
248215
216+ TBD.
217+
249218# # Implementing your own
219+
220+ TBD.
221+
222+ # Columns
223+
224+ Column classes derive from `AbstractColumn`, and implement the transformations required to convert
225+ raw data into output ready for rendering in a DataTable.
226+
227+ # # TextColumn
228+
229+ TBD.
230+
231+ # # DateTimeColumn
232+
233+ TBD.
234+
235+ # DataTable Types
236+
237+ ` ` ` php?start_inline=1
238+ $table = $this->createDataTableFromType(PresidentsTableType::class)
239+ ->handleRequest($request);
240+ ` ` `
241+
242+ Having the table configuration in your controller is convenient, but not practical for reusable or
243+ extensible tables, or highly customized tables. In the example above we could also create a class
244+ ` DataTable\T ype\P residentsTableType` in our app bundle, and make it implement
245+ ` Omines\D ataTablesBundle\D ataTableTypeInterface` . We can then use the code illustrated here to
246+ instantiate the reusable class in the controller.
247+
248+ This ensures your controllers stay lean and short, and only delegate tasks. The first parameter
249+ takes either a Fully Qualified Class Name (FQCN) to instantiate the class dynamically, or a
250+ registered service with a `datatables.type` tag. Use a service if you need to inject dependencies
251+ dynamically. When using Symfony's autoconfiguration the tag will be applied automatically.
252+
253+ Of course you can modify the base type to fit the controller's specific needs before calling
254+ ` handleRequest` . Secondly, the `createDataTableFromType` function accepts an array as a second
255+ argument which is passed to the type class for parametrized instantiation.
0 commit comments