Download the PHP package ttek/tk-domtemplate without Composer
On this page you can find all versions of the php package ttek/tk-domtemplate. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ttek/tk-domtemplate
More information about ttek/tk-domtemplate
Files in ttek/tk-domtemplate
Package tk-domtemplate
Short Description Tk8 Lib: PHP DOM Template library with inline SCSS file compiler
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package tk-domtemplate
PHP DomTemplate :boom:
Project: ttek/tk-domtemplate
Web: http://www.domtemplate.com/
Authors: Michael Mifsud http://www.tropotek.com/
A PHP5 DOM Template engine for XHTML/XML
Contents
- Installation
- Introduction
- VAR
- CHOICE
- REPEAT
- Forms
- Misc Functions
- Auto Renderer
- Loader
- PHP Examples
Installation
Available on Packagist (ttek/tk-domtemplate) and as such installable via Composer.
Or add the following to your composer.json file:
If you do not use Composer, you can grab the code from GitHub, and use any PSR-0 compatible autoloader (e.g. the PHP DomTemplate) to load the classes.
Introduction
NOTE: This engine uses the PHP DOM module that requires that all documents loaded into it must be strict XML/XHTML markup. Close all tags and ensure all & are &, even in URL query strings.
The DOM template engine has been developed so designers have a simple way to communicate to build templates and communicate their requirements to developers.
There are three custom attributes the template engine uses. These are:
- var: Is used to allow to add attributes and content to a node.
- choice: Is used to hide/show a node and its contents
- repeat: For repeating data like lists or tables.
Do not be concerned that these attributes do not meet the HTML5 spec or some other spec because they are removed once the template is parsed.
That's all there is to it from a designers point of view. For a developer it makes interacting with HTML template easy without overriding any of the designers hard work.
PHP DOMTemplate also comes with a number of other features that help when rendering forms, css, javascript metatags, etc. The following sections will outline how to use these. Also check out the code examples to see how we have used the DOMTemplate.
VAR
This is the var attribute. This us used in a node if you want to modify its content or attributes.
The following is an example of a var being used within a template:
With this template the developer can then build coe to manipulate this node how they see fit:
CHOICE
A choice attribute allows for the removal of a dom node.
If the attribute exists then the node is removed by default. you must call setChoice().
See the example below.
so by default this node would be removed from the DOM tree. To keep it visible simply use:
REPEAT
A repeat attribute is used for repeating data such as lists or tables. The repeat blocks can contain nested var, choice, repeat
nodes as well.
When retreiving the repeat object from a template it is important to note that the repeat object is a subClass of the Template object
and thus has the same functionality with the added extra call to appendRepeat(); that is called when you are finished rendering a repeat
and want it appended to its parent template node.
See the example below.
With the repeat markup set you can then go ahead and populate your list or table.
FORM
Forms are handled a little differently with the DOMTemplate object. You do not need any vars or choices to access a form element node, but you can if you wish.
If we are given the following basic form:
Then we can access the form through the code lik this:
Misc Methods
For CSS and Javascript we have added some unique methods, these allow you to call the insertTemplate(), \ appendTemplate(), insertDoc(), appendDoc(), etc.. methods and the javascript and CSS will be inserted into the parents
tag. This allows you insert these scripts or URLS anywhere in the rendering process as long as the final parent template has a Head tag.-
appendCss():
-
appendCssUrl():
-
appendJs():
- appendJsUrl():
This functionality is fantastic if you want to iterate over the DOMTemplate just before displaying the document and manipulate all the CSS or Javascript nodes.
Other functions of the DomTemplate include:
- getElementById(): Retrieve a node via its ID attribute.
- setTitleText(): Set the <title> tag text if the tag exists.
- appendMetaTag(): will append a meta tag to the parent template if a <head> tag exists.
Loader
The loader object gives the developer the ability to search for alternate templates before loading the supplied template. This is handy when you want to be able to give users the ability to override existing default templates. Adapters can be added/created that search for alternate templates based on your own frameworks needs.
First you need to setup the Loader and add any adapters that will look for existing templates. This uses a LIFO queue. So the Last added Adapter is the first to be executed.
Then later you can retrieve it to load all your apps templates:
AutoRenderer (deprecated)
WHY? As I am not a fan of making the DOMTemplate Lib use any type of internal scripting logic, which will add a new layer of complexity for the designer, I have terminated this as a supported part of the DOMTemplate lib.
It is left here as a reference only, use it as a base to get yourself started if you want to build on it for your own requirements.
The auto renderer was built to facilitate automatic rendering of data similar to that of other templating languages.
Data is passed to the auto renderer and template attributes are used to display the selected data stored in the AutoRenderer.
See the Example
All versions of tk-domtemplate with dependencies
ext-dom Version *
ext-tidy Version *
scssphp/scssphp Version ^1.11.0-@stable