documentation/content/developer/reference/user_interface.rst

:nosearch:

==============
User interface
==============

.. toctree::
    :titlesonly:

    user_interface/view_records
    user_interface/view_architectures
    user_interface/scss_inheritance
    user_interface/icons
[IMP] scss: update, improve preexisting content Add a new content focused on SCSS and user-interface. - SCSS coding guidelines: regroup information already available (eg [1]) or based on "oral tradition". The aim is not to establish new rules, ~99% of the current codebase is already compliant. - SCSS inheritance: explain how SCSS assets management works in odoo. For example, people still find confusing that overrides are defined before the variable to customize. - SCSS optimization tips: suggestions to lean SCSS code. Based on SCSS optimization task's know-how [2]. - CSS variables: explain how this feature is commonly used in odoo to adapt layout & design without raw CSS overrides. - UI Icons: Add link to fontAwesome4 library . Replace the picture of odoo icons with the actual font (90kb image VS 15Kb font) [1] https://github.com/odoo/odoo/wiki/SCSS-coding-guidelines [2] https://www.odoo.com/web#id=2704984&menu_id=4720&cids=1&model=project.task&view_type=form task-3090800 closes odoo/documentation#3327 X-original-commit: 2ca32b40bc48b32fe512e0177374161560d40d3b Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com> 2022-10-27 15:19:25 +07:00			`:nosearch:`

			`==============`
			`User interface`
			`==============`

			`.. toctree::`
			`:titlesonly:`

[IMP] reference: rewrite and move views documentation to user_interface/ The documentation of the views is redone in order to be up to date and has allowed a better visualization of the task on the modifiers. task-2495504 closes odoo/documentation#3523 Related: odoo/odoo#104741 Related: odoo/enterprise#35255 Related: odoo/upgrade#4884 Signed-off-by: Julien Castiaux (juc) <juc@odoo.com> 2023-01-17 22:25:44 +07:00			`user_interface/view_records`
[IMP] reference/user_interface: reformat and clarify views reference In particular, the following changes are made: - Use the `class` and `attribute` admonitions along with custom attributes to define classes, views' root attributes, views' components, and attribute values. This allows re-using the responsive design that was made for reference lists, and getting rid of the previous implementation that relied on class attributes, which were not intended for this usage and reduce readability while hindering further contributions due to a lack of flexibility (no admonitions, sub-attributes...) - Use definition lists to define view types to allow for clearer and longer descriptions. - Rewrite and restructure the explanations when there is a lack clarity. - Extract duplicated content to included RST files. - Display SVG images into dedicated admonitions. - Fix RST and English mistakes. - Rename `view_architecture` to `view_architectures`, as it lists all existing architectures and doesn't describe "the architecture of a view". - Replace underscores with hyphens in image file names to improve SEO. task-3458320 closes odoo/documentation#5237 closes odoo/documentation#7497 X-original-commit: a17eaf4c6f74e89d2f0e0b3e93dc5fd3c545b703 Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com> 2023-07-25 22:24:49 +07:00			`user_interface/view_architectures`
[IMP] scss: update, improve preexisting content Add a new content focused on SCSS and user-interface. - SCSS coding guidelines: regroup information already available (eg [1]) or based on "oral tradition". The aim is not to establish new rules, ~99% of the current codebase is already compliant. - SCSS inheritance: explain how SCSS assets management works in odoo. For example, people still find confusing that overrides are defined before the variable to customize. - SCSS optimization tips: suggestions to lean SCSS code. Based on SCSS optimization task's know-how [2]. - CSS variables: explain how this feature is commonly used in odoo to adapt layout & design without raw CSS overrides. - UI Icons: Add link to fontAwesome4 library . Replace the picture of odoo icons with the actual font (90kb image VS 15Kb font) [1] https://github.com/odoo/odoo/wiki/SCSS-coding-guidelines [2] https://www.odoo.com/web#id=2704984&menu_id=4720&cids=1&model=project.task&view_type=form task-3090800 closes odoo/documentation#3327 X-original-commit: 2ca32b40bc48b32fe512e0177374161560d40d3b Signed-off-by: Antoine Vandevenne (anv) <anv@odoo.com> 2022-10-27 15:19:25 +07:00			`user_interface/scss_inheritance`
			`user_interface/icons`