Files
nextcloud-docs/developer_manual/basics/front-end/css.rst
Christoph Wurst 2647cd93c7 Restructure the dev manual
This moves lots of pages around. The high-level changes are

* Better main sections, so it's more *general*, *into*, *basics* and *details*
* Move more general topics to a *Basic* section, which are not
  app-specific
* Remove app docs to the stuff that is likely used, anything else goes
  into "Digging deeper"
* Move general guides into a prologue
* Try to *compress*/combine some pages with similar content
* Try to have better consistencs on level ob abstraction across pages
* Split app development and maintenance pages into two sections
* Integrate bugtracker info into prologue
* Integrate Android pages into client APIs section

Signed-off-by: Christoph Wurst <christoph@winzerhof-wurst.at>
2020-06-22 18:35:59 +02:00

40 lines
1.4 KiB
ReStructuredText

===
CSS
===
.. sectionauthor:: Bernhard Posselt <dev@bernhard-posselt.com>
The CSS files reside in the **css/** folder and should be included in the template:
.. code-block:: php
<?php
// include one file
style('myapp', 'style'); // adds css/style.(s)css
// include multiple files for the same app
style('myapp', array('style', 'navigation')); // adds css/style.(s)css, css/navigation.(s)css
// include vendor file (also allows array syntax)
vendor_style('myapp', 'style'); // adds vendor/style.(s)css
.. note:: ``SCSS`` is supported natively.
You can migrate your files by simply renaming your ``.css`` files to ``.scss``.
The server will automatically compile, cache and and serve it.
The priority goes to the scss file. So having two file with the same name and a ``scss`` & ``css`` extension
will ensure a retro compatibility with <12 versions as scss files will be ignored by the server.
Web Components go into the **component/** folder and can be imported like this:
.. code-block:: php
<?php
// include one file
component('myapp', 'tabs'); // adds component/tabs.html
// include multiple files for the same app
component('myapp', array('tabs', 'forms')); // adds component/tabs.html, component/forms.html
.. note:: Keep in mind that Web Components are still very new and you `might need to add polyfills <https://www.webcomponents.org/polyfills/>`_