Merge cfeb445 into dc84fe1

resources/migration/v1_to_v2_migration_guide.md

@@ -0,0 +1,84 @@
+# Migration guide of Material Design Lite for Seaside V1 to V2
+
+**WORK IN PROGRESS**
+
+The version v2.0.0 of Material Design Lite contains breaking changes. This guide is here to ease the migration of projects to this new version. 
+
+*Note that most of the replacement for removed classes/methods are already present in v1.3.0 to ease the transition.*
+
+## Removal of MDLPaginationWidget
+
+`MDLPaginationWidget` had almost everything duplicated in `MDLSortableTable`. In order to ease the maintenance of this project, the widget is now removed in v2.0.0.
+
+The easiest way to manage paginated tables is now to use a `MDLSortableTable`. Note that v2.0.0 also comes with a new pagination widget that is not table oriented and that is `MDLPaginationComponent`.
+
+You can find example of those widgets in the demo of Material Design Lite for Seaside.
+
+## Renaming of MDLCalendarWidget and MDLCalendarCardWidget
+
+Two renaming happened on the date picker present in MDL widgets in order to use more conventional names. 
+
+- `MDLCalendarWidget` is now named `MDLFlatDatePicker`
+- `MDLCalendarCardWidget` is now named `MDLDatePicker`
+
+The behavior of those components is still the same as before.
+
+
+## WATagBrush>>#mdlCardTitle is now named #mdlCardTitleContainer
+
+Two methods around the MDL card titles were renamed to be coherent with the naming convention of MDL.
+
+- `WATagBrush>>#mdlCardTitle` is now `WATagBrush>>#mdlCardTitleContainer`
+- `WATagBrush>>#mdlCardTitle:` is now `WATagBrush>>#mdlCardTitleContainer:`
+
+## MDLMenuItem>>disable is now removed
+
+The method `MDLMenuItem>>disable` is now removed. You can use the method `disabled` that is more coherent with Seaside API.
+
+## MDLGridSection is now removed
+
+`MDLGridSection` is now removed from MDL for Seaside. To replace it you can directly call the method `beGrid` on a section brush.
+
+## MDLApplication>>applicationName is now removed
+
+It was possible before to set a variabel `#applicationName` in a MDLApplication. But this name was used nowhere in the abstract class. It is now removed. If you wish to get this variable in your application you can just create a new variable in you subclass.
+
+## MDLFooterLogo is now removed
+
+The class `MDLFooterLogo` is now removed since it is a duplication of `MDLLogo`. This change should not impact the users since they should use brushes instead of referencing the class directly.
+
+## Removal of MDLCheckboxWidget
+
+`MDLCheckboxWidget` was an attempt to make the usage of checkboxes easier with MDL for Seaside. In the end it was not simpler than using brushes directly and was missing features. 
+
+Is it now removed in favor of direct use of checkbox brushes as shown in the demo.
+
+## Removal of MDLIconToggleLabel
+
+The class `MDLIconToggleLabel` is now removed. It can be replace by the usage of a `MDLIcon` with the `toggle` option. 
+
+## Removal of MDLMultilineTextField
+
+The class `MDLMultilineTextField` is now removed. It can be replaced by `MDLTextArea` that is the equivalent with a name closer to HTML5 standard.
+
+## Cleaning of MDLCardWidget API
+
+Some methods are now renamed in `MDLCardWidget` :
+- `addTitle:level:` is now `title:level:`
+- `addTitle:level:class:` is now `title:level:class:`
+
+## MDLSelectWidget>>defaultSorting is now removed
+
+`MDLSelectWidget>>defaultSorting` is now removed in favor of `standardSorting`.
+
+## MDLNavigationLinkWithIconComponent>>icon: is removed
+
+`MDLNavigationLinkWithIconComponent>>icon:` is removed in favor of `iconURL:`.
+
+## MDLProgressBar API cleaning
+
+In the MDLProgressBar some methods were renamed:
+- `hyde` to `hide`
+- `hyde:` to `'hide:`
+
+

src/Material-Design-Lite-Components/MDLAnchorButton.class.st

