Skip to content

Commit a8f7a26

Browse files
authored
docs(v8): update with latest migration recommendations (#3524)
1 parent 01344a3 commit a8f7a26

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

docs/updating/8-0.md

+17
Original file line numberDiff line numberDiff line change
@@ -148,6 +148,17 @@ Developers who want to disable dynamic font scaling can set `--ion-dynamic-font:
148148

149149
For more information on the dynamic font, refer to the [Dynamic Font Scaling documentation](../layout/dynamic-font-scaling).
150150

151+
### (Angular Only) `angular.json` CSS import order
152+
153+
The `angular.json` file currently imports `src/theme/variables.scss` before importing `src/global.scss`. This may cause the incorrect styles to be applied when customizing the new [Dark Theme](#dark-theme) changes.
154+
155+
We recommend having the `src/global.scss` file get imported first instead:
156+
157+
```diff
158+
- "styles": ["src/theme/variables.scss", "src/global.scss"],
159+
+ "styles": ["src/global.scss", "src/theme/variables.scss"],
160+
```
161+
151162
## Required Changes
152163

153164
### Browser Support
@@ -175,6 +186,12 @@ iOS >=15
175186
2. Remove any usages of the `accept` property.
176187
3. Migrate any remaining instances of Input to use the [modern form control syntax](../api/input#migrating-from-legacy-input-syntax). Additionally, remove any usages of the `legacy` property as the legacy form control syntax has been removed.
177188

189+
### Item
190+
191+
1. Remove any usages of the `counter` or `counterFormatter` properties. Use the properties of the same names on `ion-input` and `ion-textarea` instead.
192+
2. Remove any usages of the `helper` or `error` slots. Use the `helperText` and `errorText` properties on `ion-input` and `ion-textarea` instead.
193+
3. Remove any usages of the `fill` or `shape` properties. Use the properties of the same names on `ion-input`, `ion-textarea`, and `ion-select` instead.
194+
178195
### Nav
179196

180197
1. Update any usages of `getLength` to `await` the call before accessing the returned value as this method now returns `Promise<number>` instead of `number`.

0 commit comments

Comments
 (0)