data/TWiki/TWikiCss.txt
author Colas Nahaboo <colas@nahaboo.net>
Sat, 26 Jan 2008 15:50:53 +0100
changeset 0 414e01d06fd5
permissions -rw-r--r--
RELEASE 4.2.0 freetown
colas@0
     1
%META:TOPICINFO{author="TWikiContributor" date="1111929255" format="1.0" version="7"}%
colas@0
     2
%STARTINCLUDE%
colas@0
     3
---+ Appendix C: TWiki CSS
colas@0
     4
colas@0
     5
_Listing of CSS class names emitted from TWiki core code and standard plugins, for the Dakar release._
colas@0
     6
colas@0
     7
%TOC%
colas@0
     8
colas@0
     9
---++ Who should read this document?
colas@0
    10
colas@0
    11
Most html elements generated by TWiki core code now have Cascading Style Sheet (CSS) tags. __Skin builders__ and others who want to change the appearance of the default TWiki installation or any of the skins can use this document to see what styles can be created for these html elements.
colas@0
    12
colas@0
    13
---++ Naming conventions
colas@0
    14
colas@0
    15
   1 All TWiki class names have the prefix =twiki=. So: twikiAlert, twikiToc, etcetera. Remember that CSS class names are case sensitive - TWiki CSS uses lowercase =tw=.
colas@0
    16
   1 If you define your own CSS classes, it is preferable that you do not use the =twiki= prefix to prevent undesired overriding effects.
colas@0
    17
colas@0
    18
A wide range of standard styles are used in the TWiki core code and topics, and more are used in plugins. The following is an exhaustive list of all styles defined by the Pattern skin. For the most part, the names are the only documentation of the purpose of the style. For more information on how these styles are used, read the code (sorry!)
colas@0
    19
colas@0
    20
---+++ TWiki styles in core code
colas@0
    21
colas@0
    22
|.twikiAlert  |Client.pm, Form.pm, Statistics.pm  |
colas@0
    23
|.twikiFirstCol  |Render.pm  |
colas@0
    24
|.twikiForm  |Render.pm  |
colas@0
    25
|.twikiNew  |Changes.pm, Search.pm  |
colas@0
    26
|.twikiHelp  |Changes.pm  |
colas@0
    27
|.twikiTopRow  |Manage.pm  |
colas@0
    28
|.twikiSummary  |Manage.pm  |
colas@0
    29
|.twikiGrayText  |Manage.pm  |
colas@0
    30
|.twikiCheckBox  |Manage.pm  |
colas@0
    31
|.twikiLink  |Render.pm  |
colas@0
    32
|.twikiNewLink  |Render.pm  |
colas@0
    33
|.twikiAnchorLink  |Render.pm  |
colas@0
    34
|.twikiCurrentWebHomeLink  |Render.pm  |
colas@0
    35
|.twikiCurrentTopicLink  |Render.pm  |
colas@0
    36
|.twikiEmulatedLink  |Preview.pm  |
colas@0
    37
|.twikiWebIndent  |TWiki.pm  |
colas@0
    38
colas@0
    39
|.twikiEditFormDateField  | Form.pm  |
colas@0
    40
|.twikiEditFormTextField  |Form.pm  |
colas@0
    41
|.twikiEditFormLabelField  |Form.pm  |
colas@0
    42
|.twikiEditFormTextAreaField  |Form.pm  |
colas@0
    43
|.twikiEditFormCheckboxButton  |Form.pm  |
colas@0
    44
|.twikiEditFormCheckboxField  |Form.pm  |
colas@0
    45
|.twikiRadioButton  |Form.pm  |
colas@0
    46
|.twikiEditFormRadioField  |Form.pm  |
colas@0
    47
|.twikiEditFormError  |Form.pm  |
colas@0
    48
colas@0
    49
|.twikiDiffTable  |RDiff.pm  |
colas@0
    50
|.twikiDiffDeletedHeader  |RDiff.pm  |
colas@0
    51
|.twikiDiffDeletedMarker  |RDiff.pm  |
colas@0
    52
|.twikiDiffDeletedText  |RDiff.pm  |
colas@0
    53
|.twikiDiffAddedHeader  |RDiff.pm  |
colas@0
    54
|.twikiDiffAddedMarker  |RDiff.pm  |
colas@0
    55
|.twikiDiffAddedText  |RDiff.pm  |
colas@0
    56
|.twikiDiffChangedHeader  |RDiff.pm  |
colas@0
    57
|.twikiDiffChangedText  |RDiff.pm  |
colas@0
    58
|.twikiDiffUnchangedText  |RDiff.pm  |
colas@0
    59
|.twikiDiffUnchangedTextContents  |RDiff.pm  |
colas@0
    60
|.twikiDiffLineNumberHeader  |RDiff.pm  |
colas@0
    61
|.twikiDiffDebug  |RDiff.pm  |
colas@0
    62
|.twikiDiffDebugRight  |RDiff.pm  |
colas@0
    63
|.twikiDiffDebugLeft  |RDiff.pm  |
colas@0
    64
colas@0
    65
|.twikiToc  |TWiki.pm  |
colas@0
    66
|.twikiTocTitle  |TWiki.pm  |
colas@0
    67
colas@0
    68
colas@0
    69
---+++ TWiki Styles in Plugins
colas@0
    70
---++++ TablePlugin
colas@0
    71
|=.twikiTable=  |The table  |
colas@0
    72
|=.twikiSortedCol=  |A sorted column  |
colas@0
    73
|=.twikiSortedAscendingCol=  |Sorted column, ascending  |
colas@0
    74
|=.twikiSortedDescendingCol=  |Sorted column, descending  |
colas@0
    75