@@ -20,7 +20,7 @@ Class {
 	#superclass : #WAAnchorTag,
 	#traits : 'TMDLButton',
 	#classTraits : 'TMDLButton classTrait',
-	#category : 'Material-Design-Lite-Components-Buttons'
+	#category : #'Material-Design-Lite-Components-Buttons'
 }
 
 { #category : #initialization }

src/Material-Design-Lite-Components/MDLBadge.class.st

@@ -15,7 +15,7 @@ Example
 Class {
 	#name : #MDLBadge,
 	#superclass : #MDLDivTag,
-	#category : 'Material-Design-Lite-Components-Badge'
+	#category : #'Material-Design-Lite-Components-Badge'
 }
 
 { #category : #options }

src/Material-Design-Lite-Components/MDLButton.class.st

@@ -21,7 +21,7 @@ Class {
 	#instVars : [
 		'tag'
 	],
-	#category : 'Material-Design-Lite-Components-Buttons'
+	#category : #'Material-Design-Lite-Components-Buttons'
 }
 
 { #category : #converting }

src/Material-Design-Lite-Components/MDLCardActions.class.st

@@ -36,7 +36,7 @@ Example
 Class {
 	#name : #MDLCardActions,
 	#superclass : #MDLCardInnerDiv,
-	#category : 'Material-Design-Lite-Components-Cards'
+	#category : #'Material-Design-Lite-Components-Cards'
 }
 
 { #category : #initialization }

src/Material-Design-Lite-Components/MDLCardInnerDiv.class.st

@@ -8,7 +8,7 @@ I'm a Card inner div. Place me or my subclasses into a Card.
 Class {
 	#name : #MDLCardInnerDiv,
 	#superclass : #MDLDivTag,
-	#category : 'Material-Design-Lite-Components-Cards'
+	#category : #'Material-Design-Lite-Components-Cards'
 }
 
 { #category : #options }

src/Material-Design-Lite-Components/MDLCardMedia.class.st

@@ -7,7 +7,7 @@ I am a brush to create a medias in a card.
 Class {
 	#name : #MDLCardMedia,
 	#superclass : #MDLCardInnerDiv,
-	#category : 'Material-Design-Lite-Components-Cards'
+	#category : #'Material-Design-Lite-Components-Cards'
 }
 
 { #category : #initialization }

src/Material-Design-Lite-Components/MDLCardMenu.class.st

@@ -36,7 +36,7 @@ Example
 Class {
 	#name : #MDLCardMenu,
 	#superclass : #MDLDivTag,
-	#category : 'Material-Design-Lite-Components-Cards'
+	#category : #'Material-Design-Lite-Components-Cards'
 }
 
 { #category : #initialization }

src/Material-Design-Lite-Components/MDLCardSubtitleText.class.st

@@ -8,7 +8,7 @@ I am a brush to create a subtitle to a card.
 Class {
 	#name : #MDLCardSubtitleText,
 	#superclass : #MDLDivTag,
-	#category : 'Material-Design-Lite-Components-Cards'
+	#category : #'Material-Design-Lite-Components-Cards'
 }
 
 { #category : #initialization }

src/Material-Design-Lite-Components/MDLCardTag.class.st

@@ -24,7 +24,7 @@ Example
 Class {
 	#name : #MDLCardTag,
 	#superclass : #MDLDivTag,
-	#category : 'Material-Design-Lite-Components-Cards'
+	#category : #'Material-Design-Lite-Components-Cards'
 }
 
 { #category : #initialization }

src/Material-Design-Lite-Components/MDLCardTextContainer.class.st

@@ -36,7 +36,7 @@ Example
 Class {
 	#name : #MDLCardTextContainer,
 	#superclass : #MDLCardInnerDiv,
-	#category : 'Material-Design-Lite-Components-Cards'
+	#category : #'Material-Design-Lite-Components-Cards'
 }
 
 { #category : #initialization }

src/Material-Design-Lite-Components/MDLCardTitleContainer.class.st

@@ -36,7 +36,7 @@ Example
 Class {
 	#name : #MDLCardTitleContainer,
 	#superclass : #MDLCardInnerDiv,
-	#category : 'Material-Design-Lite-Components-Cards'
+	#category : #'Material-Design-Lite-Components-Cards'
 }
 
 { #category : #initialization }

src/Material-Design-Lite-Components/MDLCardTitleText.class.st

@@ -30,7 +30,7 @@ Example
 Class {
 	#name : #MDLCardTitleText,
 	#superclass : #WAHeadingTag,
-	#category : 'Material-Design-Lite-Components-Cards'
+	#category : #'Material-Design-Lite-Components-Cards'
 }
 
 { #category : #initialization }

src/Material-Design-Lite-Components/MDLCell.class.st

@@ -50,7 +50,7 @@ Example
 Class {
 	#name : #MDLCell,
 	#superclass : #MDLDivTag,
-	#category : 'Material-Design-Lite-Components-Layout'
+	#category : #'Material-Design-Lite-Components-Layout'
 }
 
 { #category : #'options - positionning' }

src/Material-Design-Lite-Components/MDLCheckbox.class.st

@@ -18,7 +18,7 @@ Example
 Class {
 	#name : #MDLCheckbox,
 	#superclass : #WACheckboxTag,
-	#category : 'Material-Design-Lite-Components-Forms'
+	#category : #'Material-Design-Lite-Components-Forms'
 }
 
 { #category : #initialization }

src/Material-Design-Lite-Components/MDLCheckboxContainer.class.st

@@ -18,7 +18,7 @@ Example
 Class {
 	#name : #MDLCheckboxContainer,
 	#superclass : #WALabelTag,
-	#category : 'Material-Design-Lite-Components-Forms'
+	#category : #'Material-Design-Lite-Components-Forms'
 }
 
 { #category : #initialization }

src/Material-Design-Lite-Components/MDLCheckboxLabel.class.st

@@ -18,7 +18,7 @@ Example
 Class {
 	#name : #MDLCheckboxLabel,
 	#superclass : #WATagBrush,
-	#category : 'Material-Design-Lite-Components-Forms'
+	#category : #'Material-Design-Lite-Components-Forms'
 }
 
 { #category : #initialization }

src/Material-Design-Lite-Components/MDLChipImage.class.st

@@ -19,7 +19,7 @@ Example
 Class {
 	#name : #MDLChipImage,
 	#superclass : #WAImageTag,
-	#category : 'Material-Design-Lite-Components-Chips'
+	#category : #'Material-Design-Lite-Components-Chips'
 }
 
 { #category : #public }

src/Material-Design-Lite-Components/MDLChipInitial.class.st

@@ -29,7 +29,7 @@ Example
 Class {
 	#name : #MDLChipInitial,
 	#superclass : #WATagBrush,
-	#category : 'Material-Design-Lite-Components-Chips'
+	#category : #'Material-Design-Lite-Components-Chips'
 }
 
 { #category : #options }

src/Material-Design-Lite-Components/MDLChipTag.class.st

@@ -77,7 +77,7 @@ Class {
 	#instVars : [
 		'hasContactTag'
 	],
-	#category : 'Material-Design-Lite-Components-Chips'
+	#category : #'Material-Design-Lite-Components-Chips'
 }
 
 { #category : #private }

src/Material-Design-Lite-Components/MDLChipTextTag.class.st

@@ -7,7 +7,7 @@ I am just some text inside a MDLChip.
 Class {
 	#name : #MDLChipTextTag,
 	#superclass : #WATagBrush,
-	#category : 'Material-Design-Lite-Components-Chips'
+	#category : #'Material-Design-Lite-Components-Chips'
 }
 
 { #category : #initialization }

src/Material-Design-Lite-Components/MDLDialog.class.st

@@ -22,7 +22,7 @@ Example
 Class {
 	#name : #MDLDialog,
 	#superclass : #WATagBrush,
-	#category : 'Material-Design-Lite-Components-Dialog'
+	#category : #'Material-Design-Lite-Components-Dialog'
 }
 
 { #category : #'javascript generation' }

src/Material-Design-Lite-Components/MDLDialogActions.class.st

@@ -29,7 +29,7 @@ Example
 Class {
 	#name : #MDLDialogActions,
 	#superclass : #MDLDivTag,
-	#category : 'Material-Design-Lite-Components-Dialog'
+	#category : #'Material-Design-Lite-Components-Dialog'
 }
 
 { #category : #options }

src/Material-Design-Lite-Components/MDLDialogContent.class.st

@@ -22,7 +22,7 @@ Example
 Class {
 	#name : #MDLDialogContent,
 	#superclass : #MDLDivTag,
-	#category : 'Material-Design-Lite-Components-Dialog'
+	#category : #'Material-Design-Lite-Components-Dialog'
 }
 
 { #category : #initialization }

src/Material-Design-Lite-Components/MDLDialogTitle.class.st

@@ -22,7 +22,7 @@ Example
 Class {
 	#name : #MDLDialogTitle,
 	#superclass : #WAHeadingTag,
-	#category : 'Material-Design-Lite-Components-Dialog'
+	#category : #'Material-Design-Lite-Components-Dialog'
 }
 
 { #category : #initialization }

src/Material-Design-Lite-Components/MDLDivTag.class.st

@@ -9,7 +9,7 @@ Use the <div> tag to group block-elements to format them with styles.
 Class {
 	#name : #MDLDivTag,
 	#superclass : #WATagBrush,
-	#category : 'Material-Design-Lite-Components-Core'
+	#category : #'Material-Design-Lite-Components-Core'
 }
 
 { #category : #accessing }

src/Material-Design-Lite-Components/MDLGrid.class.st

@@ -43,7 +43,7 @@ Example
 Class {
 	#name : #MDLGrid,
 	#superclass : #MDLDivTag,
-	#category : 'Material-Design-Lite-Components-Layout'
+	#category : #'Material-Design-Lite-Components-Layout'
 }
 
 { #category : #initialization }