|=.tableSortIcon=  |The sort icon holder (span)  |
colas@0
    76
|=.twikiFirstCol=  |The first column  |
colas@0
    77
|=.twikiTableEven= |Even numbered rows  |
colas@0
    78
|=.twikiTableOdd= |Odd numbered rows  |
colas@0
    79
|=.twikiTableCol= + column number  | Unique column identifier, for instance: =twikiTableCol0= |
colas@0
    80
|=.twikiTableRow= + type + row number | Unique row identifier, for instance: =twikiTableRowdataBg0= |
colas@0
    81
colas@0
    82
colas@0
    83
---+++ TWiki Styles in Templates
colas@0
    84
colas@0
    85
|.twikiPage  |twiki.tmpl  |
colas@0
    86
|.twikiMiddleContainer  |twiki.tmpl  |
colas@0
    87
|.twikiMain  |twiki.tmpl  |
colas@0
    88
|.twikiFormTable  |formtables.tmpl, form.tmpl  |
colas@0
    89
|.twikiFormTableHRow  |formtables.tmpl, form.tmpl  |
colas@0
    90
|.twikiFormTableRow  |formtables.tmpl  |
colas@0
    91
|.twikiFormTableFooter  |formtables.tmpl  |
colas@0
    92
|.twikiAttachments  |attachtables.tmpl |
colas@0
    93
|.twikiEditForm |form.tmpl |
colas@0
    94
|.twikiSubmit  | |
colas@0
    95
|.twikiSubmitDisabled  | |
colas@0
    96
|.twikiInputField  | |
colas@0
    97
|.twikiInputFieldDisabled  | |
colas@0
    98
|.twikiInputFieldReadOnly  | |
colas@0
    99
|.twikiInputFieldFocus | For Internet Explorer that does not recognize the =:focus= pseudo class selector |
colas@0
   100
|.twikiInputFieldBeforeFocus  |for use with Javascript: the color of the input text when not clicked in the field |
colas@0
   101
|.twikiTextarea | |
colas@0
   102
|.twikiTextareaRawView | |
colas@0
   103
|.twikiButton  | |
colas@0
   104
|.twikiFocus  |Behaviour marker so a field can be given input focus |
colas@0
   105
|.twikiLeft  | |
colas@0
   106
|.twikiRight  | |
colas@0
   107
|.twikiClear  | |
colas@0
   108
|.twikiHidden  | |
colas@0
   109
|.twikiSmall  | |
colas@0
   110
|.twikiBottomRow  | |
colas@0
   111
|.twikiSRAuthor  | |
colas@0
   112
|.twikiSRRev  | |
colas@0
   113
|.twikiPageForm  | |
colas@0
   114
|.twikiSeparator  | |
colas@0
   115
|.twikiAccessKey  | |
colas@0
   116
|.twikiLinkLabel  | |
colas@0
   117
|.twikiFormSteps  |container around a form, such as the attach form: attach.tmpl |
colas@0
   118
|.twikiFormStep  |form row |
colas@0
   119
|.twikiNoBreak   | no break on whitespace |
colas@0
   120
|.twikiMakeVisible  |For elements that should only be visible with javascript on: default set to hidden, is made visible by javascript. Defaults to inline. |
colas@0
   121
|.twikiMakeVisibleInline  |For =span= elements that should only be visible with javascript on: default set to hidden, is made visible by javascript. |
colas@0
   122
|.twikiMakeVisibleBlock  |For =div= elements that should only be visible with javascript on: default set to hidden, is made visible by javascript. |
colas@0
   123
|.twikiMakeHidden  |For elements that should be *hidden* with javascript on: no default style, is made hidden by javascript. |
colas@0
   124
|.twikiFooterNote  | |
colas@0
   125
|.twikiPopUp | Behaviour marker so a popup-window can be invoked |
colas@0
   126
colas@0
   127
---+++ TWiki Styles used in =configure=
colas@0
   128
|#twikiLogin  |CSS.pm  |
colas@0
   129
|.twikiFormSteps  |CSS.pm |
colas@0
   130
|.twikiFormStep  |CSS.pm |
colas@0
   131
colas@0
   132
---+++ TWiki Styles in topics
colas@0
   133
colas@0
   134
|.twikiBroadcastMessage  |%SYSTEMWEB%.TWikiPreferences  |
colas@0
   135
|#twikiSearchTable  |%SYSTEMWEB%.WebSearch, %SYSTEMWEB%.WebSearchAdvanced  |
colas@0
   136
colas@0
   137
---+++ TWiki Styles in Skins
colas@0
   138
|#twikiLogin  | login.pattern.tmpl  | |
colas@0
   139
colas@0
   140
---+++ Reserved Styles
colas@0
   141
|.twikiImage  | defined in PatternSkin  |div creates border around enclosed image |
colas@0
   142
|.twikiNotification  | defined in PatternSkin |temporary alert, lighter than broadcast message |
colas@0
   143
|.twikiUnvisited  | defined in PatternSkin  |link style that ignores the visited link state; useful for form links |
colas@0
   144
colas@0
   145
---++ Tips
colas@0
   146
!PatternSkin makes extensive use of CSS in its templates. Read the PatternSkin topic and PatternSkinCss to learn more about creating your own CSS-based skin.
colas@0
   147
colas@0
   148
Practical introduction to CSS: http://www.w3.org/Style/LieBos2e/enter/
colas@0
   149
colas@0
   150
__Related Topics:__ TWikiSkins, PatternSkin, DeveloperDocumentationCategory, AdminDocumentationCategory
colas@0
   151
colas@0
   152
%STOPINCLUDE%